docs: update spectrum-ts documentation for v1.8.0 (#27)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: photon-action-bot[bot]

docs-src/spectrum-ts/custom-events-and-lifecycle.mdx.vel

@@ -42,7 +42,7 @@ Use the flat form on `app` when you want a merged feed across platforms; use the
 await app.stop();
 ```
 
-This closes the merged message stream, drains and disposes every custom event stream, and tears down every platform client via its `lifecycle.destroyClient` hook (if one is defined). It's idempotent — calling `stop()` twice is safe.
+This closes the merged message stream, drains and disposes every custom event stream, tears down every platform client via its `lifecycle.destroyClient` hook (if one is defined), and flushes any pending telemetry data when [telemetry](/spectrum-ts/getting-started#telemetry) is enabled. It's idempotent — calling `stop()` twice is safe.
 
 ### Signal handling
 

docs-src/spectrum-ts/getting-started.mdx.vel

@@ -121,3 +121,22 @@ for await (const [space, message] of app.messages) {
 ```
 
 Messages from every provider merge into the single `app.messages` stream. The `message.platform` field identifies the source.
+
+## Telemetry
+
+Spectrum has built-in [OpenTelemetry](https://opentelemetry.io/) instrumentation. Enable it by passing `telemetry: true`:
+
+```ts
+const app = await Spectrum({
+  projectId: process.env.PROJECT_ID!,
+  projectSecret: process.env.PROJECT_SECRET!,
+  providers: [imessage.config()],
+  telemetry: true,
+});
+```
+
+When enabled, Spectrum traces initialization, provider setup, message send/receive/get flows, space resolution, and custom events. Each span includes attributes like the provider name, space ID, content type, and sender kind.
+
+Traces are sent to the Photon OTLP endpoint by default. Standard `OTEL_EXPORTER_OTLP_*` environment variables override the default endpoint and headers.
+
+Calling `app.stop()` flushes any pending telemetry data before shutting down.

package.json

@@ -27,7 +27,7 @@
     "eslint-plugin-format": "^2.0.1",
     "husky": "^9.1.7",
     "oxfmt": "^0.44.0",
-    "spectrum-ts": "1.5.0",
+    "spectrum-ts": "1.8.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }