spectrum-ts 1.1.2 → 1.2.0

package/dist/{chunk-QZ5DJ7VR.js → chunk-I7EKZS5C.js}

@@ -2,7 +2,7 @@ import {
   bufferToStream,
   readSchema,
   streamSchema
-} from "./chunk-5GQ2OMFY.js";
+} from "./chunk-UQPIWAHH.js";
 
 // src/content/voice.ts
 import { createReadStream } from "fs";

package/dist/{chunk-UWUPCIB4.js → chunk-K3CTEGCZ.js}

@@ -3,7 +3,7 @@ import {
   readSchema,
   resolveContents,
   streamSchema
-} from "./chunk-5GQ2OMFY.js";
+} from "./chunk-UQPIWAHH.js";
 
 // src/content/group.ts
 import z from "zod";

package/dist/{chunk-5GQ2OMFY.js → chunk-UQPIWAHH.js}

@@ -658,6 +658,43 @@ var warnUnsupported = (err, fallbackPlatform) => {
     supportsAnsiColor() ? `${ANSI_YELLOW}${body}${ANSI_RESET}` : body
   );
 };
+var contentPlatform = (content) => {
+  const platform = content.__platform;
+  return typeof platform === "string" ? platform : void 0;
+};
+var findUnsupportedPlatformContent = (content, platform) => {
+  const scopedPlatform = contentPlatform(content);
+  if (scopedPlatform && scopedPlatform !== platform) {
+    return scopedPlatform;
+  }
+  if (content.type !== "group") {
+    return;
+  }
+  for (const item of content.items) {
+    const nested = item.content;
+    if (typeof nested !== "object" || nested === null || !("type" in nested)) {
+      continue;
+    }
+    const unsupported = findUnsupportedPlatformContent(
+      nested,
+      platform
+    );
+    if (unsupported) {
+      return unsupported;
+    }
+  }
+};
+var unsupportedPlatformContentError = (content, platform) => {
+  const requiredPlatform = findUnsupportedPlatformContent(content, platform);
+  if (!requiredPlatform) {
+    return;
+  }
+  return UnsupportedError.content(
+    content.type,
+    platform,
+    `requires ${requiredPlatform}`
+  );
+};
 var providerMessageCoreKeys = /* @__PURE__ */ new Set([
   "content",
   "id",
@@ -751,6 +788,13 @@ function buildSpace(params) {
   async function dispatchSend(item) {
     let raw;
     try {
+      const platformError = unsupportedPlatformContentError(
+        item,
+        definition.name
+      );
+      if (platformError) {
+        throw platformError;
+      }
       raw = await definition.actions.send({
         ...typingCtx,
         content: item
@@ -892,6 +936,13 @@ function buildMessage(params) {
   const dispatchReplyItem = async (item, target, replyToMessage) => {
     let raw;
     try {
+      const platformError = unsupportedPlatformContentError(
+        item,
+        definition.name
+      );
+      if (platformError) {
+        throw platformError;
+      }
       raw = await replyToMessage({
         space: spaceRef,
         messageId: params.id,
@@ -963,6 +1014,14 @@ function buildMessage(params) {
         if (!resolved) {
           return;
         }
+        const platformError = unsupportedPlatformContentError(
+          resolved,
+          definition.name
+        );
+        if (platformError) {
+          warnUnsupported(platformError, definition.name);
+          return;
+        }
         try {
           await definition.actions.editMessage({
             space: spaceRef,
@@ -1183,6 +1242,18 @@ function definePlatform(name, def) {
       __definition: fullDef
     };
   };
+  narrower.is = ((input) => {
+    if (typeof input !== "object" || input === null) {
+      return false;
+    }
+    if ("__platform" in input) {
+      return input.__platform === name;
+    }
+    if ("platform" in input) {
+      return input.platform === name;
+    }
+    return false;
+  });
   if (def.static) {
     Object.assign(narrower, def.static);
   }
@@ -1193,6 +1264,7 @@ export {
   readSchema,
   streamSchema,
   bufferToStream,
+  attachmentSchema,
   asAttachment,
   attachment,
   fromVCard,
@@ -1201,6 +1273,7 @@ export {
   contact,
   asCustom,
   custom,
+  textSchema,
   asText,
   text,
   resolveContents,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ContentBuilder, U as User, M as Message, a as ContentInput, b as Content, P as ProviderMessage, c as PlatformDef, d as Platform, e as PlatformProviderConfig, S as SpectrumLike, f as CustomEventStreams, g as Space, I as InboundMessage, O as OutboundMessage } from './types-GhOtIIqj.js';
-export { A as AnyPlatformDef, B as Broadcaster, E as EventProducer, h as InboundPlatformMessage, i as ManagedStream, j as PlatformInstance, k as PlatformMessage, l as PlatformRuntime, m as PlatformSpace, n as PlatformUser, o as SchemaMessage, p as broadcast, q as mergeStreams, s as stream } from './types-GhOtIIqj.js';
+import { C as ContentBuilder, U as User, M as Message, a as ContentInput, b as Content, P as ProviderMessage, c as PlatformDef, d as Platform, e as PlatformProviderConfig, S as SpectrumLike, f as CustomEventStreams, g as Space, I as InboundMessage, O as OutboundMessage } from './types-Dvp0I86h.js';
+export { A as AnyPlatformDef, B as Broadcaster, E as EventProducer, h as InboundPlatformMessage, i as ManagedStream, j as PlatformInstance, k as PlatformMessage, l as PlatformRuntime, m as PlatformSpace, n as PlatformUser, o as SchemaMessage, p as broadcast, q as mergeStreams, s as stream } from './types-Dvp0I86h.js';
 import vCard from 'vcf';
 import z__default from 'zod';
 import 'hotscript';

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   group,
   richlink
-} from "./chunk-UWUPCIB4.js";
+} from "./chunk-K3CTEGCZ.js";
 import {
   voice
-} from "./chunk-QZ5DJ7VR.js";
+} from "./chunk-I7EKZS5C.js";
 import {
   SpectrumCloudError,
   broadcast,
@@ -27,7 +27,7 @@ import {
   text,
   toVCard,
   wrapProviderMessage
-} from "./chunk-5GQ2OMFY.js";
+} from "./chunk-UQPIWAHH.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {

package/dist/providers/imessage/index.d.ts

@@ -1,11 +1,14 @@
-import { o as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage, i as ManagedStream } from '../../types-GhOtIIqj.js';
+import { a as ContentInput, C as ContentBuilder, o as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage, i as ManagedStream } from '../../types-Dvp0I86h.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
-import { AdvancedIMessage } from '@photon-ai/advanced-imessage';
+import { MessageEffect, AdvancedIMessage } from '@photon-ai/advanced-imessage';
 import { IMessageSDK } from '@photon-ai/imessage-kit';
 import 'hotscript';
 
+type IMessageMessageEffect = MessageEffect;
+declare function effect(input: ContentInput, messageEffect: IMessageMessageEffect): ContentBuilder;
+
 type IMessageClient = IMessageSDK | AdvancedIMessage[];
 declare const userSchema: z__default.ZodObject<{}, z__default.core.$strip>;
 declare const spaceSchema: z__default.ZodObject<{
@@ -75,6 +78,24 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
             }[] | undefined;
         };
     }) => ManagedStream<IMessageMessage>;
-}>> & Readonly<Record<never, never>>;
+}>> & 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 confetti: "com.apple.messages.effect.CKConfettiEffect";
+            readonly fireworks: "com.apple.messages.effect.CKFireworksEffect";
+            readonly balloons: "com.apple.messages.effect.CKBalloonEffect";
+            readonly heart: "com.apple.messages.effect.CKHeartEffect";
+            readonly lasers: "com.apple.messages.effect.CKLasersEffect";
+            readonly celebration: "com.apple.messages.effect.CKHappyBirthdayEffect";
+            readonly sparkles: "com.apple.messages.effect.CKSparklesEffect";
+            readonly spotlight: "com.apple.messages.effect.CKSpotlightEffect";
+            readonly echo: "com.apple.messages.effect.CKEchoEffect";
+        };
+    };
+}>;
 
-export { imessage };
+export { type IMessageMessageEffect, effect, imessage };

package/dist/providers/imessage/index.js

@@ -2,7 +2,7 @@ import {
   asGroup,
   asRichlink,
   groupSchema
-} from "../../chunk-UWUPCIB4.js";
+} from "../../chunk-K3CTEGCZ.js";
 import {
   asPoll,
   asPollOption,
@@ -16,16 +16,66 @@ import {
   asContact,
   asCustom,
   asText,
+  attachmentSchema,
   definePlatform,
   fromVCard,
   reactionSchema,
+  text,
+  textSchema,
   toVCard
-} from "../../chunk-5GQ2OMFY.js";
+} from "../../chunk-UQPIWAHH.js";
 
 // src/providers/imessage/index.ts
-import { createClient as createClient2, directChat } from "@photon-ai/advanced-imessage";
+import {
+  createClient as createClient2,
+  directChat,
+  MessageEffect as MessageEffect2
+} from "@photon-ai/advanced-imessage";
 import { IMessageSDK as IMessageSDK2 } from "@photon-ai/imessage-kit";
 
+// src/providers/imessage/content/effect.ts
+import {
+  MessageEffect
+} from "@photon-ai/advanced-imessage";
+
+// src/content/effect.ts
+import z from "zod";
+var effectInnerSchema = z.discriminatedUnion("type", [
+  textSchema,
+  attachmentSchema
+]);
+var messageEffectSchema = z.object({
+  type: z.literal("effect"),
+  content: effectInnerSchema,
+  effect: z.string().nonempty()
+});
+
+// src/providers/imessage/content/effect.ts
+var SUPPORTED_EFFECTS = new Set(Object.values(MessageEffect));
+var resolveContent = (input) => typeof input === "string" ? text(input).build() : input.build();
+function effect(input, messageEffect) {
+  return {
+    build: async () => {
+      if (!SUPPORTED_EFFECTS.has(messageEffect)) {
+        throw new Error(
+          `Unsupported iMessage message effect "${messageEffect}"`
+        );
+      }
+      const inner = await resolveContent(input);
+      if (inner.type !== "text" && inner.type !== "attachment") {
+        throw new Error(
+          `imessage effect() only supports text and attachment content, got "${inner.type}"`
+        );
+      }
+      return messageEffectSchema.parse({
+        type: "effect",
+        content: inner,
+        effect: messageEffect
+      });
+    }
+  };
+}
+
 // src/providers/imessage/auth.ts
 import {
   createClient
@@ -230,7 +280,7 @@ import { basename, join } from "path";
 var IMESSAGE_PLATFORM = "iMessage";
 var LOCAL_IMESSAGE_PLATFORM = "iMessage (local mode)";
 var unsupportedRemoteContent = (type, detail) => UnsupportedError.content(type, IMESSAGE_PLATFORM, detail);
-var unsupportedLocalContent = (type) => UnsupportedError.content(type, LOCAL_IMESSAGE_PLATFORM);
+var unsupportedLocalContent = (type, detail) => UnsupportedError.content(type, LOCAL_IMESSAGE_PLATFORM, detail);
 
 // src/providers/imessage/local/send.ts
 var synthRecord = (spaceId, content) => ({
@@ -269,6 +319,11 @@ var send = async (client, spaceId, content) => {
       );
       return synthRecord(spaceId, content);
     }
+    case "effect":
+      throw unsupportedLocalContent(
+        "effect",
+        "message effects require remote iMessage"
+      );
     case "poll":
       throw unsupportedLocalContent("poll");
     default:
@@ -564,11 +619,11 @@ var rebuildFromAppleMessage = async (client, message, chatGuidHint) => {
   if (getBalloonBundleId(message) === URL_BALLOON_BUNDLE_ID) {
     return toRichlinkMessage(message, base, messageGuidStr);
   }
-  const text = message.text;
+  const text2 = message.text;
   return {
     ...base,
     id: messageGuidStr,
-    content: text ? asText(text) : asCustom(message)
+    content: text2 ? asText(text2) : asCustom(message)
   };
 };
 var cacheMessage = (cache, message) => {
@@ -630,11 +685,11 @@ var toInboundMessages = async (client, cache, event) => {
     cacheMessage(cache, parent);
     return [parent];
   }
-  const text = event.message.text;
+  const text2 = event.message.text;
   const msg = {
     ...base,
     id: messageGuidStr,
-    content: text ? asText(text) : asCustom(event.message)
+    content: text2 ? asText(text2) : asCustom(event.message)
   };
   cacheMessage(cache, msg);
   return [msg];
@@ -879,9 +934,9 @@ var runFfmpeg = (ffmpegPath, args) => {
     );
     proc.on("exit", (code) => resolve(code ?? -1));
   });
-  return Promise.all([exit, stderr]).then(([code, text]) => ({
+  return Promise.all([exit, stderr]).then(([code, text2]) => ({
     code,
-    stderr: text
+    stderr: text2
   }));
 };
 var DURATION_PATTERN = /Duration:\s*(\d+):(\d{2}):(\d{2})(?:\.(\d{1,3}))?/;
@@ -961,6 +1016,7 @@ var outboundRecord = (spaceId, id, content, timestamp, extras) => ({
 });
 var withReply = (options, replyTo) => replyTo ? { ...options, replyTo } : options;
 var replyOptions = (replyTo) => replyTo ? { replyTo } : void 0;
+var effectOption = (effect2) => effect2 ? { effect: effect2 } : {};
 var sendVCardAttachment = (remote, name, vcf) => remote.attachments.upload({
   data: Buffer.from(vcf, "utf8"),
   fileName: name,
@@ -990,13 +1046,22 @@ var uploadVoice = async (remote, content) => {
   });
   return { guid: attachment.guid, name };
 };
-var sendContent = async (remote, spaceId, chat, content, replyTo) => {
+var sendContent = async (remote, spaceId, chat, content, replyTo, effect2) => {
   switch (content.type) {
+    case "effect":
+      return sendContent(
+        remote,
+        spaceId,
+        chat,
+        content.content,
+        replyTo,
+        content.effect
+      );
     case "text": {
       const receipt = await remote.messages.send(
         chat,
         content.text,
-        withReply({}, replyTo)
+        withReply(effectOption(effect2), replyTo)
       );
       return outboundRecord(
         spaceId,
@@ -1022,6 +1087,7 @@ var sendContent = async (remote, spaceId, chat, content, replyTo) => {
       const { guid } = await uploadAttachment(remote, content);
       const receipt = await remote.messages.send(chat, "", {
         attachment: guid,
+        ...effectOption(effect2),
         ...replyOptions(replyTo)
       });
       return outboundRecord(
@@ -1762,30 +1828,35 @@ var getMessage4 = async (clients, spaceId, msgId) => {
 
 // src/providers/imessage/types.ts
 import { IMessageSDK } from "@photon-ai/imessage-kit";
-import z from "zod";
+import z2 from "zod";
 var isLocal = (client) => client instanceof IMessageSDK;
-var clientEntry = z.object({ address: z.string(), token: z.string() });
-var 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()
+var clientEntry = z2.object({ address: z2.string(), token: z2.string() });
+var configSchema = z2.union([
+  z2.object({ local: z2.literal(true) }),
+  z2.object({
+    local: z2.literal(false).optional().default(false),
+    clients: clientEntry.or(z2.array(clientEntry)).optional()
   })
 ]);
-var userSchema = z.object({});
-var spaceSchema = z.object({
-  id: z.string(),
-  type: z.enum(["dm", "group"])
+var userSchema = z2.object({});
+var spaceSchema = z2.object({
+  id: z2.string(),
+  type: z2.enum(["dm", "group"])
 });
-var messageSchema = z.object({
-  partIndex: z.number().int().nonnegative().optional(),
-  parentId: z.string().optional()
+var messageSchema = z2.object({
+  partIndex: z2.number().int().nonnegative().optional(),
+  parentId: z2.string().optional()
 });
 
 // src/providers/imessage/index.ts
 var isPollContent = (content) => content.type === "poll" || content.type === "poll_option";
 var imessage = definePlatform("iMessage", {
   config: configSchema,
+  static: {
+    effect: {
+      message: MessageEffect2
+    }
+  },
   user: {
     resolve: async ({ input }) => ({ id: input.userID })
   },
@@ -1919,5 +1990,6 @@ var imessage = definePlatform("iMessage", {
   }
 });
 export {
+  effect,
   imessage
 };

package/dist/providers/terminal/index.d.ts

@@ -1,4 +1,4 @@
-import { d as Platform, c as PlatformDef, P as ProviderMessage, M as Message } from '../../types-GhOtIIqj.js';
+import { d as Platform, c as PlatformDef, P as ProviderMessage, M as Message } from '../../types-Dvp0I86h.js';
 import z__default from 'zod';
 import 'hotscript';
 
@@ -42,9 +42,6 @@ declare const terminal: Platform<PlatformDef<"terminal", z__default.ZodObject<{
         content: {
             type: "text";
             text: string;
-        } | {
-            type: "custom";
-            raw: unknown;
         } | {
             type: "attachment";
             name: string;
@@ -52,6 +49,9 @@ declare const terminal: Platform<PlatformDef<"terminal", z__default.ZodObject<{
             read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
             stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
             size?: number | undefined;
+        } | {
+            type: "custom";
+            raw: unknown;
         } | {
             type: "contact";
             user?: {
@@ -140,6 +140,20 @@ declare const terminal: Platform<PlatformDef<"terminal", z__default.ZodObject<{
             };
             selected: boolean;
             title: string;
+        } | {
+            type: "effect";
+            content: {
+                type: "text";
+                text: string;
+            } | {
+                type: "attachment";
+                name: string;
+                mimeType: string;
+                read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+                stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+                size?: number | undefined;
+            };
+            effect: string;
         };
         sender: {
             id: string;

package/dist/providers/terminal/index.js

@@ -1,6 +1,6 @@
 import {
   asVoice
-} from "../../chunk-QZ5DJ7VR.js";
+} from "../../chunk-I7EKZS5C.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -10,7 +10,7 @@ import {
   fromVCard,
   reactionSchema,
   toVCard
-} from "../../chunk-5GQ2OMFY.js";
+} from "../../chunk-UQPIWAHH.js";
 
 // src/providers/terminal/index.ts
 import { spawn } from "child_process";

package/dist/providers/whatsapp-business/index.d.ts

@@ -1,4 +1,4 @@
-import { o as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage, i as ManagedStream } from '../../types-GhOtIIqj.js';
+import { o as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage, i as ManagedStream } from '../../types-Dvp0I86h.js';
 import { WhatsAppClient } from '@photon-ai/whatsapp-business';
 import * as z from 'zod';
 import z__default from 'zod';

package/dist/providers/whatsapp-business/index.js

@@ -12,7 +12,7 @@ import {
   asReaction,
   asText,
   definePlatform
-} from "../../chunk-5GQ2OMFY.js";
+} from "../../chunk-UQPIWAHH.js";
 
 // src/providers/whatsapp-business/index.ts
 import { createClient as createClient2 } from "@photon-ai/whatsapp-business";

package/dist/{types-GhOtIIqj.d.ts → types-Dvp0I86h.d.ts}

@@ -115,6 +115,20 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     }, z__default.core.$strip>;
     selected: z__default.ZodBoolean;
     title: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"effect">;
+    content: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+        type: z__default.ZodLiteral<"text">;
+        text: z__default.ZodString;
+    }, z__default.core.$strip>, z__default.ZodObject<{
+        type: z__default.ZodLiteral<"attachment">;
+        name: z__default.ZodString;
+        mimeType: z__default.ZodString;
+        size: z__default.ZodOptional<z__default.ZodNumber>;
+        read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    }, z__default.core.$strip>], "type">;
+    effect: z__default.ZodString;
 }, z__default.core.$strip>], "type">;
 type Content = z__default.infer<typeof contentSchema>;
 interface ContentBuilder {
@@ -427,6 +441,9 @@ interface SpectrumLike<Providers extends PlatformProviderConfig[] = PlatformProv
 }
 interface Platform<Def extends AnyPlatformDef> {
     config(...args: Record<string, never> extends z__default.input<Def["config"]> ? [config?: z__default.input<Def["config"]>] : [config: z__default.input<Def["config"]>]): PlatformProviderConfig<Def>;
+    is(input: Message): input is PlatformMessage<Def>;
+    is(input: Space): input is PlatformSpace<Def>;
+    is(input: unknown): input is PlatformMessage<Def> | PlatformSpace<Def>;
     <Providers extends PlatformProviderConfig[]>(spectrum: SpectrumLike<Providers>): HasProvider<Providers, Def["name"]> extends true ? PlatformInstance<Def> : never;
     (space: Space): PlatformSpace<Def>;
     (message: Message): PlatformMessage<Def>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",