@spinabot/brigade 1.6.1 → 1.8.0

package/dist/agents/channels/bluebubbles/reactions.js

@@ -0,0 +1,207 @@
+/**
+ * BlueBubbles tapback / reaction maps.
+ *
+ * iMessage "tapbacks" are the six canonical reactions. They cross the wire two
+ * different ways:
+ *
+ *   OUTBOUND — the Private-API `message/react` endpoint takes a TYPE NAME string
+ *   (`"love"`, `"like"`, …), with a leading `-` to REMOVE
+ *   (`"-love"`). `normalizeBlueBubblesReaction` resolves any input — a type name,
+ *   a common alias, or an emoji glyph — to that wire string.
+ *
+ *   INBOUND — a tapback arrives as a MESSAGE whose `associatedMessageType` is a
+ *   numeric code: `2000-2005` = ADD, `3000-3005` = REMOVE, in the canonical order
+ *   love/like/dislike/laugh/emphasize/question. `decodeTapbackType` maps that
+ *   code to `{ emoji, action }` so the inbound path can DROP the tapback as a
+ *   normal message and (optionally) surface it as a reaction note.
+ */
+/** Ordered tapback types — index N maps to the `200N` (add) / `300N` (remove) code. */
+const REACTION_ORDER = [
+    "love",
+    "like",
+    "dislike",
+    "laugh",
+    "emphasize",
+    "question",
+];
+/** Tapback type → its representative emoji (for inbound surfacing). */
+const REACTION_EMOJI = {
+    love: "❤️",
+    like: "👍",
+    dislike: "👎",
+    laugh: "😂",
+    emphasize: "‼️",
+    question: "❓",
+};
+/**
+ * Text/name aliases → canonical type. Covers the canonical names, the
+ * Apple/Messages past-tense forms, and a broad colloquial set (`fire`, `wow`,
+ * `lmao`, `xd`, `ok`, `boo`, `heart_eyes`, `important`, `bang`, `ask`, …) so the
+ * agent can name a tapback however it likes.
+ */
+const REACTION_ALIASES = {
+    // love
+    love: "love",
+    heart: "love",
+    loved: "love",
+    red_heart: "love",
+    heart_eyes: "love",
+    fire: "love",
+    // like
+    like: "like",
+    liked: "like",
+    thumbsup: "like",
+    thumb: "like",
+    "thumbs-up": "like",
+    "thumbs up": "like",
+    thumbs_up: "like",
+    ok: "like",
+    // dislike
+    dislike: "dislike",
+    disliked: "dislike",
+    thumbsdown: "dislike",
+    "thumbs-down": "dislike",
+    "thumbs down": "dislike",
+    thumbs_down: "dislike",
+    boo: "dislike",
+    no: "dislike",
+    // laugh
+    laugh: "laugh",
+    laughed: "laugh",
+    haha: "laugh",
+    lol: "laugh",
+    lmao: "laugh",
+    rofl: "laugh",
+    xd: "laugh",
+    smile: "laugh",
+    smiley: "laugh",
+    happy: "laugh",
+    joy: "laugh",
+    // emphasize / exclaim
+    emphasize: "emphasize",
+    emphasized: "emphasize",
+    emphasis: "emphasize",
+    exclaim: "emphasize",
+    important: "emphasize",
+    bang: "emphasize",
+    wow: "emphasize",
+    "!!": "emphasize",
+    "!": "emphasize",
+    // question
+    question: "question",
+    questioned: "question",
+    ask: "question",
+    "?": "question",
+};
+/** Emoji glyph → canonical type (resolves the common variants + the broadened set). */
+const REACTION_EMOJIS = {
+    // love
+    "❤️": "love",
+    "❤": "love",
+    "♥️": "love",
+    "♥": "love",
+    "🩷": "love",
+    "😍": "love",
+    "💕": "love",
+    "🔥": "love",
+    // like
+    "👍": "like",
+    "👍🏻": "like",
+    "👌": "like",
+    // dislike
+    "👎": "dislike",
+    "👎🏻": "dislike",
+    "🙅": "dislike",
+    // laugh
+    "😂": "laugh",
+    "🤣": "laugh",
+    "😆": "laugh",
+    "😁": "laugh",
+    "😹": "laugh",
+    // emphasize
+    "‼️": "emphasize",
+    "‼": "emphasize",
+    "❗": "emphasize",
+    "❕": "emphasize",
+    // question
+    "❓": "question",
+    "❔": "question",
+};
+/**
+ * Resolve any reaction input to the BlueBubbles wire string for `message/react`.
+ * A leading `-` (e.g. `"-love"`) or the words `remove`/`removed` mark a REMOVAL.
+ * Returns null when the input doesn't map to a known tapback.
+ */
+export function normalizeBlueBubblesReaction(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        return null;
+    let remove = false;
+    let body = trimmed;
+    if (body.startsWith("-")) {
+        remove = true;
+        body = body.slice(1).trim();
+    }
+    const lower = body.toLowerCase();
+    if (lower.startsWith("remove ") || lower.startsWith("removed ")) {
+        remove = true;
+        body = body.replace(/^removed?\s+/i, "").trim();
+    }
+    const type = resolveReactionType(body);
+    if (!type)
+        return null;
+    return remove ? `-${type}` : type;
+}
+/** Resolve a name/alias/emoji to a canonical reaction type (null when unknown). */
+export function resolveReactionType(raw) {
+    const trimmed = (raw ?? "").trim();
+    if (!trimmed)
+        return null;
+    const lower = trimmed.toLowerCase();
+    if (REACTION_ALIASES[lower])
+        return REACTION_ALIASES[lower];
+    if (REACTION_EMOJIS[trimmed])
+        return REACTION_EMOJIS[trimmed];
+    // Bare canonical type passes through.
+    if (REACTION_ORDER.includes(lower))
+        return lower;
+    return null;
+}
+/**
+ * Decode an inbound `associatedMessageType` numeric code into a tapback. Codes
+ * `2000-2005` are ADD; `3000-3005` are REMOVE; the low digit selects the type in
+ * canonical order. Returns null for any non-tapback type.
+ */
+export function decodeTapbackType(associatedMessageType) {
+    if (typeof associatedMessageType !== "number" || !Number.isFinite(associatedMessageType))
+        return null;
+    let action;
+    let index;
+    if (associatedMessageType >= 2000 && associatedMessageType <= 2005) {
+        action = "added";
+        index = associatedMessageType - 2000;
+    }
+    else if (associatedMessageType >= 3000 && associatedMessageType <= 3005) {
+        action = "removed";
+        index = associatedMessageType - 3000;
+    }
+    else {
+        return null;
+    }
+    const type = REACTION_ORDER[index];
+    if (!type)
+        return null;
+    return { type, emoji: REACTION_EMOJI[type], action };
+}
+/**
+ * True iff an `associatedMessageType` is in the tapback range at all (2000-3999).
+ * Used to DROP a tapback-as-message so it isn't replied to as normal text and so
+ * a reaction-association isn't mistaken for a reply target.
+ */
+export function isTapbackAssociatedType(associatedMessageType) {
+    return (typeof associatedMessageType === "number" &&
+        Number.isFinite(associatedMessageType) &&
+        associatedMessageType >= 2000 &&
+        associatedMessageType < 4000);
+}
+//# sourceMappingURL=reactions.js.map

