@pellux/goodvibes-transport-core 0.30.2 → 0.33.0

package/README.md

@@ -1,8 +1,8 @@
 # @pellux/goodvibes-transport-core
 
-Internal workspace package backing `@pellux/goodvibes-sdk/transport-core`.
+Public GoodVibes transport-core package for shared transport, event-feed, observer, and middleware primitives.
 
-Consumers should install `@pellux/goodvibes-sdk` and import this surface from the umbrella package.
+Most applications should install `@pellux/goodvibes-sdk` and import `@pellux/goodvibes-sdk/transport-core`. Install this package directly when you only need the transport primitives.
 
 Use this surface only when you are composing your own transport/client abstraction.
 

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOpD;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2BpE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAOhF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOpD;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2BpE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAoBhF"}

package/dist/errors.js

@@ -37,9 +37,22 @@ export function describeUnknownTransportError(error) {
 export function transportErrorFromUnknown(error, context) {
     if (error instanceof Error)
         return error;
+    const code = typeof error === 'object'
+        && error !== null
+        && typeof error.code === 'string'
+        ? error.code
+        : '';
+    // Include undici/Bun error codes alongside Node-style errno codes.
+    // recoverable is ONLY set to true for recognized network-layer error codes
+    // (errno values, undici codes, and 'fetch failed'). Unknown/unrecognized codes
+    // (including programmer errors wrapped as non-Error objects) get recoverable:false
+    // so they do not trigger retry loops.
+    const recoverable = /^(?:EAI_AGAIN|ECONNRESET|ECONNREFUSED|ETIMEDOUT|ENOTFOUND|EPIPE|ECONNABORTED)$/.test(code)
+        || /^UND_ERR_/.test(code)
+        || code === 'fetch failed';
     return new GoodVibesSdkError(`${context}: ${describeUnknownTransportError(error)}`, {
         category: 'network',
         source: 'transport',
-        recoverable: true,
+        recoverable,
     });
 }

package/dist/event-envelope.d.ts

@@ -1,21 +1,21 @@
 export interface EventEnvelope<TType extends string, TPayload> {
     readonly type: TType;
     readonly ts: number;
-    readonly traceId: string;
-    readonly sessionId: string;
-    readonly turnId?: string;
-    readonly agentId?: string;
-    readonly taskId?: string;
-    readonly source: string;
+    readonly traceId?: string | undefined;
+    readonly sessionId?: string | undefined;
+    readonly turnId?: string | undefined;
+    readonly agentId?: string | undefined;
+    readonly taskId?: string | undefined;
+    readonly source?: string | undefined;
     readonly payload: TPayload;
 }
 export interface EventEnvelopeContext {
     readonly sessionId: string;
     readonly source: string;
-    readonly traceId?: string;
-    readonly turnId?: string;
-    readonly agentId?: string;
-    readonly taskId?: string;
+    readonly traceId?: string | undefined;
+    readonly turnId?: string | undefined;
+    readonly agentId?: string | undefined;
+    readonly taskId?: string | undefined;
 }
 export declare function createEventEnvelope<TType extends string, TPayload>(type: TType, payload: TPayload, context: EventEnvelopeContext): EventEnvelope<TType, TPayload>;
 //# sourceMappingURL=event-envelope.d.ts.map

package/dist/event-envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-envelope.d.ts","sourceRoot":"","sources":["../src/event-envelope.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IAC3D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EAChE,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAYhC"}
+{"version":3,"file":"event-envelope.d.ts","sourceRoot":"","sources":["../src/event-envelope.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ;IAC3D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EAChE,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAiBhC"}

package/dist/event-envelope.js

@@ -1,9 +1,13 @@
-import { createUuidV4 } from './uuid.js';
 export function createEventEnvelope(type, payload, context) {
     return Object.freeze({
         type,
         ts: Date.now(),
-        traceId: context.traceId ?? createUuidV4(),
+        // Callers that want multiple fan-out envelopes correlated under one trace
+        // must provide a shared traceId.
+        // default to undefined instead of generating entropy on every envelope.
+        // High-volume callers (telemetry, streaming deltas) should provide a shared
+        // traceId in context to correlate fan-out envelopes under one trace.
+        traceId: context.traceId,
         sessionId: context.sessionId,
         turnId: context.turnId,
         agentId: context.agentId,

package/dist/event-feeds.d.ts

@@ -1,8 +1,13 @@
 import type { EventEnvelope } from './event-envelope.js';
-type EventLike = {
+/**
+ * Minimal structural constraint for runtime events. Matches the `{ type: string }` shape
+ * of `AnyRuntimeEvent` from `@pellux/goodvibes-contracts` without taking on that dependency.
+ * Re-exported so downstream packages can share the same public type identity.
+ */
+export type EventLike = {
     readonly type: string;
 };
-type EventForType<TEvent extends EventLike, TType extends TEvent['type']> = Extract<TEvent, {
+export type EventForType<TEvent extends EventLike, TType extends TEvent['type']> = Extract<TEvent, {
     type: TType;
 }>;
 export interface RuntimeEventFeed<TEvent extends EventLike = EventLike> {
@@ -18,5 +23,4 @@ export type RuntimeEventFeeds<TDomain extends string, TEvent extends EventLike =
 export type EnvelopeSubscriber<TEvent extends EventLike> = <TType extends TEvent['type']>(type: TType, listener: (envelope: EventEnvelope<TType, EventForType<TEvent, TType>>) => void) => () => void;
 export declare function createRuntimeEventFeed<TEvent extends EventLike>(subscribe: EnvelopeSubscriber<TEvent>): RuntimeEventFeed<TEvent>;
 export declare function createRuntimeEventFeeds<TDomain extends string, TEvent extends EventLike>(domains: readonly TDomain[], createFeed: (domain: TDomain) => RuntimeEventFeed<TEvent>): RuntimeEventFeeds<TDomain, TEvent>;
-export {};
 //# sourceMappingURL=event-feeds.d.ts.map

package/dist/event-feeds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-feeds.d.ts","sourceRoot":"","sources":["../src/event-feeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,KAAK,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,KAAK,YAAY,CACf,MAAM,SAAS,SAAS,EACxB,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,IAC1B,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACpE,EAAE,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,GACvD,MAAM,IAAI,CAAC;IACd,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACrC,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,GAC9E,MAAM,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,CAC3B,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,GAAG,SAAS,IAClC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACnD,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACtF,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,KAC5E,MAAM,IAAI,CAAC;AAEhB,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,SAAS,EAC7D,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACpC,gBAAgB,CAAC,MAAM,CAAC,CAiB1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,EAExB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC,MAAM,CAAC,GACxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAYpC"}
+{"version":3,"file":"event-feeds.d.ts","sourceRoot":"","sources":["../src/event-feeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,YAAY,CACtB,MAAM,SAAS,SAAS,EACxB,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,IAC1B,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErC,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACpE,EAAE,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EAC7B,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,GACvD,MAAM,IAAI,CAAC;IACd,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACrC,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,GAC9E,MAAM,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,CAC3B,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,GAAG,SAAS,IAClC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACnD,GAAG;IACF,QAAQ,EAAE,CAAC,IAAI,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,SAAS,IAAI,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,CAAC,EACtF,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,IAAI,KAC5E,MAAM,IAAI,CAAC;AAEhB,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,SAAS,EAC7D,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACpC,gBAAgB,CAAC,MAAM,CAAC,CAiB1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,SAAS,EAExB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,gBAAgB,CAAC,MAAM,CAAC,GACxD,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAcpC"}

package/dist/event-feeds.js

@@ -15,9 +15,11 @@ export function createRuntimeEventFeeds(domains, createFeed) {
     for (const domain of domains) {
         feeds[domain] = createFeed(domain);
     }
+    // Snapshot the domains array defensively.
+    const frozenDomains = Object.freeze([...domains]);
     return Object.freeze({
         ...feeds,
-        domains,
+        domains: frozenDomains,
         domain(domain) {
             return feeds[domain];
         },

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type { EventEnvelope, EventEnvelopeContext } from './event-envelope.js';
 export { createEventEnvelope } from './event-envelope.js';
-export type { RuntimeEventFeed, RuntimeEventFeeds, EnvelopeSubscriber } from './event-feeds.js';
+export type { EventForType, EventLike, RuntimeEventFeed, RuntimeEventFeeds, EnvelopeSubscriber } from './event-feeds.js';
 export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
 export type { ClientTransport } from './client-transport.js';
 export { createClientTransport } from './client-transport.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzH,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/middleware.d.ts

@@ -29,29 +29,36 @@ export interface TransportContext {
     body: unknown;
     /** Per-request options forwarded from the caller. */
     options: {
-        readonly signal?: AbortSignal;
-        readonly retry?: unknown;
+        readonly signal?: AbortSignal | undefined;
+        readonly retry?: unknown | undefined;
         [key: string]: unknown;
     };
     /** AbortSignal for the request. Propagated from caller options. */
-    signal?: AbortSignal;
+    signal?: AbortSignal | undefined;
     /** The HTTP response object — set after `next()` resolves successfully. */
-    response?: Response;
+    response?: Response | undefined;
     /** Round-trip duration in milliseconds — set after `next()` resolves. */
-    durationMs?: number;
+    durationMs?: number | undefined;
     /** Error thrown by the fetch or a downstream middleware — set on failure. */
-    error?: unknown;
+    error?: unknown | undefined;
     /**
      * Set to `true` when the error originated from within the middleware chain
      * (as opposed to from the real fetch). Used by the transport to wrap
      * middleware errors as `SDKError{kind:'unknown'}`.
      */
-    middlewareError?: boolean;
+    middlewareError?: boolean | undefined;
     /**
      * Name (or index) of the middleware that was active when the error occurred.
      * Set alongside `middlewareError` for error identity in cause objects.
      */
-    activeMiddlewareName?: string;
+    activeMiddlewareName?: string | undefined;
+    /**
+     * the already-parsed response body, stashed by innerFetch after
+     * the real fetch resolves. If set, middleware callers should read this
+     * field directly instead of calling `ctx.response.json()` to avoid an
+     * unnecessary JSON stringify → parse round-trip.
+     */
+    parsedBody?: unknown | undefined;
 }
 /**
  * A transport middleware function.

package/dist/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAInB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,UAAU,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,GACvD,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAwD1C"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE;QACP,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAInB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,UAAU,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,GACvD,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAkE1C"}

package/dist/middleware.js

@@ -22,8 +22,12 @@ export function composeMiddleware(middleware, innerFetch) {
     }
     return async (ctx) => {
         let index = -1;
+        let dispatchCount = 0;
         const dispatch = async (i) => {
-            if (i > MAX_MIDDLEWARE_DEPTH) {
+            // count actual re-entrant dispatch() invocations rather than
+            // reusing `i` (which is the chain index and cannot exceed chain length).
+            dispatchCount += 1;
+            if (dispatchCount > MAX_MIDDLEWARE_DEPTH) {
                 throw new GoodVibesSdkError(`Transport middleware recursion exceeded the maximum depth of ${MAX_MIDDLEWARE_DEPTH}.`, {
                     category: 'internal',
                     source: 'transport',
@@ -44,6 +48,12 @@ export function composeMiddleware(middleware, innerFetch) {
                 ctx.activeMiddlewareName = mwName;
                 try {
                     await mw(ctx, () => dispatch(i + 1));
+                    // clear middlewareError and activeMiddlewareName when the middleware
+                    // handled the error internally and did not re-throw. Leaving
+                    // activeMiddlewareName set would wrongly attribute a later unrelated error
+                    // to this middleware in the cause chain.
+                    ctx.middlewareError = false;
+                    ctx.activeMiddlewareName = undefined;
                 }
                 catch (err) {
                     // Mark that the error originated from this middleware (not the real fetch).

package/dist/observer.d.ts

@@ -1,14 +1,3 @@
-/**
- * TransportObserver — first-class observability interface at the transport layer.
- *
- * Defined here (transport-core) so that HTTP and realtime sibling transports can
- * accept it through their shared options types without depending on the SDK layer.
- * `SDKObserver` in `@pellux/goodvibes-sdk` extends this interface and adds
- * SDK-level callbacks (`onEvent`, `onAuthTransition`).
- *
- * All methods are optional. Observer exceptions are always swallowed via
- * `invokeObserver` — they must never propagate into transport control flow.
- */
 /**
  * Transport activity metadata surfaced at request/response boundaries.
  */
@@ -18,19 +7,23 @@ export interface TransportActivityInfo {
     /** The full URL of the request. */
     readonly url: string;
     /** HTTP response status code (only present on `'recv'`). */
-    readonly status?: number;
+    readonly status?: number | undefined;
     /** Round-trip duration in milliseconds (only present on `'recv'`). */
-    readonly durationMs?: number;
+    readonly durationMs?: number | undefined;
     /** Transport kind. */
-    readonly kind?: 'http' | 'sse' | 'ws';
+    readonly kind?: 'http' | 'sse' | 'ws' | undefined;
 }
 /**
  * Minimal observer interface at the transport layer.
  *
  * Implement any subset; the SDK works identically whether an observer is
- * present or not. All call sites are wrapped in a silent try/catch.
+ * present or not. All call sites are isolated from transport control flow.
  */
 export interface TransportObserver {
+    /**
+     * Called when another observer callback throws. This is notification only.
+     */
+    onObserverError?(err: Error): void;
     /**
      * Called when the SDK catches and is about to rethrow a transport error.
      * The error is still rethrown; this is notification only.
@@ -44,10 +37,11 @@ export interface TransportObserver {
     onTransportActivity?(activity: TransportActivityInfo): void;
 }
 /**
- * Safely invoke an observer method. Observer errors are swallowed so they
- * never disrupt transport control flow.
+ * Safely invoke an observer method. Observer errors are reported through
+ * `onObserverError` when available and never disrupt transport control flow.
  *
  * @param fn - Zero-argument thunk wrapping the observer call.
+ * @param onObserverError - Optional observer failure reporter.
  */
-export declare function invokeTransportObserver(fn: () => void): void;
+export declare function invokeTransportObserver(fn: () => void, onObserverError?: ((err: Error) => void) | undefined): void;
 //# sourceMappingURL=observer.d.ts.map

package/dist/observer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAO5D"}
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,sBAAsB;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,eAAe,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAEnC;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAoBlH"}

package/dist/observer.js

@@ -2,25 +2,43 @@
  * TransportObserver — first-class observability interface at the transport layer.
  *
  * Defined here (transport-core) so that HTTP and realtime sibling transports can
- * accept it through their shared options types without depending on the SDK layer.
- * `SDKObserver` in `@pellux/goodvibes-sdk` extends this interface and adds
- * SDK-level callbacks (`onEvent`, `onAuthTransition`).
+ * accept it through their shared options types without depending on higher-level packages.
+ * Higher-level SDK packages can extend this interface with product-specific
+ * callbacks while sharing the same transport option shape.
  *
- * All methods are optional. Observer exceptions are always swallowed via
- * `invokeObserver` — they must never propagate into transport control flow.
+ * All methods are optional. Observer callback errors are reported through
+ * `onObserverError` when supplied and never propagate into transport control flow.
  */
+import { GoodVibesSdkError } from '@pellux/goodvibes-errors';
+import { transportErrorFromUnknown } from './errors.js';
 /**
- * Safely invoke an observer method. Observer errors are swallowed so they
- * never disrupt transport control flow.
+ * Safely invoke an observer method. Observer errors are reported through
+ * `onObserverError` when available and never disrupt transport control flow.
  *
  * @param fn - Zero-argument thunk wrapping the observer call.
+ * @param onObserverError - Optional observer failure reporter.
  */
-export function invokeTransportObserver(fn) {
+export function invokeTransportObserver(fn, onObserverError) {
     try {
         fn();
     }
     catch (error) {
-        void error;
-        // Observer errors must not propagate into transport logic.
+        if (!onObserverError)
+            return;
+        try {
+            const observerError = error instanceof Error
+                ? new GoodVibesSdkError(`Transport observer callback failed: ${error.message}`, {
+                    category: 'internal',
+                    source: 'transport',
+                    recoverable: false,
+                    cause: error,
+                })
+                : transportErrorFromUnknown(error, 'Transport observer callback failed');
+            onObserverError(observerError);
+        }
+        catch {
+            // The observer failure reporter itself failed; no remaining observer hook
+            // can report that without risking recursive failure.
+        }
     }
 }

package/dist/otel-state.d.ts

@@ -0,0 +1,22 @@
+export interface SpanContext {
+    traceId: string;
+    spanId: string;
+    traceFlags: number;
+    traceState?: {
+        serialize(): string;
+    } | null | undefined;
+}
+export interface Span {
+    spanContext(): SpanContext;
+}
+export interface OtelApi {
+    trace: {
+        getActiveSpan(): Span | undefined;
+    };
+}
+export declare function readCachedOtelApi(): OtelApi | null | undefined;
+export declare function cacheOtelApi(api: OtelApi | null): void;
+export declare function readOtelModuleOverride(): OtelApi | null | undefined;
+export declare function setOtelModuleOverride(api: OtelApi | null | undefined): void;
+export declare function resetOtelState(): void;
+//# sourceMappingURL=otel-state.d.ts.map

package/dist/otel-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-state.d.ts","sourceRoot":"","sources":["../src/otel-state.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QAAE,SAAS,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,WAAW,IAAI;IACnB,WAAW,IAAI,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE;QACL,aAAa,IAAI,IAAI,GAAG,SAAS,CAAC;KACnC,CAAC;CACH;AAKD,wBAAgB,iBAAiB,IAAI,OAAO,GAAG,IAAI,GAAG,SAAS,CAE9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAEtD;AAED,wBAAgB,sBAAsB,IAAI,OAAO,GAAG,IAAI,GAAG,SAAS,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE3E;AAED,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/otel-state.js

@@ -0,0 +1,18 @@
+let cachedOtelApi = undefined;
+let otelModuleOverride = undefined;
+export function readCachedOtelApi() {
+    return cachedOtelApi;
+}
+export function cacheOtelApi(api) {
+    cachedOtelApi = api;
+}
+export function readOtelModuleOverride() {
+    return otelModuleOverride;
+}
+export function setOtelModuleOverride(api) {
+    otelModuleOverride = api;
+}
+export function resetOtelState() {
+    cachedOtelApi = undefined;
+    otelModuleOverride = undefined;
+}

package/dist/otel.d.ts

@@ -11,41 +11,6 @@
  *
  * W3C Trace Context spec: https://www.w3.org/TR/trace-context/
  */
-interface SpanContext {
-    traceId: string;
-    spanId: string;
-    traceFlags: number;
-    traceState?: {
-        serialize(): string;
-    } | null;
-}
-interface Span {
-    spanContext(): SpanContext;
-}
-interface OtelApi {
-    trace: {
-        getActiveSpan(): Span | undefined;
-    };
-}
-/**
- * Set the OTel module override for testing. Pass `undefined` to clear.
- * Calling this bypasses dynamic import and require-based detection.
- *
- * @internal — for testing only, do NOT use in production code.
- */
-export declare function setOtelModuleOverride(api: OtelApi | null | undefined): void;
-/**
- * Get the current OTel module override (for test inspection).
- * @internal
- */
-export declare function getOtelModuleOverride(): OtelApi | null | undefined;
-/**
- * Reset both the module-level cache and the test injection seam.
- * Call this in `afterEach` when using `setOtelModuleOverride` in tests.
- *
- * @internal — for testing only.
- */
-export declare function __resetOtelCache(): void;
 /**
  * Inject W3C Trace Context headers (`traceparent`, `tracestate`) if an active
  * OTel span is available. Synchronous; uses require-based detection.
@@ -60,5 +25,4 @@ export declare function injectTraceparent(headers: Record<string, string>): void
  * @param headers - Mutable header record to augment in-place.
  */
 export declare function injectTraceparentAsync(headers: Record<string, string>): Promise<void>;
-export {};
 //# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QAAE,SAAS,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7C;AAED,UAAU,IAAI;IACZ,WAAW,IAAI,WAAW,CAAC;CAC5B;AAED,UAAU,OAAO;IACf,KAAK,EAAE;QACL,aAAa,IAAI,IAAI,GAAG,SAAS,CAAC;KACnC,CAAC;CACH;AAQD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,GAAG,IAAI,GAAG,SAAS,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAoDD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiBvE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3F"}
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4EH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiBvE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3F"}

package/dist/otel.js

@@ -11,84 +11,69 @@
  *
  * W3C Trace Context spec: https://www.w3.org/TR/trace-context/
  */
-/** Cached result of OTel detection. `null` = not available. `undefined` = not yet probed. */
-let otelApi = undefined;
-/** Internal override value for the test injection seam. */
-let _otelModuleOverride = undefined;
-/**
- * Set the OTel module override for testing. Pass `undefined` to clear.
- * Calling this bypasses dynamic import and require-based detection.
- *
- * @internal — for testing only, do NOT use in production code.
- */
-export function setOtelModuleOverride(api) {
-    _otelModuleOverride = api;
-}
-/**
- * Get the current OTel module override (for test inspection).
- * @internal
- */
-export function getOtelModuleOverride() {
-    return _otelModuleOverride;
-}
-/**
- * Reset both the module-level cache and the test injection seam.
- * Call this in `afterEach` when using `setOtelModuleOverride` in tests.
- *
- * @internal — for testing only.
- */
-export function __resetOtelCache() {
-    otelApi = undefined;
-    _otelModuleOverride = undefined;
-}
+import { cacheOtelApi, readCachedOtelApi, readOtelModuleOverride, } from './otel-state.js';
 /**
  * Dynamic import that is opaque to bundlers.
  * `new Function(...)` is not statically analysed for import() specifiers.
  */
 function dynamicImport(moduleName) {
-    // Using Function constructor prevents bundler static analysis of import().
+    // `new Function(...)` is intentional: it prevents bundlers (esbuild, Rollup,
+    // Miniflare/workerd) from statically analysing the import() specifier and either
+    // bundling @opentelemetry/api or raising an unresolvable-specifier error.
+    //
+    // CSP note: `new Function` violates strict `script-src 'self'` Content Security
+    // Policies (equivalent to eval). Call sites must guard with the WorkerGlobalScope /
+    // window checks in probeOtel() so this is never called in restricted browser / worker
+    // environments. In Node.js and non-CSP environments it is safe.
     // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
     return new Function('m', 'return import(m)')(moduleName);
 }
 async function probeOtel() {
-    // Test injection seam takes highest priority.
-    if (_otelModuleOverride !== undefined)
-        return _otelModuleOverride;
-    if (otelApi !== undefined)
-        return otelApi;
+    const override = readOtelModuleOverride();
+    if (override !== undefined)
+        return override;
+    const cached = readCachedOtelApi();
+    if (cached !== undefined)
+        return cached;
+    // skip dynamic import in browser windows AND Service Workers / workerd
+    // (which have no `window` but do have WorkerGlobalScope). The Function constructor
+    // used in dynamicImport violates strict `script-src 'self'` CSPs in workers.
+    if (typeof window !== 'undefined' || 'WorkerGlobalScope' in globalThis) {
+        cacheOtelApi(null);
+        return null;
+    }
     try {
         const mod = await dynamicImport('@opentelemetry/api');
-        otelApi = mod;
+        cacheOtelApi(mod);
     }
-    catch (error) {
-        void error;
-        otelApi = null;
+    catch {
+        cacheOtelApi(null);
     }
-    return otelApi;
+    return readCachedOtelApi() ?? null;
 }
 function probeOtelSync() {
-    // Test injection seam takes highest priority.
-    if (_otelModuleOverride !== undefined)
-        return _otelModuleOverride;
-    if (otelApi !== undefined)
-        return otelApi;
+    const override = readOtelModuleOverride();
+    if (override !== undefined)
+        return override;
+    const cached = readCachedOtelApi();
+    if (cached !== undefined)
+        return cached;
     try {
         // Use globalThis.require via indirect reference to avoid bundler module resolution.
         const nodeRequire = typeof globalThis !== 'undefined'
             ? globalThis.require
             : undefined;
         if (typeof nodeRequire === 'function') {
-            otelApi = nodeRequire('@opentelemetry/api');
+            cacheOtelApi(nodeRequire('@opentelemetry/api'));
         }
         else {
-            otelApi = null;
+            cacheOtelApi(null);
         }
     }
-    catch (error) {
-        void error;
-        otelApi = null;
+    catch {
+        cacheOtelApi(null);
     }
-    return otelApi;
+    return readCachedOtelApi() ?? null;
 }
 function buildTraceparent(ctx) {
     const flags = (ctx.traceFlags & 0xff).toString(16).padStart(2, '0');
@@ -117,9 +102,9 @@ export function injectTraceparent(headers) {
             headers['tracestate'] = traceState;
         }
     }
-    catch (error) {
-        void error;
+    catch {
         // Never let OTel errors propagate into transport logic.
+        return;
     }
 }
 /**
@@ -145,8 +130,8 @@ export async function injectTraceparentAsync(headers) {
             headers['tracestate'] = traceState;
         }
     }
-    catch (error) {
-        void error;
+    catch {
         // Never let OTel errors propagate into transport logic.
+        return;
     }
 }

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@pellux/goodvibes-transport-core",
-  "version": "0.30.2",
+  "version": "0.33.0",
   "engines": {
-    "node": ">=20.0.0"
+    "bun": "1.3.10",
+    "node": ">=22.0.0"
   },
   "description": "Shared GoodVibes client transport primitives for direct, HTTP, and realtime integrations.",
   "type": "module",
@@ -17,6 +18,14 @@
       "types": "./dist/client-transport.d.ts",
       "import": "./dist/client-transport.js"
     },
+    "./direct": {
+      "types": "./dist/direct.d.ts",
+      "import": "./dist/direct.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
+    },
     "./event-envelope": {
       "types": "./dist/event-envelope.d.ts",
       "import": "./dist/event-envelope.js"
@@ -48,7 +57,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@pellux/goodvibes-errors": "0.30.2"
+    "@pellux/goodvibes-errors": "0.33.0"
   },
   "license": "MIT",
   "repository": {