@liphium/neoroute-ts 0.1.0

package/dist/src/transporter/transporter_websocket.js

@@ -0,0 +1,93 @@
+import { logger } from '../logger.js';
+export class WebSocketTransporter {
+    conn = null;
+    receiver;
+    options;
+    connected = false;
+    queue = [];
+    constructor(receiver, options) {
+        this.receiver = receiver;
+        this.options = options;
+    }
+    /// Will start a connection to the server. Will not block until the connection is open.
+    ///
+    /// All things sent before the connection is open are queued, so feel free to send already after calling connect.
+    connect(url) {
+        if (this.connected || this.conn) {
+            return;
+        }
+        // Queue outgoing messages until connection is open
+        this.receiver.setSendFunc(async (data) => {
+            if (this.connected && this.conn?.readyState === WebSocket.OPEN) {
+                this.conn.send(data); // TODO: Find out if this is actually fine xd
+            }
+            else {
+                this.queue.push(data);
+            }
+        });
+        // Add a timeout to make sure the connection actually happens
+        const timeout = setTimeout(() => {
+            if (this.conn?.readyState !== WebSocket.OPEN) {
+                this.close('connection timeout');
+            }
+        }, this.options.connectionTimeout ?? 20000);
+        // Init WebSocket to open the actual connection
+        this.conn = new WebSocket(url);
+        this.conn.binaryType = 'arraybuffer';
+        this.conn.onopen = () => {
+            if (!this.conn)
+                return;
+            clearTimeout(timeout);
+            this.connected = true;
+            // Call onOpen callback
+            this.options.onOpen?.();
+            // Flush queue
+            while (this.queue.length > 0) {
+                const data = this.queue.shift();
+                if (data) {
+                    this.conn.send(data);
+                }
+            }
+        };
+        // When there is an error, we immediately disconnect
+        this.conn.onerror = () => {
+            if (this.conn) {
+                this.close('websocket error');
+            }
+        };
+        // Even on a close, we want to quickly close the thingy to notify the event handler for onError and update internal state
+        this.conn.onclose = (event) => {
+            if (this.conn) {
+                this.close(`websocket connection closed: ${event.code} ${event.reason}`);
+            }
+        };
+        // Forward messages to the receiver
+        this.conn.onmessage = (event) => {
+            if (event.data instanceof ArrayBuffer) {
+                this.receiver.handle(new Uint8Array(event.data));
+            }
+            else {
+                // If we get this, the browser is doing something weird
+                logger.error('wrong message type received:', typeof event.data);
+                this.close('wrong kind of message received');
+            }
+        };
+    }
+    /// Closes the connection to the server. Will not throw if the connection is already closed.
+    close(reason = 'Connection closed') {
+        const wasConnected = this.connected || !!this.conn;
+        this.connected = false;
+        if (this.conn) {
+            const c = this.conn;
+            this.conn = null;
+            c.close(1000, reason);
+        }
+        if (wasConnected) {
+            this.receiver.getConfig().errorHandler(new Error(reason));
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=transporter_websocket.js.map

package/dist/src/transporter/transporter_websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transporter_websocket.js","sourceRoot":"","sources":["../../../src/transporter/transporter_websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAWtC,MAAM,OAAO,oBAAoB;IACxB,IAAI,GAAqB,IAAI,CAAC;IAC9B,QAAQ,CAAW;IACnB,OAAO,CAAmB;IAC1B,SAAS,GAAY,KAAK,CAAC;IAC3B,KAAK,GAAiB,EAAE,CAAC;IAEjC,YAAY,QAAkB,EAAE,OAAyB;QACxD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,uFAAuF;IACvF,GAAG;IACH,iHAAiH;IAC1G,OAAO,CAAC,GAAW;QACzB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO;QACR,CAAC;QAED,mDAAmD;QACnD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,IAAgB,EAAiB,EAAE;YACnE,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBAChE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAW,CAAC,CAAC,CAAC,6CAA6C;YAC3E,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,6DAA6D;QAC7D,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,IAAI,IAAI,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC9C,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAClC,CAAC;QACF,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC;QAE5C,+CAA+C;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC;QAErC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE;YACvB,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,OAAO;YAEvB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YAEtB,uBAAuB;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAExB,cAAc;YACd,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,IAAI,EAAE,CAAC;oBACV,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAW,CAAC,CAAC;gBAC7B,CAAC;YACF,CAAC;QACF,CAAC,CAAC;QAEF,oDAAoD;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE;YACxB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC/B,CAAC;QACF,CAAC,CAAC;QAEF,yHAAyH;QACzH,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YAC7B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,KAAK,CACT,gCAAgC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAC5D,CAAC;YACH,CAAC;QACF,CAAC,CAAC;QAEF,mCAAmC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;YAC/B,IAAI,KAAK,CAAC,IAAI,YAAY,WAAW,EAAE,CAAC;gBACvC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACP,uDAAuD;gBACvD,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChE,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC9C,CAAC;QACF,CAAC,CAAC;IACH,CAAC;IAED,4FAA4F;IACrF,KAAK,CAAC,SAAiB,mBAAmB;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;IACF,CAAC;IAEM,WAAW;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACD"}

package/dist/src/user_error.d.ts

@@ -0,0 +1,4 @@
+export declare class UserError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=user_error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user_error.d.ts","sourceRoot":"","sources":["../../src/user_error.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAmB3B"}

package/dist/src/user_error.js

@@ -0,0 +1,11 @@
+export class UserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UserError';
+        if (typeof Error
+            .captureStackTrace === 'function') {
+            Error.captureStackTrace(this, UserError);
+        }
+    }
+}
+//# sourceMappingURL=user_error.js.map

package/dist/src/user_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_error.js","sourceRoot":"","sources":["../../src/user_error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACnC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,IACC,OAAQ,KAA4D;aAClE,iBAAiB,KAAK,UAAU,EACjC,CAAC;YAED,KAMA,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;CACD"}

package/dist/src/util.d.ts

@@ -0,0 +1,9 @@
+export declare function newPromiseWithResolver<T>(): {
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: any) => void;
+    promise: Promise<T>;
+};
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, onTimeout?: () => void): Promise<T>;
+export declare function marshalRequestData<RQ>(req: RQ): Uint8Array;
+export declare function unmarshalResponseData<RS>(respBytes: Uint8Array): RS;
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,CAAC,CAAC,KAAK;IAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpB,CAUA;AAGD,wBAAgB,WAAW,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,IAAI,GACpB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,UAAU,CAM1D;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,GAAG,EAAE,CAMnE"}