package/dist/agents/channels/bluebubbles/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/reactions.ts"],"names":[],"mappings":"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"}

package/dist/agents/channels/bluebubbles/send.d.ts

@@ -0,0 +1,132 @@
+/**
+ * BlueBubbles REST outbound.
+ *
+ * Every outbound action is a REST call to the BlueBubbles server, authenticated
+ * by the password in the query string (see `types.ts`). `fetch` is INJECTABLE on
+ * every function (the test seam) so the whole surface is exercised with no live
+ * server.
+ *
+ * Surface:
+ *   - `sendBlueBubblesText`       POST message/text (Private API adds reply-thread + effect)
+ *   - `sendBlueBubblesAttachment` POST message/attachment (multipart; caption is a SEPARATE bubble after)
+ *   - `reactBlueBubbles`          POST message/react (Private API)
+ *   - `editBlueBubblesMessage`    POST message/{guid}/edit (Private API)
+ *   - `unsendBlueBubblesMessage`  POST message/{guid}/unsend (Private API)
+ *   - `createBlueBubblesChat`     POST chat/new (start a DM to a fresh handle)
+ *   - `resolveChatGuid`           map a target (handle / chat_id / chat_identifier) → chatGuid
+ *
+ * iMessage has NO native media caption, so an attachment send with a caption is
+ * delivered as the media bubble FOLLOWED BY a separate text bubble (the
+ * connection layer orchestrates the second send).
+ *
+ * `bubbleSplit` splits outbound text on BLANK LINES so multi-paragraph replies
+ * land as separate iMessage bubbles (each chunk = a separate text POST).
+ */
+import { type FetchLike } from "./types.js";
+/** Shared REST args every send helper takes. */
+export interface BlueBubblesRestBase {
+    serverUrl: string;
+    password: string;
+    timeoutMs?: number;
+    /** TEST SEAM — inject a mock fetch. */
+    fetchImpl?: FetchLike;
+    /** When false, Private-API-only params (reply-thread, effect, react, edit…) are skipped/refused. */
+    privateApiEnabled?: boolean;
+    /** Allow private/LAN/loopback hosts through the SSRF guard (default TRUE for BlueBubbles). */
+    allowPrivateNetwork?: boolean;
+}
+/**
+ * Split outbound text into iMessage bubbles on BLANK lines. A run of text with
+ * no blank line stays one bubble; an empty result (whitespace only) yields []. A
+ * source with no blank line yields a single-element array (one bubble).
+ */
+export declare function bubbleSplit(text: string): string[];
+/** Result of an outbound send — the BlueBubbles message GUID when known. */
+export interface BlueBubblesSendResult {
+    messageId?: string;
+}
+/**
+ * Create a new chat to a fresh handle (DM). Returns the new chat GUID. Requires
+ * the Private API for groups; a 1:1 chat may work without it on some servers.
+ */
+export declare function createBlueBubblesChat(base: BlueBubblesRestBase, params: {
+    address: string;
+    message?: string;
+}): Promise<string>;
+/**
+ * Resolve an outbound conversation target to a real chatGuid.
+ *
+ *   - `chat_guid:` — passes straight through (the HOT inbound→reply path; the
+ *     webhook always delivers the chatGuid).
+ *   - `chat_id:` / `chat_identifier:` — looked up against the server via
+ *     `chat/query` (paged), matching the numeric id or the GUID's identifier
+ *     component. Passing these raw produced a silent 400 on a cold send.
+ *   - `handle` — looked up by participant in existing DM chats; if none exists a
+ *     fresh `chat/new` is created.
+ *
+ * Returns the resolved chatGuid. Throws when a `chat_id`/`chat_identifier`
+ * target can't be resolved (the server has no such chat) rather than handing the
+ * server a bad key.
+ */
+export declare function resolveChatGuid(base: BlueBubblesRestBase, target: string): Promise<string>;
+/** Options for a text send. */
+export interface SendTextOptions extends BlueBubblesRestBase {
+    /** Native reply-thread target (Private API): the message GUID to reply to. */
+    replyToMessageGuid?: string;
+    /** Part index of the replied-to message (Private API). */
+    replyToPartIndex?: number;
+    /** A send effect name (balloons/confetti/slam/…) — Private API. */
+    effect?: string;
+}
+/**
+ * Send ONE text bubble to a chatGuid. Use `bubbleSplit` + a loop for
+ * multi-bubble replies (the connection layer does this). Returns the message
+ * GUID when the server reports one.
+ */
+export declare function sendBlueBubblesText(chatGuid: string, message: string, opts: SendTextOptions): Promise<BlueBubblesSendResult>;
+/** Options for an attachment send. */
+export interface SendAttachmentOptions extends BlueBubblesRestBase {
+    /** Local file path to upload. */
+    filePath: string;
+    /** Override the multipart filename (e.g. an extension coerced by the voice pre-flight). Defaults to the basename of `filePath`. */
+    fileName?: string;
+    /** MIME content type, when known. */
+    contentType?: string;
+    /** Send as a voice memo (BlueBubbles converts mp3→caf when set). */
+    asVoice?: boolean;
+    /** Native reply-thread target (Private API). */
+    replyToMessageGuid?: string;
+    replyToPartIndex?: number;
+    /** Pre-read bytes (TEST SEAM — bypass disk read). */
+    bytes?: Uint8Array;
+}
+/**
+ * Send a media attachment via multipart. iMessage has NO native caption, so the
+ * caller sends any caption as a SEPARATE text bubble AFTER this (handled by the
+ * connection layer). Returns the message GUID when reported.
+ */
+export declare function sendBlueBubblesAttachment(chatGuid: string, opts: SendAttachmentOptions): Promise<BlueBubblesSendResult>;
+/**
+ * Add or remove a tapback reaction on a message (Private API). `reaction` is any
+ * input `normalizeBlueBubblesReaction` accepts (`"love"`, `"👍"`, `"-love"` to
+ * remove). Throws when the Private API isn't available or the reaction is unknown.
+ */
+export declare function reactBlueBubbles(base: BlueBubblesRestBase, params: {
+    chatGuid: string;
+    messageGuid: string;
+    reaction: string;
+    partIndex?: number;
+}): Promise<void>;
+/** Edit a previously-sent message (Private API, macOS 13+ / iMessage edit window). */
+export declare function editBlueBubblesMessage(base: BlueBubblesRestBase, params: {
+    messageGuid: string;
+    editedMessage: string;
+    partIndex?: number;
+    backwardsCompatMessage?: string;
+}): Promise<void>;
+/** Unsend (retract) a previously-sent message (Private API, iMessage unsend window). */
+export declare function unsendBlueBubblesMessage(base: BlueBubblesRestBase, params: {
+    messageGuid: string;
+    partIndex?: number;
+}): Promise<void>;
+//# sourceMappingURL=send.d.ts.map

