Implement change phone number

Closes #1240

src/main/java/org/asamk/signal/commands/FinishChangeNumberCommand.java

@@ -0,0 +1,58 @@
+package org.asamk.signal.commands;
+
+import net.sourceforge.argparse4j.inf.Namespace;
+import net.sourceforge.argparse4j.inf.Subparser;
+
+import org.asamk.signal.commands.exceptions.CommandException;
+import org.asamk.signal.commands.exceptions.IOErrorException;
+import org.asamk.signal.commands.exceptions.UserErrorException;
+import org.asamk.signal.manager.Manager;
+import org.asamk.signal.manager.api.IncorrectPinException;
+import org.asamk.signal.manager.api.NotPrimaryDeviceException;
+import org.asamk.signal.manager.api.PinLockedException;
+import org.asamk.signal.output.OutputWriter;
+
+import java.io.IOException;
+
+public class FinishChangeNumberCommand implements JsonRpcLocalCommand {
+
+    @Override
+    public String getName() {
+        return "finishChangeNumber";
+    }
+
+    @Override
+    public void attachToSubparser(final Subparser subparser) {
+        subparser.help("Verify the new number using the code received via SMS or voice.");
+        subparser.addArgument("number").help("The new phone number in E164 format.").required(true);
+        subparser.addArgument("-v", "--verification-code")
+                .help("The verification code you received via sms or voice call.")
+                .required(true);
+        subparser.addArgument("-p", "--pin").help("The registration lock PIN, that was set by the user (Optional)");
+    }
+
+    @Override
+    public void handleCommand(
+            final Namespace ns, final Manager m, final OutputWriter outputWriter
+    ) throws CommandException {
+        final var newNumber = ns.getString("number");
+        final var verificationCode = ns.getString("verification-code");
+        final var pin = ns.getString("pin");
+
+        try {
+            m.finishChangeNumber(newNumber, verificationCode, pin);
+        } catch (PinLockedException e) {
+            throw new UserErrorException(
+                    "Verification failed! This number is locked with a pin. Hours remaining until reset: "
+                            + (e.getTimeRemaining() / 1000 / 60 / 60)
+                            + "\nUse '--pin PIN_CODE' to specify the registration lock PIN");
+        } catch (IncorrectPinException e) {
+            throw new UserErrorException("Verification failed! Invalid pin, tries remaining: " + e.getTriesRemaining());
+        } catch (NotPrimaryDeviceException e) {
+            throw new UserErrorException("This command doesn't work on linked devices.");
+        } catch (IOException e) {
+            throw new IOErrorException("Failed to change number: %s (%s)".formatted(e.getMessage(),
+                    e.getClass().getSimpleName()), e);
+        }
+    }
+}