@pellux/goodvibes-sdk 0.18.53 → 0.19.8

package/dist/client.js

@@ -4,10 +4,11 @@ import { createPeerSdk, } from './_internal/peer/index.js';
 import { normalizeAuthToken } from './_internal/transport-http/index.js';
 import { createEventSourceConnector, createRemoteRuntimeEvents, createWebSocketConnector, } from './_internal/transport-realtime/index.js';
 import { createGoodVibesAuthClient, createMemoryTokenStore, } from './auth.js';
+import { AutoRefreshCoordinator, createAutoRefreshMiddleware, } from './_internal/platform/auth/index.js';
 function requireBaseUrl(baseUrl) {
     const normalized = baseUrl.trim();
     if (!normalized) {
-        throw new ConfigurationError('GoodVibes baseUrl is required');
+        throw new ConfigurationError('GoodVibes baseUrl is required. Pass a non-empty baseUrl in your createGoodVibesSdk options (e.g. "https://my-daemon.example.com").');
     }
     return normalized;
 }
@@ -37,6 +38,7 @@ function createClientOptions(options) {
         ...(options.headers ? { headers: options.headers } : {}),
         ...(options.getHeaders ? { getHeaders: options.getHeaders } : {}),
         ...(options.retry ? { retry: options.retry } : {}),
+        ...(options.middleware ? { middleware: options.middleware } : {}),
     };
 }
 /**
@@ -44,8 +46,7 @@ function createClientOptions(options) {
  *
  * This is the runtime-agnostic constructor. For environments with sensible
  * defaults already configured, prefer the platform-specific wrappers:
- * `createNodeGoodVibesSdk`, `createBrowserGoodVibesSdk`,
- * `createReactNativeGoodVibesSdk`.
+ * `createBrowserGoodVibesSdk`, `createReactNativeGoodVibesSdk`.
  *
  * @see https://github.com/mgd34msu/goodvibes-sdk/blob/main/docs/getting-started.md
  *
@@ -64,36 +65,95 @@ function createClientOptions(options) {
 export function createGoodVibesSdk(options) {
     const baseUrl = requireBaseUrl(options.baseUrl);
     const tokenStore = options.tokenStore ?? (options.getAuthToken ? null : createMemoryTokenStore(options.authToken ?? null));
-    const authToken = options.authToken ?? null;
     const getAuthToken = tokenStore
         ? () => tokenStore.getToken()
         : options.getAuthToken;
     // Single normalized resolver used by realtime connectors.
     const tokenResolver = normalizeAuthToken(getAuthToken ?? options.authToken ?? undefined);
     const fetchImpl = () => requireFetchImplementation(options.fetch);
+    const { observer } = options;
+    // Build the auto-refresh coordinator when a writable token store is present
+    // and autoRefresh is not explicitly disabled.
+    const autoRefreshEnabled = (options.autoRefresh?.autoRefresh ?? true) && tokenStore !== null;
+    const coordinator = autoRefreshEnabled && tokenStore
+        ? new AutoRefreshCoordinator({
+            tokenStore,
+            autoRefresh: true,
+            refreshLeewayMs: options.autoRefresh?.refreshLeewayMs ?? 60_000,
+            refresh: options.autoRefresh?.refresh,
+            observer,
+        })
+        : null;
+    // Build the merged middleware list: auto-refresh first (if enabled), then
+    // consumer-provided middleware. This ensures the auto-refresh pre-flight runs
+    // before any consumer middleware sees ctx.headers.Authorization, and that the
+    // reactive 401 retry is transparent to consumer middleware.
+    //
+    // The transport reference for the retry callback is resolved lazily: we pass
+    // a proxy object whose `requestJson` property is populated immediately after
+    // createOperatorSdk / createPeerSdk returns. Because the middleware only calls
+    // `transport.requestJson` on a reactive 401 (not at construction time), the
+    // holder is always populated before it is accessed.
+    // Lazy transport proxy: populated after createOperatorSdk / createPeerSdk.
+    // The middleware only invokes requestJson on a reactive 401 — never at
+    // construction time — so the proxy is always populated before first use.
+    let operatorRequestJson = null;
+    let peerRequestJson = null;
+    const buildMiddleware = (getRequestJson) => {
+        const mws = [];
+        if (coordinator) {
+            // Wrap the coordinator + lazy transport reference into a minimal proxy
+            // that satisfies createAutoRefreshMiddleware's Pick<HttpJsonTransport, 'requestJson'>.
+            const transportProxy = {
+                requestJson(url, opts) {
+                    const rj = getRequestJson();
+                    if (!rj)
+                        throw new Error('Auto-refresh: transport not yet initialised');
+                    return rj(url, opts);
+                },
+            };
+            mws.push(createAutoRefreshMiddleware(coordinator, transportProxy, tokenStore));
+        }
+        if (options.middleware) {
+            mws.push(...options.middleware);
+        }
+        return mws;
+    };
     const operator = createOperatorSdk(createClientOptions({
         ...options,
         tokenStore: tokenStore ?? undefined,
+        middleware: buildMiddleware(() => operatorRequestJson),
     }));
+    // Populate the lazy reference now that the transport is fully constructed.
+    operatorRequestJson = (url, opts) => operator.transport.requestJson(url, opts);
     const peer = createPeerSdk(createClientOptions({
         ...options,
         tokenStore: tokenStore ?? undefined,
+        middleware: buildMiddleware(() => peerRequestJson),
     }));
+    // Populate the lazy reference now that the transport is fully constructed.
+    peerRequestJson = (url, opts) => peer.transport.requestJson(url, opts);
     return {
         operator,
         peer,
-        auth: createGoodVibesAuthClient(operator, tokenStore, getAuthToken),
+        auth: createGoodVibesAuthClient(operator, tokenStore, getAuthToken, observer, options.autoRefresh, coordinator),
+        use(middleware) {
+            operator.transport.use(middleware);
+            peer.transport.use(middleware);
+        },
         realtime: {
             viaSse() {
                 return createRemoteRuntimeEvents(createEventSourceConnector(baseUrl, tokenResolver, fetchImpl(), {
                     reconnect: options.realtime?.sseReconnect,
                     onError: options.realtime?.onError,
+                    observer,
                 }));
             },
             viaWebSocket(webSocketImpl) {
                 return createRemoteRuntimeEvents(createWebSocketConnector(baseUrl, tokenResolver, requireWebSocketImplementation(webSocketImpl ?? options.WebSocketImpl), {
                     reconnect: options.realtime?.webSocketReconnect,
                     onError: options.realtime?.onError,
+                    observer,
                 }));
             },
         },

package/dist/expo.d.ts

@@ -17,4 +17,5 @@ export interface ExpoGoodVibesSdkOptions extends ReactNativeGoodVibesSdkOptions
  */
 export { forSession } from './transport-realtime.js';
 export declare function createExpoGoodVibesSdk(options: ExpoGoodVibesSdkOptions): ReactNativeGoodVibesSdk;
