link-stack/apps/bridge-worker/tasks/signal/send-signal-message.ts

import { db, getWorkerUtils } from "@link-stack/bridge-common";
import { createLogger } from "@link-stack/logger";
import * as signalApi from "@link-stack/signal-api";
const { Configuration, MessagesApi, GroupsApi } = signalApi;

const logger = createLogger("bridge-worker-send-signal-message");

interface SendSignalMessageTaskOptions {
  token: string;
  to: string;
  message: any;
  conversationId?: string; // Zammad ticket/conversation ID for callback
  quoteMessage?: string; // Optional: message text to quote
  quoteAuthor?: string; // Optional: author of quoted message (phone number)
  quoteTimestamp?: number; // Optional: timestamp of quoted message in milliseconds
  attachments?: Array<{
    data: string; // base64
    filename: string;
    mime_type: string;
  }>;
}

const sendSignalMessageTask = async ({
  token,
  to,
  message,
  conversationId,
  quoteMessage,
  quoteAuthor,
  quoteTimestamp,
  attachments,
}: SendSignalMessageTaskOptions): Promise<void> => {
  logger.debug(
    {
      token,
      to,
      conversationId,
      messageLength: message?.length,
    },
    "Processing outgoing message",
  );
  const bot = await db
    .selectFrom("SignalBot")
    .selectAll()
    .where("token", "=", token)
    .executeTakeFirstOrThrow();

  const { phoneNumber: number } = bot;
  const config = new Configuration({
    basePath: process.env.BRIDGE_SIGNAL_URL,
  });
  const messagesClient = new MessagesApi(config);
  const groupsClient = new GroupsApi(config);
  const worker = await getWorkerUtils();

  let finalTo = to;
  let groupCreated = false;

  try {
    // Check if 'to' is a group ID (UUID format, group.base64 format, or base64) vs phone number
    const isUUID =
      /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
        to,
      );
    const isGroupPrefix = to.startsWith("group.");
    const isBase64 = /^[A-Za-z0-9+/]+=*$/.test(to) && to.length > 20; // Base64 internal_id
    const isGroupId = isUUID || isGroupPrefix || isBase64;
    const enableAutoGroups = process.env.BRIDGE_SIGNAL_AUTO_GROUPS === "true";

    logger.debug(
      {
        to,
        isGroupId,
        enableAutoGroups,
        shouldCreateGroup:
          enableAutoGroups && !isGroupId && to && conversationId,
      },
      "Recipient analysis",
    );

    // If sending to a phone number and auto-groups is enabled, create a group first
    if (enableAutoGroups && !isGroupId && to && conversationId) {
      try {
        const groupName = `DPN Support Request: ${conversationId}`;
        const createGroupResponse = await groupsClient.v1GroupsNumberPost({
          number: bot.phoneNumber,
          data: {
            name: groupName,
            members: [to],
            description: "Private support conversation",
          },
        });

        if (createGroupResponse.id) {
          // The createGroupResponse.id already contains the full group identifier (group.BASE64)
          finalTo = createGroupResponse.id;
          groupCreated = true;

          // Fetch the group details to get the actual internalId
          let internalId: string | undefined;
          try {
            const groups = await groupsClient.v1GroupsNumberGet({
              number: bot.phoneNumber,
            });

            const createdGroup = groups.find((g) => g.id === finalTo);
            if (createdGroup && createdGroup.internalId) {
              internalId = createdGroup.internalId;
              logger.debug({ internalId }, "Got actual internalId");
            } else {
              // Fallback: extract base64 part from ID
              if (finalTo.startsWith("group.")) {
                internalId = finalTo.substring(6);
              }
            }
          } catch (fetchError) {
            logger.debug("Could not fetch group details, using ID base64 part");
            // Fallback: extract base64 part from ID
            if (finalTo.startsWith("group.")) {
              internalId = finalTo.substring(6);
            }
          }
          logger.debug(
            {
              groupId: finalTo,
              internalId,
              groupName,
              conversationId,
              originalRecipient: to,
              botNumber: bot.phoneNumber,
            },
            "Created new Signal group",
          );

          // Notify Zammad about the new group ID via webhook
          await worker.addJob("common/notify-webhooks", {
            backendId: bot.id,
            payload: {
              event: "group_created",
              conversation_id: conversationId,
              original_recipient: to,
              group_id: finalTo,
              internal_group_id: internalId,
              timestamp: new Date().toISOString(),
            },
          });
        }
      } catch (groupError) {
        logger.error(
          {
            error:
              groupError instanceof Error ? groupError.message : groupError,
            to,
            conversationId,
          },
          "Error creating Signal group",
        );
        // Continue with original recipient if group creation fails
      }
    }

    logger.debug(
      {
        fromNumber: number,
        toRecipient: finalTo,
        originalTo: to,
        recipientChanged: to !== finalTo,
        groupCreated,
        isGroupRecipient: finalTo.startsWith("group."),
      },
      "Sending message via API",
    );

    // Build the message data with optional quote parameters
    const messageData: signalApi.ApiSendMessageV2 = {
      number,
      recipients: [finalTo],
      message,
    };

    logger.debug(
      {
        number,
        recipients: [finalTo],
        message: message.substring(0, 50) + "...",
        hasQuoteParams: !!(quoteMessage && quoteAuthor && quoteTimestamp),
      },
      "Message data being sent",
    );

    // Add quote parameters if all are provided
    if (quoteMessage && quoteAuthor && quoteTimestamp) {
      messageData.quoteTimestamp = quoteTimestamp;
      messageData.quoteAuthor = quoteAuthor;
      messageData.quoteMessage = quoteMessage;

      logger.debug(
        {
          quoteAuthor,
          quoteMessage: quoteMessage.substring(0, 50) + "...",
          quoteTimestamp,
        },
        "Including quote in message",
      );
    }

    // Add attachments if provided
    if (attachments && attachments.length > 0) {
      messageData.base64Attachments = attachments.map((att) => att.data);
      logger.debug(
        {
          attachmentCount: attachments.length,
          attachmentNames: attachments.map((att) => att.filename),
        },
        "Including attachments in message",
      );
    }

    const response = await messagesClient.v2SendPost({
      data: messageData,
    });

    logger.debug(
      {
        to: finalTo,
        groupCreated,
        response: response?.timestamp || "no timestamp",
      },
      "Message sent successfully",
    );
  } catch (error: any) {
    // Try to get the actual error message from the response
    if (error.response) {
      try {
        const errorBody = await error.response.text();
        logger.error(
          {
            status: error.response.status,
            statusText: error.response.statusText,
            body: errorBody,
            sentTo: finalTo,
            messageDetails: {
              fromNumber: number,
              toRecipients: [finalTo],
              hasQuote: !!quoteMessage,
            },
          },
          "Signal API error",
        );
      } catch (e) {
        logger.error("Could not parse error response");
      }
    }
    logger.error({ error }, "Full error details");
    throw error;
  }
};

export default sendSignalMessageTask;