spectrum-ts 0.9.0 → 1.0.1

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-B8g0pvfg.js';
-export { A as AnyPlatformDef, E as EventProducer, h as PlatformInstance, i as PlatformMessage, j as PlatformSpace, k as PlatformUser, l as SchemaMessage } from './types-B8g0pvfg.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-D5KhSXLy.js';
+export { A as AnyPlatformDef, E as EventProducer, h as PlatformInstance, i as PlatformMessage, j as PlatformSpace, k as PlatformUser, l as SchemaMessage } from './types-D5KhSXLy.js';
 import vCard from 'vcf';
 import z__default from 'zod';
 export { M as ManagedStream, m as mergeStreams, s as stream } from './stream-B55k7W8-.js';
@@ -122,21 +122,39 @@ declare function contact(input: string | ContactInput | vCard): ContentBuilder;
 
 declare function custom(raw: unknown): ContentBuilder;
 
+/**
+ * A `group` bundles multiple messages into one logical unit (e.g. an album
+ * of images sent together). Each item is a full `Message` — addressable by
+ * id, reactable via `.react()`, replyable via `.reply()`.
+ *
+ * Groups do not nest, and reactions cannot be group members. Enforced by the
+ * `group()` builder; platforms may additionally reject unsupported item
+ * content types at send time.
+ */
+declare const groupSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"group">;
+    items: z__default.ZodArray<z__default.ZodCustom<Message, Message>>;
+}, z__default.core.$strip>;
+type Group = z__default.infer<typeof groupSchema>;
+declare function group(...items: [ContentInput, ContentInput, ...ContentInput[]]): ContentBuilder;
+
 declare const reactionSchema: z__default.ZodObject<{
     type: z__default.ZodLiteral<"reaction">;
     emoji: z__default.ZodString;
-    target: z__default.ZodString;
+    target: z__default.ZodCustom<Message, Message>;
 }, z__default.core.$strip>;
 type Reaction = z__default.infer<typeof reactionSchema>;
 /**
- * Construct a `reaction` content value. Passing a `Message` extracts its id;
- * a string is treated as the target message id directly.
+ * Construct a `reaction` content value targeting the given message.
  *
  * `space.send(reaction(emoji, message))` is sugar for `message.react(emoji)`.
  * Reactions are fire-and-forget — the returned `OutboundMessage` will be
  * `undefined` because platforms do not surface a message id for reactions.
+ *
+ * To react to a message known only by id, resolve it first via
+ * `space.getMessage(id)`.
  */
-declare function reaction(emoji: string, target: Message | string): ContentBuilder;
+declare function reaction(emoji: string, target: Message): ContentBuilder;
 
 declare const resolveContents: (items: readonly ContentInput[]) => Promise<Content[]>;
 
@@ -2122,14 +2140,32 @@ type SpectrumInstance<Providers extends PlatformProviderConfig[] = PlatformProvi
     edit(message: OutboundMessage, newContent: ContentInput): Promise<void>;
     responding<T>(space: Space, fn: () => T | Promise<T>): Promise<T>;
 };
+/**
+ * Runtime behavior tweaks for a Spectrum instance.
+ */
+interface SpectrumOptions {
+    /**
+     * When `true`, inbound `group` messages are never delivered whole. Instead,
+     * each group item is yielded from `spectrum.messages` as its own
+     * `[space, message]` tuple, in order. Items retain their individual
+     * `id`, `sender`, `timestamp`, and `.react()` / `.reply()` methods.
+     *
+     * Does not affect outbound `group(...)` sends or `space.getMessage(id)`.
+     *
+     * @default false
+     */
+    flattenGroups?: boolean;
+}
 declare function Spectrum<const Providers extends PlatformProviderConfig[]>(options: {
     projectId: string;
     projectSecret: string;
     providers: [...Providers];
+    options?: SpectrumOptions;
 } | {
     projectId?: never;
     projectSecret?: never;
     providers: [...Providers];
+    options?: SpectrumOptions;
 }): Promise<SpectrumInstance<Providers>>;
 
 type SubscriptionStatus = "active" | "canceled" | "past_due";
