spectrum-ts 1.7.1 → 1.8.0

package/dist/{chunk-VO43HJ5B.js → chunk-5NHNMN4H.js}

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

package/dist/{chunk-WFIUWFE4.js → chunk-HWADNTQF.js}

@@ -192,7 +192,7 @@ function broadcast(source) {
 }
 
 // src/utils/cloud.ts
-var SPECTRUM_CLOUD_URL = `https://${process.env.SPECTRUM_CLOUD_URL ?? "spectrum.photon.codes"}`;
+var SPECTRUM_CLOUD_URL = process.env.SPECTRUM_CLOUD_URL ?? "https://spectrum.photon.codes";
 var SpectrumCloudError = class extends Error {
   status;
   code;

package/dist/{chunk-2SB6VN7J.js → chunk-N3ZKMTSG.js}

@@ -1,6 +1,6 @@
 import {
   asVoice
-} from "./chunk-VVXMZYDH.js";
+} from "./chunk-TN54TDTQ.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -10,7 +10,7 @@ import {
   fromVCard,
   reactionSchema,
   toVCard
-} from "./chunk-JWWIFSI7.js";
+} from "./chunk-XZSBR26X.js";
 
 // src/providers/terminal/index.ts
 import { spawn } from "child_process";

package/dist/{chunk-H2QKKFQW.js → chunk-OM5VSKWD.js}

@@ -2,14 +2,14 @@ import {
   asGroup,
   asRichlink,
   groupSchema
-} from "./chunk-VO43HJ5B.js";
+} from "./chunk-5NHNMN4H.js";
 import {
   asPoll,
   asPollOption,
   cloud,
   mergeStreams,
   stream
-} from "./chunk-WFIUWFE4.js";
+} from "./chunk-HWADNTQF.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -24,7 +24,7 @@ import {
   text,
   textSchema,
   toVCard
-} from "./chunk-JWWIFSI7.js";
+} from "./chunk-XZSBR26X.js";
 
 // src/providers/imessage/index.ts
 import { createClient as createClient2, MessageEffect as MessageEffect2 } from "@photon-ai/advanced-imessage";

package/dist/{chunk-4O7DPKLI.js → chunk-OR3VGVML.js}

@@ -3,7 +3,7 @@ import {
   cloud,
   mergeStreams,
   stream
-} from "./chunk-WFIUWFE4.js";
+} from "./chunk-HWADNTQF.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -12,7 +12,7 @@ import {
   asReaction,
   asText,
   definePlatform
-} from "./chunk-JWWIFSI7.js";
+} from "./chunk-XZSBR26X.js";
 
 // src/providers/whatsapp-business/index.ts
 import { createClient as createClient2 } from "@photon-ai/whatsapp-business";

package/dist/{chunk-VVXMZYDH.js → chunk-TN54TDTQ.js}

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

package/dist/{chunk-JWWIFSI7.js → chunk-XZSBR26X.js}

@@ -710,7 +710,125 @@ var UnsupportedError = class _UnsupportedError extends Error {
   }
 };
 