+export { createExpoSecureTokenStore, type ExpoSecureTokenStore, type ExpoSecureTokenStoreOptions, type ExpoSecureStoreAccessible, } from './_internal/platform/auth/expo-secure-token-store.js';
 //# sourceMappingURL=expo.d.ts.map

package/dist/expo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expo.d.ts","sourceRoot":"","sources":["../src/expo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACpC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,uBAAwB,SAAQ,8BAA8B;CAAG;AAElF;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,uBAAuB,CAEhG"}
+{"version":3,"file":"expo.d.ts","sourceRoot":"","sources":["../src/expo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACpC,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,uBAAwB,SAAQ,8BAA8B;CAAG;AAElF;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,uBAAuB,CAEhG;AAED,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,GAC/B,MAAM,sDAAsD,CAAC"}

package/dist/expo.js

@@ -17,3 +17,4 @@ export { forSession } from './transport-realtime.js';
 export function createExpoGoodVibesSdk(options) {
     return createReactNativeGoodVibesSdk(options);
 }
+export { createExpoSecureTokenStore, } from './_internal/platform/auth/expo-secure-token-store.js';

package/dist/index.d.ts

@@ -6,12 +6,11 @@ export type { BrowserGoodVibesSdkOptions } from './browser.js';
 export { createBrowserGoodVibesSdk } from './browser.js';
 export type { WebGoodVibesSdkOptions } from './web.js';
 export { createWebGoodVibesSdk } from './web.js';
-export type { NodeGoodVibesSdkOptions } from './node.js';
-export { createNodeGoodVibesSdk } from './node.js';
 export type { ReactNativeGoodVibesRealtime, ReactNativeGoodVibesSdk, ReactNativeGoodVibesSdkOptions, } from './react-native.js';
 export { createReactNativeGoodVibesSdk } from './react-native.js';
 export type { ExpoGoodVibesSdkOptions } from './expo.js';
 export { createExpoGoodVibesSdk } from './expo.js';
+export * from './observer/index.js';
 export * from './contracts.js';
 export * from './daemon.js';
 export * from './errors.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -2,9 +2,9 @@ export { createGoodVibesSdk } from './client.js';
 export { createBrowserTokenStore, createGoodVibesAuthClient, createMemoryTokenStore, } from './auth.js';
 export { createBrowserGoodVibesSdk } from './browser.js';
 export { createWebGoodVibesSdk } from './web.js';
-export { createNodeGoodVibesSdk } from './node.js';
 export { createReactNativeGoodVibesSdk } from './react-native.js';
 export { createExpoGoodVibesSdk } from './expo.js';
+export * from './observer/index.js';
 export * from './contracts.js';
 export * from './daemon.js';
 export * from './errors.js';

package/dist/observer/index.d.ts

@@ -0,0 +1,160 @@
+/**
+ * SDKObserver — first-class observability hooks for the GoodVibes SDK.
+ *
+ * Consumers can implement any subset of `SDKObserver` and pass the instance
+ * via the `observer` option on supported client factories. All methods are
+ * optional; the SDK works identically whether an observer is present or not.
+ *
+ * Observer call sites are wrapped in a silent try/catch: an observer that
+ * throws will not propagate into SDK logic. This is intentional — observer
+ * errors must never break the SDK flow.
+ *
+ * @example
+ * const sdk = createGoodVibesSdk({
+ *   baseUrl: 'https://daemon.example.com',
+ *   tokenStore: createMemoryTokenStore(),
+ *   observer: createConsoleObserver({ level: 'debug' }),
+ * });
+ */
+import type { GoodVibesSdkError } from '../_internal/errors/index.js';
+import type { AnyRuntimeEvent } from '../_internal/platform/runtime/events/domain-map.js';
+import type { TransportObserver, TransportActivityInfo } from '../_internal/transport-core/index.js';
+export type { AnyRuntimeEvent };
+/**
+ * The auth state kind used in transition notifications.
+ * - `'anonymous'` — no credentials present
+ * - `'session'` — session-cookie or short-lived token
+ * - `'token'` — long-lived bearer token
+ */
+export type AuthStateKind = 'anonymous' | 'session' | 'token';
+/**
+ * The reason an auth transition occurred.
+ */
+export type AuthTransitionReason = 'login' | 'logout' | 'refresh' | 'expire' | 'revoke';
+/**
+ * Re-export TransportActivityInfo from transport-core so SDK consumers
+ * don't need to import from an internal package.
+ */
+export type { TransportActivityInfo } from '../_internal/transport-core/index.js';
+/**
+ * Auth transition metadata surfaced to the observer.
+ */
+export interface AuthTransitionInfo {
+    readonly from: AuthStateKind;
+    readonly to: AuthStateKind;
+    readonly reason: AuthTransitionReason;
+}
+/**
+ * Optional observer interface. Implement any subset of methods and pass the
+ * instance to a supported client factory. All methods are optional.
+ *
+ * Every call site is wrapped in `try { observer.onX?.(...) } catch (e) {}`
+ * — observer errors are swallowed and never propagate into SDK logic.
+ */
+export interface SDKObserver extends TransportObserver {
+    /**
+     * Called for every event dispatched through the realtime transport
+     * (SSE or WebSocket). Receives the fully-typed runtime event payload.
+     *
+     * Wired as of 0.19.7 — fires on every envelope dispatched through
+     * `createEventSourceConnector` and `createWebSocketConnector`.
+     */
+    onEvent?(event: AnyRuntimeEvent): void;
+    /**
+     * Called when the SDK catches and is about to rethrow a GoodVibesSdkError.
+     * The error is still rethrown; this is notification only.
+     *
+     * Wired as of 0.19.7 — fires at every `GoodVibesSdkError` throw site in
+     * the transport and auth layers before the error propagates to the caller.
+     */
+    onError?(err: GoodVibesSdkError): void;
+    /**
+     * Called at HTTP/SSE/WebSocket transport boundaries.
+     * - `'send'` fires before the request is dispatched.
+     * - `'recv'` fires after a response is received (with status + duration).
+     *
+     * Wired as of 0.19.7 — fires in `transport-http` request/response boundary
+     * and in realtime connect/message boundaries.
+     */
+    onTransportActivity?(activity: TransportActivityInfo): void;
+    /**
+     * Called when the SDK's auth state transitions (login, logout, token
+     * refresh, expiry, or revocation).
+     */
+    onAuthTransition?(transition: AuthTransitionInfo): void;
+}
+/**
+ * Safely invoke an observer method. Observer errors are swallowed so they
+ * never disrupt SDK control flow. This is the canonical call pattern for
+ * all observer call sites throughout the SDK.
+ *
+ * @param fn - Zero-argument thunk wrapping the observer call.
+ */
+export declare function invokeObserver(fn: () => void): void;
+export interface ConsoleObserverOptions {
+    /** Minimum log level. Defaults to `'info'`. */
+    readonly level?: 'debug' | 'info';
+}
+/**
+ * Create a development-friendly observer that logs SDK activity to the console.
+ *
+ * Use `level: 'debug'` to also log transport activity and every runtime event.
+ *
+ * @example
+ * const sdk = createGoodVibesSdk({
+ *   baseUrl: '...',
+ *   observer: createConsoleObserver({ level: 'debug' }),
+ * });
+ */
+export declare function createConsoleObserver(options?: ConsoleObserverOptions): SDKObserver;
+/**
+ * Accept-only OpenTelemetry types so we don't add a hard dependency on
+ * `@opentelemetry/*`. Consumers bring their own tracer and meter.
+ */
+export interface OtelTracer {
+    startActiveSpan<F extends (span: OtelSpan) => unknown>(name: string, fn: F): ReturnType<F>;
+    startSpan(name: string, options?: unknown): OtelSpan;
+}
+export interface OtelSpan {
+    setAttribute(key: string, value: string | number | boolean): this;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): this;
+    recordException(error: Error | unknown): this;
+    end(): void;
+}
+export interface OtelMeter {
+    createCounter(name: string, options?: {
+        description?: string;
+    }): OtelCounter;
+    createHistogram(name: string, options?: {
+        description?: string;
+        unit?: string;
+    }): OtelHistogram;
+}
+export interface OtelCounter {
+    add(value: number, attributes?: Record<string, string | number | boolean>): void;
+}
+export interface OtelHistogram {
+    record(value: number, attributes?: Record<string, string | number | boolean>): void;
+}
+/**
+ * Create an observer that emits OpenTelemetry spans and metrics.
+ *
+ * Pass a pre-configured `Tracer` and `Meter` from your OpenTelemetry SDK setup.
+ * This adapter has no hard dependency on `@opentelemetry/*` — it accepts the
+ * abstractions defined above, which are structurally compatible with the real
+ * OpenTelemetry API.
+ *
+ * @example
+ * import { trace, metrics } from '@opentelemetry/api';
+ *
+ * const observer = createOpenTelemetryObserver(
+ *   trace.getTracer('goodvibes-sdk'),
+ *   metrics.getMeter('goodvibes-sdk'),
+ * );
+ * const sdk = createGoodVibesSdk({ baseUrl: '...', observer });
+ */
+export declare function createOpenTelemetryObserver(tracer: OtelTracer, meter: OtelMeter): SDKObserver;
+//# sourceMappingURL=index.d.ts.map

