Add command to get an attachment

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

@@ -0,0 +1,65 @@
+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.UnexpectedErrorException;
+import org.asamk.signal.json.JsonAttachmentData;
+import org.asamk.signal.manager.AttachmentPointer;
+import org.asamk.signal.manager.Manager;
+import org.asamk.signal.output.JsonWriter;
+import org.asamk.signal.output.OutputWriter;
+import org.asamk.signal.output.PlainTextWriter;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.Base64;
+
+public class AttachmentCommand implements JsonRpcLocalCommand {
+
+    @Override
+    public String getName() {
+        return "attachment";
+    }
+
+    @Override
+    public void attachToSubparser(final Subparser subparser) {
+        subparser.addArgument("--file-id")
+                .help("The ID of the attachment file.");
+        subparser.addArgument("--file-name")
+                .nargs("?")
+                .help("The name of the file.");
+        subparser.addArgument("--content-type")
+                .nargs("?")
+                .help("The content type of the file.");
+    }
+
+    @Override
+    public void handleCommand(
+            final Namespace ns,
+            final Manager m,
+            final OutputWriter outputWriter
+    ) throws CommandException {
+
+        final var id = ns.getString("file-id");
+        final var fileName = ns.getString("file-name");
+        final var contentType = ns.getString("content-type");
+
+        final var file = m.getAttachmentFile(new AttachmentPointer(id, fileName, contentType));
+
+        try {
+            final var bytes = Files.readAllBytes(file.toPath());
+            final var base64 = Base64.getEncoder().encodeToString(bytes);
+
+            if (outputWriter instanceof PlainTextWriter writer) {
+                writer.println(base64);
+            }
+            else if (outputWriter instanceof JsonWriter writer) {
+                writer.write(new JsonAttachmentData(base64));
+            }
+        } catch (IOException ex) {
+            throw new UnexpectedErrorException("An error occurred reading attachment file: " + file, ex);
+        }
+    }
+}

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

@@ -11,6 +11,7 @@ public class Commands {
 
     static {
         addCommand(new AddDeviceCommand());
+        addCommand(new AttachmentCommand());
         addCommand(new BlockCommand());
         addCommand(new DaemonCommand());
         addCommand(new DeleteLocalAccountDataCommand());

src/main/java/org/asamk/signal/dbus/DbusManagerImpl.java

@@ -2,6 +2,7 @@ package org.asamk.signal.dbus;
 
 import org.asamk.Signal;
 import org.asamk.signal.DbusConfig;
+import org.asamk.signal.manager.AttachmentPointer;
 import org.asamk.signal.manager.Manager;
 import org.asamk.signal.manager.api.AttachmentInvalidException;
 import org.asamk.signal.manager.api.Configuration;
@@ -907,6 +908,12 @@ public class DbusManagerImpl implements Manager {
         }).toList();
     }
 
+    @Override
+    public File getAttachmentFile(final AttachmentPointer pointer) {
+        //TODO may need an implementation
+        return null;
+    }
+
     @SuppressWarnings("unchecked")
     private <T> T getValue(
             final Map<String, Variant<?>> stringVariantMap, final String field

src/main/java/org/asamk/signal/json/JsonAttachmentData.java

@@ -0,0 +1,3 @@
+package org.asamk.signal.json;
+
+public record JsonAttachmentData(String dataBase64) {}