spectrum-ts 0.7.0 → 0.8.0

package/dist/{chunk-6URE4AYH.js → chunk-4O6MQC5Z.js}

@@ -292,6 +292,29 @@ function createPlatformInstance(def, runtime) {
   const isPlatformUser = (value) => {
     return typeof value === "object" && value !== null && "__platform" in value && value.__platform === def.name;
   };
+  const resolveUserID = async (userID) => {
+    const resolved = await def.user.resolve({
+      input: { userID },
+      client: runtime.client,
+      config: runtime.config
+    });
+    return {
+      ...resolved,
+      __platform: def.name
+    };
+  };
+  const resolveStringUsers = async (args) => {
+    const convertArg = async (arg) => {
+      if (typeof arg === "string") {
+        return await resolveUserID(arg);
+      }
+      if (Array.isArray(arg)) {
+        return await Promise.all(arg.map(convertArg));
+      }
+      return arg;
+    };
+    return await Promise.all(args.map(convertArg));
+  };
   const normalizeSpaceArgs = (args) => {
     if (args.length === 0) {
       return { users: [], params: void 0 };
@@ -334,7 +357,8 @@ function createPlatformInstance(def, runtime) {
       };
     },
     async space(...args) {
-      const { users, params } = normalizeSpaceArgs(args);
+      const convertedArgs = await resolveStringUsers(args);
+      const { users, params } = normalizeSpaceArgs(convertedArgs);
       let parsedParams = params;
       if (params !== void 0 && def.space.params) {
         parsedParams = def.space.params.parse(params);

package/dist/chunk-H5XYVRHM.js

@@ -0,0 +1,141 @@
+import {
+  bufferToStream,
+  readSchema,
+  streamSchema
+} from "./chunk-ZNUORCLB.js";
+
+// src/content/richlink.ts
+import z from "zod";
+
+// src/utils/link-metadata.ts
+import ogs from "open-graph-scraper";
+var DEFAULT_TIMEOUT_MS = 5e3;
+var USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15 spectrum-ts/richlink";
+var normaliseImageUrl = (raw, base) => {
+  try {
+    return new URL(raw, base).toString();
+  } catch {
+    return;
+  }
+};
+var cleanString = (v) => {
+  if (typeof v !== "string") {
+    return;
+  }
+  const trimmed = v.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+};
+var fetchLinkMetadata = async (url) => {
+  try {
+    const result = await ogs({
+      url,
+      timeout: DEFAULT_TIMEOUT_MS,
+      fetchOptions: { headers: { "User-Agent": USER_AGENT } }
+    });
+    if (result.error) {
+      return {};
+    }
+    const {
+      ogTitle,
+      ogDescription,
+      ogImage,
+      twitterTitle,
+      twitterDescription,
+      twitterImage
+    } = result.result;
+    const title = cleanString(ogTitle) ?? cleanString(twitterTitle);
+    const summary = cleanString(ogDescription) ?? cleanString(twitterDescription);
+    const imageCandidate = ogImage?.[0] ?? twitterImage?.[0];
+    const resolved = imageCandidate ? normaliseImageUrl(imageCandidate.url, url) : void 0;
+    const image = imageCandidate && resolved ? {
+      url: resolved,
+      mimeType: "type" in imageCandidate && typeof imageCandidate.type === "string" ? imageCandidate.type : void 0
+    } : void 0;
+    return { title, summary, image };
+  } catch {
+    return {};
+  }
+};
+var fetchImage = async (url) => {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT_MS);
+  try {
+    const res = await fetch(url, {
+      signal: controller.signal,
+      headers: { "User-Agent": USER_AGENT }
+    });
+    if (!res.ok) {
+      throw new Error(`image fetch ${url} returned ${res.status}`);
+    }
+    const data = Buffer.from(await res.arrayBuffer());
+    const mimeType = res.headers.get("content-type") ?? void 0;
+    return { data, mimeType };
+  } finally {
+    clearTimeout(timer);
+  }
+};
+
+// src/content/richlink.ts
+var richlinkCoverSchema = z.object({
+  mimeType: z.string().min(1).optional(),
+  read: readSchema,
+  stream: streamSchema
+});
+var optionalStringAccessor = z.function({
+  input: [],
+  output: z.promise(z.string().min(1).optional())
+});
+var coverAccessor = z.function({
+  input: [],
+  output: z.promise(richlinkCoverSchema.optional())
+});
+var richlinkSchema = z.object({
+  type: z.literal("richlink"),
+  url: z.url(),
+  title: optionalStringAccessor,
+  summary: optionalStringAccessor,
+  cover: coverAccessor
+});
+var memoize = (factory) => {
+  let cached;
+  return () => {
+    cached ??= factory();
+    return cached;
+  };
+};
+var buildCover = (image) => {
+  const read = memoize(
+    () => fetchImage(image.url).then((r) => r.data).catch(() => Buffer.alloc(0))
+  );
+  return {
+    mimeType: image.mimeType,
+    read,
+    stream: async () => bufferToStream(await read())
+  };
+};
+var asRichlink = (input) => {
+  const getMetadata = memoize(() => fetchLinkMetadata(input.url));
+  const getCover = memoize(async () => {
+    const { image } = await getMetadata();
+    return image ? buildCover(image) : void 0;
+  });
+  const title = async () => (await getMetadata()).title;
+  const summary = async () => (await getMetadata()).summary;
+  return richlinkSchema.parse({
+    type: "richlink",
+    url: input.url,
+    title,
+    summary,
+    cover: getCover
+  });
+};
+function richlink(url) {
+  return {
+    build: async () => asRichlink({ url })
+  };
+}
+
+export {
+  asRichlink,
+  richlink
+};

package/dist/{chunk-GX3JCGSD.js → chunk-ZNUORCLB.js}

@@ -557,11 +557,13 @@ function custom(raw) {
 import { Repeater } from "@repeaterjs/repeater";
 function stream(setup) {
   const repeater = new Repeater(async (push, stop) => {
-    const emit = (value) => {
-      Promise.resolve(push(value)).catch((error) => {
+    const emit = async (value) => {
+      try {
+        await push(value);
+      } catch (error) {
         stop(error);
-        return void 0;
-      });
+        throw error;
+      }
     };
     const end = (error) => {
       stop(error);
@@ -589,7 +591,7 @@ function mergeStreams(streams) {
     const workers = streams.map(async (source) => {
       try {
         for await (const value of source) {
-          emit(value);
+          await emit(value);
         }
       } catch (error) {
         end(error);

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as ContentBuilder, U as User, 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-B5tTx5hc.js';
-export { A as AnyPlatformDef, E as EventProducer, M as Message, h as PlatformInstance, i as PlatformMessage, j as PlatformSpace, k as PlatformUser, l as SchemaMessage } from './types-B5tTx5hc.js';
+import { C as ContentBuilder, U as User, 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-DLrsDzV-.js';
+export { A as AnyPlatformDef, E as EventProducer, M as Message, h as PlatformInstance, i as PlatformMessage, j as PlatformSpace, k as PlatformUser, l as SchemaMessage } from './types-DLrsDzV-.js';
 import vCard from 'vcf';
 import z__default from 'zod';
-export { M as ManagedStream, m as mergeStreams, s as stream } from './stream-DGy4geUK.js';
+export { M as ManagedStream, m as mergeStreams, s as stream } from './stream-B55k7W8-.js';
 import 'hotscript';
 
 declare function attachment(input: string | Buffer, options?: {
@@ -124,6 +124,20 @@ declare function custom(raw: unknown): ContentBuilder;
 
 declare const resolveContents: (items: readonly ContentInput[]) => Promise<Content[]>;
 
+declare const richlinkSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"richlink">;
+    url: z__default.ZodURL;
+    title: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+    summary: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+    cover: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodObject<{
+        mimeType: z__default.ZodOptional<z__default.ZodString>;
+        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>>>>;
+}, z__default.core.$strip>;
+type Richlink = z__default.infer<typeof richlinkSchema>;
+declare function richlink(url: string): ContentBuilder;
+
 declare function text(text: string): ContentBuilder;
 
 declare const voiceSchema: z__default.ZodObject<{
@@ -244,4 +258,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, type ImessageInfoData, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, 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, resolveContents, 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, type ImessageInfoData, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, 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, resolveContents, richlink, text, toVCard, voice };

package/dist/index.js

@@ -1,3 +1,6 @@
+import {
+  richlink
+} from "./chunk-H5XYVRHM.js";
 import {
   SpectrumCloudError,
   attachment,
@@ -11,7 +14,7 @@ import {
   stream,
   streamSchema,
   toVCard
-} from "./chunk-GX3JCGSD.js";
+} from "./chunk-ZNUORCLB.js";
 import {
   UnsupportedError,
   buildMessage,
@@ -19,7 +22,7 @@ import {
   definePlatform,
   resolveContents,
   text
-} from "./chunk-6URE4AYH.js";
+} from "./chunk-4O6MQC5Z.js";
 
 // src/content/voice.ts
 import { createReadStream } from "fs";
@@ -173,11 +176,11 @@ async function Spectrum(options) {
   const adaptIterable = (iterable) => {
     return stream((emit, end) => {
       const iterator = iterable[Symbol.asyncIterator]();
-      (async () => {
+      const pump = (async () => {
         try {
           let result = await iterator.next();
           while (!result.done) {
-            emit(result.value);
+            await emit(result.value);
             result = await iterator.next();
           }
           end();
@@ -187,6 +190,7 @@ async function Spectrum(options) {
       })();
       return async () => {
         await iterator.return?.();
+        await pump;
       };
     });
   };
@@ -235,14 +239,14 @@ async function Spectrum(options) {
     return adaptIterable(bindSend());
   };
   const createMessagesStream = () => {
-    return stream(async (emit, end) => {
+    return stream((emit, end) => {
       const merged = mergeStreams(
         Array.from(platformStates.values(), createProviderMessagesStream)
       );
-      (async () => {
+      const pump = (async () => {
         try {
           for await (const value of merged) {
-            emit(value);
+            await emit(value);
           }
           end();
         } catch (error) {
@@ -251,11 +255,12 @@ async function Spectrum(options) {
       })();
       return async () => {
         await merged.close();
+        await pump;
       };
     });
   };
   const createCustomEventStream = (eventName) => {
-    return stream(async (emit, end) => {
+    return stream((emit, end) => {
       const providerStreams = Array.from(platformStates.values(), (state) => {
         const { client, config, definition } = state;
         const producer = definition.events[eventName];
@@ -273,10 +278,10 @@ async function Spectrum(options) {
         (value) => value !== void 0
       );
       const merged = mergeStreams(providerStreams);
-      (async () => {
+      const pump = (async () => {
         try {
           for await (const value of merged) {
-            emit(value);
+            await emit(value);
           }
           end();
         } catch (error) {
@@ -285,6 +290,7 @@ async function Spectrum(options) {
       })();
       return async () => {
         await merged.close();
+        await pump;
       };
     });
   };
@@ -375,6 +381,7 @@ export {
   fromVCard,
   mergeStreams,
   resolveContents,
+  richlink,
   stream,
   text,
   toVCard,

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

@@ -1,9 +1,9 @@
-import { M as ManagedStream } from '../../stream-DGy4geUK.js';
+import { M as ManagedStream } from '../../stream-B55k7W8-.js';
 import { AdvancedIMessage } from '@photon-ai/advanced-imessage';
 import { IMessageSDK } from '@photon-ai/imessage-kit';
 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-B5tTx5hc.js';
+import { l as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-DLrsDzV-.js';
 import * as zod_v4_core from 'zod/v4/core';
 import 'hotscript';
 

package/dist/providers/imessage/index.js

@@ -1,3 +1,6 @@
+import {
+  asRichlink
+} from "../../chunk-H5XYVRHM.js";
 import {
   asAttachment,
   asContact,
@@ -7,12 +10,12 @@ import {
   mergeStreams,
   stream,
   toVCard
-} from "../../chunk-GX3JCGSD.js";
+} from "../../chunk-ZNUORCLB.js";
 import {
   UnsupportedError,
   asText,
   definePlatform
-} from "../../chunk-6URE4AYH.js";
+} from "../../chunk-4O6MQC5Z.js";
 
 // src/providers/imessage/index.ts
 import { createClient as createClient2, directChat } from "@photon-ai/advanced-imessage";
@@ -191,9 +194,9 @@ var messages = (client) => stream((emit, end) => {
   let lastPromise = Promise.resolve();
   const startPromise = client.startWatching({
     onIncomingMessage: (message) => {
-      lastPromise = lastPromise.then(() => toMessages(message)).then((ms) => {
+      lastPromise = lastPromise.then(() => toMessages(message)).then(async (ms) => {
         for (const m of ms) {
-          emit(m);
+          await emit(m);
         }
       }).catch(end);
     },
@@ -378,6 +381,7 @@ var ensureM4a = async (buffer, mimeType) => {
 
 // src/providers/imessage/remote.ts
 var PLATFORM = "iMessage";
+var URL_BALLOON_BUNDLE_ID = "com.apple.messages.URLBalloonProvider";
 var unsupportedContent = (type) => UnsupportedError.content(type, PLATFORM);
 var toSendResult = (receipt) => ({
   id: receipt.guid,
@@ -422,9 +426,29 @@ var toVCardContent2 = async (client, info) => {
     return toAttachmentContent2(client, info);
   }
 };
+var getBalloonBundleId = (message) => {
+  const raw = message._raw;
+  const id = raw?.balloonBundleId;
+  return typeof id === "string" ? id : void 0;
+};
+var toRichlinkMessage = (event, base, id) => {
+  const url = event.message.text ?? "";
+  try {
+    return { ...base, id, content: asRichlink({ url }) };
+  } catch {
+    return {
+      ...base,
+      id,
+      content: url ? asText(url) : asCustom(event.message)
+    };
+  }
+};
 var toMessages2 = async (client, event) => {
   const base = baseMessage(event);
   const messageGuidStr = event.message.guid;
+  if (getBalloonBundleId(event.message) === URL_BALLOON_BUNDLE_ID) {
+    return [toRichlinkMessage(event, base, messageGuidStr)];
+  }
   if (event.message.attachments.length > 0) {
     return Promise.all(
       event.message.attachments.map(async (info) => ({
@@ -446,14 +470,14 @@ var toMessages2 = async (client, event) => {
 var clientStream = (client) => {
   const sub = client.messages.subscribe("message.received");
   return stream((emit, end) => {
-    (async () => {
+    const pump = (async () => {
       try {
         for await (const event of sub) {
           if (event.message.isFromMe) {
             continue;
           }
           for (const message of await toMessages2(client, event)) {
-            emit(message);
+            await emit(message);
           }
         }
         end();
@@ -461,7 +485,10 @@ var clientStream = (client) => {
         end(e);
       }
     })();
-    return () => sub.close();
+    return async () => {
+      sub.close();
+      await pump;
+    };
   });
 };
 var sendVCardAttachment = (remote, name, vcf) => remote.attachments.upload({
@@ -502,6 +529,10 @@ var send2 = async (clients, spaceId, content) => {
   switch (content.type) {
     case "text":
       return toSendResult(await remote.messages.send(chat, content.text));
+    case "richlink":
+      return toSendResult(
+        await remote.messages.send(chat, content.url, { richLink: true })
+      );
     case "attachment": {
       const attachment = await remote.attachments.upload({
         data: await content.read(),
@@ -551,6 +582,13 @@ var replyToMessage = async (clients, spaceId, msgId, content) => {
       return toSendResult(
         await remote.messages.send(chat, content.text, { replyTo })
       );
+    case "richlink":
+      return toSendResult(
+        await remote.messages.send(chat, content.url, {
+          richLink: true,
+          replyTo
+        })
+      );
     case "attachment": {
       const attachment = await remote.attachments.upload({
         data: await content.read(),

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

@@ -1,4 +1,4 @@
-import { d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-B5tTx5hc.js';
+import { d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-DLrsDzV-.js';
 import * as node_readline from 'node:readline';
 import z__default from 'zod';
 import 'hotscript';

package/dist/providers/terminal/index.js

@@ -1,7 +1,7 @@
 import {
   UnsupportedError,
   definePlatform
-} from "../../chunk-6URE4AYH.js";
+} from "../../chunk-4O6MQC5Z.js";
 
 // src/providers/terminal/index.ts
 import { createInterface } from "readline";

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

@@ -1,8 +1,8 @@
-import { M as ManagedStream } from '../../stream-DGy4geUK.js';
+import { M as ManagedStream } from '../../stream-B55k7W8-.js';
 import { WhatsAppClient } from '@photon-ai/whatsapp-business';
 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-B5tTx5hc.js';
+import { l as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-DLrsDzV-.js';
 import * as zod_v4_core from 'zod/v4/core';
 import 'hotscript';
 

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

@@ -5,12 +5,12 @@ import {
   cloud,
   mergeStreams,
   stream
-} from "../../chunk-GX3JCGSD.js";
+} from "../../chunk-ZNUORCLB.js";
 import {
   UnsupportedError,
   asText,
   definePlatform
-} from "../../chunk-6URE4AYH.js";
+} from "../../chunk-4O6MQC5Z.js";
 
 // src/providers/whatsapp-business/index.ts
 import { createClient as createClient2 } from "@photon-ai/whatsapp-business";
@@ -174,7 +174,7 @@ var pumpOnce = async (ctx) => {
   ctx.setActive(sub);
   try {
     for await (const event of sub) {
-      ctx.emit(event);
+      await ctx.emit(event);
     }
     return true;
   } catch {
@@ -195,7 +195,7 @@ var resubscribableStream = (state, options) => {
         active = s;
       }
     };
-    (async () => {
+    const pump = (async () => {
       while (!closed) {
         await pumpOnce(ctx);
         if (!closed) {
@@ -204,11 +204,12 @@ var resubscribableStream = (state, options) => {
       }
       end();
     })();
-    return () => {
+    return async () => {
       closed = true;
       active?.close().catch(() => void 0);
       active = void 0;
       state.subscriptions.delete(subscription);
+      await pump;
     };
   });
   const subscription = {
@@ -518,11 +519,11 @@ var clientStream = (client) => {
     (e) => e.type === "message"
   );
   return stream((emit, end) => {
-    (async () => {
+    const pump = (async () => {
       try {
         for await (const event of eventStream) {
           for (const m of toMessages(client, event.message)) {
-            emit(m);
+            await emit(m);
           }
         }
         end();
@@ -530,7 +531,10 @@ var clientStream = (client) => {
         end(e);
       }
     })();
-    return () => eventStream.close();
+    return async () => {
+      await eventStream.close();
+      await pump;
+    };
   });
 };
 var messages = (clients) => mergeStreams(clients.map(clientStream));

package/dist/{stream-DGy4geUK.d.ts → stream-B55k7W8-.d.ts}

@@ -2,7 +2,7 @@ interface ManagedStream<T> extends AsyncIterable<T> {
     close(): Promise<void>;
 }
 type StreamCleanup = void | (() => void | Promise<void>);
-declare function stream<T>(setup: (emit: (value: T) => void, end: (error?: unknown) => void) => StreamCleanup | Promise<StreamCleanup>): ManagedStream<T>;
+declare function stream<T>(setup: (emit: (value: T) => Promise<void>, end: (error?: unknown) => void) => StreamCleanup | Promise<StreamCleanup>): ManagedStream<T>;
 declare function mergeStreams<T>(streams: readonly ManagedStream<T>[]): ManagedStream<T>;
 
 export { type ManagedStream as M, mergeStreams as m, stream as s };

package/dist/{types-B5tTx5hc.d.ts → types-DLrsDzV-.d.ts}

@@ -78,6 +78,16 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     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>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"richlink">;
+    url: z__default.ZodURL;
+    title: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+    summary: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodString>>>;
+    cover: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodOptional<z__default.ZodObject<{
+        mimeType: z__default.ZodOptional<z__default.ZodString>;
+        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>>>>;
 }, z__default.core.$strip>], "type">;
 type Content = z__default.infer<typeof contentSchema>;
 interface ContentBuilder {
@@ -310,12 +320,13 @@ type SpaceShapeOf<Def extends AnyPlatformDef> = [SchemaSpaceOf<Def>] extends [
     never
 ] ? ResolvedSpaceOf<Def> : SchemaSpaceOf<Def>;
 type SpaceParamsInputOf<Def extends AnyPlatformDef> = InputSchema<Def["space"]["params"]>;
+type SpaceUserLike<Def extends AnyPlatformDef> = PlatformUser<Def> | string;
 type SpaceArrayArgs<Def extends AnyPlatformDef> = [
     SpaceParamsInputOf<Def>
-] extends [never] ? [users: PlatformUser<Def>[]] : [users: PlatformUser<Def>[]] | [users: PlatformUser<Def>[], params: SpaceParamsInputOf<Def>] | [params: SpaceParamsInputOf<Def>];
+] extends [never] ? [users: SpaceUserLike<Def>[]] : [users: SpaceUserLike<Def>[]] | [users: SpaceUserLike<Def>[], params: SpaceParamsInputOf<Def>] | [params: SpaceParamsInputOf<Def>];
 type SpaceVarargArgs<Def extends AnyPlatformDef> = [
     SpaceParamsInputOf<Def>
-] extends [never] ? PlatformUser<Def>[] : PlatformUser<Def>[] | [...PlatformUser<Def>[], SpaceParamsInputOf<Def>];
+] extends [never] ? SpaceUserLike<Def>[] : SpaceUserLike<Def>[] | [...SpaceUserLike<Def>[], SpaceParamsInputOf<Def>];
 type SpaceArgs<Def extends AnyPlatformDef> = SpaceArrayArgs<Def> | SpaceVarargArgs<Def>;
 type PlatformSpace<Def extends AnyPlatformDef> = Omit<SpaceShapeOf<Def>, keyof Space> & Space;
 type PlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message"]>, keyof Message> & Message<Def["name"], PlatformUser<Def>, PlatformSpace<Def>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -25,6 +25,7 @@
     "@repeaterjs/repeater": "^3.0.6",
     "better-grpc": "^0.3.2",
     "mime-types": "^3.0.1",
+    "open-graph-scraper": "^6.11.0",
     "type-fest": "^5.4.1",
     "vcf": "^2.1.2",
     "zod": "^4.2.1"