package/dist/src/util.js

@@ -0,0 +1,42 @@
+import { decode, encode } from '@msgpack/msgpack';
+// Creates a promise that can be resolved or rejected externally. This is useful for creating a promise that can be resolved or rejected at a later time, such as when waiting for an event to occur.
+export function newPromiseWithResolver() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { resolve, reject, promise };
+}
+// Helper to create a timeout promise
+export function withTimeout(promise, timeoutMs, onTimeout) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            onTimeout?.();
+            reject(new Error(`waiting for response timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    return Promise.race([
+        promise.finally(() => clearTimeout(timeoutId)),
+        timeoutPromise,
+    ]);
+}
+export function marshalRequestData(req) {
+    try {
+        return encode(req);
+    }
+    catch (error) {
+        throw new Error(`failed to marshal request data: ${error}`);
+    }
+}
+export function unmarshalResponseData(respBytes) {
+    try {
+        return decode(respBytes);
+    }
+    catch (error) {
+        throw new Error(`failed to unmarshal response data: ${error}`);
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/src/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAElD,qMAAqM;AACrM,MAAM,UAAU,sBAAsB;IAKrC,IAAI,OAA6C,CAAC;IAClD,IAAI,MAA+B,CAAC;IAEpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,OAAO,GAAG,GAAG,CAAC;QACd,MAAM,GAAG,GAAG,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAC1B,OAAmB,EACnB,SAAiB,EACjB,SAAsB;IAEtB,IAAI,SAAwC,CAAC;IAC7C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACnD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,SAAS,EAAE,EAAE,CAAC;YACd,MAAM,CACL,IAAI,KAAK,CACR,wCAAwC,SAAS,IAAI,CACrD,CACD,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC;QACnB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC9C,cAAc;KACd,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAK,GAAO;IAC7C,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAK,SAAqB;IAC9D,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,SAAS,CAAO,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;AACF,CAAC"}

package/dist/transporter/transporter_http.d.ts

@@ -0,0 +1,6 @@
+import type { Sender } from '../sender.js';
+export declare class HTTPTransporter {
+    private sender;
+    constructor(s: Sender, method: string, url: string);
+}
+//# sourceMappingURL=transporter_http.d.ts.map

package/dist/transporter/transporter_http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transporter_http.d.ts","sourceRoot":"","sources":["../../src/transporter/transporter_http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,qBAAa,eAAe;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEX,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CA+BlD"}

package/dist/transporter/transporter_http.js

@@ -0,0 +1,30 @@
+export class HTTPTransporter {
+    sender;
+    constructor(s, method, url) {
+        this.sender = s;
+        this.sender.setSendFunc(async (data) => {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 20000);
+            try {
+                const response = await fetch(url, {
+                    method: method,
+                    body: data,
+                    signal: controller.signal,
+                    headers: {
+                        'Content-Type': 'application/octet-stream',
+                    },
+                });
+                // Check for transporter errors
+                if (!response.ok) {
+                    throw new Error(`received non ok status ${response.status} ${response.statusText}`);
+                }
+                // Let sender handle the response routing
+                this.sender.handle(await response.bytes());
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        });
+    }
+}
+//# sourceMappingURL=transporter_http.js.map

package/dist/transporter/transporter_http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transporter_http.js","sourceRoot":"","sources":["../../src/transporter/transporter_http.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IACnB,MAAM,CAAS;IAEvB,YAAY,CAAS,EAAE,MAAc,EAAE,GAAW;QACjD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,IAAgB,EAAiB,EAAE;YACjE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;YAE5D,IAAI,CAAC;gBACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBACjC,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,IAA2B;oBACjC,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,OAAO,EAAE;wBACR,cAAc,EAAE,0BAA0B;qBAC1C;iBACD,CAAC,CAAC;gBAEH,+BAA+B;gBAC/B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CACd,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAClE,CAAC;gBACH,CAAC;gBAED,yCAAyC;gBACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YAC5C,CAAC;oBAAS,CAAC;gBACV,YAAY,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/transporter/transporter_websocket.d.ts

@@ -0,0 +1,17 @@
+import type { Receiver } from '../receiver.js';
+export interface WebSocketOptions {
+    connectionTimeout?: number;
+    onOpen?: () => void;
+}
+export declare class WebSocketTransporter {
+    private conn;
+    private receiver;
+    private options;
+    private connected;
+    private queue;
+    constructor(receiver: Receiver, options: WebSocketOptions);
+    connect(url: string): void;
+    close(reason?: string): void;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=transporter_websocket.d.ts.map

package/dist/transporter/transporter_websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transporter_websocket.d.ts","sourceRoot":"","sources":["../../src/transporter/transporter_websocket.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAEhC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,qBAAa,oBAAoB;IAChC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,KAAK,CAAoB;gBAErB,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB;IAQlD,OAAO,CAAC,GAAG,EAAE,MAAM;IAwEnB,KAAK,CAAC,MAAM,GAAE,MAA4B,GAAG,IAAI;IAajD,WAAW,IAAI,OAAO;CAG7B"}

package/dist/transporter/transporter_websocket.js

@@ -0,0 +1,93 @@
+import { logger } from '../logger.js';
+export class WebSocketTransporter {
+    conn = null;
+    receiver;
+    options;
+    connected = false;
+    queue = [];
+    constructor(receiver, options) {
+        this.receiver = receiver;
+        this.options = options;
+    }
+    /// Will start a connection to the server. Will not block until the connection is open.
+    ///
+    /// All things sent before the connection is open are queued, so feel free to send already after calling connect.
+    connect(url) {
+        if (this.connected || this.conn) {
+            return;
+        }
+        // Queue outgoing messages until connection is open
+        this.receiver.setSendFunc(async (data) => {
+            if (this.connected && this.conn?.readyState === WebSocket.OPEN) {
+                this.conn.send(data); // TODO: Find out if this is actually fine xd
+            }
+            else {
+                this.queue.push(data);
+            }
+        });
+        // Add a timeout to make sure the connection actually happens
+        const timeout = setTimeout(() => {
+            if (this.conn?.readyState !== WebSocket.OPEN) {
+                this.close('connection timeout');
+            }
+        }, this.options.connectionTimeout ?? 20000);
+        // Init WebSocket to open the actual connection
+        this.conn = new WebSocket(url);
+        this.conn.binaryType = 'arraybuffer';
+        this.conn.onopen = () => {
+            if (!this.conn)
+                return;
+            clearTimeout(timeout);
+            this.connected = true;
+            // Call onOpen callback
+            this.options.onOpen?.();
+            // Flush queue
+            while (this.queue.length > 0) {
+                const data = this.queue.shift();
+                if (data) {
+                    this.conn.send(data);
+                }
+            }
+        };
+        // When there is an error, we immediately disconnect
+        this.conn.onerror = () => {
+            if (this.conn) {
+                this.close('websocket error');
+            }
+        };
+        // Even on a close, we want to quickly close the thingy to notify the event handler for onError and update internal state
+        this.conn.onclose = (event) => {
+            if (this.conn) {
+                this.close(`websocket connection closed: ${event.code} ${event.reason}`);
+            }
+        };
+        // Forward messages to the receiver
+        this.conn.onmessage = (event) => {
+            if (event.data instanceof ArrayBuffer) {
+                this.receiver.handle(new Uint8Array(event.data));
+            }
+            else {
+                // If we get this, the browser is doing something weird
+                logger.error('wrong message type received:', typeof event.data);
+                this.close('wrong kind of message received');
+            }
+        };
+    }
+    /// Closes the connection to the server. Will not throw if the connection is already closed.
+    close(reason = 'Connection closed') {
+        const wasConnected = this.connected || !!this.conn;
+        this.connected = false;
+        if (this.conn) {
+            const c = this.conn;
+            this.conn = null;
+            c.close(1000, reason);
+        }
+        if (wasConnected) {
+            this.receiver.getConfig().errorHandler(new Error(reason));
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=transporter_websocket.js.map

package/dist/transporter/transporter_websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transporter_websocket.js","sourceRoot":"","sources":["../../src/transporter/transporter_websocket.ts"],"names":[],"mappings":"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"}

package/dist/user_error.d.ts

@@ -0,0 +1,4 @@
+export declare class UserError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=user_error.d.ts.map

package/dist/user_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_error.d.ts","sourceRoot":"","sources":["../src/user_error.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAmB3B"}

package/dist/user_error.js

@@ -0,0 +1,11 @@
+export class UserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UserError';
+        if (typeof Error
+            .captureStackTrace === 'function') {
+            Error.captureStackTrace(this, UserError);
+        }
+    }
+}
+//# sourceMappingURL=user_error.js.map

package/dist/user_error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_error.js","sourceRoot":"","sources":["../src/user_error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACnC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,IACC,OAAQ,KAA4D;aAClE,iBAAiB,KAAK,UAAU,EACjC,CAAC;YAED,KAMA,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;CACD"}

package/dist/util.d.ts

@@ -0,0 +1,9 @@
+export declare function newPromiseWithResolver<T>(): {
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: any) => void;
+    promise: Promise<T>;
+};
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, onTimeout?: () => void): Promise<T>;
+export declare function marshalRequestData<RQ>(req: RQ): Uint8Array;
+export declare function unmarshalResponseData<RS>(respBytes: Uint8Array): RS;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,CAAC,CAAC,KAAK;IAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpB,CAUA;AAGD,wBAAgB,WAAW,CAAC,CAAC,EAC5B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,IAAI,GACpB,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,UAAU,CAM1D;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,GAAG,EAAE,CAMnE"}

package/dist/util.js

@@ -0,0 +1,42 @@
+import { decode, encode } from '@msgpack/msgpack';
+// Creates a promise that can be resolved or rejected externally. This is useful for creating a promise that can be resolved or rejected at a later time, such as when waiting for an event to occur.
+export function newPromiseWithResolver() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { resolve, reject, promise };
+}
+// Helper to create a timeout promise
+export function withTimeout(promise, timeoutMs, onTimeout) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            onTimeout?.();
+            reject(new Error(`waiting for response timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    return Promise.race([
+        promise.finally(() => clearTimeout(timeoutId)),
+        timeoutPromise,
+    ]);
+}
+export function marshalRequestData(req) {
+    try {
+        return encode(req);
+    }
+    catch (error) {
+        throw new Error(`failed to marshal request data: ${error}`);
+    }
+}
+export function unmarshalResponseData(respBytes) {
+    try {
+        return decode(respBytes);
+    }
+    catch (error) {
+        throw new Error(`failed to unmarshal response data: ${error}`);
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAElD,qMAAqM;AACrM,MAAM,UAAU,sBAAsB;IAKrC,IAAI,OAA6C,CAAC;IAClD,IAAI,MAA+B,CAAC;IAEpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3C,OAAO,GAAG,GAAG,CAAC;QACd,MAAM,GAAG,GAAG,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAC1B,OAAmB,EACnB,SAAiB,EACjB,SAAsB;IAEtB,IAAI,SAAwC,CAAC;IAC7C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACnD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,SAAS,EAAE,EAAE,CAAC;YACd,MAAM,CACL,IAAI,KAAK,CACR,wCAAwC,SAAS,IAAI,CACrD,CACD,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC;QACnB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC9C,cAAc;KACd,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAK,GAAO;IAC7C,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAK,SAAqB;IAC9D,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,SAAS,CAAO,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;AACF,CAAC"}

package/examples/http_client/package.json

@@ -0,0 +1,20 @@
+{
+	"name": "http_example",
+	"version": "0.1.0",
+	"type": "module",
+	"description": "How to use the HTTP client from neoroute-ts",
+	"main": "index.ts",
+	"scripts": {
+		"start": "node --loader ts-node/esm src/main.ts"
+	},
+	"dependencies": {
+		"@liphium/neoroute-ts": "workspace:*"
+	},
+	"devDependencies": {
+		"@types/node": "^26.0.1"
+	},
+	"keywords": [],
+	"author": "",
+	"private": "true",
+	"packageManager": "pnpm@10.32.1"
+}

package/examples/http_client/src/main.ts

@@ -0,0 +1,59 @@
+import { Receiver, HTTPTransporter } from '@liphium/neoroute-ts';
+import { testHttpSimple, testHttpGroup1, testHttpGroup2 } from './requests.js';
+import readline from 'node:readline';
+
+async function main() {
+	// 1. Setup Receiver
+	const httpReceiver = new Receiver({
+		errorHandler: (err: Error) =>
+			console.log('Global HTTP receiver error:', err),
+		requestTimeout: 5000,
+	});
+
+	// 2. Setup HTTP Transporter with the required auth token
+	const httpTransporter = new HTTPTransporter(
+		httpReceiver,
+		'POST',
+		'http://localhost:6121/?token=secret_token',
+	);
+	console.log('HTTP Transporter initialized and ready.');
+
+	// 3. Setup console interface
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+		prompt: '> ',
+	});
+
+	console.log('\n--- HTTP Client Commands ---');
+	console.log("1: Test 'simple.route'");
+	console.log("2: Test 'group1.route1'");
+	console.log("3: Test 'group1.group2.route1'");
+	console.log('exit: Quit the program');
+	console.log('----------------------------\n');
+	rl.prompt();
+
+	rl.on('line', (line) => {
+		const input = line.trim();
+
+		if (input === '1') {
+			testHttpSimple(httpReceiver).then(() => rl.prompt());
+		} else if (input === '2') {
+			testHttpGroup1(httpReceiver, 10).then(() => rl.prompt());
+		} else if (input === '3') {
+			testHttpGroup2(httpReceiver, 42).then(() => rl.prompt());
+		} else if (input === 'exit') {
+			rl.close();
+		} else {
+			console.log('Unknown command.');
+			rl.prompt();
+		}
+	});
+
+	rl.on('close', () => {
+		console.log('Shutting down HTTP client.');
+		process.exit(0);
+	});
+}
+
+main();

package/examples/http_client/src/messages.ts

@@ -0,0 +1,9 @@
+export interface TestRequest {
+	field1: string;
+	field2: number;
+}
+
+export interface TestResponse {
+	field1: string;
+	field2: number;
+}

package/examples/http_client/src/requests.ts

@@ -0,0 +1,64 @@
+import { Receiver, UserError } from '@liphium/neoroute-ts';
+import { type TestRequest, type TestResponse } from './messages.js';
+
+export async function testHttpSimple(receiver: Receiver): Promise<void> {
+	try {
+		console.log('Sending simple HTTP request...');
+		const resp = receiver.sendNoRequest<TestResponse>('simple.route');
+		console.log('Simple HTTP Response:', resp);
+	} catch (err) {
+		if (err instanceof UserError) {
+			console.log('UserError on simple route:', err.message);
+		} else {
+			console.log('System error on simple route:', err);
+		}
+	}
+}
+
+export async function testHttpGroup1(
+	receiver: Receiver,
+	numberValue: number,
+): Promise<void> {
+	try {
+		console.log('Sending group1 HTTP request...');
+		const req: TestRequest = {
+			field1: 'Testing Group 1',
+			field2: numberValue,
+		};
+		const resp = receiver.send<TestResponse, TestRequest>(
+			'group1.route1',
+			req,
+		);
+		console.log('Group 1 HTTP Response:', resp);
+	} catch (err) {
+		if (err instanceof UserError) {
+			console.log('UserError on group1 route:', err.message);
+		} else {
+			console.log('System error on group1 route:', err);
+		}
+	}
+}
+
+export async function testHttpGroup2(
+	receiver: Receiver,
+	numberValue: number,
+): Promise<void> {
+	try {
+		console.log('Sending group2 HTTP request...');
+		const req: TestRequest = {
+			field1: 'Testing Group 2',
+			field2: numberValue,
+		};
+		const resp = await receiver.send<TestResponse, TestRequest>(
+			'group1.group2.route1',
+			req,
+		);
+		console.log('Group 2 HTTP Response:', resp);
+	} catch (err) {
+		if (err instanceof UserError) {
+			console.log('UserError on group2 route:', err.message);
+		} else {
+			console.log('System error on group2 route:', err);
+		}
+	}
+}

package/examples/http_client/tsconfig.json

@@ -0,0 +1,44 @@
+{
+	// Visit https://aka.ms/tsconfig to read more about this file
+	"compilerOptions": {
+		// File Layout
+		"rootDir": "./src",
+		"outDir": "./dist",
+
+		// Environment Settings
+		// See also https://aka.ms/tsconfig/module
+		"module": "nodenext",
+		"target": "esnext",
+		"types": ["node"],
+		// For nodejs:
+		// "lib": ["esnext"],
+		// "types": ["node"],
+		// and npm install -D @types/node
+
+		// Other Outputs
+		"sourceMap": true,
+		"declaration": true,
+		"declarationMap": true,
+
+		// Stricter Typechecking Options
+		"noUncheckedIndexedAccess": true,
+		"exactOptionalPropertyTypes": true,
+
+		// Style Options
+		// "noImplicitReturns": true,
+		// "noImplicitOverride": true,
+		// "noUnusedLocals": true,
+		// "noUnusedParameters": true,
+		// "noFallthroughCasesInSwitch": true,
+		// "noPropertyAccessFromIndexSignature": true,
+
+		// Recommended Options
+		"strict": true,
+		"jsx": "react-jsx",
+		"verbatimModuleSyntax": true,
+		"isolatedModules": true,
+		"noUncheckedSideEffectImports": true,
+		"moduleDetection": "force",
+		"skipLibCheck": true,
+	},
+}