@synnaxlabs/freighter 0.56.0 → 0.56.1

package/dist/src/alamos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alamos.d.ts","sourceRoot":"","sources":["../../src/alamos.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7D,eAAO,MAAM,UAAU,GACpB,iBAAiB,eAAe,KAAG,UA0BnC,CAAC"}
+{"version":3,"file":"alamos.d.ts","sourceRoot":"","sources":["../../src/alamos.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7D,eAAO,MAAM,UAAU,GACpB,iBAAiB,eAAe,KAAG,UAuBnC,CAAC"}

package/dist/src/errors.d.ts

@@ -25,6 +25,9 @@ export declare class StreamClosed extends StreamClosed_base {
 export interface UnreachableArgs {
     message?: string;
     url?: URL;
+    /** Underlying error that caused the target to be unreachable (e.g. the original fetch
+     * failure). Preserved on Error.cause for stack-trace continuity. */
+    cause?: unknown;
 }
 declare const Unreachable_base: errors.TypedClass;
 /** Thrown when a network target is unreachable. */

package/dist/src/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;;AAE5C;;GAEG;AACH,qBAAa,cAAe,SAAQ,mBAA+B;CAAG;;AAEtE;;GAEG;AACH,qBAAa,GAAI,SAAQ,QAAyB;;CAIjD;;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,iBAAmC;;CAIpE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;;AAED,mDAAmD;AACnD,qBAAa,WAAY,SAAQ,gBAAiC;IAChE,GAAG,EAAE,GAAG,CAAC;gBAEG,IAAI,GAAE,eAAoB;CAKvC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;;AAE5C;;GAEG;AACH,qBAAa,cAAe,SAAQ,mBAA+B;CAAG;;AAEtE;;GAEG;AACH,qBAAa,GAAI,SAAQ,QAAyB;;CAIjD;;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,iBAAmC;;CAIpE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;wEACoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;;AAED,mDAAmD;AACnD,qBAAa,WAAY,SAAQ,gBAAiC;IAChE,GAAG,EAAE,GAAG,CAAC;gBAEG,IAAI,GAAE,eAAoB;CAKvC"}

package/dist/src/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,MAAM,EAAU,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,EAAgB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAWtD,eAAO,MAAM,uBAAuB,GAAI,KAAK,KAAK,KAAG,OAsBpD,CAAC;AAIF;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,mBAAoB,YAAW,WAAW;IACxE,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;gBAEV,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAE,OAAe;IAazE,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIpC;IAEK,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EACxD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9B,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CAkDxB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,MAAM,EAAU,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,EAAgB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAWtD,eAAO,MAAM,uBAAuB,GAAI,KAAK,KAAK,KAAG,OAsBpD,CAAC;AAIF;;;;;;GAMG;AACH,qBAAa,UAAW,SAAQ,mBAAoB,YAAW,WAAW;IACxE,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;gBAEV,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAE,OAAe;IAazE,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIpC;IAEK,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EACxD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9B,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;CA2DxB"}

package/dist/src/unary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unary.d.ts","sourceRoot":"","sources":["../../src/unary.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C;;;;;;;OAOG;IACH,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EACpD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9B,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,KACV,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,GAC3B,MAAM,WAAW,EACjB,KAAK,OAAO,CAAC,MAAM,KAClB,WA+BF,CAAC"}
+{"version":3,"file":"unary.d.ts","sourceRoot":"","sources":["../../src/unary.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAU,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C;;;;;;;OAOG;IACH,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EACpD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9B,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,KACV,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3B;AAED,eAAO,MAAM,gBAAgB,GAC3B,MAAM,WAAW,EACjB,KAAK,OAAO,CAAC,MAAM,KAClB,WAgCF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/freighter",
-  "version": "0.56.0",
+  "version": "0.56.1",
   "type": "module",
   "description": "a modular transport abstraction",
   "repository": "https://github.com/synnaxlabs/synnax/tree/main/freighter/ts",
@@ -16,7 +16,7 @@
   "dependencies": {
     "zod": "^4.4.3",
     "@synnaxlabs/alamos": "^0.56.0",
-    "@synnaxlabs/x": "^0.56.0"
+    "@synnaxlabs/x": "^0.56.1"
   },
   "devDependencies": {
     "@types/node": "^25.9.0",

package/src/alamos.ts

@@ -8,6 +8,7 @@
 // included in the file licenses/APL.txt.
 
 import { type Instrumentation } from "@synnaxlabs/alamos";
+import { errors } from "@synnaxlabs/x";
 
 import { type Context, type Middleware } from "@/middleware";
 
@@ -24,19 +25,16 @@ export const middleware =
             return await next(context);
           } catch (err) {
             if (err instanceof Error) span.recordError(err);
-            throw err;
+            throw errors.fromUnknown(err);
           }
         },
       );
       log(context, instrumentation, null);
       return res;
     } catch (err) {
-      log(
-        context,
-        instrumentation,
-        err instanceof Error ? err : new Error(String(err)),
-      );
-      throw err;
+      const e = errors.fromUnknown(err);
+      log(context, instrumentation, e);
+      throw e;
     }
   };
 