package/dist/observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"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"}

package/dist/observer/index.js

@@ -0,0 +1,140 @@
+/**
+ * SDKObserver — first-class observability hooks for the GoodVibes SDK.
+ *
+ * Consumers can implement any subset of `SDKObserver` and pass the instance
+ * via the `observer` option on supported client factories. All methods are
+ * optional; the SDK works identically whether an observer is present or not.
+ *
+ * Observer call sites are wrapped in a silent try/catch: an observer that
+ * throws will not propagate into SDK logic. This is intentional — observer
+ * errors must never break the SDK flow.
+ *
+ * @example
+ * const sdk = createGoodVibesSdk({
+ *   baseUrl: 'https://daemon.example.com',
+ *   tokenStore: createMemoryTokenStore(),
+ *   observer: createConsoleObserver({ level: 'debug' }),
+ * });
+ */
+const SPAN_STATUS_ERROR = 2; // OpenTelemetry SpanStatusCode.ERROR
+/**
+ * Safely invoke an observer method. Observer errors are swallowed so they
+ * never disrupt SDK control flow. This is the canonical call pattern for
+ * all observer call sites throughout the SDK.
+ *
+ * @param fn - Zero-argument thunk wrapping the observer call.
+ */
+export function invokeObserver(fn) {
+    try {
+        fn();
+    }
+    catch {
+        // Observer errors must not propagate into SDK logic.
+        // Observers are passive listeners; they have no authority to break flows.
+    }
+}
+/**
+ * Create a development-friendly observer that logs SDK activity to the console.
+ *
+ * Use `level: 'debug'` to also log transport activity and every runtime event.
+ *
+ * @example
+ * const sdk = createGoodVibesSdk({
+ *   baseUrl: '...',
+ *   observer: createConsoleObserver({ level: 'debug' }),
+ * });
+ */
+export function createConsoleObserver(options = {}) {
+    const level = options.level ?? 'info';
+    return {
+        onAuthTransition(transition) {
+            // eslint-disable-next-line no-console
+            console.log(`[sdk:observer] auth transition ${transition.from} → ${transition.to} (${transition.reason})`);
+        },
+        onError(err) {
+            // eslint-disable-next-line no-console
+            console.error(`[sdk:observer] error kind=${err.kind} category=${err.category}`, err.message);
+        },
+        onTransportActivity(activity) {
+            if (level !== 'debug')
+                return;
+            const status = activity.status !== undefined ? ` status=${activity.status}` : '';
+            const dur = activity.durationMs !== undefined ? ` ${activity.durationMs}ms` : '';
+            // eslint-disable-next-line no-console
+            console.debug(`[sdk:observer] transport ${activity.direction} ${activity.kind ?? 'http'} ${activity.url}${status}${dur}`);
+        },
+        onEvent(event) {
+            if (level !== 'debug')
+                return;
+            // eslint-disable-next-line no-console
+            console.debug(`[sdk:observer] event ${event.type}`);
+        },
+    };
+}
+/**
+ * Create an observer that emits OpenTelemetry spans and metrics.
+ *
+ * Pass a pre-configured `Tracer` and `Meter` from your OpenTelemetry SDK setup.
+ * This adapter has no hard dependency on `@opentelemetry/*` — it accepts the
+ * abstractions defined above, which are structurally compatible with the real
+ * OpenTelemetry API.
+ *
+ * @example
+ * import { trace, metrics } from '@opentelemetry/api';
+ *
+ * const observer = createOpenTelemetryObserver(
+ *   trace.getTracer('goodvibes-sdk'),
+ *   metrics.getMeter('goodvibes-sdk'),
+ * );
+ * const sdk = createGoodVibesSdk({ baseUrl: '...', observer });
+ */
+export function createOpenTelemetryObserver(tracer, meter) {
+    const authCounter = meter.createCounter('sdk.auth.transitions', {
+        description: 'Number of SDK auth state transitions',
+    });
+    const errorCounter = meter.createCounter('sdk.errors', {
+        description: 'Number of SDK errors observed',
+    });
+    const transportHistogram = meter.createHistogram('sdk.transport.duration_ms', {
+        description: 'SDK transport call duration',
+        unit: 'ms',
+    });
+    return {
+        onAuthTransition(transition) {
+            authCounter.add(1, {
+                from: transition.from,
+                to: transition.to,
+                reason: transition.reason,
+            });
+            const span = tracer.startSpan('sdk.auth.transition');
+            span.setAttribute('sdk.auth.from', transition.from);
+            span.setAttribute('sdk.auth.to', transition.to);
+            span.setAttribute('sdk.auth.reason', transition.reason);
+            span.end();
+        },
+        onError(err) {
+            errorCounter.add(1, { kind: err.kind, category: err.category });
+            const span = tracer.startSpan('sdk.error');
+            span.setAttribute('sdk.error.kind', err.kind);
+            span.setAttribute('sdk.error.category', err.category);
+            span.setAttribute('sdk.error.recoverable', err.recoverable);
+            span.recordException(err);
+            span.setStatus({ code: SPAN_STATUS_ERROR, message: err.message });
+            span.end();
+        },
+        onTransportActivity(activity) {
+            if (activity.direction !== 'recv')
+                return; // only record completed calls
+            if (activity.durationMs !== undefined) {
+                transportHistogram.record(activity.durationMs, {
+                    kind: activity.kind ?? 'http',
+                    ...(activity.status !== undefined && { status: activity.status }),
+                });
+            }
+        },
+        onEvent(_event) {
+            // Event counting is high-cardinality; consumers can add their own meter
+            // by wrapping this observer if they need per-event metrics.
+        },
+    };
+}

