@pellux/goodvibes-transport-core 0.34.2 → 0.36.0

package/README.md

@@ -6,9 +6,25 @@ Most applications should install `@pellux/goodvibes-sdk` and import `@pellux/goo
 
 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
+Key exports:
+- Event envelopes: `createEventEnvelope` (with the `EventEnvelope` / `EventEnvelopeContext` types).
+- Client transport: `createClientTransport`, `createDirectClientTransport`.
+- Middleware: `composeMiddleware` (with the `TransportMiddleware` / `TransportContext` types).
+- Transport error helpers: `transportErrorFromUnknown`, `isAbortError`, `describeUnknownTransportError`.
+- Runtime event feeds: `createRuntimeEventFeed`, `createRuntimeEventFeeds`.
+- Utilities: `createUuidV4`.
+
+```ts
+import {
+  createEventEnvelope,
+  createUuidV4,
+} from '@pellux/goodvibes-sdk/transport-core';
+
+const envelope = createEventEnvelope(
+  'TURN_SUBMITTED',
+  { turnId: createUuidV4(), prompt: 'Hello' },
+  { sessionId: 'sess_abc', source: 'orchestrator' },
+);
+```
 
 Most consumers should use `@pellux/goodvibes-sdk`, `@pellux/goodvibes-sdk/operator`, or `@pellux/goodvibes-sdk/peer` instead.

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

package/dist/middleware.js

@@ -57,8 +57,15 @@ export function composeMiddleware(middleware, innerFetch) {
                 }
                 catch (err) {
                     // Mark that the error originated from this middleware (not the real fetch).
-                    ctx.middlewareError = true;
-                    ctx.activeMiddlewareName = mwName;
+                    // innerFetch sets `ctx.error = err` before rethrowing, so a transport/fetch
+                    // error that merely bubbled up through this middleware is reference-identical
+                    // to `ctx.error`. Only flag errors thrown by the middleware body itself,
+                    // otherwise genuine transport errors would be reclassified and lose their
+                    // HttpStatusError identity (status/category/retryAfterMs), disabling retries.
+                    if (err !== ctx.error) {
+                        ctx.middlewareError = true;
+                        ctx.activeMiddlewareName = mwName;
+                    }
                     throw err;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-transport-core",
-  "version": "0.34.2",
+  "version": "0.36.0",
   "engines": {
     "bun": "1.3.10",
     "node": ">=22.0.0"
@@ -57,7 +57,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@pellux/goodvibes-errors": "0.34.2"
+    "@pellux/goodvibes-errors": "0.36.0"
   },
   "license": "MIT",
   "repository": {