@pellux/goodvibes-transport-core 0.18.3 → 0.30.1

package/README.md

@@ -1,18 +1,14 @@
 # @pellux/goodvibes-transport-core
 
-Shared client transport and event-feed primitives used by the GoodVibes SDK packages.
+Internal workspace package backing `@pellux/goodvibes-sdk/transport-core`.
 
-Install:
+Consumers should install `@pellux/goodvibes-sdk` and import this surface from the umbrella package.
 
-```bash
-npm install @pellux/goodvibes-transport-core
-```
-
-Use this package only when you are composing your own transport/client abstraction.
+Use this surface only when you are composing your own transport/client abstraction.
 
 Exports include:
 - event envelope helpers
 - runtime event feed primitives
 - generic client transport helpers
 
-Most consumers should use `@pellux/goodvibes-sdk`, `@pellux/goodvibes-operator-sdk`, or `@pellux/goodvibes-peer-sdk` instead.
+Most consumers should use `@pellux/goodvibes-sdk`, `@pellux/goodvibes-sdk/operator`, or `@pellux/goodvibes-sdk/peer` instead.

package/dist/client-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-transport.d.ts","sourceRoot":"","sources":["../src/client-transport.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iBAAiB,IAAI,SAAS,CAAC;IAC/B,aAAa,IAAI,KAAK,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,EAC1E,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAY1C"}
+{"version":3,"file":"client-transport.d.ts","sourceRoot":"","sources":["../src/client-transport.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iBAAiB,IAAI,SAAS,CAAC;IAC/B,aAAa,IAAI,KAAK,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,EAC1E,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAY1C"}

package/dist/direct.d.ts

@@ -0,0 +1,4 @@
+import { type ClientTransport } from './client-transport.js';
+export type DirectClientTransport<TOperator, TPeer> = ClientTransport<'direct', TOperator, TPeer>;
+export declare function createDirectClientTransport<TOperator, TPeer>(operator: TOperator, peer: TPeer): DirectClientTransport<TOperator, TPeer>;
+//# sourceMappingURL=direct.d.ts.map

package/dist/direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct.d.ts","sourceRoot":"","sources":["../src/direct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,MAAM,qBAAqB,CAAC,SAAS,EAAE,KAAK,IAAI,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAElG,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,KAAK,EAC1D,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,KAAK,GACV,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,CAEzC"}

package/dist/direct.js

@@ -0,0 +1,4 @@
+import { createClientTransport } from './client-transport.js';
+export function createDirectClientTransport(operator, peer) {
+    return createClientTransport('direct', operator, peer);
+}

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+export declare function isAbortError(error: unknown): boolean;
+export declare function describeUnknownTransportError(error: unknown): string;
+export declare function transportErrorFromUnknown(error: unknown, context: string): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +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"}

package/dist/errors.js

@@ -0,0 +1,45 @@
+import { GoodVibesSdkError } from '@pellux/goodvibes-errors';
+export function isAbortError(error) {
+    return Boolean(error
+        && typeof error === 'object'
+        && 'name' in error
+        && error.name === 'AbortError');
+}
+export function describeUnknownTransportError(error) {
+    if (typeof error === 'string')
+        return error;
+    if (typeof error === 'number' || typeof error === 'boolean' || error === null || error === undefined) {
+        return String(error);
+    }
+    if (typeof error !== 'object')
+        return String(error);
+    const record = error;
+    const nested = record.error;
+    const nestedMessage = nested instanceof Error
+        ? nested.message
+        : nested && typeof nested === 'object' && typeof nested.message === 'string'
+            ? nested.message
+            : undefined;
+    const target = record.target && typeof record.target === 'object'
+        ? `[target:${record.target.constructor?.name ?? 'object'}]`
+        : undefined;
+    const fields = [
+        typeof record.name === 'string' ? `name=${record.name}` : undefined,
+        typeof record.type === 'string' ? `type=${record.type}` : undefined,
+        typeof record.message === 'string' ? `message=${record.message}` : undefined,
+        typeof record.reason === 'string' ? `reason=${record.reason}` : undefined,
+        typeof record.code === 'number' ? `code=${record.code}` : undefined,
+        nestedMessage ? `error=${nestedMessage}` : undefined,
+        target,
+    ].filter(Boolean);
+    return fields.length > 0 ? fields.join(' ') : Object.prototype.toString.call(error);
+}
+export function transportErrorFromUnknown(error, context) {
+    if (error instanceof Error)
+        return error;
+    return new GoodVibesSdkError(`${context}: ${describeUnknownTransportError(error)}`, {
+        category: 'network',
+        source: 'transport',
+        recoverable: true,
+    });
+}

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

@@ -1 +1 @@
-{"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,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;AAMD,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":"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"}

package/dist/event-envelope.js

@@ -1,11 +1,9 @@
-function generateTraceId() {
-    return crypto.randomUUID();
-}
+import { createUuidV4 } from './uuid.js';
 export function createEventEnvelope(type, payload, context) {
     return Object.freeze({
         type,
         ts: Date.now(),
-        traceId: context.traceId ?? generateTraceId(),
+        traceId: context.traceId ?? createUuidV4(),
         sessionId: context.sessionId,
         turnId: context.turnId,
         agentId: context.agentId,

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

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

package/dist/index.d.ts

@@ -4,4 +4,13 @@ export type { RuntimeEventFeed, RuntimeEventFeeds, EnvelopeSubscriber } from './
 export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
 export type { ClientTransport } from './client-transport.js';
 export { createClientTransport } from './client-transport.js';
+export type { DirectClientTransport } from './direct.js';
+export { createDirectClientTransport } from './direct.js';
+export type { TransportObserver, TransportActivityInfo } from './observer.js';
+export { invokeTransportObserver } from './observer.js';
+export type { TransportContext, TransportMiddleware } from './middleware.js';
+export { composeMiddleware } from './middleware.js';
+export { injectTraceparent, injectTraceparentAsync } from './otel.js';
+export { createUuidV4 } from './uuid.js';
+export { describeUnknownTransportError, isAbortError, transportErrorFromUnknown } from './errors.js';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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"}

package/dist/index.js

@@ -1,3 +1,9 @@
 export { createEventEnvelope } from './event-envelope.js';
 export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
 export { createClientTransport } from './client-transport.js';
+export { createDirectClientTransport } from './direct.js';
+export { invokeTransportObserver } from './observer.js';
+export { composeMiddleware } from './middleware.js';
+export { injectTraceparent, injectTraceparentAsync } from './otel.js';
+export { createUuidV4 } from './uuid.js';
+export { describeUnknownTransportError, isAbortError, transportErrorFromUnknown } from './errors.js';

package/dist/middleware.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Transport middleware (Koa-style) for the HTTP transport layer.
+ *
+ * Middleware functions wrap the real fetch call and receive a mutable context
+ * object. Calling `next()` executes the next middleware in the chain (or the
+ * real fetch at the end). After `await next()` returns, `ctx.response` and
+ * `ctx.durationMs` are populated; `ctx.error` is set if the fetch threw.
+ *
+ * @example
+ * sdk.use(async (ctx, next) => {
+ *   console.log('->', ctx.method, ctx.url);
+ *   await next();
+ *   console.log('<-', ctx.response?.status, ctx.durationMs, 'ms');
+ * });
+ */
+/**
+ * Mutable context object passed through the middleware chain.
+ * Fields are populated progressively: request fields are set before the chain
+ * runs; response fields are set after the real fetch resolves.
+ */
+export interface TransportContext {
+    /** HTTP method (uppercased). */
+    method: string;
+    /** Fully-qualified request URL. */
+    url: string;
+    /** Request headers (mutable — middleware may add/override). */
+    headers: Record<string, string>;
+    /** Request body (undefined for GET/HEAD). */
+    body: unknown;
+    /** Per-request options forwarded from the caller. */
+    options: {
+        readonly signal?: AbortSignal;
+        readonly retry?: unknown;
+        [key: string]: unknown;
+    };
+    /** AbortSignal for the request. Propagated from caller options. */
+    signal?: AbortSignal;
+    /** The HTTP response object — set after `next()` resolves successfully. */
+    response?: Response;
+    /** Round-trip duration in milliseconds — set after `next()` resolves. */
+    durationMs?: number;
+    /** Error thrown by the fetch or a downstream middleware — set on failure. */
+    error?: unknown;
+    /**
+     * 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;
+    /**
+     * Name (or index) of the middleware that was active when the error occurred.
+     * Set alongside `middlewareError` for error identity in cause objects.
+     */
+    activeMiddlewareName?: string;
+}
+/**
+ * A transport middleware function.
+ *
+ * @param ctx  - Shared mutable context for the request/response cycle.
+ * @param next - Calls the next middleware (or the real fetch at the end).
+ */
+export type TransportMiddleware = (ctx: TransportContext, next: () => Promise<void>) => Promise<void>;
+/**
+ * Build a composed middleware executor from an ordered array of middleware.
+ * The last item in the chain calls the real fetch via `innerFetch`.
+ *
+ * Returns a function that:
+ *  1. Mutates `ctx.headers` with any header overrides from middleware.
+ *  2. Calls through the chain.
+ *  3. Sets `ctx.response`, `ctx.durationMs`, or `ctx.error` on the context.
+ *
+ * @param middleware - Ordered list of middleware functions.
+ * @param innerFetch - The real fetch call wrapped at the end of the chain.
+ */
+export declare function composeMiddleware(middleware: readonly TransportMiddleware[], innerFetch: (ctx: TransportContext) => Promise<Response>): (ctx: TransportContext) => Promise<void>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +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"}

package/dist/middleware.js

@@ -0,0 +1,71 @@
+import { GoodVibesSdkError } from '@pellux/goodvibes-errors';
+const MAX_MIDDLEWARE_DEPTH = 128;
+/**
+ * Build a composed middleware executor from an ordered array of middleware.
+ * The last item in the chain calls the real fetch via `innerFetch`.
+ *
+ * Returns a function that:
+ *  1. Mutates `ctx.headers` with any header overrides from middleware.
+ *  2. Calls through the chain.
+ *  3. Sets `ctx.response`, `ctx.durationMs`, or `ctx.error` on the context.
+ *
+ * @param middleware - Ordered list of middleware functions.
+ * @param innerFetch - The real fetch call wrapped at the end of the chain.
+ */
+export function composeMiddleware(middleware, innerFetch) {
+    if (middleware.length > MAX_MIDDLEWARE_DEPTH) {
+        throw new GoodVibesSdkError(`Transport middleware chain exceeds the maximum depth of ${MAX_MIDDLEWARE_DEPTH}.`, {
+            category: 'config',
+            source: 'transport',
+            recoverable: false,
+        });
+    }
+    return async (ctx) => {
+        let index = -1;
+        const dispatch = async (i) => {
+            if (i > MAX_MIDDLEWARE_DEPTH) {
+                throw new GoodVibesSdkError(`Transport middleware recursion exceeded the maximum depth of ${MAX_MIDDLEWARE_DEPTH}.`, {
+                    category: 'internal',
+                    source: 'transport',
+                    recoverable: false,
+                });
+            }
+            if (i <= index) {
+                throw new GoodVibesSdkError('next() called multiple times in transport middleware', {
+                    category: 'protocol',
+                    source: 'transport',
+                    recoverable: false,
+                });
+            }
+            index = i;
+            if (i < middleware.length) {
+                const mw = middleware[i];
+                const mwName = mw.name || String(i);
+                ctx.activeMiddlewareName = mwName;
+                try {
+                    await mw(ctx, () => dispatch(i + 1));
+                }
+                catch (err) {
+                    // Mark that the error originated from this middleware (not the real fetch).
+                    ctx.middlewareError = true;
+                    ctx.activeMiddlewareName = mwName;
+                    throw err;
+                }
+            }
+            else {
+                // End of chain — execute the real fetch.
+                const sendAt = Date.now();
+                try {
+                    ctx.response = await innerFetch(ctx);
+                    ctx.durationMs = Date.now() - sendAt;
+                }
+                catch (err) {
+                    ctx.error = err;
+                    ctx.durationMs = Date.now() - sendAt;
+                    throw err;
+                }
+            }
+        };
+        await dispatch(0);
+    };
+}

package/dist/observer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+export interface TransportActivityInfo {
+    /** Direction: `'send'` before the request, `'recv'` after a response. */
+    readonly direction: 'send' | 'recv';
+    /** The full URL of the request. */
+    readonly url: string;
+    /** HTTP response status code (only present on `'recv'`). */
+    readonly status?: number;
+    /** Round-trip duration in milliseconds (only present on `'recv'`). */
+    readonly durationMs?: number;
+    /** Transport kind. */
+    readonly kind?: 'http' | 'sse' | 'ws';
+}
+/**
+ * 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.
+ */
+export interface TransportObserver {
+    /**
+     * Called when the SDK catches and is about to rethrow a transport error.
+     * The error is still rethrown; this is notification only.
+     */
+    onError?(err: Error): void;
+    /**
+     * Called at HTTP/SSE/WebSocket transport boundaries.
+     * - `'send'` fires before the request is dispatched.
+     * - `'recv'` fires after a response is received (status + duration included).
+     */
+    onTransportActivity?(activity: TransportActivityInfo): void;
+}
+/**
+ * Safely invoke an observer method. Observer errors are swallowed so they
+ * never disrupt transport control flow.
+ *
+ * @param fn - Zero-argument thunk wrapping the observer call.
+ */
+export declare function invokeTransportObserver(fn: () => void): void;
+//# sourceMappingURL=observer.d.ts.map

package/dist/observer.d.ts.map

@@ -0,0 +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"}

package/dist/observer.js

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+/**
+ * Safely invoke an observer method. Observer errors are swallowed so they
+ * never disrupt transport control flow.
+ *
+ * @param fn - Zero-argument thunk wrapping the observer call.
+ */
+export function invokeTransportObserver(fn) {
+    try {
+        fn();
+    }
+    catch (error) {
+        void error;
+        // Observer errors must not propagate into transport logic.
+    }
+}

package/dist/otel.d.ts

@@ -0,0 +1,64 @@
+/**
+ * OpenTelemetry traceparent/tracestate propagation helper.
+ *
+ * Zero-dependency: detects `@opentelemetry/api` at runtime.
+ * If OTel is absent, all functions are no-ops.
+ *
+ * Dynamic detection uses an indirect import pattern to prevent bundlers
+ * (esbuild, Rollup, Miniflare/workerd) from flagging the import as an
+ * unresolvable dynamic specifier. The module name is never a literal in
+ * any import() call that the bundler sees.
+ *
+ * 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.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export declare function injectTraceparent(headers: Record<string, string>): void;
+/**
+ * Async variant — probes OTel via dynamic import on first call, then caches.
+ * Use for SSE/WS connection setup where async is acceptable.
+ *
+ * @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

@@ -0,0 +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"}

package/dist/otel.js

@@ -0,0 +1,152 @@
+/**
+ * OpenTelemetry traceparent/tracestate propagation helper.
+ *
+ * Zero-dependency: detects `@opentelemetry/api` at runtime.
+ * If OTel is absent, all functions are no-ops.
+ *
+ * Dynamic detection uses an indirect import pattern to prevent bundlers
+ * (esbuild, Rollup, Miniflare/workerd) from flagging the import as an
+ * unresolvable dynamic specifier. The module name is never a literal in
+ * any import() call that the bundler sees.
+ *
+ * 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;
+}
+/**
+ * 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().
+    // 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;
+    try {
+        const mod = await dynamicImport('@opentelemetry/api');
+        otelApi = mod;
+    }
+    catch (error) {
+        void error;
+        otelApi = null;
+    }
+    return otelApi;
+}
+function probeOtelSync() {
+    // Test injection seam takes highest priority.
+    if (_otelModuleOverride !== undefined)
+        return _otelModuleOverride;
+    if (otelApi !== undefined)
+        return otelApi;
+    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');
+        }
+        else {
+            otelApi = null;
+        }
+    }
+    catch (error) {
+        void error;
+        otelApi = null;
+    }
+    return otelApi;
+}
+function buildTraceparent(ctx) {
+    const flags = (ctx.traceFlags & 0xff).toString(16).padStart(2, '0');
+    return `00-${ctx.traceId}-${ctx.spanId}-${flags}`;
+}
+/**
+ * Inject W3C Trace Context headers (`traceparent`, `tracestate`) if an active
+ * OTel span is available. Synchronous; uses require-based detection.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export function injectTraceparent(headers) {
+    const api = probeOtelSync();
+    if (!api)
+        return;
+    try {
+        const span = api.trace.getActiveSpan();
+        if (!span)
+            return;
+        const ctx = span.spanContext();
+        if (!ctx.traceId || !ctx.spanId)
+            return;
+        headers['traceparent'] = buildTraceparent(ctx);
+        const traceState = ctx.traceState?.serialize();
+        if (traceState) {
+            headers['tracestate'] = traceState;
+        }
+    }
+    catch (error) {
+        void error;
+        // Never let OTel errors propagate into transport logic.
+    }
+}
+/**
+ * Async variant — probes OTel via dynamic import on first call, then caches.
+ * Use for SSE/WS connection setup where async is acceptable.
+ *
+ * @param headers - Mutable header record to augment in-place.
+ */
+export async function injectTraceparentAsync(headers) {
+    const api = await probeOtel();
+    if (!api)
+        return;
+    try {
+        const span = api.trace.getActiveSpan();
+        if (!span)
+            return;
+        const ctx = span.spanContext();
+        if (!ctx.traceId || !ctx.spanId)
+            return;
+        headers['traceparent'] = buildTraceparent(ctx);
+        const traceState = ctx.traceState?.serialize();
+        if (traceState) {
+            headers['tracestate'] = traceState;
+        }
+    }
+    catch (error) {
+        void error;
+        // Never let OTel errors propagate into transport logic.
+    }
+}

package/dist/uuid.d.ts

@@ -0,0 +1,2 @@
+export declare function createUuidV4(): string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,IAAI,MAAM,CAmBrC"}

package/dist/uuid.js

@@ -0,0 +1,22 @@
+import { GoodVibesSdkError } from '@pellux/goodvibes-errors';
+export function createUuidV4() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {
+        crypto.getRandomValues(bytes);
+    }
+    else {
+        throw new GoodVibesSdkError('Secure random UUID generation is unavailable in this runtime.', {
+            category: 'config',
+            source: 'transport',
+            recoverable: false,
+            hint: 'Run GoodVibes in a runtime with crypto.randomUUID() or crypto.getRandomValues().',
+        });
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@pellux/goodvibes-transport-core",
-  "version": "0.18.3",
+  "version": "0.30.1",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "description": "Shared GoodVibes client transport primitives for direct, HTTP, and realtime integrations.",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,12 +13,43 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./client-transport": {
+      "types": "./dist/client-transport.d.ts",
+      "import": "./dist/client-transport.js"
+    },
+    "./event-envelope": {
+      "types": "./dist/event-envelope.d.ts",
+      "import": "./dist/event-envelope.js"
+    },
+    "./event-feeds": {
+      "types": "./dist/event-feeds.d.ts",
+      "import": "./dist/event-feeds.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js"
+    },
+    "./observer": {
+      "types": "./dist/observer.d.ts",
+      "import": "./dist/observer.js"
+    },
+    "./otel": {
+      "types": "./dist/otel.d.ts",
+      "import": "./dist/otel.js"
+    },
+    "./uuid": {
+      "types": "./dist/uuid.d.ts",
+      "import": "./dist/uuid.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist"
   ],
   "sideEffects": false,
+  "dependencies": {
+    "@pellux/goodvibes-errors": "0.30.1"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",