package/dist/platform/acp/connection.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/acp/connection.js';
+//# sourceMappingURL=connection.d.ts.map

package/dist/platform/acp/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/connection.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC"}

package/dist/platform/acp/connection.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/acp/connection.js';

package/dist/platform/acp/manager.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/acp/manager.js';
+//# sourceMappingURL=manager.d.ts.map

package/dist/platform/acp/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/manager.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC"}

package/dist/platform/acp/manager.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/acp/manager.js';

package/dist/platform/acp/protocol.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/acp/protocol.js';
+//# sourceMappingURL=protocol.d.ts.map

package/dist/platform/acp/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/platform/acp/protocol.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC"}

package/dist/platform/acp/protocol.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/acp/protocol.js';

package/dist/platform/adapters/helpers.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/adapters/helpers.js';
+//# sourceMappingURL=helpers.d.ts.map

package/dist/platform/adapters/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/platform/adapters/helpers.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAC"}

package/dist/platform/adapters/helpers.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/adapters/helpers.js';

package/dist/platform/agents/archetypes.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/archetypes.js';
+//# sourceMappingURL=archetypes.d.ts.map

package/dist/platform/agents/archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/archetypes.ts"],"names":[],"mappings":"AAAA,cAAc,+CAA+C,CAAC"}

