@synnaxlabs/freighter 0.54.0 → 0.56.0

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

package/dist/src/http.d.ts

@@ -16,6 +16,6 @@ export declare class HTTPClient extends MiddlewareCollector implements UnaryClie
     encoder: binary.Codec;
     constructor(endpoint: URL, encoder: binary.Codec, secure?: boolean);
     get headers(): Record<string, string>;
-    send<RQ extends z.ZodType, RS extends z.ZodType = RQ>(target: string, req: z.input<RQ> | z.infer<RQ>, reqSchema: RQ, resSchema: RS): Promise<[z.infer<RS>, null] | [null, Error]>;
+    send<RQ extends z.ZodType, RS extends z.ZodType = RQ>(target: string, req: z.input<RQ> | z.infer<RQ>, reqSchema: RQ, resSchema: RS): Promise<z.infer<RS>>;
 }
 //# sourceMappingURL=http.d.ts.map

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,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAsDhD"}
+{"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"}

package/dist/src/index.d.ts

@@ -2,7 +2,7 @@ export { EOF, StreamClosed, Unreachable } from './errors';
 export { HTTPClient } from './http';
 export { type Context, type Middleware, type Next } from './middleware';
 export { type Stream, type StreamClient } from './stream';
-export { sendRequired, type UnaryClient, unaryWithBreaker } from './unary';
+export { type UnaryClient, unaryWithBreaker } from './unary';
 export { WebSocketClient } from './websocket';
 export { type WebsocketMessage } from './websocket';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/middleware.d.ts

@@ -14,36 +14,40 @@ export interface Context {
 }
 export declare const ROLES: readonly ["client", "server"];
 export type Role = (typeof ROLES)[number];
-/** Next executes the next middleware in the chain. */
-export type Next = (ctx: Context) => Promise<[Context, Error | null]>;
 /**
- * Middleware represents a general middleware function that can be used to
- * parse/attach metadata to a request or alter its behavior.
+ * Next executes the next middleware in the chain, returning the resulting context. It
+ * throws if any downstream middleware or the finalizer throws.
  */
-export type Middleware = (ctx: Context, next: Next) => Promise<[Context, Error | null]>;
+export type Next = (ctx: Context) => Promise<Context>;
 /**
- * Finalizer is a middleware that is executed as the last step in the chain.
- * Finalizer middleware should be used to execute the request.
+ * Middleware represents a general middleware function that can be used to parse/attach
+ * metadata to a request or alter its behavior. It should call next to continue the
+ * chain and may throw to abort the request.
  */
-type Finalizer = (ctx: Context) => Promise<[Context, Error | null]>;
+export type Middleware = (ctx: Context, next: Next) => Promise<Context>;
 /**
- * MiddlewareCollector is a class that can be used to collect and execute
- * middleware in order to implement the Transport interface.
+ * Finalizer is a middleware that is executed as the last step in the chain. Finalizer
+ * middleware should be used to execute the request. It throws if the request fails.
+ */
+type Finalizer = (ctx: Context) => Promise<Context>;
+/**
+ * MiddlewareCollector is a class that can be used to collect and execute middleware in
+ * order to implement the Transport interface.
  */
 export declare class MiddlewareCollector {
     middleware: Middleware[];
     /** Implements the Transport interface */
     use(...mw: Middleware[]): void;
     /**
-     * Executes middleware in order, passing the the metadata to each middleware
-     * until the end of the chain is reached. It then calls the finalizer with the
-     * metadata.
+     * Executes middleware in order, passing the the metadata to each middleware until the
+     * end of the chain is reached. It then calls the finalizer with the metadata.
      *
      * @param ctx - The context to pass to the middleware.
      * @param finalizer - The finalizer to call with the metadata.
-     * @returns An error if one was encountered, otherwise undefined.
+     * @returns The context produced by the chain. Throws if any middleware or the
+     * finalizer throws.
      */
-    executeMiddleware(ctx: Context, finalizer: Finalizer): Promise<[Context, Error | null]>;
+    executeMiddleware(ctx: Context, finalizer: Finalizer): Promise<Context>;
 }
 export {};
 //# sourceMappingURL=middleware.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,KAAK,+BAAgC,CAAC;AACnD,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,sDAAsD;AACtD,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;AAExF;;;GAGG;AACH,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,UAAU,EAAE,UAAU,EAAE,CAAM;IAE9B,yCAAyC;IACzC,GAAG,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,IAAI;IAI9B;;;;;;;;OAQG;IACG,iBAAiB,CACrB,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;CAUpC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,KAAK,+BAAgC,CAAC;AACnD,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAExE;;;GAGG;AACH,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,UAAU,EAAE,UAAU,EAAE,CAAM;IAE9B,yCAAyC;IACzC,GAAG,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,IAAI;IAI9B;;;;;;;;OAQG;IACG,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAU9E"}