+// src/platform/define.ts
+import { withSpan as withSpan2 } from "@photon-ai/otel";
+
+// src/utils/identifier.ts
+import { sanitizeEmail, sanitizePhone } from "@photon-ai/otel";
+var PHONE_LIKE = /^\+?[\d\s()\-.]{7,}$/;
+var EMAIL_LIKE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function classifyIdentifier(s) {
+  if (EMAIL_LIKE.test(s)) {
+    return { kind: "email", identifier: sanitizeEmail(s) };
+  }
+  if (PHONE_LIKE.test(s) && s.replace(/\D/g, "").length >= 7) {
+    return { kind: "phone", identifier: sanitizePhone(s) };
+  }
+  return { kind: "unknown", identifier: s };
+}
+
+// src/platform/build.ts
+import { createLogger, withSpan } from "@photon-ai/otel";
+
+// src/utils/telemetry.ts
+var targetId = (target) => {
+  const id = target?.id;
+  return typeof id === "string" ? id : void 0;
+};
+var targetType = (target) => {
+  const type = target?.content?.type;
+  return typeof type === "string" ? type : void 0;
+};
+var replyOrEditAttrs = (content) => {
+  const target = content.target;
+  const inner = content.content;
+  const innerType = inner?.type;
+  return {
+    "spectrum.message.content.target.id": targetId(target),
+    "spectrum.message.content.target.type": targetType(target),
+    "spectrum.message.content.inner.type": typeof innerType === "string" ? innerType : void 0
+  };
+};
+var reactionAttrs = (content) => {
+  const target = content.target;
+  const emoji = content.emoji;
+  return {
+    "spectrum.message.content.target.id": targetId(target),
+    "spectrum.message.content.reaction.emoji": typeof emoji === "string" ? emoji : void 0
+  };
+};
+var groupAttrs = (content) => {
+  const items = content.items;
+  if (!Array.isArray(items)) {
+    return {};
+  }
+  const types = items.map((item) => {
+    const itemType = item?.content?.type;
+    return typeof itemType === "string" ? itemType : void 0;
+  }).filter((t) => t !== void 0);
+  return {
+    "spectrum.message.content.items.count": items.length,
+    "spectrum.message.content.items.types": types.length > 0 ? types.join(",") : void 0
+  };
+};
+var typingAttrs = (content) => {
+  const state = content.state;
+  return {
+    "spectrum.message.content.typing.state": typeof state === "string" ? state : void 0
+  };
+};
+var attachmentAttrs = (content) => {
+  const mime = content.mimeType;
+  const size = content.size;
+  return {
+    "spectrum.message.content.attachment.mime": typeof mime === "string" ? mime : void 0,
+    "spectrum.message.content.attachment.size": typeof size === "number" ? size : void 0
+  };
+};
+var voiceAttrs = (content) => {
+  const mime = content.mimeType;
+  const duration = content.duration;
+  const size = content.size;
+  return {
+    "spectrum.message.content.voice.mime": typeof mime === "string" ? mime : void 0,
+    "spectrum.message.content.voice.duration": typeof duration === "number" ? duration : void 0,
+    "spectrum.message.content.voice.size": typeof size === "number" ? size : void 0
+  };
+};
+var CONTENT_ATTR_HANDLERS = {
+  reply: replyOrEditAttrs,
+  edit: replyOrEditAttrs,
+  reaction: reactionAttrs,
+  group: groupAttrs,
+  typing: typingAttrs,
+  attachment: attachmentAttrs,
+  voice: voiceAttrs
+};
+function contentAttrs(content) {
+  const type = content?.type;
+  if (!(content && type)) {
+    return { "spectrum.message.content.type": void 0 };
+  }
+  const handler = CONTENT_ATTR_HANDLERS[type];
+  return {
+    "spectrum.message.content.type": type,
+    ...handler ? handler(content) : {}
+  };
+}
+function senderAttrs(sender) {
+  const id = sender?.id;
+  if (typeof id !== "string" || id.length === 0) {
+    return {};
+  }
+  const { kind, identifier } = classifyIdentifier(id);
+  return {
+    "spectrum.message.sender.id": identifier,
+    "spectrum.message.sender.kind": kind
+  };
+}
+
 // src/platform/build.ts