package/dist/platform/agents/archetypes.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/archetypes.js';

package/dist/platform/agents/communication-policy.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/communication-policy.js';
+//# sourceMappingURL=communication-policy.d.ts.map

package/dist/platform/agents/communication-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication-policy.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/communication-policy.ts"],"names":[],"mappings":"AAAA,cAAc,yDAAyD,CAAC"}

package/dist/platform/agents/communication-policy.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/communication-policy.js';

package/dist/platform/agents/completion-report.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/completion-report.js';
+//# sourceMappingURL=completion-report.d.ts.map

package/dist/platform/agents/completion-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/completion-report.ts"],"names":[],"mappings":"AAAA,cAAc,sDAAsD,CAAC"}

package/dist/platform/agents/completion-report.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/completion-report.js';

package/dist/platform/agents/message-bus.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/message-bus.js';
+//# sourceMappingURL=message-bus.d.ts.map

package/dist/platform/agents/message-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-bus.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/message-bus.ts"],"names":[],"mappings":"AAAA,cAAc,gDAAgD,CAAC"}

package/dist/platform/agents/message-bus.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/message-bus.js';

package/dist/platform/agents/orchestrator-utils.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/orchestrator-utils.js';
+//# sourceMappingURL=orchestrator-utils.d.ts.map