package/dist/src/stream.d.ts

@@ -5,15 +5,14 @@ import { Transport } from './transport';
  */
 export interface StreamReceiver<RS extends z.ZodType> {
     /**
-     * Receives a response from the stream. It's not safe to call receive
-     * concurrently.
+     * Receives a response from the stream. It's not safe to call receive concurrently.
      *
-     *  @returns freighter.EOF: if the server closed the stream nominally.
-     *  @returns Error: if the server closed the stream abnormally,
-     *  returns the error the server returned.
-     *  @raises Error: if the transport fails.
+     *  @returns the next response from the stream.
+     *  @throws freighter.EOF: if the server closed the stream nominally.
+     *  @throws Error: if the server closed the stream abnormally, throws the error the
+     *  server returned, or a transport error if the transport itself failed.
      */
-    receive: () => Promise<[z.infer<RS>, null] | [null, Error]>;
+    receive: () => Promise<z.infer<RS>>;
     /**
      * @returns true if the stream has received a response
      */
@@ -24,17 +23,16 @@ export interface StreamReceiver<RS extends z.ZodType> {
  */
 export interface StreamSender<RQ extends z.ZodType> {
     /**
-    * Sends a request to the stream. It is not safe to call send concurrently
-    * with closeSend or send.
+    * Sends a request to the stream. It is not safe to call send concurrently with
+    * closeSend or send.
   
     * @param req -  the request to send.
-    * @returns freighter.EOF: if the server closed the stream. The caller
-    * can discover the error returned by the server by calling receive().
-    * @returns undefined: if the message was sent successfully.
-    * @raises freighter.StreamClosed: if the client called close_send()
-    * @raises Error: if the transport fails.
+    * @throws freighter.EOF: if the server closed the stream. The caller can discover the
+    * error returned by the server by calling receive().
+    * @throws freighter.StreamClosed: if the client called closeSend().
+    * @throws Error: if the transport fails.
     */
-    send: (req: z.input<RQ> | z.infer<RQ>) => Error | null;
+    send: (req: z.input<RQ> | z.infer<RQ>) => void;
 }
 /**
  * Extension of the StreamSender interface that allows the client to close the sending
@@ -42,13 +40,13 @@ export interface StreamSender<RQ extends z.ZodType> {
  */
 export interface StreamSenderCloser<RQ extends z.ZodType> extends StreamSender<RQ> {
     /**
-    * Lets the server know no more messages will be sent. If the client attempts
-    * to call send() after calling closeSend(), a freighter.StreamClosed
-    * exception will be raised. close_send is idempotent. If the server has
-    * already closed the stream, close_send will do nothing.
+    * Lets the server know no more messages will be sent. If the client attempts to call
+    * send() after calling closeSend(), a freighter.StreamClosed exception will be raised.
+    * close_send is idempotent. If the server has already closed the stream, close_send
+    * will do nothing.
   
-    * After calling close_send, the client is responsible for calling receive()
-    * to successfully receive the server's acknowledgement.
+    * After calling close_send, the client is responsible for calling receive() to
+    * successfully receive the server's acknowledgement.
      */
     closeSend: () => void;
 }
@@ -62,15 +60,15 @@ export interface Stream<RQ extends z.ZodType, RS extends z.ZodType = RQ> extends
  */
 export interface StreamClient extends Transport {
     /**
-     * Dials the target and returns a stream that can be used to issue requests
-     * and receive responses
+     * Dials the target and returns a stream that can be used to issue requests and
+     * receive responses
      *
-     * @param target - The target to dial. In some implementations, this may be
-     * an endpoint path, or in others, a complete hostname or URL.
-     * @param reqSchema - The schema for the request type. This is used to
-     * validate the request before sending it.
-     * @param resSchema - The schema for the response type. This is used to
-     * validate the response before returning it.
+     * @param target - The target to dial. In some implementations, this may be an
+     * endpoint path, or in others, a complete hostname or URL.
+     * @param reqSchema - The schema for the request type. This is used to validate the
+     * request before sending it.
+     * @param resSchema - The schema for the response type. This is used to validate the
+     * response before returning it.
      */
     stream: <RQ extends z.ZodType, RS extends z.ZodType = RQ>(target: string, reqSchema: RQ, resSchema: RS) => Promise<Stream<RQ, RS>>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO;IAClD;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAE5D;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO;IAChD;;;;;;;;;;MAUE;IACF,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,GAAG,IAAI,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,CAAE,SAAQ,YAAY,CAAC,EAAE,CAAC;IAChF;;;;;;;;OAQG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,CACrE,SAAQ,kBAAkB,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC;CAAG;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EACtD,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,KACV,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO;IAClD;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO;IAChD;;;;;;;;;MASE;IACF,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,CAAE,SAAQ,YAAY,CAAC,EAAE,CAAC;IAChF;;;;;;;;OAQG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,CACrE,SAAQ,kBAAkB,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC;CAAG;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EACtD,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,KACV,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;CAC9B"}

package/dist/src/unary.d.ts

@@ -2,8 +2,8 @@ import { breaker } from '@synnaxlabs/x';
 import { z } from 'zod';
 import { Transport } from './transport';
 /**
- * An interface for an entity that implements a simple request-response
- * transport between two entities.
+ * An interface for an entity that implements a simple request-response transport
+ * between two entities.
  */
 export interface UnaryClient extends Transport {
     /**
@@ -11,9 +11,10 @@ export interface UnaryClient extends Transport {
      * @param target - The target server to send the request to.
      * @param req - The request to send.
      * @param resSchema - The schema to validate the response against.
+     * @returns the decoded response.
+     * @throws Error: if the server returns an error or the transport fails.
      */
-    send: <RQ extends z.ZodType, RS extends z.ZodType = RQ>(target: string, req: z.input<RQ> | z.infer<RQ>, reqSchema: RQ, resSchema: RS) => Promise<[z.infer<RS>, null] | [null, Error]>;
+    send: <RQ extends z.ZodType, RS extends z.ZodType = RQ>(target: string, req: z.input<RQ> | z.infer<RQ>, reqSchema: RQ, resSchema: RS) => Promise<z.infer<RS>>;
 }
 export declare const unaryWithBreaker: (base: UnaryClient, cfg: breaker.Config) => UnaryClient;
-export declare const sendRequired: <RQ extends z.ZodType, RS extends z.ZodType = RQ>(client: UnaryClient, target: string, req: z.input<RQ> | z.infer<RQ>, reqSchema: RQ, resSchema: RS) => Promise<z.infer<RS>>;
 //# sourceMappingURL=unary.d.ts.map

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;;;;;OAKG;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,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,gBAAgB,GAC3B,MAAM,WAAW,EACjB,KAAK,OAAO,CAAC,MAAM,KAClB,WA6BF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EAChF,QAAQ,WAAW,EACnB,QAAQ,MAAM,EACd,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9B,WAAW,EAAE,EACb,WAAW,EAAE,KACZ,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAIrB,CAAC"}
+{"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/websocket.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAgB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAQ1D,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC1C,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAgHF,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAIxD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,mBAAoB,YAAW,YAAY;IAC9E,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAEhB,MAAM,CAAC,QAAQ,CAAC,YAAY,iBAAiB;IAE7C;;;;OAIG;gBACS,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,UAAQ;IAOpE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,eAAe;IAM/C,6CAA6C;IACvC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EAC1D,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAkB1B,OAAO,CAAC,QAAQ;YAWF,UAAU;CAsBzB"}
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/websocket.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,EAAE,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAgB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAQ1D,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC1C,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AA8GF,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAIxD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,mBAAoB,YAAW,YAAY;IAC9E,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAEhB,MAAM,CAAC,QAAQ,CAAC,YAAY,iBAAiB;IAE7C;;;;OAIG;gBACS,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,UAAQ;IAOpE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,eAAe;IAM/C,6CAA6C;IACvC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,OAAO,GAAG,EAAE,EAC1D,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,EAAE,EACb,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAe1B,OAAO,CAAC,QAAQ;YAWF,UAAU;CAmBzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/freighter",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "type": "module",
   "description": "a modular transport abstraction",
   "repository": "https://github.com/synnaxlabs/synnax/tree/main/freighter/ts",
@@ -14,21 +14,21 @@
     "control systems"
   ],
   "dependencies": {
-    "zod": "^4.3.6",
-    "@synnaxlabs/alamos": "^0.54.0",
-    "@synnaxlabs/x": "^0.54.0"
+    "zod": "^4.4.3",
+    "@synnaxlabs/alamos": "^0.56.0",
+    "@synnaxlabs/x": "^0.56.0"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^4.1.2",
-    "eslint": "^10.1.0",
+    "@types/node": "^25.9.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "eslint": "^10.4.0",
     "madge": "^8.0.0",
-    "typescript": "^6.0.2",
-    "vite": "^8.0.3",
-    "vitest": "^4.1.2",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.13",
+    "vitest": "^4.1.6",
     "@synnaxlabs/eslint-config": "^0.0.0",
-    "@synnaxlabs/vite-plugin": "^0.0.0",
-    "@synnaxlabs/tsconfig": "^0.0.0"
+    "@synnaxlabs/tsconfig": "^0.0.0",
+    "@synnaxlabs/vite-plugin": "^0.0.0"
   },
   "main": "dist/freighter.cjs",
   "module": "dist/freighter.js",

package/src/alamos.ts

@@ -15,18 +15,29 @@ export const middleware =
   (instrumentation: Instrumentation): Middleware =>
   async (context, next) => {
     if (context.role === "client") instrumentation.T.propagate(context.params);
-
-    const [res, exc] = await instrumentation.T.trace(
-      context.target,
-      "debug",
-      async (span): Promise<[Context, Error | null]> => {
-        const [ctx, err] = await next(context);
-        if (err != null) span.recordError(err);
-        return [ctx, err];
-      },
-    );
-    log(context, instrumentation, exc);
-    return [res, exc];
+    try {
+      const res = await instrumentation.T.trace(
+        context.target,
+        "debug",
+        async (span): Promise<Context> => {
+          try {
+            return await next(context);
+          } catch (err) {
+            if (err instanceof Error) span.recordError(err);
+            throw err;
+          }
+        },
+      );
+      log(context, instrumentation, null);
+      return res;
+    } catch (err) {
+      log(
+        context,
+        instrumentation,
+        err instanceof Error ? err : new Error(String(err)),
+      );
+      throw err;
+    }
   };
 
 const log = (

package/src/http.spec.ts

@@ -30,28 +30,19 @@ const messageZ = z.object({
 
 describe("http", () => {
   test("echo", async () => {
-    const [response, error] = await client.send<typeof messageZ>(
+    const response = await client.send(
       "/echo",
-      {
-        id: 1,
-        message: "hello",
-      },
+      { id: 1, message: "hello" },
       messageZ,
       messageZ,
     );
-    expect(error).toBeNull();
     expect(response).toEqual({ id: 2, message: "hello" });
   });
 
   test("not found", async () => {
-    const [response, error] = await client.send<typeof messageZ>(
-      "/not-found",
-      {},
-      messageZ,
-      messageZ,
+    await expect(client.send("/not-found", {}, messageZ, messageZ)).rejects.toThrow(
+      "Not Found",
     );
-    expect(error?.message).toEqual("Not Found");
-    expect(response).toBeNull();
   });
 
   test("middleware", async () => {
@@ -59,34 +50,17 @@ describe("http", () => {
       md.params.Test = "test";
       return await next(md);
     });
-    const [response, error] = await client.send<typeof messageZ>(
-      "/middlewareCheck",
-      {},
-      messageZ,
-      messageZ,
-    );
-    expect(error).toBeNull();
-    expect(response?.message).toEqual("");
+    const response = await client.send("/middlewareCheck", {}, messageZ, messageZ);
+    expect(response.message).toEqual("");
   });
 
   test("unreachable", async () => {
     const c = new HTTPClient(
-      new URL({
-        host: "127.0.0.1",
-        protocol: "http",
-        port: 9999,
-        pathPrefix: "unary",
-      }),
+      new URL({ host: "127.0.0.1", protocol: "http", port: 9999, pathPrefix: "unary" }),
       new binary.JSONCodec(),
     );
-    const [response, error] = await c.send<typeof messageZ>(
-      "/unreachable",
-      {},
-      messageZ,
-      messageZ,
-    );
-    expect(error).toBeInstanceOf(Unreachable);
-    expect(error?.message).toEqual("Unreachable");
-    expect(response).toBeNull();
+    const send = c.send("/unreachable", {}, messageZ, messageZ);
+    await expect(send).rejects.toThrow(Unreachable);
+    await expect(send).rejects.toThrow("Unreachable");
   });
 });

package/src/http.ts

@@ -86,20 +86,20 @@ export class HTTPClient extends MiddlewareCollector implements UnaryClient {
     req: z.input<RQ> | z.infer<RQ>,
     reqSchema: RQ,
     resSchema: RS,
-  ): Promise<[z.infer<RS>, null] | [null, Error]> {
+  ): Promise<z.infer<RS>> {
     let res: z.infer<RS> | null = null;
     const url = this.endpoint.child(target);
     const request: RequestInit = {};
     request.method = "POST";
     request.body = this.encoder.encode(req, reqSchema) as BodyInit;
-    const [, err] = await this.executeMiddleware(
+    await this.executeMiddleware(
       {
         target: url.toString(),
         protocol: this.endpoint.protocol,
         params: {},
         role: "client",
       },
-      async (ctx: Context): Promise<[Context, Error | null]> => {
+      async (ctx: Context): Promise<Context> => {
         const outCtx: Context = { ...ctx, params: {} };
         request.headers = {
           ...this.headers,
@@ -110,34 +110,30 @@ export class HTTPClient extends MiddlewareCollector implements UnaryClient {
           httpRes = await fetch(ctx.target, request);
         } catch (e) {
           if (!(e instanceof Error)) throw e;
-          return [outCtx, shouldCastToUnreachable(e) ? new Unreachable({ url }) : e];
+          throw shouldCastToUnreachable(e) ? new Unreachable({ url }) : e;
         }
         const data = await httpRes.arrayBuffer();
         if (httpRes?.ok) {
           if (resSchema != null) res = this.encoder.decode<RS>(data, resSchema);
-          return [outCtx, null];
+          return outCtx;
         }
+        if (httpRes.status !== HTTP_STATUS_BAD_REQUEST)
+          throw new Error(httpRes.statusText);
+        let decoded: Error | null;
         try {
-          if (httpRes.status !== HTTP_STATUS_BAD_REQUEST)
-            return [outCtx, new Error(httpRes.statusText)];
-          const err = this.encoder.decode(data, errors.payloadZ);
-          const decoded = errors.decode(err);
-          return [outCtx, decoded];
+          decoded = errors.decode(this.encoder.decode(data, errors.payloadZ));
         } catch (e) {
-          return [
-            outCtx,
-            new Error(
-              `[freighter] - failed to decode error: ${httpRes.statusText}: ${
-                (e as Error).message
-              }`,
-            ),
-          ];
+          if (!(e instanceof Error)) throw e;
+          throw new Error(
+            `[freighter] - failed to decode error: ${httpRes.statusText}: ${e.message}`,
+            { cause: e },
+          );
         }
+        throw decoded ?? new Error(httpRes.statusText);
       },
     );
 
-    if (err != null) return [null, err];
     if (res == null) throw new Error("Response must be defined");
-    return [res, null];
+    return res;
   }
 }

package/src/index.ts

@@ -11,6 +11,6 @@ export { EOF, StreamClosed, Unreachable } from "@/errors";
 export { HTTPClient } from "@/http";
 export { type Context, type Middleware, type Next } from "@/middleware";
 export { type Stream, type StreamClient } from "@/stream";
-export { sendRequired, type UnaryClient, unaryWithBreaker } from "@/unary";
+export { type UnaryClient, unaryWithBreaker } from "@/unary";
 export { WebSocketClient } from "@/websocket";
 export { type WebsocketMessage } from "@/websocket";

package/src/middleware.ts

@@ -25,24 +25,28 @@ export interface Context {
 export const ROLES = ["client", "server"] as const;
 export type Role = (typeof ROLES)[number];
 
-/** Next executes the next middleware in the chain. */
-export type Next = (ctx: Context) => Promise<[Context, Error | null]>;
+/**
+ * Next executes the next middleware in the chain, returning the resulting context. It
+ * throws if any downstream middleware or the finalizer throws.
+ */
+export type Next = (ctx: Context) => Promise<Context>;
 
 /**
- * Middleware represents a general middleware function that can be used to
- * parse/attach metadata to a request or alter its behavior.
+ * Middleware represents a general middleware function that can be used to parse/attach
+ * metadata to a request or alter its behavior. It should call next to continue the
+ * chain and may throw to abort the request.
  */
-export type Middleware = (ctx: Context, next: Next) => Promise<[Context, Error | null]>;
+export type Middleware = (ctx: Context, next: Next) => Promise<Context>;
 
 /**
- * Finalizer is a middleware that is executed as the last step in the chain.
- * Finalizer middleware should be used to execute the request.
+ * Finalizer is a middleware that is executed as the last step in the chain. Finalizer
+ * middleware should be used to execute the request. It throws if the request fails.
  */
-type Finalizer = (ctx: Context) => Promise<[Context, Error | null]>;
+type Finalizer = (ctx: Context) => Promise<Context>;
 
 /**
- * MiddlewareCollector is a class that can be used to collect and execute
- * middleware in order to implement the Transport interface.
+ * MiddlewareCollector is a class that can be used to collect and execute middleware in
+ * order to implement the Transport interface.
  */
 export class MiddlewareCollector {
   middleware: Middleware[] = [];
@@ -53,20 +57,17 @@ export class MiddlewareCollector {
   }
 
   /**
-   * Executes middleware in order, passing the the metadata to each middleware
-   * until the end of the chain is reached. It then calls the finalizer with the
-   * metadata.
+   * Executes middleware in order, passing the the metadata to each middleware until the
+   * end of the chain is reached. It then calls the finalizer with the metadata.
    *
    * @param ctx - The context to pass to the middleware.
    * @param finalizer - The finalizer to call with the metadata.
-   * @returns An error if one was encountered, otherwise undefined.
+   * @returns The context produced by the chain. Throws if any middleware or the
+   * finalizer throws.
    */
-  async executeMiddleware(
-    ctx: Context,
-    finalizer: Finalizer,
-  ): Promise<[Context, Error | null]> {
+  async executeMiddleware(ctx: Context, finalizer: Finalizer): Promise<Context> {
     let i = 0;
-    const next = async (md: Context): Promise<[Context, Error | null]> => {
+    const next = async (md: Context): Promise<Context> => {
       if (i === this.middleware.length) return await finalizer(md);
       const _mw = this.middleware[i];
       i++;