+var platformLog = createLogger("spectrum.platform");
 var ANSI_YELLOW = "\x1B[33m";
 var ANSI_RESET = "\x1B[0m";
 var supportsAnsiColor = () => {
@@ -752,9 +870,14 @@ var warnUnsupported = (err, fallbackPlatform) => {
   const platform = err.platform ?? fallbackPlatform;
   const subject = err.kind === "content" ? `content type "${err.contentType ?? "unknown"}"` : `action "${err.action ?? "unknown"}"`;
   const detail = err.detail ? `: ${err.detail}` : "";
-  const body = `[spectrum-ts] ${platform} does not support ${subject}${detail}; skipping.`;
-  console.warn(
-    supportsAnsiColor() ? `${ANSI_YELLOW}${body}${ANSI_RESET}` : body
+  platformLog.warn(
+    `${platform} does not support ${subject}${detail}; skipping.`,
+    {
+      "spectrum.provider": platform,
+      "spectrum.unsupported.kind": err.kind,
+      "spectrum.unsupported.content_type": err.contentType,
+      "spectrum.unsupported.action": err.action
+    }
   );
 };
 var contentPlatform = (content) => {
@@ -879,38 +1002,49 @@ function buildSpace(params) {
   const { spaceRef, extras, actionCtx, definition, client, config, store } = params;
   let space;
   async function dispatchSend(item) {
-    let raw;
-    try {
-      const platformError = unsupportedPlatformContentError(
-        item,
-        definition.name
-      );
-      if (platformError) {
-        throw platformError;
-      }
-      raw = await definition.send({
-        ...actionCtx,
-        content: item
-      });
-    } catch (err) {
-      if (err instanceof UnsupportedError) {
-        warnUnsupported(err, definition.name);
-        return;
-      }
-      throw err;
-    }
-    if (!raw?.id) {
-      if (isFireAndForget(item)) {
-        return;
+    return withSpan(
+      "spectrum.message.send",
+      {
+        "spectrum.provider": definition.name,
+        "spectrum.space.id": spaceRef.id,
+        "spectrum.message.fire_and_forget": isFireAndForget(item),
+        ...contentAttrs(item)
+      },
+      async () => {
+        let raw;
+        try {
+          const platformError = unsupportedPlatformContentError(
+            item,
+            definition.name
+          );
+          if (platformError) {
+            throw platformError;
+          }
+          raw = await definition.send({
+            ...actionCtx,
+            content: item
+          });
+        } catch (err) {
+          if (err instanceof UnsupportedError) {
+            warnUnsupported(err, definition.name);
+            return;
+          }
+          throw err;
+        }
+        if (!raw?.id) {
+          if (isFireAndForget(item)) {
+            return;
+          }
+          throw new Error(
+            `Platform "${definition.name}" send did not return a message id`
+          );
+        }
+        return wrapProviderMessage(
+          raw,
+          { client, config, definition, space, spaceRef, store },
+          "outbound"
+        );
       }
-      throw new Error(
-        `Platform "${definition.name}" send did not return a message id`
-      );
-    }
-    return wrapProviderMessage(
-      raw,
-      { client, config, definition, space, spaceRef, store },
-      "outbound"
     );
   }
   async function sendImpl(...content) {
@@ -936,29 +1070,39 @@ function buildSpace(params) {
       );
       return;
     }
-    let raw;
-    try {
-      raw = await getMessage({
-        space: spaceRef,
-        messageId: id,
-        client,
-        config,
-        store
-      });
-    } catch (err) {
-      if (err instanceof UnsupportedError) {
-        warnUnsupported(err, definition.name);
-        return;
+    return withSpan(
+      "spectrum.message.get",
+      {
+        "spectrum.provider": definition.name,
+        "spectrum.space.id": spaceRef.id,
+        "spectrum.message.id": id
+      },
+      async () => {
+        let raw;
+        try {
+          raw = await getMessage({
+            space: spaceRef,
+            messageId: id,
+            client,
+            config,
+            store
+          });
+        } catch (err) {
+          if (err instanceof UnsupportedError) {
+            warnUnsupported(err, definition.name);
+            return;
+          }
+          throw err;
+        }
+        if (!raw) {
+          return;
+        }
+        return wrapProviderMessage(
+          raw,
+          { client, config, definition, space, spaceRef, store },
+          "inbound"
+        );
       }
-      throw err;
-    }
-    if (!raw) {
-      return;
-    }
-    return wrapProviderMessage(
-      raw,
-      { client, config, definition, space, spaceRef, store },
-      "inbound"
     );
   }
   const platformActions = {};
@@ -1057,6 +1201,21 @@ function buildMessage(params) {
 }
 
 // src/platform/define.ts
+function classifySpaceIdentifier(args) {
+  const stringArgs = args.filter((a) => typeof a === "string");
+  if (stringArgs.length > 1) {
+    return { kind: "group" };
+  }
+  const s = stringArgs[0];
+  if (!s) {
+    return { kind: "unknown" };
+  }
+  const { kind, identifier } = classifyIdentifier(s);
+  if (kind === "unknown") {
+    return { kind: "unknown" };
+  }
+  return { kind, identifier };
+}
 function createPlatformInstance(def, runtime) {
   const isPlatformUser = (value) => typeof value === "object" && value !== null && "__platform" in value && value.__platform === def.name;
   const resolveUserID = async (userID) => {
@@ -1126,39 +1285,50 @@ function createPlatformInstance(def, runtime) {
       };
     },
     async space(...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);
-      }
-      const resolved = await def.space.resolve({
-        input: { users, params: parsedParams },
-        client: runtime.client,
-        config: runtime.config,
-        store: runtime.store
-      });
-      const parsedSpace = def.space.schema ? def.space.schema.parse(resolved) : resolved;
-      const spaceRef = {
-        ...parsedSpace,
-        id: parsedSpace.id,
-        __platform: def.name
-      };
-      const actionCtx = {
-        space: spaceRef,
-        client: runtime.client,
-        config: runtime.config,
-        store: runtime.store
-      };
-      return buildSpace({
-        spaceRef,
-        extras: parsedSpace,
-        actionCtx,
-        definition: def,
-        client: runtime.client,
-        config: runtime.config,
-        store: runtime.store
-      });
+      const { kind, identifier } = classifySpaceIdentifier(args);
+      return withSpan2(
+        "spectrum.space.resolve",
+        {
+          "spectrum.provider": def.name,
+          "spectrum.space.identifier_kind": kind,
+          "spectrum.space.identifier": identifier
+        },
+        async () => {
+          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);
+          }
+          const resolved = await def.space.resolve({
+            input: { users, params: parsedParams },
+            client: runtime.client,
+            config: runtime.config,
+            store: runtime.store
+          });
+          const parsedSpace = def.space.schema ? def.space.schema.parse(resolved) : resolved;
+          const spaceRef = {
+            ...parsedSpace,
+            id: parsedSpace.id,
+            __platform: def.name
+          };
+          const actionCtx = {
+            space: spaceRef,
+            client: runtime.client,
+            config: runtime.config,
+            store: runtime.store
+          };
+          return buildSpace({
+            spaceRef,
+            extras: parsedSpace,
+            actionCtx,
+            definition: def,
+            client: runtime.client,
+            config: runtime.config,
+            store: runtime.store
+          });
+        }
+      );
     }
   };
   const eventProperties = {};
@@ -1282,6 +1452,8 @@ export {
   reply,
   typing,
   UnsupportedError,
+  contentAttrs,
+  senderAttrs,
   wrapProviderMessage,
   buildSpace,
   definePlatform

package/dist/index.d.ts

@@ -2739,11 +2739,13 @@ declare function Spectrum<const Providers extends PlatformProviderConfig[]>(opti
     projectSecret: string;
     providers: [...Providers];
     options?: SpectrumOptions;
+    telemetry?: boolean;
 } | {
     projectId?: never;
     projectSecret?: never;
     providers: [...Providers];
     options?: SpectrumOptions;
+    telemetry?: boolean;
 }): Promise<SpectrumInstance<Providers>>;
 
 type SubscriptionStatus = "active" | "canceled" | "past_due";

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   group,
   richlink
-} from "./chunk-VO43HJ5B.js";
+} from "./chunk-5NHNMN4H.js";
 import {
   voice
-} from "./chunk-VVXMZYDH.js";
+} from "./chunk-TN54TDTQ.js";
 import {
   SpectrumCloudError,
   broadcast,
@@ -13,12 +13,13 @@ import {
   option,
   poll,
   stream
-} from "./chunk-WFIUWFE4.js";
+} from "./chunk-HWADNTQF.js";
 import {
   UnsupportedError,
   attachment,
   buildSpace,
   contact,
+  contentAttrs,
   custom,
   definePlatform,
   edit,
@@ -26,11 +27,12 @@ import {
   reaction,
   reply,
   resolveContents,
+  senderAttrs,
   text,
   toVCard,
   typing,
   wrapProviderMessage
-} from "./chunk-JWWIFSI7.js";
+} from "./chunk-XZSBR26X.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {
@@ -1962,6 +1964,11 @@ var aliases = {
 var Emoji = { ...GeneratedEmoji, ...aliases };
 
 // src/spectrum.ts
+import {
+  createLogger,
+  setupOtel,
+  withSpan
+} from "@photon-ai/otel";
 import z from "zod";
 
 // src/utils/store.ts
@@ -2019,7 +2026,12 @@ function createStore() {
   };
 }
 
