@spectrum-ts/imessage 9.3.0 → 10.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @spectrum-ts/imessage
 
-iMessage provider for [spectrum-ts](https://github.com/photon-hq/spectrum-ts), supporting local (imessage-kit) and remote (advanced-imessage) modes — including tapbacks, special effects, polls, and mini-apps.
+iMessage provider for [spectrum-ts](https://github.com/photon-hq/spectrum-ts), including tapbacks, special effects, polls, and mini-apps.
 
 ## Install
 
@@ -15,7 +15,7 @@ import { Spectrum } from "spectrum-ts";
 import { imessage } from "@spectrum-ts/imessage";
 
 const spectrum = Spectrum({
-  providers: [imessage.config({ /* ... */ })],
+  platforms: [imessage.config()],
 });
 ```
 
@@ -32,3 +32,11 @@ await space.shareContactCard();
 ```
 
 See the [spectrum-ts documentation](https://photon.codes/spectrum) for the full guide.
+
+For direct access to the local macOS Messages database, install and import
+`@spectrum-ts/imessage-local` separately. The local provider is intentionally
+not included in the batteries-included `spectrum-ts` package.
+
+```sh
+bun add @spectrum-ts/imessage-local
+```

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import { AdvancedIMessage, ChatServiceType, MessageEffect } from "@photon-ai/advanced-imessage";
-import { IMessageSDK } from "@photon-ai/imessage-kit";
+import { AdvancedIMessage, ChatServiceType } from "@photon-ai/advanced-imessage";
 import { Attachment, ContentBuilder, ContentInput, SchemaMessage, Space, read } from "@spectrum-ts/core";
 import { PhotoInput } from "@spectrum-ts/core/authoring";
 import z from "zod";
@@ -168,7 +167,22 @@ type CustomizedMiniAppInput = Omit<CustomizedMiniApp, "type" | "__platform">;
 declare function customizedMiniApp(input: CustomizedMiniAppInput): ContentBuilder;
 //#endregion
 //#region src/content/effect.d.ts
-type IMessageMessageEffect = MessageEffect;
+declare const messageEffects: {
+  readonly balloons: "com.apple.messages.effect.CKBalloonEffect";
+  readonly celebration: "com.apple.messages.effect.CKHappyBirthdayEffect";
+  readonly confetti: "com.apple.messages.effect.CKConfettiEffect";
+  readonly echo: "com.apple.messages.effect.CKEchoEffect";
+  readonly fireworks: "com.apple.messages.effect.CKFireworksEffect";
+  readonly gentle: "com.apple.MobileSMS.expressivesend.gentle";
+  readonly heart: "com.apple.messages.effect.CKHeartEffect";
+  readonly invisible: "com.apple.MobileSMS.expressivesend.invisibleink";
+  readonly lasers: "com.apple.messages.effect.CKLasersEffect";
+  readonly loud: "com.apple.MobileSMS.expressivesend.loud";
+  readonly slam: "com.apple.MobileSMS.expressivesend.impact";
+  readonly sparkles: "com.apple.messages.effect.CKSparklesEffect";
+  readonly spotlight: "com.apple.messages.effect.CKSpotlightEffect";
+};
+type IMessageMessageEffect = (typeof messageEffects)[keyof typeof messageEffects];
 declare function effect(input: ContentInput, messageEffect: IMessageMessageEffect): ContentBuilder;
 //#endregion
 //#region src/types.d.ts
@@ -176,7 +190,7 @@ interface RemoteClient {
   client: AdvancedIMessage;
   phone: string;
 }
-type IMessageClient = IMessageSDK | RemoteClient[];
+type IMessageClient = RemoteClient[];
 declare const userSchema: z.ZodObject<{
   address: z.ZodOptional<z.ZodString>;
   country: z.ZodOptional<z.ZodString>;
@@ -219,10 +233,7 @@ type IMessageMessage = SchemaMessage<typeof userSchema, typeof spaceSchema> & {
 };
 //#endregion
 //#region src/index.d.ts
-declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-ts/core").PlatformDef<"iMessage", import("zod").ZodUnion<readonly [import("zod").ZodObject<{
-  local: import("zod").ZodLiteral<true>;
-}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-  local: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodLiteral<false>>>;
+declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-ts/core").PlatformDef<"iMessage", import("zod").ZodObject<{
   clients: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodObject<{
     address: import("zod").ZodString;
     token: import("zod").ZodString;
@@ -232,7 +243,7 @@ declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-t
     token: import("zod").ZodString;
     phone: import("zod").ZodString;
   }, import("zod/v4/core").$strip>>]>>;
-}, import("zod/v4/core").$strip>]>, import("zod").ZodObject<{
+}, import("zod/v4/core").$strict>, import("zod").ZodObject<{
   address: import("zod").ZodOptional<import("zod").ZodString>;
   country: import("zod").ZodOptional<import("zod").ZodString>;
   service: import("zod").ZodOptional<import("zod").ZodEnum<{
@@ -276,9 +287,6 @@ declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-t
   }: {
     client: IMessageClient;
     config: {
-      local: true;
-    } | {
-      local: false;
       clients?: {
         address: string;
         token: string;
@@ -303,9 +311,6 @@ declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-t
   }: {
     client: IMessageClient;
     config: {
-      local: true;
-    } | {
-      local: false;
       clients?: {
         address: string;
         token: string;
@@ -330,9 +335,6 @@ declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-t
   }: {
     client: IMessageClient;
     config: {
-      local: true;
-    } | {
-      local: false;
       clients?: {
         address: string;
         token: string;
@@ -357,9 +359,6 @@ declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-t
   }: {
     client: IMessageClient;
     config: {
-      local: true;
-    } | {
-      local: false;
       clients?: {
         address: string;
         token: string;
@@ -387,19 +386,19 @@ declare const imessage: import("@spectrum-ts/core").Platform<import("@spectrum-t
 }>> & Readonly<{
   effect: {
     message: {
-      readonly slam: "com.apple.MobileSMS.expressivesend.impact";
-      readonly loud: "com.apple.MobileSMS.expressivesend.loud";
-      readonly gentle: "com.apple.MobileSMS.expressivesend.gentle";
-      readonly invisible: "com.apple.MobileSMS.expressivesend.invisibleink";
+      readonly balloons: "com.apple.messages.effect.CKBalloonEffect";
+      readonly celebration: "com.apple.messages.effect.CKHappyBirthdayEffect";
       readonly confetti: "com.apple.messages.effect.CKConfettiEffect";
+      readonly echo: "com.apple.messages.effect.CKEchoEffect";
       readonly fireworks: "com.apple.messages.effect.CKFireworksEffect";
-      readonly balloons: "com.apple.messages.effect.CKBalloonEffect";
+      readonly gentle: "com.apple.MobileSMS.expressivesend.gentle";
       readonly heart: "com.apple.messages.effect.CKHeartEffect";
+      readonly invisible: "com.apple.MobileSMS.expressivesend.invisibleink";
       readonly lasers: "com.apple.messages.effect.CKLasersEffect";
-      readonly celebration: "com.apple.messages.effect.CKHappyBirthdayEffect";
+      readonly loud: "com.apple.MobileSMS.expressivesend.loud";
+      readonly slam: "com.apple.MobileSMS.expressivesend.impact";
       readonly sparkles: "com.apple.messages.effect.CKSparklesEffect";
       readonly spotlight: "com.apple.messages.effect.CKSpotlightEffect";
-      readonly echo: "com.apple.messages.effect.CKEchoEffect";
     };
   };
 }>;

package/dist/index.js

@@ -1,15 +1,8 @@
-import { MessageEffect, NotFoundError, ValidationError, createClient } from "@photon-ai/advanced-imessage";
-import { IMessageSDK } from "@photon-ai/imessage-kit";
+import { NotFoundError, ValidationError, createClient } from "@photon-ai/advanced-imessage";
 import { sanitizePhone, withSpan } from "@photon-ai/otel";
-import { UnsupportedError, appLayoutSchema, cloud, definePlatform, fromVCard, mergeStreams, read, stream, text, toVCard } from "@spectrum-ts/core";
+import { UnsupportedError, appLayoutSchema, cloud, definePlatform, fromVCard, mergeStreams, read, text, toVCard } from "@spectrum-ts/core";
 import { addMemberSchema, asAttachment, asContact, asCustom, asGroup, asPoll, asPollOption, asReply, asText, avatarSchema, buildPhotoAction, createLogger, ensureM4a, errorAttrs, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, resumableOrderedStream, sanitizeErrorMessage } from "@spectrum-ts/core/authoring";
 import z from "zod";
-import { setTimeout as setTimeout$1 } from "node:timers/promises";
-import { createReadStream } from "node:fs";
-import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import { Readable } from "node:stream";
-import { tmpdir } from "node:os";
-import { basename, join } from "node:path";
 import { Marked } from "marked";
 import { LRUCache } from "lru-cache";
 //#region src/content/background.ts
@@ -156,7 +149,22 @@ function customizedMiniApp(input) {
 }
 //#endregion
 //#region src/content/effect.ts
-const SUPPORTED_EFFECTS = new Set(Object.values(MessageEffect));
+const messageEffects = {
+	balloons: "com.apple.messages.effect.CKBalloonEffect",
+	celebration: "com.apple.messages.effect.CKHappyBirthdayEffect",
+	confetti: "com.apple.messages.effect.CKConfettiEffect",
+	echo: "com.apple.messages.effect.CKEchoEffect",
+	fireworks: "com.apple.messages.effect.CKFireworksEffect",
+	gentle: "com.apple.MobileSMS.expressivesend.gentle",
+	heart: "com.apple.messages.effect.CKHeartEffect",
+	invisible: "com.apple.MobileSMS.expressivesend.invisibleink",
+	lasers: "com.apple.messages.effect.CKLasersEffect",
+	loud: "com.apple.MobileSMS.expressivesend.loud",
+	slam: "com.apple.MobileSMS.expressivesend.impact",
+	sparkles: "com.apple.messages.effect.CKSparklesEffect",
+	spotlight: "com.apple.messages.effect.CKSpotlightEffect"
+};
+const SUPPORTED_EFFECTS = new Set(Object.values(messageEffects));
 const resolveContent = (input) => typeof input === "string" ? text(input).build() : input.build();
 function effect(input, messageEffect) {
 	return { build: async () => {
@@ -178,16 +186,12 @@ function effect(input, messageEffect) {
 * no `from` parameter on send), so all routing through it tags this sentinel.
 */
 const SHARED_PHONE = "shared";
-const isLocal = (client) => client instanceof IMessageSDK;
 const clientEntry = z.object({
 	address: z.string(),
 	token: z.string(),
 	phone: z.string()
 });
-const configSchema = z.union([z.object({ local: z.literal(true) }), z.object({
-	local: z.literal(false).optional().default(false),
-	clients: clientEntry.or(z.array(clientEntry)).optional()
-})]);
+const configSchema = z.strictObject({ clients: clientEntry.or(z.array(clientEntry)).optional() });
 const userSchema = z.object({
 	address: z.string().optional(),
 	country: z.string().optional(),
@@ -436,10 +440,9 @@ var PollCache = class {
 const messageCaches = /* @__PURE__ */ new WeakMap();
 const pollCaches = /* @__PURE__ */ new WeakMap();
 /**
-* Returns a per-client message cache. Keyed by an object (the client array
-* for remote, or the IMessageSDK instance for local), so each iMessage
-* provider instance has its own cache and multiple providers don't share
-* state accidentally.
+* Returns a per-client message cache. Keyed by the client array so each
+* iMessage provider instance has its own cache and multiple providers don't
+* share state accidentally.
 */
 const getMessageCache = (owner) => {
 	let cache = messageCaches.get(owner);
@@ -457,257 +460,6 @@ const getPollCache = (owner) => {
 	}
 	return cache;
 };
-const addTextPart = (parts, text) => {
-	const trimmed = text?.trim();
-	if (trimmed) parts.push({
-		type: "text",
-		text: trimmed
-	});
-};
-const hasUsableTextPart = (text) => text?.split("").some((segment) => segment.trim()) ?? false;
-const addAttachmentParts = (parts, attachments) => {
-	for (const attachment of attachments) if (attachment) parts.push({
-		type: "attachment",
-		attachment
-	});
-};
-const toOrderedParts = (text, attachments) => {
-	const parts = [];
-	if (!text) {
-		addAttachmentParts(parts, attachments);
-		return parts;
-	}
-	if (!text.includes("")) {
-		addAttachmentParts(parts, attachments);
-		addTextPart(parts, text);
-		return parts;
-	}
-	const textSegments = text.split("");
-	for (let i = 0; i < attachments.length; i++) {
-		addTextPart(parts, textSegments[i]);
-		const attachment = attachments[i];
-		if (attachment) parts.push({
-			type: "attachment",
-			attachment
-		});
-	}
-	addTextPart(parts, textSegments.slice(attachments.length).join(""));
-	return parts;
-};
-//#endregion
-//#region src/shared/vcard.ts
-const VCARD_MIME_TYPES = new Set([
-	"text/vcard",
-	"text/x-vcard",
-	"text/directory",
-	"application/vcard",
-	"application/x-vcard"
-]);
-const normalizeMimeType = (mimeType) => (mimeType.split(";")[0] ?? "").trim().toLowerCase();
-const isVCardAttachment = (mimeType, fileName) => {
-	if (mimeType && VCARD_MIME_TYPES.has(normalizeMimeType(mimeType))) return true;
-	return Boolean(fileName?.toLowerCase().endsWith(".vcf"));
-};
-const vcardFileName = (contact) => {
-	return `${(contact.name?.formatted ?? contact.user?.id ?? "contact").replace(/[^a-zA-Z0-9_\-.]/g, "_")}.vcf`;
-};
-const readLocalAttachment = async (att) => {
-	if (!att.localPath) throw new Error(`iMessage attachment ${att.id} has no local file available on disk`);
-	return readFile(att.localPath);
-};
-const toAttachmentContent$1 = (att) => {
-	const { localPath } = att;
-	return asAttachment({
-		id: att.id,
-		name: att.fileName ?? "attachment",
-		mimeType: att.mimeType,
-		size: att.sizeBytes,
-		read: () => readLocalAttachment(att),
-		stream: localPath ? async () => Readable.toWeb(createReadStream(localPath)) : void 0
-	});
-};
-const toVCardContent$1 = async (att) => {
-	try {
-		return asContact(fromVCard((await readLocalAttachment(att)).toString("utf8")));
-	} catch {
-		return toAttachmentContent$1(att);
-	}
-};
-const localAttachmentContent = async (att) => isVCardAttachment(att.mimeType, att.fileName) ? await toVCardContent$1(att) : toAttachmentContent$1(att);
-//#endregion
-//#region src/local/inbound.ts
-const ATTACHMENT_JOIN_RETRY_DELAY_MS = 250;
-const ATTACHMENT_JOIN_RETRY_LIMIT = 8;
-const ATTACHMENT_JOIN_FETCH_LIMIT = 10;
-const hasAttachmentPlaceholder = (message) => message.text?.includes("") ?? false;
-const isPendingAttachmentJoin = (message) => message.attachments.length === 0 && (message.hasAttachments || hasAttachmentPlaceholder(message));
-const replyTargetId = (message) => message.threadRootMessageId ?? void 0;
-const stubReplyTarget$1 = (space, targetId) => ({
-	id: targetId,
-	content: asCustom({
-		imessage_type: "reply-target",
-		stub: true
-	}),
-	space
-});
-const asProviderReply$1 = (content, target) => asReply({
-	content,
-	target
-});
-const wrapReply = (messages, targetId) => {
-	if (!targetId) return messages;
-	return messages.map((message) => ({
-		...message,
-		content: asProviderReply$1(message.content, stubReplyTarget$1(message.space, targetId))
-	}));
-};
-const refetchUntilAttachmentsSettle = async (client, message) => {
-	if (!message.chatId) return message;
-	for (let attempt = 0; attempt < ATTACHMENT_JOIN_RETRY_LIMIT; attempt += 1) {
-		await setTimeout$1(ATTACHMENT_JOIN_RETRY_DELAY_MS);
-		let rows;
-		try {
-			rows = await client.getMessages({
-				chatId: message.chatId,
-				limit: ATTACHMENT_JOIN_FETCH_LIMIT,
-				since: message.createdAt
-			});
-		} catch {
-			continue;
-		}
-		const refreshed = rows.find((row) => row.id === message.id);
-		if (refreshed && !isPendingAttachmentJoin(refreshed)) return refreshed;
-	}
-	return message;
-};
-const toMessages = async (message) => {
-	const { chatId, chatKind } = message;
-	if (!chatId || chatKind === "unknown") return [];
-	if (message.reaction !== null || message.kind !== "text" || message.retractedAt !== null) return [];
-	if (isPendingAttachmentJoin(message)) return [];
-	const base = {
-		sender: {
-			id: message.participant ?? "",
-			...message.participant ? { address: message.participant } : {}
-		},
-		space: {
-			id: chatId,
-			type: chatKind === "group" ? "group" : "dm",
-			phone: ""
-		},
-		timestamp: message.createdAt
-	};
-	const targetId = replyTargetId(message);
-	if (message.attachments.length > 0) {
-		if (!hasUsableTextPart(message.text)) return wrapReply(await Promise.all(message.attachments.map(async (att) => ({
-			...base,
-			id: `${message.id}:${att.id}`,
-			content: await localAttachmentContent(att)
-		}))), targetId);
-		const parts = toOrderedParts(message.text, message.attachments);
-		const messages = [];
-		for (let i = 0; i < parts.length; i++) {
-			const part = parts[i];
-			if (!part) continue;
-			messages.push(part.type === "text" ? {
-				...base,
-				id: `${message.id}:text:${i}`,
-				content: asText(part.text),
-				partIndex: i
-			} : {
-				...base,
-				id: `${message.id}:${part.attachment.id}`,
-				content: await localAttachmentContent(part.attachment),
-				partIndex: i
-			});
-		}
-		return wrapReply(messages, targetId);
-	}
-	return wrapReply([{
-		...base,
-		id: message.id,
-		content: {
-			type: "text",
-			text: message.text ?? ""
-		}
-	}], targetId);
-};
-const messages$3 = (client) => stream((emit, end) => {
-	let lastPromise = Promise.resolve();
-	const handleIncoming = async (message) => {
-		const ms = await toMessages(isPendingAttachmentJoin(message) ? await refetchUntilAttachmentsSettle(client, message) : message);
-		for (const m of ms) await emit(m);
-	};
-	const startPromise = client.startWatching({
-		onIncomingMessage: (message) => {
-			lastPromise = lastPromise.then(() => handleIncoming(message)).catch(end);
-		},
-		onError: end
-	}).catch(end);
-	return async () => {
-		await startPromise.catch(() => {});
-		await client.stopWatching();
-		await lastPromise.catch(() => {});
-	};
-});
-//#endregion
-//#region src/shared/errors.ts
-const IMESSAGE_PLATFORM = "iMessage";
-const LOCAL_IMESSAGE_PLATFORM = "iMessage (local mode)";
-const unsupportedRemoteContent = (type, detail) => UnsupportedError.content(type, IMESSAGE_PLATFORM, detail);
-const unsupportedLocalContent = (type, detail) => UnsupportedError.content(type, LOCAL_IMESSAGE_PLATFORM, detail);
-//#endregion
-//#region src/local/send.ts
-const synthRecord = (spaceId, content) => ({
-	id: crypto.randomUUID(),
-	content,
-	space: { id: spaceId },
-	timestamp: /* @__PURE__ */ new Date()
-});
-const sendTempFile = async (client, spaceId, name, data) => {
-	const safeName = basename(name) || "attachment";
-	const dir = await mkdtemp(join(tmpdir(), "spectrum-"));
-	const tmp = join(dir, safeName);
-	await writeFile(tmp, data);
-	try {
-		await client.send({
-			to: spaceId,
-			attachments: [tmp]
-		});
-	} finally {
-		await rm(dir, {
-			recursive: true,
-			force: true
-		}).catch(() => {});
-	}
-};
-const send$3 = async (client, spaceId, content) => {
-	switch (content.type) {
-		case "text":
-			await client.send({
-				to: spaceId,
-				text: content.text
-			});
-			return synthRecord(spaceId, content);
-		case "attachment":
-			await sendTempFile(client, spaceId, content.name, await content.read());
-			return synthRecord(spaceId, content);
-		case "contact": {
-			const vcf = await toVCard(content);
-			await sendTempFile(client, spaceId, vcardFileName(content), Buffer.from(vcf, "utf8"));
-			return synthRecord(spaceId, content);
-		}
-		case "effect": throw unsupportedLocalContent("effect", "message effects require remote iMessage");
-		case "poll": throw unsupportedLocalContent("poll");
-		default: throw unsupportedLocalContent(content.type);
-	}
-};
-const getMessage$3 = async (_client, _id) => void 0;
-//#endregion
-//#region src/local/api.ts
-const messages$2 = (client) => messages$3(client);
-const send$2 = async (client, spaceId, content) => send$3(client, spaceId, content);
-const getMessage$2 = async (client, id) => getMessage$3(client, id);
 //#endregion
 //#region src/remote/ids.ts
 const PART_PREFIX = /^p:(\d+)\//;
@@ -824,6 +576,59 @@ const sendCustomizedMiniApp$1 = async (remote, spaceId, content) => {
 const updateCustomizedMiniApp$1 = async (remote, spaceId, session, content) => {
 	return toProviderRecord(await remote.messages.updateCustomizedMiniApp(session, content), content, spaceId);
 };
+const addTextPart = (parts, text) => {
+	const trimmed = text?.trim();
+	if (trimmed) parts.push({
+		type: "text",
+		text: trimmed
+	});
+};
+const addAttachmentParts = (parts, attachments) => {
+	for (const attachment of attachments) if (attachment) parts.push({
+		type: "attachment",
+		attachment
+	});
+};
+const toOrderedParts = (text, attachments) => {
+	const parts = [];
+	if (!text) {
+		addAttachmentParts(parts, attachments);
+		return parts;
+	}
+	if (!text.includes("")) {
+		addAttachmentParts(parts, attachments);
+		addTextPart(parts, text);
+		return parts;
+	}
+	const textSegments = text.split("");
+	for (let i = 0; i < attachments.length; i++) {
+		addTextPart(parts, textSegments[i]);
+		const attachment = attachments[i];
+		if (attachment) parts.push({
+			type: "attachment",
+			attachment
+		});
+	}
+	addTextPart(parts, textSegments.slice(attachments.length).join(""));
+	return parts;
+};
+//#endregion
+//#region src/shared/vcard.ts
+const VCARD_MIME_TYPES = new Set([
+	"text/vcard",
+	"text/x-vcard",
+	"text/directory",
+	"application/vcard",
+	"application/x-vcard"
+]);
+const normalizeMimeType = (mimeType) => (mimeType.split(";")[0] ?? "").trim().toLowerCase();
+const isVCardAttachment = (mimeType, fileName) => {
+	if (mimeType && VCARD_MIME_TYPES.has(normalizeMimeType(mimeType))) return true;
+	return Boolean(fileName?.toLowerCase().endsWith(".vcf"));
+};
+const vcardFileName = (contact) => {
+	return `${(contact.name?.formatted ?? contact.user?.id ?? "contact").replace(/[^a-zA-Z0-9_\-.]/g, "_")}.vcf`;
+};
 //#endregion
 //#region src/remote/attachments.ts
 /**
@@ -1273,6 +1078,10 @@ const getDisplayName$1 = async (remote, spaceId) => {
 	return displayName || void 0;
 };
 //#endregion
+//#region src/shared/errors.ts
+const IMESSAGE_PLATFORM = "iMessage";
+const unsupportedRemoteContent = (type, detail) => UnsupportedError.content(type, IMESSAGE_PLATFORM, detail);
+//#endregion
 //#region src/remote/markdown.ts
 const markdownLexer = new Marked();
 const BULLET = "• ";
@@ -1701,6 +1510,30 @@ const unsendMessage$1 = async (remote, spaceId, msgId) => {
 	await remote.messages.unsend(toChatGuid(spaceId), toMessageGuid(childRef?.parentGuid ?? msgId), childRef ? { partIndex: childRef.partIndex } : void 0);
 };
 //#endregion
+//#region src/remote/client.ts
+const isSharedMode = (clients) => clients.length === 1 && clients[0]?.phone === "shared";
+const availablePhones = (clients) => clients.map((c) => c.phone);
+const clientForPhone = (clients, phone) => {
+	if (isSharedMode(clients)) {
+		const entry = clients[0];
+		if (!entry) throw new Error("No iMessage clients configured");
+		return entry.client;
+	}
+	const entry = clients.find((c) => c.phone === phone);
+	if (!entry) {
+		const list = availablePhones(clients).join(", ") || "<none>";
+		throw new Error(`No iMessage client serves phone ${phone}. Available: ${list}`);
+	}
+	return entry.client;
+};
+const randomPhone = (clients) => {
+	if (clients.length === 0) throw new Error("No iMessage phones configured for this account");
+	if (isSharedMode(clients)) return SHARED_PHONE;
+	const entry = clients[Math.floor(Math.random() * clients.length)];
+	if (!entry) throw new Error("No iMessage phones configured for this account");
+	return entry.phone;
+};
+//#endregion
 //#region src/remote/contact-share.ts
 const log$2 = createLogger("spectrum.imessage.contact");
 const SHARE_TTL_MS = 1440 * 60 * 1e3;
@@ -2103,18 +1936,19 @@ const groupStream = (client, phone, recover) => resumableOrderedStream({
 	processMissed: (event) => event.type === "catchup.complete" ? Promise.resolve(toCatchUpCompleteItem(event)) : toGroupItem(client, event, phone, String(event.sequence)),
 	subscribeLive: (cursor) => withClose(client.groups.subscribeEvents(), cursor)
 });
-const clientStream = (client, pollCache, phone, onInbound, recover) => mergeStreams([
-	messageStream(client, phone, onInbound, recover),
-	pollStream(client, pollCache, phone, recover),
-	groupStream(client, phone, recover)
-]);
+const clientStream = (client, pollCache, phone, includeGroupEvents, onInbound, recover) => {
+	const streams = [messageStream(client, phone, onInbound, recover), pollStream(client, pollCache, phone, recover)];
+	if (includeGroupEvents) streams.push(groupStream(client, phone, recover));
+	return mergeStreams(streams);
+};
 const messages$1 = (clients, projectConfig) => {
 	const pollCache = getPollCache(clients);
 	const shareEnabled = projectConfig?.profile?.imessageSynced === true;
 	const recover = getCloudRecover(clients);
+	const includeGroupEvents = !isSharedMode(clients);
 	return mergeStreams(clients.map((entry) => {
 		const tracker = shareEnabled ? getContactShareTracker(entry.client) : void 0;
-		return clientStream(entry.client, pollCache, entry.phone, tracker ? (chatGuid) => tracker.maybeShare(chatGuid) : void 0, recover);
+		return clientStream(entry.client, pollCache, entry.phone, includeGroupEvents, tracker ? (chatGuid) => tracker.maybeShare(chatGuid) : void 0, recover);
 	}));
 };
 //#endregion
@@ -2234,30 +2068,6 @@ const toSpectrumMiniApp = (url, layout, live) => asCustomizedMiniApp({
 	...live === void 0 ? {} : { live }
 });
 //#endregion
-//#region src/remote/client.ts
-const isSharedMode = (clients) => clients.length === 1 && clients[0]?.phone === "shared";
-const availablePhones = (clients) => clients.map((c) => c.phone);
-const clientForPhone = (clients, phone) => {
-	if (isSharedMode(clients)) {
-		const entry = clients[0];
-		if (!entry) throw new Error("No iMessage clients configured");
-		return entry.client;
-	}
-	const entry = clients.find((c) => c.phone === phone);
-	if (!entry) {
-		const list = availablePhones(clients).join(", ") || "<none>";
-		throw new Error(`No iMessage client serves phone ${phone}. Available: ${list}`);
-	}
-	return entry.client;
-};
-const randomPhone = (clients) => {
-	if (clients.length === 0) throw new Error("No iMessage phones configured for this account");
-	if (isSharedMode(clients)) return SHARED_PHONE;
-	const entry = clients[Math.floor(Math.random() * clients.length)];
-	if (!entry) throw new Error("No iMessage phones configured for this account");
-	return entry.phone;
-};
-//#endregion
 //#region src/index.ts
 const isPollContent = (content) => content.type === "poll" || content.type === "poll_option";
 const cacheRemoteOutbound = (remote, space, record) => {
@@ -2275,7 +2085,6 @@ const cacheRemoteOutbound = (remote, space, record) => {
 	return record;
 };
 const handleEdit = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("edit", "iMessage (local mode)");
 	const miniAppCardSession = content.target.miniAppCardSession;
 	const updateMiniAppCardSession = (record) => {
 		const nextSession = record?.miniAppCardSession;
@@ -2299,7 +2108,6 @@ const handleEdit = async (client, space, content) => {
 	await editMessage(clientForPhone(client, space.phone), space.id, content.target.id, content.content);
 };
 const handleUnsend = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("unsend", "iMessage (local mode)");
 	if (isPollContent(content.target.content)) throw UnsupportedError.action("unsend", "iMessage", "iMessage polls cannot be unsent");
 	const remote = clientForPhone(client, space.phone);
 	const targetContent = content.target.content;
@@ -2310,53 +2118,43 @@ const handleUnsend = async (client, space, content) => {
 	await unsendMessage(remote, space.id, content.target.id);
 };
 const handleStreamText = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("streamText", "iMessage (local mode)", "streaming text responses require remote iMessage");
 	const remote = clientForPhone(client, space.phone);
 	return cacheRemoteOutbound(remote, space, await sendStreamText(remote, space.id, content));
 };
 const handleBackground = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("background", "iMessage (local mode)", "chat backgrounds require remote iMessage");
 	await setBackground(clientForPhone(client, space.phone), space.id, content);
 };
 const handleCustomizedMiniApp = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("customized-mini-app", "iMessage (local mode)", "mini app cards require remote iMessage");
 	const remote = clientForPhone(client, space.phone);
 	return cacheRemoteOutbound(remote, space, await sendCustomizedMiniApp(remote, space.id, content));
 };
 /**
 * Render the universal `app` content. On remote it becomes a native Spectrum
 * mini-app card (fixed `SPECTRUM_MINI_APP` identity + the URL + the layout
-* already parsed from the URL's link metadata). Local mode cannot send cards,
-* so it degrades to the bare URL as a text message.
+* already parsed from the URL's link metadata).
 */
 const handleApp = async (client, space, content) => {
 	const url = await content.url();
-	if (isLocal(client)) return await send$2(client, space.id, await text(url).build());
 	const layout = await content.layout();
 	const remote = clientForPhone(client, space.phone);
 	return cacheRemoteOutbound(remote, space, await sendCustomizedMiniApp(remote, space.id, toSpectrumMiniApp(url, layout, content.live)));
 };
 const handleRead = async (client, space) => {
-	if (isLocal(client)) throw UnsupportedError.action("read", "iMessage (local mode)", "marking chats as read requires remote iMessage");
 	await markRead(clientForPhone(client, space.phone), space.id);
 };
 const handleShareContactCard = async (client, space) => {
-	if (isLocal(client)) throw UnsupportedError.action("shareContactCard", "iMessage (local mode)", "sharing the contact card requires remote iMessage");
 	await shareContactCard(clientForPhone(client, space.phone), space.id);
 };
 const handleTyping = async (client, space, state) => {
-	if (isLocal(client)) return;
 	const remote = clientForPhone(client, space.phone);
 	if (state === "start") await startTyping(remote, space.id);
 	else await stopTyping(remote, space.id);
 };
 const handleRename = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("rename", "iMessage (local mode)", "renaming chats requires remote iMessage");
 	if (space.type !== "group") throw UnsupportedError.action("rename", "iMessage", "only group chats can be renamed (this space is a DM)");
 	await setDisplayName(clientForPhone(client, space.phone), space.id, content);
 };
 const handleAvatar = async (client, space, content) => {
-	if (isLocal(client)) throw UnsupportedError.action("avatar", "iMessage (local mode)", "setting group avatars requires remote iMessage");
 	if (space.type !== "group") throw UnsupportedError.action("avatar", "iMessage", "only group chats have avatars (this space is a DM)");
 	await setIcon(clientForPhone(client, space.phone), space.id, content);
 };
@@ -2366,27 +2164,17 @@ const handleAvatar = async (client, space, content) => {
 * guard sequence.
 */
 const remoteGroupClient = (client, space, action, detail) => {
-	if (isLocal(client)) throw UnsupportedError.action(action, "iMessage (local mode)", detail.local);
-	if (space.type !== "group") throw UnsupportedError.action(action, "iMessage", detail.dm);
+	if (space.type !== "group") throw UnsupportedError.action(action, "iMessage", detail);
 	return clientForPhone(client, space.phone);
 };
 const handleAddMember = async (client, space, content) => {
-	await addParticipants(remoteGroupClient(client, space, "addMember", {
-		dm: "only group chats can add members (this space is a DM — iMessage cannot convert a DM into a group; create a group via space.create instead)",
-		local: "adding members requires remote iMessage"
-	}), space.id, content);
+	await addParticipants(remoteGroupClient(client, space, "addMember", "only group chats can add members (this space is a DM — iMessage cannot convert a DM into a group; create a group via space.create instead)"), space.id, content);
 };
 const handleRemoveMember = async (client, space, content) => {
-	await removeParticipants(remoteGroupClient(client, space, "removeMember", {
-		dm: "only group chats can remove members (this space is a DM — iMessage cannot convert a DM into a group; create a group via space.create instead)",
-		local: "removing members requires remote iMessage"
-	}), space.id, content);
+	await removeParticipants(remoteGroupClient(client, space, "removeMember", "only group chats can remove members (this space is a DM — iMessage cannot convert a DM into a group; create a group via space.create instead)"), space.id, content);
 };
 const handleLeaveSpace = async (client, space) => {
-	await leaveGroup(remoteGroupClient(client, space, "leaveSpace", {
-		dm: "only group chats can be left (this space is a DM)",
-		local: "leaving chats requires remote iMessage"
-	}), space.id);
+	await leaveGroup(remoteGroupClient(client, space, "leaveSpace", "only group chats can be left (this space is a DM)"), space.id);
 };
 /**
 * Dispatch the iMessage-only fire-and-forget control signals that live outside
@@ -2408,21 +2196,18 @@ const handleProviderControlSignal = async (client, space, content) => {
 };
 /**
 * Resolve the remote client for a `reply` / `reaction` whose target is another
-* message. Both reject local mode and poll targets identically, so the guard
-* lives here to keep the `send` dispatch flat. `action` labels the error and
-* `pollNoun` is the plural used in the poll-unsupported message.
+* message. `action` labels the error and `pollNoun` is the plural used in the
+* poll-unsupported message.
 */
 const remoteForMessageTarget = (client, space, target, action, pollNoun) => {
-	if (isLocal(client)) throw UnsupportedError.action(action, "iMessage (local mode)");
 	if (isPollContent(target.content)) throw UnsupportedError.action(action, "iMessage", `iMessage polls do not support ${pollNoun}`);
 	return clientForPhone(client, space.phone);
 };
 const imessage = definePlatform("iMessage", {
 	config: configSchema,
-	static: { effect: { message: MessageEffect } },
+	static: { effect: { message: messageEffects } },
 	lifecycle: {
 		createClient: async ({ config, projectId, projectSecret }) => {
-			if (config.local) return new IMessageSDK();
 			if (config.clients) return (Array.isArray(config.clients) ? config.clients : [config.clients]).map((e) => ({
 				phone: e.phone,
 				client: createClient({
@@ -2433,14 +2218,10 @@ const imessage = definePlatform("iMessage", {
 					token: e.token
 				})
 			}));
-			if (!(projectId && projectSecret)) throw new Error("iMessage requires projectId and projectSecret. Either pass credentials to Spectrum(), use local mode: imessage.config({ local: true }), or provide explicit client config: imessage.config({ clients: [...] })");
+			if (!(projectId && projectSecret)) throw new Error("Cloud iMessage requires projectId and projectSecret. Pass credentials to Spectrum() or provide explicit clients with imessage.config({ clients: [...] }). For local Messages access, install @spectrum-ts/imessage-local and use its imessage.config().");
 			return await createCloudClients(projectId, projectSecret);
 		},
 		destroyClient: async ({ client }) => {
-			if (isLocal(client)) {
-				await client.close();
-				return;
-			}
 			await disposeCloudAuth(client);
 			await Promise.all(client.map((entry) => entry.client.close()));
 		}
@@ -2454,14 +2235,6 @@ const imessage = definePlatform("iMessage", {
 		params: spaceParamsSchema,
 		create: async ({ input, client }) => {
 			if (input.users.length === 0) throw new Error("iMessage space creation requires at least one user");
-			if (isLocal(client)) {
-				if (input.users.length > 1) throw UnsupportedError.action("space.create", "iMessage (local mode)", "local mode cannot create group chats — use space.get(chatGuid) for an existing group");
-				return {
-					id: dmChatGuid(input.users[0]?.id ?? ""),
-					type: "dm",
-					phone: ""
-				};
-			}
 			if (client.length === 0) throw new Error("No iMessage clients configured");
 			const addresses = input.users.map((u) => u.id);
 			if (isSharedMode(client)) {
@@ -2481,11 +2254,6 @@ const imessage = definePlatform("iMessage", {
 			};
 		},
 		get: async ({ input, client }) => {
-			if (isLocal(client)) return {
-				id: input.id,
-				type: chatTypeFromGuid(input.id),
-				phone: ""
-			};
 			if (client.length === 0) throw new Error("No iMessage clients configured");
 			const phone = isSharedMode(client) ? SHARED_PHONE : input.params?.phone ?? (client.length === 1 ? client[0]?.phone : void 0);
 			if (!phone) throw new Error(`iMessage space.get requires params.phone when multiple clients are configured. Available: ${availablePhones(client).join(", ")}`);
@@ -2505,7 +2273,7 @@ const imessage = definePlatform("iMessage", {
 		}
 	},
 	message: { schema: messageSchema },
-	messages: ({ client, projectConfig }) => isLocal(client) ? messages$2(client) : messages(client, projectConfig),
+	messages: ({ client, projectConfig }) => messages(client, projectConfig),
 	send: async ({ space, content, client }) => {
 		if (content.type === "reply") {
 			const remote = remoteForMessageTarget(client, space, content.target, "reply", "replies");
@@ -2555,35 +2323,23 @@ const imessage = definePlatform("iMessage", {
 		if (content.type === "app") return await handleApp(client, space, content);
 		if (await handleProviderControlSignal(client, space, content)) return;
 		if (isCustomizedMiniApp(content)) return await handleCustomizedMiniApp(client, space, content);
-		if (isLocal(client)) return await send$2(client, space.id, content);
 		const remote = clientForPhone(client, space.phone);
 		return cacheRemoteOutbound(remote, space, await send(remote, space.id, content));
 	},
 	actions: {
 		getMessage: async ({ client }, space, messageId) => {
-			if (isLocal(client)) return getMessage$2(client, messageId);
 			return getMessage(clientForPhone(client, space.phone), space.id, messageId, space.phone);
 		},
 		getMembers: async ({ client }, space) => {
-			return await listParticipants(remoteGroupClient(client, space, "getMembers", {
-				dm: "only group chats support listing members (this space is a DM)",
-				local: "listing members requires remote iMessage"
-			}), space.id, space.phone);
+			return await listParticipants(remoteGroupClient(client, space, "getMembers", "only group chats support listing members (this space is a DM)"), space.id, space.phone);
 		},
 		getAvatar: async ({ client }, space) => {
-			return await getIcon(remoteGroupClient(client, space, "getAvatar", {
-				dm: "only group chats have avatars (this space is a DM)",
-				local: "fetching group avatars requires remote iMessage"
-			}), space.id);
+			return await getIcon(remoteGroupClient(client, space, "getAvatar", "only group chats have avatars (this space is a DM)"), space.id);
 		},
 		getDisplayName: async ({ client }, space) => {
-			return await getDisplayName(remoteGroupClient(client, space, "getDisplayName", {
-				dm: "only group chats have display names (this space is a DM)",
-				local: "reading chat display names requires remote iMessage"
-			}), space.id);
+			return await getDisplayName(remoteGroupClient(client, space, "getDisplayName", "only group chats have display names (this space is a DM)"), space.id);
 		},
 		getAttachment: async ({ client }, guid, phone) => {
-			if (isLocal(client)) throw UnsupportedError.action("getAttachment", "iMessage (local mode)", "fetching attachments by GUID requires remote iMessage");
 			if (client.length === 0) throw new Error("No iMessage clients configured");
 			const routedPhone = (() => {
 				if (isSharedMode(client)) return SHARED_PHONE;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spectrum-ts/imessage",
-  "version": "9.3.0",
-  "description": "iMessage provider for spectrum-ts — local and remote (advanced) modes.",
+  "version": "10.0.0",
+  "description": "iMessage provider for spectrum-ts.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/photon-hq/spectrum-ts.git",
@@ -32,14 +32,13 @@
   },
   "dependencies": {
     "@photon-ai/advanced-imessage": "^1.0.0",
-    "@photon-ai/imessage-kit": "^3.0.0",
     "@photon-ai/otel": "^3.1.0",
     "lru-cache": "^11.0.0",
     "marked": "^18.0.5",
     "zod": "^4.2.1"
   },
   "peerDependencies": {
-    "@spectrum-ts/core": "^9.0.0",
+    "@spectrum-ts/core": "^10.0.0",
     "typescript": "^5 || ^6.0.0"
   },
   "license": "MIT"