refactor: de-duplicate channel runtime and payload helpers

src/channels/plugins/media-payload.ts

@@ -0,0 +1,33 @@
+export type MediaPayloadInput = {
+  path: string;
+  contentType?: string;
+};
+
+export type MediaPayload = {
+  MediaPath?: string;
+  MediaType?: string;
+  MediaUrl?: string;
+  MediaPaths?: string[];
+  MediaUrls?: string[];
+  MediaTypes?: string[];
+};
+
+export function buildMediaPayload(
+  mediaList: MediaPayloadInput[],
+  opts?: { preserveMediaTypeCardinality?: boolean },
+): MediaPayload {
+  const first = mediaList[0];
+  const mediaPaths = mediaList.map((media) => media.path);
+  const rawMediaTypes = mediaList.map((media) => media.contentType ?? "");
+  const mediaTypes = opts?.preserveMediaTypeCardinality
+    ? rawMediaTypes
+    : rawMediaTypes.filter((value): value is string => Boolean(value));
+  return {
+    MediaPath: first?.path,
+    MediaType: first?.contentType,
+    MediaUrl: first?.path,
+    MediaPaths: mediaPaths.length > 0 ? mediaPaths : undefined,
+    MediaUrls: mediaPaths.length > 0 ? mediaPaths : undefined,
+    MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
+  };
+}

src/channels/plugins/normalize/whatsapp.ts

@@ -9,6 +9,14 @@ export function normalizeWhatsAppMessagingTarget(raw: string): string | undefine
   return normalizeWhatsAppTarget(trimmed) ?? undefined;
 }
 
+export function normalizeWhatsAppAllowFromEntries(allowFrom: Array<string | number>): string[] {
+  return allowFrom
+    .map((entry) => String(entry).trim())
+    .filter((entry): entry is string => Boolean(entry))
+    .map((entry) => (entry === "*" ? entry : normalizeWhatsAppTarget(entry)))
+    .filter((entry): entry is string => Boolean(entry));
+}
+
 export function looksLikeWhatsAppTargetId(raw: string): boolean {
   return looksLikeHandleOrPhoneTarget({
     raw,

src/channels/plugins/whatsapp-shared.ts

@@ -0,0 +1,17 @@
+import { escapeRegExp } from "../../utils.js";
+
+export const WHATSAPP_GROUP_INTRO_HINT =
+  "WhatsApp IDs: SenderId is the participant JID (group participant id).";
+
+export function resolveWhatsAppGroupIntroHint(): string {
+  return WHATSAPP_GROUP_INTRO_HINT;
+}
+
+export function resolveWhatsAppMentionStripPatterns(ctx: { To?: string | null }): string[] {
+  const selfE164 = (ctx.To ?? "").replace(/^whatsapp:/, "");
+  if (!selfE164) {
+    return [];
+  }
+  const escaped = escapeRegExp(selfE164);
+  return [escaped, `@${escaped}`];
+}