@pixelzx/genesis 2026.6.29 → 2026.7.9

package/dist/reactions-C1FEqLK1.js

@@ -0,0 +1,998 @@
+import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString, s as normalizeOptionalLowercaseString } from "./string-coerce-DPP_aYVc.js";
+import { r as stripMarkdown } from "./text-runtime-DVUvIDNC.js";
+import { A as parseBlueBubblesTarget, D as normalizeBlueBubblesHandle, a as isMacOS26OrHigher, c as createBlueBubblesClientFromParts, i as isBlueBubblesPrivateApiStatusEnabled, j as resolveBlueBubblesServerAccount, l as assertMultipartActionOk, n as getCachedBlueBubblesPrivateApiStatus, s as createBlueBubblesClient, t as fetchBlueBubblesServerInfo, u as asRecord, x as extractHandleFromChatGuid } from "./probe-D-WslSkr.js";
+import { r as warnBlueBubbles } from "./runtime-B9l-nKJ2.js";
+import path from "node:path";
+import crypto from "node:crypto";
+//#region extensions/bluebubbles/src/send-helpers.ts
+function resolveBlueBubblesSendTarget(raw) {
+	const parsed = parseBlueBubblesTarget(raw);
+	if (parsed.kind === "handle") return {
+		kind: "handle",
+		address: normalizeBlueBubblesHandle(parsed.to),
+		service: parsed.service
+	};
+	if (parsed.kind === "chat_id") return {
+		kind: "chat_id",
+		chatId: parsed.chatId
+	};
+	if (parsed.kind === "chat_guid") return {
+		kind: "chat_guid",
+		chatGuid: parsed.chatGuid
+	};
+	return {
+		kind: "chat_identifier",
+		chatIdentifier: parsed.chatIdentifier
+	};
+}
+function extractBlueBubblesMessageId(payload) {
+	if (!payload || typeof payload !== "object") return "unknown";
+	const record = payload;
+	const roots = [
+		record,
+		asRecord(record.data),
+		asRecord(record.result),
+		asRecord(record.payload),
+		asRecord(record.message),
+		Array.isArray(record.data) ? asRecord(record.data[0]) : null
+	];
+	for (const root of roots) {
+		if (!root) continue;
+		const candidates = [
+			root.message_id,
+			root.messageId,
+			root.messageGuid,
+			root.message_guid,
+			root.guid,
+			root.id,
+			root.uuid
+		];
+		for (const candidate of candidates) {
+			if (typeof candidate === "string" && candidate.trim()) return candidate.trim();
+			if (typeof candidate === "number" && Number.isFinite(candidate)) return String(candidate);
+		}
+	}
+	return "unknown";
+}
+//#endregion
+//#region extensions/bluebubbles/src/send.ts
+/** Maps short effect names to full Apple effect IDs */
+const EFFECT_MAP = {
+	slam: "com.apple.MobileSMS.expressivesend.impact",
+	loud: "com.apple.MobileSMS.expressivesend.loud",
+	gentle: "com.apple.MobileSMS.expressivesend.gentle",
+	invisible: "com.apple.MobileSMS.expressivesend.invisibleink",
+	"invisible-ink": "com.apple.MobileSMS.expressivesend.invisibleink",
+	"invisible ink": "com.apple.MobileSMS.expressivesend.invisibleink",
+	invisibleink: "com.apple.MobileSMS.expressivesend.invisibleink",
+	echo: "com.apple.messages.effect.CKEchoEffect",
+	spotlight: "com.apple.messages.effect.CKSpotlightEffect",
+	balloons: "com.apple.messages.effect.CKHappyBirthdayEffect",
+	confetti: "com.apple.messages.effect.CKConfettiEffect",
+	love: "com.apple.messages.effect.CKHeartEffect",
+	heart: "com.apple.messages.effect.CKHeartEffect",
+	hearts: "com.apple.messages.effect.CKHeartEffect",
+	lasers: "com.apple.messages.effect.CKLasersEffect",
+	fireworks: "com.apple.messages.effect.CKFireworksEffect",
+	celebration: "com.apple.messages.effect.CKSparklesEffect"
+};
+function resolveEffectId(raw) {
+	const trimmed = normalizeOptionalLowercaseString(raw);
+	if (!trimmed) return;
+	if (EFFECT_MAP[trimmed]) return EFFECT_MAP[trimmed];
+	const normalized = trimmed.replace(/[\s_]+/g, "-");
+	if (EFFECT_MAP[normalized]) return EFFECT_MAP[normalized];
+	const compact = trimmed.replace(/[\s_-]+/g, "");
+	if (EFFECT_MAP[compact]) return EFFECT_MAP[compact];
+	return raw;
+}
+function resolvePrivateApiDecision(params) {
+	const { privateApiStatus, wantsReplyThread, wantsEffect, accountId } = params;
+	const needsPrivateApi = wantsReplyThread || wantsEffect;
+	const forceOnMacOS26 = isMacOS26OrHigher(accountId) && isBlueBubblesPrivateApiStatusEnabled(privateApiStatus);
+	const canUsePrivateApi = (needsPrivateApi || forceOnMacOS26) && isBlueBubblesPrivateApiStatusEnabled(privateApiStatus);
+	const throwEffectDisabledError = wantsEffect && privateApiStatus === false;
+	if (!needsPrivateApi || privateApiStatus !== null) return {
+		canUsePrivateApi,
+		throwEffectDisabledError
+	};
+	return {
+		canUsePrivateApi,
+		throwEffectDisabledError,
+		warningMessage: `Private API status unknown; sending without ${[wantsReplyThread ? "reply threading" : null, wantsEffect ? "message effects" : null].filter(Boolean).join(" + ")}. Run a status probe to restore private-api features.`
+	};
+}
+async function parseBlueBubblesMessageResponse(res) {
+	const body = await res.text();
+	if (!body) return { messageId: "ok" };
+	try {
+		return { messageId: extractBlueBubblesMessageId(JSON.parse(body)) };
+	} catch {
+		return { messageId: "ok" };
+	}
+}
+function extractChatGuid(chat) {
+	const candidates = [
+		chat.chatGuid,
+		chat.guid,
+		chat.chat_guid,
+		chat.identifier,
+		chat.chatIdentifier,
+		chat.chat_identifier
+	];
+	for (const candidate of candidates) {
+		const value = normalizeOptionalString(candidate);
+		if (value) return value;
+	}
+	return null;
+}
+function extractChatId(chat) {
+	const candidates = [
+		chat.chatId,
+		chat.id,
+		chat.chat_id
+	];
+	for (const candidate of candidates) if (typeof candidate === "number" && Number.isFinite(candidate)) return candidate;
+	return null;
+}
+function extractChatIdentifierFromChatGuid(chatGuid) {
+	const parts = chatGuid.split(";");
+	if (parts.length < 3) return null;
+	return normalizeOptionalString(parts[2]) ?? null;
+}
+function extractParticipantAddresses(chat) {
+	const raw = (Array.isArray(chat.participants) ? chat.participants : null) ?? (Array.isArray(chat.handles) ? chat.handles : null) ?? (Array.isArray(chat.participantHandles) ? chat.participantHandles : null);
+	if (!raw) return [];
+	const out = [];
+	for (const entry of raw) {
+		if (typeof entry === "string") {
+			out.push(entry);
+			continue;
+		}
+		if (entry && typeof entry === "object") {
+			const record = entry;
+			const candidate = typeof record.address === "string" && record.address || typeof record.handle === "string" && record.handle || typeof record.id === "string" && record.id || typeof record.identifier === "string" && record.identifier;
+			if (candidate) out.push(candidate);
+		}
+	}
+	return out;
+}
+async function queryChats(params) {
+	const res = await createBlueBubblesClientFromParts({
+		baseUrl: params.baseUrl,
+		password: params.password,
+		allowPrivateNetwork: params.allowPrivateNetwork === true,
+		timeoutMs: params.timeoutMs
+	}).request({
+		method: "POST",
+		path: "/api/v1/chat/query",
+		body: {
+			limit: params.limit,
+			offset: params.offset,
+			with: ["participants"]
+		},
+		timeoutMs: params.timeoutMs
+	});
+	if (!res.ok) return [];
+	const payload = await res.json().catch(() => null);
+	const data = payload && payload.data !== void 0 ? payload.data : null;
+	return Array.isArray(data) ? data : [];
+}
+async function resolveChatGuidForTarget(params) {
+	if (params.target.kind === "chat_guid") return params.target.chatGuid;
+	const normalizedHandle = params.target.kind === "handle" ? normalizeBlueBubblesHandle(params.target.address) : "";
+	const targetChatId = params.target.kind === "chat_id" ? params.target.chatId : null;
+	const targetChatIdentifier = params.target.kind === "chat_identifier" ? params.target.chatIdentifier : null;
+	const limit = 500;
+	const preferredService = params.target.kind === "handle" && params.target.service === "sms" ? "SMS" : "iMessage";
+	const preferredPrefix = `${preferredService};-;`;
+	const otherPrefix = preferredService === "iMessage" ? "SMS;-;" : "iMessage;-;";
+	let directHandleOtherServiceMatch = null;
+	let directHandleUnknownServiceMatch = null;
+	let participantPreferredMatch = null;
+	let participantOtherServiceMatch = null;
+	let participantUnknownServiceMatch = null;
+	for (let offset = 0; offset < 5e3; offset += limit) {
+		const chats = await queryChats({
+			baseUrl: params.baseUrl,
+			password: params.password,
+			timeoutMs: params.timeoutMs,
+			offset,
+			limit,
+			allowPrivateNetwork: params.allowPrivateNetwork
+		});
+		if (chats.length === 0) break;
+		for (const chat of chats) {
+			if (targetChatId != null) {
+				const chatId = extractChatId(chat);
+				if (chatId != null && chatId === targetChatId) return extractChatGuid(chat);
+			}
+			if (targetChatIdentifier) {
+				const guid = extractChatGuid(chat);
+				if (guid) {
+					if (guid === targetChatIdentifier) return guid;
+					const guidIdentifier = extractChatIdentifierFromChatGuid(guid);
+					if (guidIdentifier && guidIdentifier === targetChatIdentifier) return guid;
+				}
+				const identifier = typeof chat.identifier === "string" ? chat.identifier : typeof chat.chatIdentifier === "string" ? chat.chatIdentifier : typeof chat.chat_identifier === "string" ? chat.chat_identifier : "";
+				if (identifier && identifier === targetChatIdentifier) return guid ?? extractChatGuid(chat);
+			}
+			if (normalizedHandle) {
+				const guid = extractChatGuid(chat);
+				const directHandle = guid ? extractHandleFromChatGuid(guid) : null;
+				if (directHandle && directHandle === normalizedHandle && guid) {
+					if (guid.startsWith(preferredPrefix)) return guid;
+					if (guid.startsWith(otherPrefix)) {
+						if (!directHandleOtherServiceMatch) directHandleOtherServiceMatch = guid;
+					} else if (!directHandleUnknownServiceMatch) directHandleUnknownServiceMatch = guid;
+				}
+				if (guid) {
+					if (guid.includes(";-;")) {
+						if (extractParticipantAddresses(chat).map((entry) => normalizeBlueBubblesHandle(entry)).includes(normalizedHandle)) {
+							if (guid.startsWith(preferredPrefix)) {
+								if (!participantPreferredMatch) participantPreferredMatch = guid;
+							} else if (guid.startsWith(otherPrefix)) {
+								if (!participantOtherServiceMatch) participantOtherServiceMatch = guid;
+							} else if (!participantUnknownServiceMatch) participantUnknownServiceMatch = guid;
+						}
+					}
+				}
+			}
+		}
+	}
+	return participantPreferredMatch ?? directHandleOtherServiceMatch ?? participantOtherServiceMatch ?? directHandleUnknownServiceMatch ?? participantUnknownServiceMatch;
+}
+/**
+* Creates a new DM chat for the given address and returns the chat GUID.
+* Requires Private API to be enabled in BlueBubbles.
+*
+* If a `message` is provided it is sent as the initial message in the new chat;
+* otherwise an empty-string message body is used (BlueBubbles still creates the
+* chat but will not deliver a visible bubble).
+*/
+async function createChatForHandle(params) {
+	const client = createBlueBubblesClientFromParts({
+		baseUrl: params.baseUrl,
+		password: params.password,
+		allowPrivateNetwork: params.allowPrivateNetwork === true,
+		timeoutMs: params.timeoutMs
+	});
+	const payload = {
+		addresses: [params.address],
+		message: params.message ?? "",
+		tempGuid: `temp-${crypto.randomUUID()}`
+	};
+	const res = await client.request({
+		method: "POST",
+		path: "/api/v1/chat/new",
+		body: payload,
+		timeoutMs: params.timeoutMs
+	});
+	if (!res.ok) {
+		const errorText = await res.text();
+		if (res.status === 400 || res.status === 403 || normalizeLowercaseStringOrEmpty(errorText).includes("private api")) throw new Error(`BlueBubbles send failed: Cannot create new chat - Private API must be enabled. Original error: ${errorText || res.status}`);
+		throw new Error(`BlueBubbles create chat failed (${res.status}): ${errorText || "unknown"}`);
+	}
+	const body = await res.text();
+	let messageId = "ok";
+	let chatGuid = null;
+	if (body) try {
+		const parsed = JSON.parse(body);
+		messageId = extractBlueBubblesMessageId(parsed);
+		const data = parsed.data;
+		if (data) {
+			chatGuid = typeof data.chatGuid === "string" && data.chatGuid || typeof data.guid === "string" && data.guid || null;
+			if (!chatGuid) {
+				const chats = data.chats ?? data.chat;
+				if (Array.isArray(chats) && chats.length > 0) {
+					const first = chats[0];
+					chatGuid = typeof first?.guid === "string" && first.guid || typeof first?.chatGuid === "string" && first.chatGuid || null;
+				} else if (chats && typeof chats === "object" && !Array.isArray(chats)) {
+					const chatObj = chats;
+					chatGuid = typeof chatObj.guid === "string" && chatObj.guid || typeof chatObj.chatGuid === "string" && chatObj.chatGuid || null;
+				}
+			}
+		}
+	} catch {}
+	return {
+		chatGuid,
+		messageId
+	};
+}
+/**
+* Creates a new chat (DM) and sends an initial message.
+* Requires Private API to be enabled in BlueBubbles.
+*/
+async function createNewChatWithMessage(params) {
+	return { messageId: (await createChatForHandle({
+		baseUrl: params.baseUrl,
+		password: params.password,
+		address: params.address,
+		message: params.message,
+		timeoutMs: params.timeoutMs,
+		allowPrivateNetwork: params.allowPrivateNetwork
+	})).messageId };
+}
+async function sendMessageBlueBubbles(to, text, opts = {}) {
+	const trimmedText = text ?? "";
+	if (!trimmedText.trim()) throw new Error("BlueBubbles send requires text");
+	const strippedText = stripMarkdown(trimmedText);
+	if (!strippedText.trim()) throw new Error("BlueBubbles send requires text (message was empty after markdown removal)");
+	const { baseUrl, password, accountId, allowPrivateNetwork, sendTimeoutMs } = resolveBlueBubblesServerAccount({
+		cfg: opts.cfg ?? {},
+		accountId: opts.accountId,
+		serverUrl: opts.serverUrl,
+		password: opts.password
+	});
+	const effectiveSendTimeoutMs = opts.timeoutMs ?? sendTimeoutMs ?? 3e4;
+	let privateApiStatus = getCachedBlueBubblesPrivateApiStatus(accountId);
+	const target = resolveBlueBubblesSendTarget(to);
+	const chatGuid = await resolveChatGuidForTarget({
+		baseUrl,
+		password,
+		timeoutMs: opts.timeoutMs,
+		target,
+		allowPrivateNetwork
+	});
+	if (!chatGuid) {
+		if (target.kind === "handle") return createNewChatWithMessage({
+			baseUrl,
+			password,
+			address: target.address,
+			message: strippedText,
+			timeoutMs: effectiveSendTimeoutMs,
+			allowPrivateNetwork
+		});
+		throw new Error("BlueBubbles send failed: chatGuid not found for target. Use a chat_guid target or ensure the chat exists.");
+	}
+	const effectId = resolveEffectId(opts.effectId);
+	const wantsReplyThread = normalizeOptionalString(opts.replyToMessageGuid) !== void 0;
+	const wantsEffect = Boolean(effectId);
+	if (privateApiStatus === null) try {
+		await fetchBlueBubblesServerInfo({
+			baseUrl,
+			password,
+			accountId,
+			timeoutMs: opts.timeoutMs ?? 5e3,
+			allowPrivateNetwork
+		});
+		privateApiStatus = getCachedBlueBubblesPrivateApiStatus(accountId);
+	} catch {}
+	const privateApiDecision = resolvePrivateApiDecision({
+		privateApiStatus,
+		wantsReplyThread,
+		wantsEffect,
+		accountId
+	});
+	if (privateApiDecision.throwEffectDisabledError) throw new Error("BlueBubbles send failed: reply/effect requires Private API, but it is disabled on the BlueBubbles server.");
+	if (privateApiDecision.warningMessage) warnBlueBubbles(privateApiDecision.warningMessage);
+	const payload = {
+		chatGuid,
+		tempGuid: crypto.randomUUID(),
+		message: strippedText,
+		method: privateApiDecision.canUsePrivateApi ? "private-api" : "apple-script"
+	};
+	if (wantsReplyThread && privateApiDecision.canUsePrivateApi) {
+		payload.selectedMessageGuid = opts.replyToMessageGuid;
+		payload.partIndex = typeof opts.replyToPartIndex === "number" ? opts.replyToPartIndex : 0;
+	}
+	if (effectId && privateApiDecision.canUsePrivateApi) payload.effectId = effectId;
+	const res = await createBlueBubblesClient({
+		cfg: opts.cfg ?? {},
+		accountId: opts.accountId,
+		serverUrl: opts.serverUrl,
+		password: opts.password
+	}).request({
+		method: "POST",
+		path: "/api/v1/message/text",
+		body: payload,
+		timeoutMs: effectiveSendTimeoutMs
+	});
+	if (!res.ok) {
+		const errorText = await res.text();
+		throw new Error(`BlueBubbles send failed (${res.status}): ${errorText || "unknown"}`);
+	}
+	return parseBlueBubblesMessageResponse(res);
+}
+//#endregion
+//#region extensions/bluebubbles/src/attachments.ts
+const AUDIO_MIME_MP3 = new Set(["audio/mpeg", "audio/mp3"]);
+const AUDIO_MIME_CAF = new Set(["audio/x-caf", "audio/caf"]);
+function sanitizeFilename(input, fallback) {
+	const trimmed = input?.trim() ?? "";
+	return ((trimmed ? path.basename(trimmed) : "") || fallback).replace(/[\r\n"\\]/g, "_");
+}
+function ensureExtension(filename, extension, fallbackBase) {
+	const currentExt = path.extname(filename);
+	if (normalizeLowercaseStringOrEmpty(currentExt) === extension) return filename;
+	return `${(currentExt ? filename.slice(0, -currentExt.length) : filename) || fallbackBase}${extension}`;
+}
+function resolveVoiceInfo(filename, contentType) {
+	const normalizedType = normalizeOptionalLowercaseString(contentType);
+	const extension = normalizeLowercaseStringOrEmpty(path.extname(filename));
+	const isMp3 = extension === ".mp3" || (normalizedType ? AUDIO_MIME_MP3.has(normalizedType) : false);
+	const isCaf = extension === ".caf" || (normalizedType ? AUDIO_MIME_CAF.has(normalizedType) : false);
+	return {
+		isAudio: isMp3 || isCaf || Boolean(normalizedType?.startsWith("audio/")),
+		isMp3,
+		isCaf
+	};
+}
+function clientFromOpts$1(params) {
+	return createBlueBubblesClient(params);
+}
+function resolveAccount(params) {
+	return resolveBlueBubblesServerAccount(params);
+}
+/**
+* Fetch attachment metadata for a message from the BlueBubbles API.
+*
+* BlueBubbles sometimes fires the `new-message` webhook before attachment
+* indexing is complete, so `attachments` arrives as `[]`. This function
+* GETs the message by GUID and returns whatever attachments the server
+* has indexed by now. (#65430, #67437)
+*/
+async function fetchBlueBubblesMessageAttachments(messageGuid, opts) {
+	return await createBlueBubblesClientFromParts({
+		baseUrl: opts.baseUrl,
+		password: opts.password,
+		allowPrivateNetwork: opts.allowPrivateNetwork === true,
+		timeoutMs: opts.timeoutMs
+	}).getMessageAttachments({
+		messageGuid,
+		timeoutMs: opts.timeoutMs
+	});
+}
+async function downloadBlueBubblesAttachment(attachment, opts = {}) {
+	return await clientFromOpts$1(opts).downloadAttachment({
+		attachment,
+		maxBytes: opts.maxBytes,
+		timeoutMs: opts.timeoutMs
+	});
+}
+/**
+* Send an attachment via BlueBubbles API.
+* Supports sending media files (images, videos, audio, documents) to a chat.
+* When asVoice is true, expects MP3/CAF audio and marks it as an iMessage voice memo.
+*/
+async function sendBlueBubblesAttachment(params) {
+	const { to, caption, replyToMessageGuid, replyToPartIndex, asVoice, opts = {} } = params;
+	let { buffer, filename, contentType } = params;
+	const wantsVoice = asVoice === true;
+	const fallbackName = wantsVoice ? "Audio Message" : "attachment";
+	filename = sanitizeFilename(filename, fallbackName);
+	contentType = normalizeOptionalString(contentType);
+	const { baseUrl, password, accountId, allowPrivateNetwork } = resolveAccount(opts);
+	const client = createBlueBubblesClient(opts);
+	let privateApiStatus = getCachedBlueBubblesPrivateApiStatus(accountId);
+	const wantsReplyThread = Boolean(replyToMessageGuid?.trim());
+	if (privateApiStatus === null && wantsReplyThread) try {
+		await fetchBlueBubblesServerInfo({
+			baseUrl,
+			password,
+			accountId,
+			timeoutMs: opts.timeoutMs ?? 5e3,
+			allowPrivateNetwork
+		});
+		privateApiStatus = getCachedBlueBubblesPrivateApiStatus(accountId);
+	} catch {}
+	const privateApiEnabled = isBlueBubblesPrivateApiStatusEnabled(privateApiStatus);
+	const isAudioMessage = wantsVoice;
+	if (isAudioMessage) {
+		const voiceInfo = resolveVoiceInfo(filename, contentType);
+		if (!voiceInfo.isAudio) throw new Error("BlueBubbles voice messages require audio media (mp3 or caf).");
+		if (voiceInfo.isMp3) {
+			filename = ensureExtension(filename, ".mp3", fallbackName);
+			contentType = contentType ?? "audio/mpeg";
+		} else if (voiceInfo.isCaf) {
+			filename = ensureExtension(filename, ".caf", fallbackName);
+			contentType = contentType ?? "audio/x-caf";
+		} else throw new Error("BlueBubbles voice messages require mp3 or caf audio (convert before sending).");
+	}
+	const target = resolveBlueBubblesSendTarget(to);
+	let chatGuid = await resolveChatGuidForTarget({
+		baseUrl,
+		password,
+		timeoutMs: opts.timeoutMs,
+		target,
+		allowPrivateNetwork
+	});
+	if (!chatGuid) {
+		if (target.kind === "handle") {
+			chatGuid = (await createChatForHandle({
+				baseUrl,
+				password,
+				address: target.address,
+				timeoutMs: opts.timeoutMs,
+				allowPrivateNetwork
+			})).chatGuid;
+			if (!chatGuid) chatGuid = await resolveChatGuidForTarget({
+				baseUrl,
+				password,
+				timeoutMs: opts.timeoutMs,
+				target,
+				allowPrivateNetwork
+			});
+		}
+		if (!chatGuid) throw new Error("BlueBubbles attachment send failed: chatGuid not found for target. Use a chat_guid target or ensure the chat exists.");
+	}
+	const boundary = `----BlueBubblesFormBoundary${crypto.randomUUID().replace(/-/g, "")}`;
+	const parts = [];
+	const encoder = new TextEncoder();
+	const addField = (name, value) => {
+		parts.push(encoder.encode(`--${boundary}\r\n`));
+		parts.push(encoder.encode(`Content-Disposition: form-data; name="${name}"\r\n\r\n`));
+		parts.push(encoder.encode(`${value}\r\n`));
+	};
+	const addFile = (name, fileBuffer, fileName, mimeType) => {
+		parts.push(encoder.encode(`--${boundary}\r\n`));
+		parts.push(encoder.encode(`Content-Disposition: form-data; name="${name}"; filename="${fileName}"\r\n`));
+		parts.push(encoder.encode(`Content-Type: ${mimeType ?? "application/octet-stream"}\r\n\r\n`));
+		parts.push(fileBuffer);
+		parts.push(encoder.encode("\r\n"));
+	};
+	addFile("attachment", buffer, filename, contentType);
+	addField("chatGuid", chatGuid);
+	addField("name", filename);
+	addField("tempGuid", `temp-${Date.now()}-${crypto.randomUUID().slice(0, 8)}`);
+	if (privateApiEnabled) addField("method", "private-api");
+	if (isAudioMessage) addField("isAudioMessage", "true");
+	const trimmedReplyTo = replyToMessageGuid?.trim();
+	if (trimmedReplyTo && privateApiEnabled) {
+		addField("selectedMessageGuid", trimmedReplyTo);
+		addField("partIndex", typeof replyToPartIndex === "number" ? String(replyToPartIndex) : "0");
+	} else if (trimmedReplyTo && privateApiStatus === null) warnBlueBubbles("Private API status unknown; sending attachment without reply threading metadata. Run a status probe to restore private-api reply features.");
+	if (caption) {
+		addField("message", caption);
+		addField("text", caption);
+		addField("caption", caption);
+	}
+	parts.push(encoder.encode(`--${boundary}--\r\n`));
+	const res = await client.requestMultipart({
+		path: "/api/v1/message/attachment",
+		boundary,
+		parts,
+		timeoutMs: opts.timeoutMs ?? 6e4
+	});
+	await assertMultipartActionOk(res, "attachment send");
+	const responseBody = await res.text();
+	if (!responseBody) return { messageId: "ok" };
+	try {
+		return { messageId: extractBlueBubblesMessageId(JSON.parse(responseBody)) };
+	} catch {
+		return { messageId: "ok" };
+	}
+}
+//#endregion
+//#region extensions/bluebubbles/src/chat.ts
+function clientFromOpts(params) {
+	return createBlueBubblesClient(params);
+}
+function assertPrivateApiEnabled(accountId, feature) {
+	if (getCachedBlueBubblesPrivateApiStatus(accountId) === false) throw new Error(`BlueBubbles ${feature} requires Private API, but it is disabled on the BlueBubbles server.`);
+}
+function resolvePartIndex(partIndex) {
+	return typeof partIndex === "number" ? partIndex : 0;
+}
+async function sendBlueBubblesChatEndpointRequest(params) {
+	const trimmed = params.chatGuid.trim();
+	if (!trimmed) return;
+	const client = clientFromOpts(params.opts);
+	if (getCachedBlueBubblesPrivateApiStatus(client.accountId) === false) return;
+	await assertMultipartActionOk(await client.request({
+		method: params.method,
+		path: `/api/v1/chat/${encodeURIComponent(trimmed)}/${params.endpoint}`,
+		timeoutMs: params.opts.timeoutMs
+	}), params.action);
+}
+async function sendPrivateApiJsonRequest(params) {
+	const client = clientFromOpts(params.opts);
+	assertPrivateApiEnabled(client.accountId, params.feature);
+	await assertMultipartActionOk(await client.request({
+		method: params.method,
+		path: params.path,
+		body: params.payload,
+		timeoutMs: params.opts.timeoutMs
+	}), params.action);
+}
+async function markBlueBubblesChatRead(chatGuid, opts = {}) {
+	await sendBlueBubblesChatEndpointRequest({
+		chatGuid,
+		opts,
+		endpoint: "read",
+		method: "POST",
+		action: "read"
+	});
+}
+async function sendBlueBubblesTyping(chatGuid, typing, opts = {}) {
+	await sendBlueBubblesChatEndpointRequest({
+		chatGuid,
+		opts,
+		endpoint: "typing",
+		method: typing ? "POST" : "DELETE",
+		action: "typing"
+	});
+}
+/**
+* Edit a message via BlueBubbles API.
+* Requires macOS 13 (Ventura) or higher with Private API enabled.
+*/
+async function editBlueBubblesMessage(messageGuid, newText, opts = {}) {
+	const trimmedGuid = messageGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles edit requires messageGuid");
+	const trimmedText = newText.trim();
+	if (!trimmedText) throw new Error("BlueBubbles edit requires newText");
+	await sendPrivateApiJsonRequest({
+		opts,
+		feature: "edit",
+		action: "edit",
+		method: "POST",
+		path: `/api/v1/message/${encodeURIComponent(trimmedGuid)}/edit`,
+		payload: {
+			editedMessage: trimmedText,
+			backwardsCompatibilityMessage: opts.backwardsCompatMessage ?? `Edited to: ${trimmedText}`,
+			partIndex: resolvePartIndex(opts.partIndex)
+		}
+	});
+}
+/**
+* Unsend (retract) a message via BlueBubbles API.
+* Requires macOS 13 (Ventura) or higher with Private API enabled.
+*/
+async function unsendBlueBubblesMessage(messageGuid, opts = {}) {
+	const trimmedGuid = messageGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles unsend requires messageGuid");
+	await sendPrivateApiJsonRequest({
+		opts,
+		feature: "unsend",
+		action: "unsend",
+		method: "POST",
+		path: `/api/v1/message/${encodeURIComponent(trimmedGuid)}/unsend`,
+		payload: { partIndex: resolvePartIndex(opts.partIndex) }
+	});
+}
+/**
+* Rename a group chat via BlueBubbles API.
+*/
+async function renameBlueBubblesChat(chatGuid, displayName, opts = {}) {
+	const trimmedGuid = chatGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles rename requires chatGuid");
+	await sendPrivateApiJsonRequest({
+		opts,
+		feature: "renameGroup",
+		action: "rename",
+		method: "PUT",
+		path: `/api/v1/chat/${encodeURIComponent(trimmedGuid)}`,
+		payload: { displayName }
+	});
+}
+/**
+* Add a participant to a group chat via BlueBubbles API.
+*/
+async function addBlueBubblesParticipant(chatGuid, address, opts = {}) {
+	const trimmedGuid = chatGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles addParticipant requires chatGuid");
+	const trimmedAddress = address.trim();
+	if (!trimmedAddress) throw new Error("BlueBubbles addParticipant requires address");
+	await sendPrivateApiJsonRequest({
+		opts,
+		feature: "addParticipant",
+		action: "addParticipant",
+		method: "POST",
+		path: `/api/v1/chat/${encodeURIComponent(trimmedGuid)}/participant`,
+		payload: { address: trimmedAddress }
+	});
+}
+/**
+* Remove a participant from a group chat via BlueBubbles API.
+*/
+async function removeBlueBubblesParticipant(chatGuid, address, opts = {}) {
+	const trimmedGuid = chatGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles removeParticipant requires chatGuid");
+	const trimmedAddress = address.trim();
+	if (!trimmedAddress) throw new Error("BlueBubbles removeParticipant requires address");
+	await sendPrivateApiJsonRequest({
+		opts,
+		feature: "removeParticipant",
+		action: "removeParticipant",
+		method: "DELETE",
+		path: `/api/v1/chat/${encodeURIComponent(trimmedGuid)}/participant`,
+		payload: { address: trimmedAddress }
+	});
+}
+/**
+* Leave a group chat via BlueBubbles API.
+*/
+async function leaveBlueBubblesChat(chatGuid, opts = {}) {
+	const trimmedGuid = chatGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles leaveChat requires chatGuid");
+	await sendPrivateApiJsonRequest({
+		opts,
+		feature: "leaveGroup",
+		action: "leaveChat",
+		method: "POST",
+		path: `/api/v1/chat/${encodeURIComponent(trimmedGuid)}/leave`
+	});
+}
+/**
+* Set a group chat's icon/photo via BlueBubbles API.
+* Requires Private API to be enabled.
+*/
+async function setGroupIconBlueBubbles(chatGuid, buffer, filename, opts = {}) {
+	const trimmedGuid = chatGuid.trim();
+	if (!trimmedGuid) throw new Error("BlueBubbles setGroupIcon requires chatGuid");
+	if (!buffer || buffer.length === 0) throw new Error("BlueBubbles setGroupIcon requires image buffer");
+	const client = clientFromOpts(opts);
+	assertPrivateApiEnabled(client.accountId, "setGroupIcon");
+	const boundary = `----BlueBubblesFormBoundary${crypto.randomUUID().replace(/-/g, "")}`;
+	const parts = [];
+	const encoder = new TextEncoder();
+	const safeFilename = path.basename(filename).replace(/[\r\n"\\]/g, "_") || "icon.png";
+	parts.push(encoder.encode(`--${boundary}\r\n`));
+	parts.push(encoder.encode(`Content-Disposition: form-data; name="icon"; filename="${safeFilename}"\r\n`));
+	parts.push(encoder.encode(`Content-Type: ${opts.contentType ?? "application/octet-stream"}\r\n\r\n`));
+	parts.push(buffer);
+	parts.push(encoder.encode("\r\n"));
+	parts.push(encoder.encode(`--${boundary}--\r\n`));
+	await assertMultipartActionOk(await client.requestMultipart({
+		path: `/api/v1/chat/${encodeURIComponent(trimmedGuid)}/icon`,
+		boundary,
+		parts,
+		timeoutMs: opts.timeoutMs ?? 6e4
+	}), "setGroupIcon");
+}
+//#endregion
+//#region extensions/bluebubbles/src/monitor-reply-cache.ts
+const REPLY_CACHE_MAX = 2e3;
+const REPLY_CACHE_TTL_MS = 360 * 60 * 1e3;
+const blueBubblesReplyCacheByMessageId = /* @__PURE__ */ new Map();
+const blueBubblesShortIdToUuid = /* @__PURE__ */ new Map();
+const blueBubblesUuidToShortId = /* @__PURE__ */ new Map();
+let blueBubblesShortIdCounter = 0;
+function generateShortId() {
+	blueBubblesShortIdCounter += 1;
+	return String(blueBubblesShortIdCounter);
+}
+function rememberBlueBubblesReplyCache(entry) {
+	const messageId = entry.messageId.trim();
+	if (!messageId) return {
+		...entry,
+		shortId: ""
+	};
+	let shortId = blueBubblesUuidToShortId.get(messageId);
+	if (!shortId) {
+		shortId = generateShortId();
+		blueBubblesShortIdToUuid.set(shortId, messageId);
+		blueBubblesUuidToShortId.set(messageId, shortId);
+	}
+	const fullEntry = {
+		...entry,
+		messageId,
+		shortId
+	};
+	blueBubblesReplyCacheByMessageId.delete(messageId);
+	blueBubblesReplyCacheByMessageId.set(messageId, fullEntry);
+	const cutoff = Date.now() - REPLY_CACHE_TTL_MS;
+	for (const [key, value] of blueBubblesReplyCacheByMessageId) {
+		if (value.timestamp < cutoff) {
+			blueBubblesReplyCacheByMessageId.delete(key);
+			if (value.shortId) {
+				blueBubblesShortIdToUuid.delete(value.shortId);
+				blueBubblesUuidToShortId.delete(key);
+			}
+			continue;
+		}
+		break;
+	}
+	while (blueBubblesReplyCacheByMessageId.size > REPLY_CACHE_MAX) {
+		const oldest = blueBubblesReplyCacheByMessageId.keys().next().value;
+		if (!oldest) break;
+		const oldEntry = blueBubblesReplyCacheByMessageId.get(oldest);
+		blueBubblesReplyCacheByMessageId.delete(oldest);
+		if (oldEntry?.shortId) {
+			blueBubblesShortIdToUuid.delete(oldEntry.shortId);
+			blueBubblesUuidToShortId.delete(oldest);
+		}
+	}
+	return fullEntry;
+}
+/**
+* Resolves a short message ID (e.g., "1", "2") to a full BlueBubbles GUID.
+* Returns the input unchanged if it's already a GUID or not found in the mapping.
+*/
+function resolveBlueBubblesMessageId(shortOrUuid, opts) {
+	const trimmed = shortOrUuid.trim();
+	if (!trimmed) return trimmed;
+	if (/^\d+$/.test(trimmed)) {
+		const uuid = blueBubblesShortIdToUuid.get(trimmed);
+		if (uuid) return uuid;
+		if (opts?.requireKnownShortId) throw new Error(`BlueBubbles short message id "${trimmed}" is no longer available. Use MessageSidFull.`);
+	}
+	return trimmed;
+}
+/**
+* Gets the short ID for a message GUID, if one exists.
+*/
+function getShortIdForUuid(uuid) {
+	return blueBubblesUuidToShortId.get(uuid.trim());
+}
+function resolveReplyContextFromCache(params) {
+	const replyToId = params.replyToId.trim();
+	if (!replyToId) return null;
+	const cached = blueBubblesReplyCacheByMessageId.get(replyToId);
+	if (!cached) return null;
+	if (cached.accountId !== params.accountId) return null;
+	const cutoff = Date.now() - REPLY_CACHE_TTL_MS;
+	if (cached.timestamp < cutoff) {
+		blueBubblesReplyCacheByMessageId.delete(replyToId);
+		return null;
+	}
+	const chatGuid = normalizeOptionalString(params.chatGuid);
+	const chatIdentifier = normalizeOptionalString(params.chatIdentifier);
+	const cachedChatGuid = normalizeOptionalString(cached.chatGuid);
+	const cachedChatIdentifier = normalizeOptionalString(cached.chatIdentifier);
+	const chatId = typeof params.chatId === "number" ? params.chatId : void 0;
+	const cachedChatId = typeof cached.chatId === "number" ? cached.chatId : void 0;
+	if (chatGuid && cachedChatGuid && chatGuid !== cachedChatGuid) return null;
+	if (!chatGuid && chatIdentifier && cachedChatIdentifier && chatIdentifier !== cachedChatIdentifier) return null;
+	if (!chatGuid && !chatIdentifier && chatId && cachedChatId && chatId !== cachedChatId) return null;
+	return cached;
+}
+//#endregion
+//#region extensions/bluebubbles/src/reactions.ts
+const REACTION_TYPES = new Set([
+	"love",
+	"like",
+	"dislike",
+	"laugh",
+	"emphasize",
+	"question"
+]);
+const REACTION_ALIASES = new Map([
+	["heart", "love"],
+	["love", "love"],
+	["❤", "love"],
+	["❤️", "love"],
+	["red_heart", "love"],
+	["thumbs_up", "like"],
+	["thumbsup", "like"],
+	["thumbs-up", "like"],
+	["thumbsup", "like"],
+	["like", "like"],
+	["thumb", "like"],
+	["ok", "like"],
+	["thumbs_down", "dislike"],
+	["thumbsdown", "dislike"],
+	["thumbs-down", "dislike"],
+	["dislike", "dislike"],
+	["boo", "dislike"],
+	["no", "dislike"],
+	["haha", "laugh"],
+	["lol", "laugh"],
+	["lmao", "laugh"],
+	["rofl", "laugh"],
+	["😂", "laugh"],
+	["🤣", "laugh"],
+	["xd", "laugh"],
+	["laugh", "laugh"],
+	["emphasis", "emphasize"],
+	["emphasize", "emphasize"],
+	["exclaim", "emphasize"],
+	["!!", "emphasize"],
+	["‼", "emphasize"],
+	["‼️", "emphasize"],
+	["❗", "emphasize"],
+	["important", "emphasize"],
+	["bang", "emphasize"],
+	["question", "question"],
+	["?", "question"],
+	["❓", "question"],
+	["❔", "question"],
+	["ask", "question"],
+	["loved", "love"],
+	["liked", "like"],
+	["disliked", "dislike"],
+	["laughed", "laugh"],
+	["emphasized", "emphasize"],
+	["questioned", "question"],
+	["fire", "love"],
+	["🔥", "love"],
+	["wow", "emphasize"],
+	["!", "emphasize"],
+	["heart_eyes", "love"],
+	["smile", "laugh"],
+	["smiley", "laugh"],
+	["happy", "laugh"],
+	["joy", "laugh"]
+]);
+const REACTION_EMOJIS = new Map([
+	["❤️", "love"],
+	["❤", "love"],
+	["♥️", "love"],
+	["♥", "love"],
+	["😍", "love"],
+	["💕", "love"],
+	["👍", "like"],
+	["👌", "like"],
+	["👎", "dislike"],
+	["🙅", "dislike"],
+	["😂", "laugh"],
+	["🤣", "laugh"],
+	["😆", "laugh"],
+	["😁", "laugh"],
+	["😹", "laugh"],
+	["‼️", "emphasize"],
+	["‼", "emphasize"],
+	["!!", "emphasize"],
+	["❗", "emphasize"],
+	["❕", "emphasize"],
+	["!", "emphasize"],
+	["❓", "question"],
+	["❔", "question"],
+	["?", "question"]
+]);
+const UNSUPPORTED_REACTION_ERROR = "UnsupportedBlueBubblesReaction";
+/**
+* Strict normalizer: throws when the input does not map to a supported
+* BlueBubbles reaction type. Use this for validator-style callers that
+* need to detect unsupported input (e.g. config sanity checks) rather
+* than gracefully substituting a fallback.
+*/
+function normalizeBlueBubblesReactionInputStrict(emoji, remove) {
+	const trimmed = emoji.trim();
+	if (!trimmed) throw new Error("BlueBubbles reaction requires an emoji or name.");
+	let raw = normalizeLowercaseStringOrEmpty(trimmed);
+	if (raw.startsWith("-")) raw = raw.slice(1);
+	const aliased = REACTION_ALIASES.get(raw) ?? raw;
+	const mapped = REACTION_EMOJIS.get(trimmed) ?? REACTION_EMOJIS.get(raw) ?? aliased;
+	if (!REACTION_TYPES.has(mapped)) {
+		const error = /* @__PURE__ */ new Error(`Unsupported BlueBubbles reaction: ${trimmed}`);
+		error.name = UNSUPPORTED_REACTION_ERROR;
+		throw error;
+	}
+	return remove ? `-${mapped}` : mapped;
+}
+/**
+* Lenient normalizer: when the input does not map to a supported
+* BlueBubbles reaction type (iMessage tapback only supports
+* love/like/dislike/laugh/emphasize/question), fall back to `love`
+* so agents that react with a wider emoji vocabulary (e.g. 👀 to
+* ack "seen, working on it") still produce a visible tapback instead
+* of failing the whole reaction request.
+*
+* Contract errors (empty input) continue to bubble up so callers
+* still catch misuse.
+*
+* Use this for model-facing paths. Callers that need to detect
+* unsupported input should use {@link normalizeBlueBubblesReactionInputStrict}.
+*/
+function normalizeBlueBubblesReactionInput(emoji, remove) {
+	try {
+		return normalizeBlueBubblesReactionInputStrict(emoji, remove);
+	} catch (error) {
+		if (error instanceof Error && error.name === UNSUPPORTED_REACTION_ERROR) return remove ? "-love" : "love";
+		throw error;
+	}
+}
+async function sendBlueBubblesReaction(params) {
+	const chatGuid = params.chatGuid.trim();
+	const messageGuid = params.messageGuid.trim();
+	if (!chatGuid) throw new Error("BlueBubbles reaction requires chatGuid.");
+	if (!messageGuid) throw new Error("BlueBubbles reaction requires messageGuid.");
+	const reaction = normalizeBlueBubblesReactionInput(params.emoji, params.remove);
+	const client = createBlueBubblesClient(params.opts ?? {});
+	if (getCachedBlueBubblesPrivateApiStatus(client.accountId) === false) throw new Error("BlueBubbles reaction requires Private API, but it is disabled on the BlueBubbles server.");
+	const res = await client.react({
+		chatGuid,
+		selectedMessageGuid: messageGuid,
+		reaction,
+		partIndex: typeof params.partIndex === "number" ? params.partIndex : 0,
+		timeoutMs: params.opts?.timeoutMs
+	});
+	if (!res.ok) {
+		const errorText = await res.text();
+		throw new Error(`BlueBubbles reaction failed (${res.status}): ${errorText || "unknown"}`);
+	}
+}
+//#endregion
+export { fetchBlueBubblesMessageAttachments as _, resolveBlueBubblesMessageId as a, sendMessageBlueBubbles as b, editBlueBubblesMessage as c, removeBlueBubblesParticipant as d, renameBlueBubblesChat as f, downloadBlueBubblesAttachment as g, unsendBlueBubblesMessage as h, rememberBlueBubblesReplyCache as i, leaveBlueBubblesChat as l, setGroupIconBlueBubbles as m, sendBlueBubblesReaction as n, resolveReplyContextFromCache as o, sendBlueBubblesTyping as p, getShortIdForUuid as r, addBlueBubblesParticipant as s, normalizeBlueBubblesReactionInputStrict as t, markBlueBubblesChatRead as u, sendBlueBubblesAttachment as v, resolveChatGuidForTarget as y };