package/src/errors.ts

@@ -38,6 +38,9 @@ export class StreamClosed extends FreighterError.sub("stream_closed") {
 export interface UnreachableArgs {
   message?: string;
   url?: URL;
+  /** Underlying error that caused the target to be unreachable (e.g. the original fetch
+   * failure). Preserved on Error.cause for stack-trace continuity. */
+  cause?: unknown;
 }
 
 /** Thrown when a network target is unreachable. */
@@ -45,8 +48,8 @@ export class Unreachable extends FreighterError.sub("unreachable") {
   url: URL;
 
   constructor(args: UnreachableArgs = {}) {
-    const { message = "Unreachable", url = URL.UNKNOWN } = args;
-    super(message);
+    const { message = "Unreachable", url = URL.UNKNOWN, cause } = args;
+    super(message, cause !== undefined ? { cause } : undefined);
     this.url = url;
   }
 }

package/src/http.ts

@@ -109,8 +109,10 @@ export class HTTPClient extends MiddlewareCollector implements UnaryClient {
         try {
           httpRes = await fetch(ctx.target, request);
         } catch (e) {
-          if (!(e instanceof Error)) throw e;
-          throw shouldCastToUnreachable(e) ? new Unreachable({ url }) : e;
+          const err = errors.fromUnknown(e);
+          throw shouldCastToUnreachable(err)
+            ? new Unreachable({ url, cause: err })
+            : err;
         }
         const data = await httpRes.arrayBuffer();
         if (httpRes?.ok) {
@@ -118,18 +120,25 @@ export class HTTPClient extends MiddlewareCollector implements UnaryClient {
           return outCtx;
         }
         if (httpRes.status !== HTTP_STATUS_BAD_REQUEST)
-          throw new Error(httpRes.statusText);
+          throw new Error(
+            `[freighter] HTTP ${httpRes.status} from ${ctx.target}: ${httpRes.statusText}`,
+          );
         let decoded: Error | null;
         try {
           decoded = errors.decode(this.encoder.decode(data, errors.payloadZ));
         } catch (e) {
-          if (!(e instanceof Error)) throw e;
+          const err = errors.fromUnknown(e);
           throw new Error(
-            `[freighter] - failed to decode error: ${httpRes.statusText}: ${e.message}`,
+            `[freighter] - failed to decode error: ${httpRes.statusText}: ${err.message}`,
             { cause: e },
           );
         }
-        throw decoded ?? new Error(httpRes.statusText);
+        throw (
+          decoded ??
+          new Error(
+            `[freighter] HTTP ${httpRes.status} from ${ctx.target}: ${httpRes.statusText}`,
+          )
+        );
       },
     );
 

package/src/unary.ts

@@ -7,7 +7,7 @@
 // License, use of this software will be governed by the Apache License, Version 2.0,
 // included in the file licenses/APL.txt.
 
-import { breaker } from "@synnaxlabs/x";
+import { breaker, errors } from "@synnaxlabs/x";
 import { type z } from "zod";
 
 import { Unreachable } from "@/errors";
@@ -61,9 +61,10 @@ export const unaryWithBreaker = (
         try {
           return await this.wrapped.send(target, req, reqSchema, resSchema);
         } catch (err) {
-          if (!Unreachable.matches(err)) throw err;
-          console.warn(`[freighter] ${brk.retryMessage}`, err);
-          if (!(await brk.wait())) throw err;
+          const e = errors.fromUnknown(err);
+          if (!Unreachable.matches(e)) throw e;
+          console.warn(`[freighter] ${brk.retryMessage}`, e);
+          if (!(await brk.wait())) throw e;
         }
       while (true);
     }

package/src/websocket.ts

@@ -210,11 +210,11 @@ export class WebSocketClient extends MiddlewareCollector implements StreamClient
         oWs
           .receiveOpenAck()
           .then(() => resolve(oWs))
-          .catch((err: Error) => reject(err));
+          .catch((err: unknown) => reject(errors.fromUnknown(err)));
       };
       ws.onerror = (ev: Event) => {
         const ev_ = ev as ErrorEvent;
-        reject(new Error(ev_.message));
+        reject(new Error(ev_.message ?? "websocket error", { cause: ev_.error ?? ev }));
       };
     });
   }