@@ -2198,4 +2234,4 @@ declare class UnsupportedError extends Error {
 declare const fromVCard: (vcf: string) => ContactInput;
 declare const toVCard: (contact: Contact) => Promise<string>;
 
-export { type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, Content, ContentBuilder, ContentInput, type DedicatedTokenData, Emoji, type EmojiKey, type ImessageInfoData, Message, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, type Reaction, type Richlink, type SharedTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, cloud, contact, custom, definePlatform, fromVCard, reaction, resolveContents, richlink, text, toVCard, voice };
+export { type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, Content, ContentBuilder, ContentInput, type DedicatedTokenData, Emoji, type EmojiKey, type Group, type ImessageInfoData, Message, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, type Reaction, type Richlink, type SharedTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, cloud, contact, custom, definePlatform, fromVCard, group, reaction, resolveContents, richlink, text, toVCard, voice };

package/dist/index.js

@@ -1,136 +1,30 @@
 import {
+  group,
   richlink
-} from "./chunk-6ZOLTQDN.js";
+} from "./chunk-LAGNM6I7.js";
+import {
+  voice
+} from "./chunk-7Q7KJKGL.js";
 import {
   SpectrumCloudError,
-  attachment,
-  bufferToStream,
   cloud,
-  contact,
-  custom,
-  fromVCard,
   mergeStreams,
-  reaction,
-  readSchema,
-  stream,
-  streamSchema,
-  toVCard
-} from "./chunk-CZIWNTXP.js";
+  stream
+} from "./chunk-2Y5GBI6W.js";
 import {
   UnsupportedError,
-  buildMessage,
+  attachment,
   buildSpace,
+  contact,
+  custom,
   definePlatform,
+  fromVCard,
+  reaction,
   resolveContents,
-  text
-} from "./chunk-PLJI5FTO.js";
-
-// src/content/voice.ts
-import { createReadStream } from "fs";
-import { readFile, stat } from "fs/promises";
-import { basename } from "path";
-import { Readable } from "stream";
-import { lookup as lookupMimeType } from "mime-types";
-import z from "zod";
-var AUDIO_MIME_PATTERN = /^audio\//i;
-var audioMimeSchema = z.string().nonempty().regex(AUDIO_MIME_PATTERN, "voice content requires an audio/* MIME type");
-var voiceSchema = z.object({
-  type: z.literal("voice"),
-  name: z.string().nonempty().optional(),
-  mimeType: audioMimeSchema,
-  duration: z.number().nonnegative().optional(),
-  size: z.number().int().nonnegative().optional(),
-  read: readSchema,
-  stream: streamSchema
-});
-var resolveVoiceName = (input, name) => {
-  if (name) {
-    return name;
-  }
-  if (typeof input === "string") {
-    return basename(input);
-  }
-  return void 0;
-};
-var resolveVoiceMimeType = (name, mimeType) => {
-  if (mimeType) {
-    if (!AUDIO_MIME_PATTERN.test(mimeType)) {
-      throw new Error(
-        `voice content requires an audio/* MIME type, got "${mimeType}".`
-      );
-    }
-    return mimeType;
-  }
-  if (name) {
-    const resolved = lookupMimeType(name);
-    if (resolved && AUDIO_MIME_PATTERN.test(resolved)) {
-      return resolved;
-    }
-    if (resolved) {
-      throw new Error(
-        `Resolved non-audio MIME type "${resolved}" from name "${name}". Pass options.mimeType explicitly with an audio/* type.`
-      );
-    }
-  }
-  throw new Error(
-    "Unable to resolve MIME type for voice content. Pass options.mimeType explicitly."
-  );
-};
-var asVoice = (input) => {
-  let cached;
-  const read = () => {
-    cached ??= input.read().catch((err) => {
-      cached = void 0;
-      throw err;
-    });
-    return cached;
-  };
-  const stream2 = input.stream ?? (async () => bufferToStream(await read()));
-  return voiceSchema.parse({
-    type: "voice",
-    name: input.name,
-    mimeType: input.mimeType,
-    duration: input.duration,
-    size: input.size,
-    read,
-    stream: stream2
-  });
-};
-function voice(input, options) {
-  return {
-    build: async () => {
-      const name = resolveVoiceName(input, options?.name);
-      const mimeHint = typeof input === "string" ? basename(input) : name;
-      const mimeType = resolveVoiceMimeType(mimeHint, options?.mimeType);
-      if (typeof input === "string") {
-        const stats = await stat(input);
-        if (!stats.isFile()) {
-          throw new Error(
-            `voice content path "${input}" is not a regular file.`
-          );
-        }
-        return asVoice({
-          name,
-          mimeType,
-          duration: options?.duration,
-          size: stats.size,
-          read: () => readFile(input),
-          stream: async () => Readable.toWeb(
-            createReadStream(input)
-          )
-        });
-      }
-      return asVoice({
-        name,
-        mimeType,
-        duration: options?.duration,
-        size: input.byteLength,
-        read: async () => input,
-        stream: async () => bufferToStream(input)
-      });
-    }
-  };
-}
+  text,
+  toVCard,
+  wrapProviderMessage
+} from "./chunk-XMAI2AAN.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {
@@ -2062,29 +1956,33 @@ var aliases = {
 var Emoji = { ...GeneratedEmoji, ...aliases };
 
 // src/spectrum.ts
-import z2 from "zod";
-var providerMessageCoreKeys = /* @__PURE__ */ new Set([
-  "content",
-  "id",
-  "sender",
-  "space",
-  "timestamp"
-]);
-var spectrumConfigSchema = z2.union([
-  z2.object({
-    projectId: z2.string().min(1),
-    projectSecret: z2.string().min(1),
-    providers: z2.array(z2.custom())
+import z from "zod";
+var spectrumOptionsSchema = z.object({
+  flattenGroups: z.boolean().optional()
+}).optional();
+var spectrumConfigSchema = z.union([
+  z.object({
+    projectId: z.string().min(1),
+    projectSecret: z.string().min(1),
+    providers: z.array(z.custom()),
+    options: spectrumOptionsSchema
   }),
-  z2.object({
-    projectId: z2.undefined().optional(),
-    projectSecret: z2.undefined().optional(),
-    providers: z2.array(z2.custom())
+  z.object({
+    projectId: z.undefined().optional(),
+    projectSecret: z.undefined().optional(),
+    providers: z.array(z.custom()),
+    options: spectrumOptionsSchema
   })
 ]);
 async function Spectrum(options) {
   spectrumConfigSchema.parse(options);
-  const { projectId, projectSecret, providers } = options;
+  const {
+    projectId,
+    projectSecret,
+    providers,
+    options: runtimeOptions
+  } = options;
+  const flattenGroups = runtimeOptions?.flattenGroups ?? false;
   const platformStates = /* @__PURE__ */ new Map();
   const customEventStreams = /* @__PURE__ */ new Map();
   let stopped = false;
@@ -2132,11 +2030,6 @@ async function Spectrum(options) {
     });
     const bindSend = async function* () {
       for await (const msg of raw) {
-        const extraEntries = Object.entries(msg).filter(
-          ([key]) => !providerMessageCoreKeys.has(key)
-        );
-        const extra = Object.fromEntries(extraEntries);
-        const parsedExtra = definition.message?.schema ? definition.message.schema.parse(extra) : {};
         const spaceRef = {
           ...msg.space,
           __platform: definition.name
@@ -2150,19 +2043,19 @@ async function Spectrum(options) {
           client,
           config
         });
-        const normalizedMessage = buildMessage({
-          id: msg.id,
-          content: msg.content,
-          sender: msg.sender,
-          timestamp: msg.timestamp ?? /* @__PURE__ */ new Date(),
-          extras: parsedExtra,
-          spaceRef,
-          space,
-          definition,
+        const normalizedMessage = wrapProviderMessage(msg, {
           client,
           config,
-          direction: "inbound"
+          definition,
+          space,
+          spaceRef
         });
+        if (flattenGroups && normalizedMessage.content.type === "group") {
+          for (const item of normalizedMessage.content.items) {
+            yield [space, item];
+          }
+          continue;
+        }
         yield [space, normalizedMessage];
       }
     };
@@ -2310,6 +2203,7 @@ export {
   custom,
   definePlatform,
   fromVCard,
+  group,
   mergeStreams,
   reaction,
   resolveContents,

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

@@ -1,10 +1,10 @@
 import { M as ManagedStream } from '../../stream-B55k7W8-.js';
-import { AdvancedIMessage } from '@photon-ai/advanced-imessage';
-import { IMessageSDK } from '@photon-ai/imessage-kit';
+import { l as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-D5KhSXLy.js';
+import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
-import { l as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-B8g0pvfg.js';
-import * as zod_v4_core from 'zod/v4/core';
+import { AdvancedIMessage } from '@photon-ai/advanced-imessage';
+import { IMessageSDK } from '@photon-ai/imessage-kit';
 import 'hotscript';
 
 type IMessageClient = IMessageSDK | AdvancedIMessage[];
@@ -16,7 +16,10 @@ declare const spaceSchema: z__default.ZodObject<{
         group: "group";
     }>;
 }, z__default.core.$strip>;
-type IMessageMessage = SchemaMessage<typeof userSchema, typeof spaceSchema>;
+type IMessageMessage = SchemaMessage<typeof userSchema, typeof spaceSchema> & {
+    partIndex?: number;
+    parentId?: string;
+};
 
 declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.ZodObject<{
     local: z.ZodLiteral<true>;
@@ -43,7 +46,10 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
 } | {
     id: string;
     type: "group";
-}, undefined, ProviderMessage<{
+}, z.ZodObject<{
+    partIndex: z.ZodOptional<z.ZodNumber>;
+    parentId: z.ZodOptional<z.ZodString>;
+}, zod_v4_core.$strip>, ProviderMessage<{
     id: string;
 }, {
     id: string;
@@ -51,7 +57,10 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
 } | {
     id: string;
     type: "group";
-}, Record<never, never>>, {
+}, {
+    partIndex?: number | undefined;
+    parentId?: string | undefined;
+}>, {
     messages: ({ client }: {
         client: IMessageClient;
         config: {