package/dist/platform/agents/orchestrator-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-utils.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator-utils.ts"],"names":[],"mappings":"AAAA,cAAc,uDAAuD,CAAC"}

package/dist/platform/agents/orchestrator-utils.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/orchestrator-utils.js';

package/dist/platform/agents/orchestrator.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/orchestrator.js';
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/platform/agents/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator.ts"],"names":[],"mappings":"AAAA,cAAc,iDAAiD,CAAC"}

package/dist/platform/agents/orchestrator.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/orchestrator.js';

package/dist/platform/agents/session.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/session.js';
+//# sourceMappingURL=session.d.ts.map

package/dist/platform/agents/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/session.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC"}

package/dist/platform/agents/session.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/session.js';

package/dist/platform/agents/worktree.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/worktree.js';
+//# sourceMappingURL=worktree.d.ts.map

package/dist/platform/agents/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/worktree.ts"],"names":[],"mappings":"AAAA,cAAc,6CAA6C,CAAC"}

package/dist/platform/agents/worktree.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/worktree.js';

package/dist/platform/agents/wrfc-controller.d.ts

@@ -0,0 +1,2 @@
+export * from '../../_internal/platform/agents/wrfc-controller.js';
+//# sourceMappingURL=wrfc-controller.d.ts.map

package/dist/platform/agents/wrfc-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrfc-controller.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-controller.ts"],"names":[],"mappings":"AAAA,cAAc,oDAAoD,CAAC"}

package/dist/platform/agents/wrfc-controller.js

@@ -0,0 +1 @@
+export * from '../../_internal/platform/agents/wrfc-controller.js';