package/dist/agents/channels/bluebubbles/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/bluebubbles/send.ts"],"names":[],"mappings":"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"}

package/dist/agents/channels/bluebubbles/send.js

@@ -0,0 +1,327 @@
+/**
+ * BlueBubbles REST outbound.
+ *
+ * Every outbound action is a REST call to the BlueBubbles server, authenticated
+ * by the password in the query string (see `types.ts`). `fetch` is INJECTABLE on
+ * every function (the test seam) so the whole surface is exercised with no live
+ * server.
+ *
+ * Surface:
+ *   - `sendBlueBubblesText`       POST message/text (Private API adds reply-thread + effect)
+ *   - `sendBlueBubblesAttachment` POST message/attachment (multipart; caption is a SEPARATE bubble after)
+ *   - `reactBlueBubbles`          POST message/react (Private API)
+ *   - `editBlueBubblesMessage`    POST message/{guid}/edit (Private API)
+ *   - `unsendBlueBubblesMessage`  POST message/{guid}/unsend (Private API)
+ *   - `createBlueBubblesChat`     POST chat/new (start a DM to a fresh handle)
+ *   - `resolveChatGuid`           map a target (handle / chat_id / chat_identifier) → chatGuid
+ *
+ * iMessage has NO native media caption, so an attachment send with a caption is
+ * delivered as the media bubble FOLLOWED BY a separate text bubble (the
+ * connection layer orchestrates the second send).
+ *
+ * `bubbleSplit` splits outbound text on BLANK LINES so multi-paragraph replies
+ * land as separate iMessage bubbles (each chunk = a separate text POST).
+ */
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveEffectId } from "./effects.js";
+import { normalizeBlueBubblesReaction } from "./reactions.js";
+import { parseIMessageTarget } from "../imessage/targets.js";
+import { blueBubblesFetchWithTimeout, buildBlueBubblesApiUrl, readBlueBubblesJson, } from "./types.js";
+/**
+ * Shared fetch-option assembly so every helper threads timeout + fetchImpl +
+ * the SSRF private-network knob identically. `allowPrivateNetwork` defaults TRUE
+ * (a BlueBubbles server is normally on the operator's LAN); only forwarded as
+ * `false` when the operator tightened the knob.
+ */
+function fetchOpts(base) {
+    return {
+        ...(base.timeoutMs !== undefined ? { timeoutMs: base.timeoutMs } : {}),
+        ...(base.fetchImpl ? { fetchImpl: base.fetchImpl } : {}),
+        ...(base.allowPrivateNetwork === false ? { allowPrivateNetwork: false } : {}),
+    };
+}
+/**
+ * Split outbound text into iMessage bubbles on BLANK lines. A run of text with
+ * no blank line stays one bubble; an empty result (whitespace only) yields []. A
+ * source with no blank line yields a single-element array (one bubble).
+ */
+export function bubbleSplit(text) {
+    const src = (text ?? "").replace(/\r\n/g, "\n");
+    if (!src.trim())
+        return [];
+    return src
+        .split(/\n\s*\n/)
+        .map((b) => b.trim())
+        .filter((b) => b.length > 0);
+}
+/** Dig a message GUID out of a BlueBubbles send response (shape varies by version). */
+function extractMessageGuid(data) {
+    if (!data || typeof data !== "object")
+        return undefined;
+    const rec = data;
+    const direct = rec.guid ?? rec.messageGuid ?? rec.tempGuid;
+    if (typeof direct === "string" && direct)
+        return direct;
+    return undefined;
+}
+/** Dig a chat GUID out of a chat/new (or chat/query) response. */
+function extractChatGuid(data) {
+    if (!data || typeof data !== "object")
+        return undefined;
+    const rec = data;
+    const direct = rec.chatGuid ?? rec.guid;
+    if (typeof direct === "string" && direct)
+        return direct;
+    const chats = rec.chats;
+    if (Array.isArray(chats) && chats[0] && typeof chats[0] === "object") {
+        const g = chats[0].guid;
+        if (typeof g === "string" && g)
+            return g;
+    }
+    return undefined;
+}
+/**
+ * Create a new chat to a fresh handle (DM). Returns the new chat GUID. Requires
+ * the Private API for groups; a 1:1 chat may work without it on some servers.
+ */
+export async function createBlueBubblesChat(base, params) {
+    const url = buildBlueBubblesApiUrl({ serverUrl: base.serverUrl, path: "chat/new", password: base.password });
+    const res = await blueBubblesFetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            addresses: [params.address],
+            message: params.message ?? "",
+            tempGuid: `temp-${randomUUID()}`,
+        }),
+    }, fetchOpts(base));
+    const data = await readBlueBubblesJson(res, "chat/new");
+    const guid = extractChatGuid(data);
+    if (!guid)
+        throw new Error("BlueBubbles chat/new returned no chat GUID");
+    return guid;
+}
+/** Pull a chat GUID off a query record. */
+function recordChatGuid(chat) {
+    const g = chat.guid ?? chat.chatGuid;
+    return typeof g === "string" && g ? g : undefined;
+}
+/** Pull the numeric chat id off a query record. */
+function recordChatId(chat) {
+    for (const c of [chat.chatId, chat.id, chat.chat_id]) {
+        if (typeof c === "number" && Number.isFinite(c))
+            return c;
+    }
+    return null;
+}
+/** The third `;`-delimited component of a chat GUID is the chat identifier. */
+function identifierFromChatGuid(chatGuid) {
+    const parts = chatGuid.split(";");
+    if (parts.length < 3)
+        return null;
+    const id = (parts[2] ?? "").trim();
+    return id || null;
+}
+/** Page through `chat/query` and return one page of chat records. */
+async function queryBlueBubblesChats(base, params) {
+    const url = buildBlueBubblesApiUrl({ serverUrl: base.serverUrl, path: "chat/query", password: base.password });
+    const res = await blueBubblesFetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ limit: params.limit, offset: params.offset, with: ["participants"] }),
+    }, fetchOpts(base));
+    if (!res.ok)
+        return [];
+    const data = await readBlueBubblesJson(res, "chat/query").catch(() => null);
+    return Array.isArray(data) ? data : [];
+}
+/**
+ * Resolve an outbound conversation target to a real chatGuid.
+ *
+ *   - `chat_guid:` — passes straight through (the HOT inbound→reply path; the
+ *     webhook always delivers the chatGuid).
+ *   - `chat_id:` / `chat_identifier:` — looked up against the server via
+ *     `chat/query` (paged), matching the numeric id or the GUID's identifier
+ *     component. Passing these raw produced a silent 400 on a cold send.
+ *   - `handle` — looked up by participant in existing DM chats; if none exists a
+ *     fresh `chat/new` is created.
+ *
+ * Returns the resolved chatGuid. Throws when a `chat_id`/`chat_identifier`
+ * target can't be resolved (the server has no such chat) rather than handing the
+ * server a bad key.
+ */
+export async function resolveChatGuid(base, target) {
+    const parsed = parseIMessageTarget(target);
+    // Hot path — a chat GUID is already a server key.
+    if (parsed.kind === "chat_guid")
+        return parsed.chatGuid;
+    const wantChatId = parsed.kind === "chat_id" ? parsed.chatId : null;
+    const wantIdentifier = parsed.kind === "chat_identifier" ? parsed.chatIdentifier : null;
+    const wantHandle = parsed.kind === "handle" ? parsed.to.trim() : "";
+    const limit = 500;
+    let participantMatch = null;
+    for (let offset = 0; offset < 5000; offset += limit) {
+        const chats = await queryBlueBubblesChats(base, { offset, limit });
+        if (chats.length === 0)
+            break;
+        for (const chat of chats) {
+            const guid = recordChatGuid(chat);
+            if (wantChatId != null && recordChatId(chat) === wantChatId && guid)
+                return guid;
+            if (wantIdentifier) {
+                if (guid && guid === wantIdentifier)
+                    return guid;
+                if (guid && identifierFromChatGuid(guid) === wantIdentifier)
+                    return guid;
+                const id = (typeof chat.identifier === "string" && chat.identifier) ||
+                    (typeof chat.chatIdentifier === "string" && chat.chatIdentifier) ||
+                    (typeof chat.chat_identifier === "string" && chat.chat_identifier) ||
+                    "";
+                if (id && id === wantIdentifier && guid)
+                    return guid;
+            }
+            if (wantHandle && !participantMatch && guid && guid.includes(";-;")) {
+                // Only DM chats (`;-;`) match a bare handle — never route a handle to a group.
+                if (identifierFromChatGuid(guid) === wantHandle)
+                    participantMatch = guid;
+            }
+        }
+    }
+    if (wantHandle) {
+        if (participantMatch)
+            return participantMatch;
+        // No existing chat for this handle — create a fresh DM.
+        return createBlueBubblesChat(base, { address: wantHandle });
+    }
+    throw new Error(`BlueBubbles could not resolve a chat for target "${target}" (no matching chat on the server)`);
+}
+/**
+ * Send ONE text bubble to a chatGuid. Use `bubbleSplit` + a loop for
+ * multi-bubble replies (the connection layer does this). Returns the message
+ * GUID when the server reports one.
+ */
+export async function sendBlueBubblesText(chatGuid, message, opts) {
+    const payload = {
+        chatGuid,
+        tempGuid: randomUUID(),
+        message,
+    };
+    if (opts.privateApiEnabled) {
+        payload.method = "private-api";
+        if (opts.replyToMessageGuid) {
+            payload.selectedMessageGuid = opts.replyToMessageGuid;
+            payload.partIndex = opts.replyToPartIndex ?? 0;
+        }
+        const effectId = opts.effect ? resolveEffectId(opts.effect) : undefined;
+        if (effectId)
+            payload.effectId = effectId;
+    }
+    const url = buildBlueBubblesApiUrl({ serverUrl: opts.serverUrl, path: "message/text", password: opts.password });
+    const res = await blueBubblesFetchWithTimeout(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(payload) }, fetchOpts(opts));
+    const data = await readBlueBubblesJson(res, "message/text");
+    const guid = extractMessageGuid(data);
+    return guid ? { messageId: guid } : {};
+}
+/** Sanitise a filename for a multipart header (CWE-93 / header injection guard). */
+function sanitizeFilename(name) {
+    const base = path.basename(name || "attachment").replace(/[\r\n"\\]/g, "_").trim();
+    return base || "attachment";
+}
+/**
+ * Send a media attachment via multipart. iMessage has NO native caption, so the
+ * caller sends any caption as a SEPARATE text bubble AFTER this (handled by the
+ * connection layer). Returns the message GUID when reported.
+ */
+export async function sendBlueBubblesAttachment(chatGuid, opts) {
+    const bytes = opts.bytes ?? new Uint8Array(await readFile(opts.filePath));
+    const filename = sanitizeFilename(opts.fileName ?? opts.filePath);
+    const form = new FormData();
+    // Copy into a fresh ArrayBuffer so the Blob ctor accepts it across lib targets.
+    const ab = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    const blob = new Blob([ab], opts.contentType ? { type: opts.contentType } : {});
+    form.append("attachment", blob, filename);
+    form.append("chatGuid", chatGuid);
+    form.append("name", filename);
+    form.append("tempGuid", `temp-${Date.now()}-${randomUUID().slice(0, 8)}`);
+    if (opts.privateApiEnabled)
+        form.append("method", "private-api");
+    if (opts.asVoice)
+        form.append("isAudioMessage", "true");
+    if (opts.privateApiEnabled && opts.replyToMessageGuid) {
+        form.append("selectedMessageGuid", opts.replyToMessageGuid);
+        form.append("partIndex", String(opts.replyToPartIndex ?? 0));
+    }
+    const url = buildBlueBubblesApiUrl({ serverUrl: opts.serverUrl, path: "message/attachment", password: opts.password });
+    const res = await blueBubblesFetchWithTimeout(url, { method: "POST", body: form }, 
+    // Attachments can be large — give a generous default upload timeout.
+    { ...fetchOpts(opts), timeoutMs: opts.timeoutMs ?? 60_000 });
+    const data = await readBlueBubblesJson(res, "message/attachment");
+    const guid = extractMessageGuid(data);
+    return guid ? { messageId: guid } : {};
+}
+/**
+ * Add or remove a tapback reaction on a message (Private API). `reaction` is any
+ * input `normalizeBlueBubblesReaction` accepts (`"love"`, `"👍"`, `"-love"` to
+ * remove). Throws when the Private API isn't available or the reaction is unknown.
+ */
+export async function reactBlueBubbles(base, params) {
+    if (base.privateApiEnabled === false) {
+        throw new Error("BlueBubbles reactions require the Private API to be enabled on the server");
+    }
+    const reaction = normalizeBlueBubblesReaction(params.reaction);
+    if (!reaction)
+        throw new Error(`Unknown iMessage reaction: ${params.reaction}`);
+    const url = buildBlueBubblesApiUrl({ serverUrl: base.serverUrl, path: "message/react", password: base.password });
+    const res = await blueBubblesFetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            chatGuid: params.chatGuid,
+            selectedMessageGuid: params.messageGuid,
+            reaction,
+            partIndex: params.partIndex ?? 0,
+        }),
+    }, fetchOpts(base));
+    await readBlueBubblesJson(res, "message/react");
+}
+/** Edit a previously-sent message (Private API, macOS 13+ / iMessage edit window). */
+export async function editBlueBubblesMessage(base, params) {
+    if (base.privateApiEnabled === false) {
+        throw new Error("BlueBubbles message edit requires the Private API to be enabled on the server");
+    }
+    const url = buildBlueBubblesApiUrl({
+        serverUrl: base.serverUrl,
+        path: `message/${encodeURIComponent(params.messageGuid)}/edit`,
+        password: base.password,
+    });
+    const res = await blueBubblesFetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            editedMessage: params.editedMessage,
+            backwardsCompatibilityMessage: params.backwardsCompatMessage ?? `Edited to: ${params.editedMessage}`,
+            partIndex: params.partIndex ?? 0,
+        }),
+    }, fetchOpts(base));
+    await readBlueBubblesJson(res, "message/edit");
+}
+/** Unsend (retract) a previously-sent message (Private API, iMessage unsend window). */
+export async function unsendBlueBubblesMessage(base, params) {
+    if (base.privateApiEnabled === false) {
+        throw new Error("BlueBubbles message unsend requires the Private API to be enabled on the server");
+    }
+    const url = buildBlueBubblesApiUrl({
+        serverUrl: base.serverUrl,
+        path: `message/${encodeURIComponent(params.messageGuid)}/unsend`,
+        password: base.password,
+    });
+    const res = await blueBubblesFetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ partIndex: params.partIndex ?? 0 }),
+    }, fetchOpts(base));
+    await readBlueBubblesJson(res, "message/unsend");
+}
+//# sourceMappingURL=send.js.map