+// src/version.ts
+var SPECTRUM_SDK_VERSION = "1.8.0";
+
 // src/spectrum.ts
+var PHOTON_OTEL_ENDPOINT = "https://otlp.photon.codes";
+var lifecycleLog = createLogger("spectrum.lifecycle");
 var ignoreCleanupError = () => void 0;
 var spectrumOptionsSchema = z.object({
   flattenGroups: z.boolean().optional()
@@ -2029,24 +2041,46 @@ var spectrumConfigSchema = z.union([
     projectId: z.string().min(1),
     projectSecret: z.string().min(1),
     providers: z.array(z.custom()),
-    options: spectrumOptionsSchema
+    options: spectrumOptionsSchema,
+    telemetry: z.boolean().optional()
   }),
   z.object({
     projectId: z.undefined().optional(),
     projectSecret: z.undefined().optional(),
     providers: z.array(z.custom()),
-    options: spectrumOptionsSchema
+    options: spectrumOptionsSchema,
+    telemetry: z.boolean().optional()
   })
 ]);
+function bootstrapTelemetry(opts) {
+  const headers = {};
+  if (opts.projectId && opts.projectSecret) {
+    const credential = `${opts.projectId}:${opts.projectSecret}`;
+    headers.Authorization = `Basic ${btoa(credential)}`;
+  }
+  const resourceAttributes = {};
+  if (opts.projectId) {
+    resourceAttributes["spectrum.project_id"] = opts.projectId;
+  }
+  return setupOtel({
+    serviceName: "spectrum-ts",
+    serviceVersion: SPECTRUM_SDK_VERSION,
+    endpoint: PHOTON_OTEL_ENDPOINT,
+    headers,
+    resourceAttributes
+  });
+}
 async function Spectrum(options) {
   spectrumConfigSchema.parse(options);
   const {
     projectId,
     projectSecret,
     providers,
-    options: runtimeOptions
+    options: runtimeOptions,
+    telemetry
   } = options;
   const flattenGroups = runtimeOptions?.flattenGroups ?? false;
+  const otelHandle = telemetry ? bootstrapTelemetry({ projectId, projectSecret }) : void 0;
   const platformStates = /* @__PURE__ */ new Map();
   const messageBroadcasters = /* @__PURE__ */ new Map();
   const customEventStreams = /* @__PURE__ */ new Map();
@@ -2079,32 +2113,46 @@ async function Spectrum(options) {
     });
     const bindSend = async function* () {
       for await (const msg of raw) {
-        const spaceRef = {
-          ...msg.space,
-          __platform: definition.name
-        };
-        const actionCtx = { space: spaceRef, client, config, store };
-        const space = buildSpace({
-          spaceRef,
-          extras: {},
-          actionCtx,
-          definition,
-          client,
-          config,
-          store
-        });
-        const normalizedMessage = wrapProviderMessage(
-          msg,
+        const built = await withSpan(
+          "spectrum.message.receive",
           {
-            client,
-            config,
-            definition,
-            space,
-            spaceRef,
-            store
+            "spectrum.provider": definition.name,
+            "spectrum.message.id": msg.id,
+            "spectrum.space.id": msg.space?.id,
+            ...contentAttrs(msg.content),
+            ...senderAttrs(msg.sender)
           },
-          "inbound"
+          () => {
+            const spaceRef = {
+              ...msg.space,
+              __platform: definition.name
+            };
+            const actionCtx = { space: spaceRef, client, config, store };
+            const space2 = buildSpace({
+              spaceRef,
+              extras: {},
+              actionCtx,
+              definition,
+              client,
+              config,
+              store
+            });
+            const normalizedMessage2 = wrapProviderMessage(
+              msg,
+              {
+                client,
+                config,
+                definition,
+                space: space2,
+                spaceRef,
+                store
+              },
+              "inbound"
+            );
+            return { space: space2, normalizedMessage: normalizedMessage2 };
+          }
         );
+        const { space, normalizedMessage } = built;
         if (flattenGroups && normalizedMessage.content.type === "group") {
           for (const item of normalizedMessage.content.items) {
             yield [space, item];
@@ -2130,28 +2178,49 @@ async function Spectrum(options) {
     }
     return broadcaster;
   };
-  for (const provider of providers) {
-    const providerConfig = provider;
-    const def = providerConfig.__definition;
-    const userConfig = def.config.parse(providerConfig.config);
-    const store = createStore();
-    const client = await def.lifecycle.createClient({
-      config: userConfig,
-      projectId,
-      projectSecret,
-      store
-    });
-    const state = {
-      client,
-      config: userConfig,
-      definition: def,
-      store
-    };
-    platformStates.set(def.name, {
-      ...state,
-      subscribeMessages: () => getOrCreateMessageBroadcast(state).subscribe()
-    });
-  }
+  await withSpan(
+    "spectrum.init",
+    {
+      "spectrum.provider_count": providers.length,
+      "spectrum.flatten_groups": flattenGroups
+    },
+    async () => {
+      for (const provider of providers) {
+        const providerConfig = provider;
+        const def = providerConfig.__definition;
+        const userConfig = def.config.parse(providerConfig.config);
+        const store = createStore();
+        const client = await withSpan(
+          "spectrum.provider.create_client",
+          {
+            "spectrum.provider": def.name
+          },
+          () => def.lifecycle.createClient({
+            config: userConfig,
+            projectId,
+            projectSecret,
+            store
+          })
+        );
+        const state = {
+          client,
+          config: userConfig,
+          definition: def,
+          store
+        };
+        platformStates.set(def.name, {
+          ...state,
+          subscribeMessages: () => getOrCreateMessageBroadcast(state).subscribe()
+        });
+      }
+    }
+  );
+  const providerNames = providers.map((p) => p.__definition.name).join(",");
+  lifecycleLog.info("Spectrum started", {
+    providerCount: providers.length,
+    providers: providerNames,
+    telemetry: telemetry === true
+  });
   const createMessagesStream = () => stream((emit, end) => {
     const merged = mergeStreams(
       Array.from(
@@ -2185,7 +2254,15 @@ async function Spectrum(options) {
       const providerEvents = producer({ client, config, store });
       const annotatePlatform = async function* () {
         for await (const value of providerEvents) {
-          yield { ...value, platform: definition.name };
+          const annotated = await withSpan(
+            "spectrum.event",
+            {
+              "spectrum.provider": definition.name,
+              "spectrum.event.name": eventName
+            },
+            () => ({ ...value, platform: definition.name })
+          );
+          yield annotated;
         }
       };
       providerStreams.push(adaptIterable(annotatePlatform()));
@@ -2226,17 +2303,33 @@ async function Spectrum(options) {
     process.off("SIGINT", handleSignal);
     process.off("SIGTERM", handleSignal);
     await Promise.allSettled(streamShutdowns);
-    const clientShutdowns = Array.from(
-      platformStates.values(),
-      (state) => state.definition.lifecycle.destroyClient?.({
-        client: state.client,
-        store: state.store
-      })
-    ).filter((shutdown) => shutdown !== void 0);
+    const clientShutdowns = [];
+    for (const state of platformStates.values()) {
+      const destroy = state.definition.lifecycle.destroyClient;
+      if (!destroy) {
+        continue;
+      }
+      clientShutdowns.push(
+        withSpan(
+          "spectrum.provider.destroy_client",
+          {
+            "spectrum.provider": state.definition.name
+          },
+          () => destroy({
+            client: state.client,
+            store: state.store
+          })
+        )
+      );
+    }
     await Promise.allSettled(clientShutdowns);
     customEventStreams.clear();
     messageBroadcasters.clear();
     platformStates.clear();
+    lifecycleLog.info("Spectrum stopped", { providers: providerNames });
+    if (otelHandle) {
+      await otelHandle.shutdown();
+    }
   };
   const handleSignal = () => {
     setTimeout(() => process.exit(1), 3e3).unref();

package/dist/providers/imessage/index.js

@@ -2,10 +2,10 @@ import {
   background,
   effect,
   imessage
-} from "../../chunk-H2QKKFQW.js";
-import "../../chunk-VO43HJ5B.js";
-import "../../chunk-WFIUWFE4.js";
-import "../../chunk-JWWIFSI7.js";
+} from "../../chunk-OM5VSKWD.js";
+import "../../chunk-5NHNMN4H.js";
+import "../../chunk-HWADNTQF.js";
+import "../../chunk-XZSBR26X.js";
 export {
   background,
   effect,

package/dist/providers/index.js

@@ -1,16 +1,16 @@
 import {
   imessage
-} from "../chunk-H2QKKFQW.js";
-import "../chunk-VO43HJ5B.js";
+} from "../chunk-OM5VSKWD.js";
+import "../chunk-5NHNMN4H.js";
 import {
   terminal
-} from "../chunk-2SB6VN7J.js";
-import "../chunk-VVXMZYDH.js";
+} from "../chunk-N3ZKMTSG.js";
+import "../chunk-TN54TDTQ.js";
 import {
   whatsappBusiness
-} from "../chunk-4O7DPKLI.js";
-import "../chunk-WFIUWFE4.js";
-import "../chunk-JWWIFSI7.js";
+} from "../chunk-OR3VGVML.js";
+import "../chunk-HWADNTQF.js";
+import "../chunk-XZSBR26X.js";
 export {
   imessage,
   terminal,

package/dist/providers/terminal/index.js

@@ -1,8 +1,8 @@
 import {
   terminal
-} from "../../chunk-2SB6VN7J.js";
-import "../../chunk-VVXMZYDH.js";
-import "../../chunk-JWWIFSI7.js";
+} from "../../chunk-N3ZKMTSG.js";
+import "../../chunk-TN54TDTQ.js";
+import "../../chunk-XZSBR26X.js";
 export {
   terminal
 };

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

@@ -1,8 +1,8 @@
 import {
   whatsappBusiness
-} from "../../chunk-4O7DPKLI.js";
-import "../../chunk-WFIUWFE4.js";
-import "../../chunk-JWWIFSI7.js";
+} from "../../chunk-OR3VGVML.js";
+import "../../chunk-HWADNTQF.js";
+import "../../chunk-XZSBR26X.js";
 export {
   whatsappBusiness
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -25,6 +25,7 @@
   "dependencies": {
     "@photon-ai/advanced-imessage": "^0.7.0",
     "@photon-ai/imessage-kit": "^3.0.0",
+    "@photon-ai/otel": "^0.1.1",
     "@photon-ai/whatsapp-business": "^0.1.1",
     "@repeaterjs/repeater": "^3.0.6",
     "better-grpc": "^0.3.2",