sleepy-socket 0.6.2 → 0.8.0

package/README.md

@@ -154,10 +154,10 @@ Requests are sent over one socket, so responses can come back in a different ord
 For example, if you fire three requests that take 300ms, 100ms, and 200ms:
 
 ```js
-import SleepySocketClient, { QUEUE } from 'sleepy-socket'
+import SleepySocketClient, { Queue } from 'sleepy-socket'
 
 const client = await SleepySocketClient.connect('localhost', 3000, {
-  queue: QUEUE.FIFO,
+  queue: Queue.Fifo,
 })
 
 const results = []
@@ -170,11 +170,11 @@ await Promise.all([
 ```
 
 The three queue types resolve those promises differently:
-- `QUEUE.NONE`: each promise resolves the moment its response arrives, so `results` is `[2, 3, 1]`. This is the default.
-- `QUEUE.FIFO`: responses are held back until every earlier request has resolved, so `results` is `[1, 2, 3]`, matching the order you sent them.
-- `QUEUE.LIFO`: responses drain from the most recent request backwards, so `results` is `[3, 2, 1]`.
+- `Queue.None`: each promise resolves the moment its response arrives, so `results` is `[2, 3, 1]`. This is the default.
+- `Queue.Fifo`: responses are held back until every earlier request has resolved, so `results` is `[1, 2, 3]`, matching the order you sent them.
+- `Queue.Lifo`: responses drain from the most recent request backwards, so `results` is `[3, 2, 1]`.
 
-`QUEUE.NONE` is the right choice most of the time. `QUEUE.FIFO` is useful when responses have to be applied in the order they were requested.
+`Queue.None` is the right choice most of the time. `Queue.Fifo` is useful when responses have to be applied in the order they were requested.
 
 ### Mount Paths
 
@@ -202,7 +202,7 @@ The parameters are:
 - `opts`: an optional options object
 
 The `opts` object can contain these optional properties:
-- `queue`: how responses are handed back, one of `QUEUE.NONE`, `QUEUE.FIFO`, or `QUEUE.LIFO`. Defaults to `QUEUE.NONE`. An unrecognized value throws a `RangeError`.
+- `queue`: how responses are handed back, one of `Queue.None`, `Queue.Fifo`, or `Queue.Lifo`. Defaults to `Queue.None`. An unrecognized value throws a `RangeError`.
 - `secure`: set to `true` to use `https` and `wss` instead of `http` and `ws`. Defaults to `false`.
 - `timeout`: how long to wait, in milliseconds, both for the initial connection and for each individual request. Defaults to `30_000`.
 - `serverTimeout`: how long the client tolerates silence from the server, in milliseconds, before it considers the connection dead and closes it. Defaults to `120_000`.
@@ -254,24 +254,24 @@ All of these are read-only:
 - `connectionData`: whatever payload the server attached when the connection was established. This is where application data such as an auth token shows up.
 - `token`: the reclaim token used internally to restore the session after a drop. This is not an application auth token; that would be on `connectionData`.
 - `queueType`: the configured queue type
-- `secure`: whether the connection uses `wss`
+- `isSecure`: whether the connection uses `wss`
 - `timeout`: the configured request timeout
 - `serverTimeout`: the configured server silence timeout
 - `heartbeatInterval`: how often the client sends heartbeats. This is dictated by the server, not configured by you.
 - `mountPath`: the configured mount path
 
-### `QUEUE`
+### `Queue`
 
-Contains the valid values for the `queue` option: `QUEUE.NONE`, `QUEUE.FIFO`, and `QUEUE.LIFO`.
+Contains the valid values for the `queue` option: `Queue.None`, `Queue.Fifo`, and `Queue.Lifo`.
 
-### `TYPES`
+### `MessageType`
 
-Contains the message type names used on the wire: `TYPES.WELCOME`, `TYPES.HEARTBEAT`, `TYPES.REQUEST`, `TYPES.RESPONSE`, and `TYPES.NOTIFICATION`. A response message's `type` is always `TYPES.RESPONSE`, and a notification's is always `TYPES.NOTIFICATION`.
+Contains the message type names used on the wire: `MessageType.Welcome`, `MessageType.Heartbeat`, `MessageType.Request`, `MessageType.Response`, and `MessageType.Notification`. A response message's `type` is always `MessageType.Response`, and a notification's is always `MessageType.Notification`.
 
 ## Errors
 
 Most failures surface as thrown errors or rejected promises:
-- `Invalid queue type: <value>`: a `RangeError` thrown by `connect()` when `queue` isn't a valid `QUEUE` value. This is thrown before any network call is made.
+- `Invalid queue type: <value>`: a `RangeError` thrown by `connect()` when `queue` isn't a valid `Queue` value. This is thrown before any network call is made.
 - `Connection failed.`: the connection couldn't be established
 - `Connection timed out.`: the connection wasn't established within `timeout` milliseconds
 - `opts.headers must be a Headers instance`: a `TypeError` thrown when a request's `headers` option isn't a `Headers` object

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { MessageType } from './messages.js';
+export * from './messages.js';
+export * from './utils.js';
+export type TimeoutHandle = ReturnType<typeof setTimeout>;
+export type IntervalHandle = ReturnType<typeof setInterval>;
+export declare const Queue: {
+    readonly None: "none";
+    readonly Fifo: "fifo";
+    readonly Lifo: "lifo";
+};
+export type Queue = typeof Queue[keyof typeof Queue];
+export type ReconnectOptions = {
+    minDelay?: number;
+    maxDelay?: number;
+    factor?: number;
+    random?: () => number;
+};
+export type ConnectOptions = {
+    queue?: Queue;
+    secure?: boolean;
+    timeout?: number;
+    serverTimeout?: number;
+    mountPath?: string;
+    reconnect?: ReconnectOptions | false;
+};
+export type RequestOptions = {
+    headers?: Headers;
+    query?: Record<string, unknown>;
+    body?: unknown;
+};
+export type ResponseMessage = {
+    id: string;
+    clientId: string;
+    type: typeof MessageType.Response;
+    timestamp: string;
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+};
+export type NotificationMessage = {
+    id: string;
+    clientId: string;
+    type: typeof MessageType.Notification;
+    timestamp: string;
+    event: string;
+    headers: Record<string, string>;
+    body: unknown;
+};
+export type EventHandler = (payload: NotificationMessage) => void;
+export type TicketData = {
+    clientId: string;
+    ticket: string;
+    data: unknown;
+};
+export default class SleepySocketClient {
+    #private;
+    get id(): string | null;
+    get isConnected(): boolean;
+    get isSecure(): boolean;
+    get queueType(): Queue;
+    get timeout(): number;
+    get heartbeatInterval(): number;
+    get serverTimeout(): number;
+    get token(): string | null;
+    get mountPath(): string;
+    get socket(): WebSocket | null;
+    get connectionData(): unknown;
+    static connect(host: string, port: number, opts?: ConnectOptions): Promise<SleepySocketClient>;
+    on(event: string, handler: EventHandler): void;
+    off(event: string, handler: EventHandler): void;
+    close(): Promise<void>;
+    head(route: string, opts?: RequestOptions): Promise<ResponseMessage>;
+    get(route: string, opts?: RequestOptions): Promise<ResponseMessage>;
+    post(route: string, opts?: RequestOptions): Promise<ResponseMessage>;
+    put(route: string, opts?: RequestOptions): Promise<ResponseMessage>;
+    patch(route: string, opts?: RequestOptions): Promise<ResponseMessage>;
+    delete(route: string, opts?: RequestOptions): Promise<ResponseMessage>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,420 @@
+import { MessageType, createMessage } from './messages.js';
+import { joinRoute } from './utils.js';
+export * from './messages.js';
+export * from './utils.js';
+export const Queue = {
+    None: 'none',
+    Fifo: 'fifo',
+    Lifo: 'lifo',
+};
+const RECONNECT_JITTER = 0.5;
+const JSON_CONTENT_TYPE = 'application/json;charset=utf-8';
+export default class SleepySocketClient {
+    #id = null;
+    #queueType = Queue.None;
+    #ready = false;
+    #closing = false;
+    #secure = false;
+    #timeout = 30_000;
+    #serverTimeout = 120_000;
+    #heartbeatInterval = 30_000;
+    #mountPath = '';
+    #host = null;
+    #port = null;
+    #token = null;
+    #socket = null;
+    #random = Math.random;
+    #livenessTimer = null;
+    #heartbeatTimer = null;
+    #reconnectTimer = null;
+    #reconnectConfig = null;
+    #connectionData = null;
+    #listeners = new Map();
+    #dispatchedMessages = [];
+    get id() {
+        return this.#id;
+    }
+    get isConnected() {
+        return this.#ready;
+    }
+    get isSecure() {
+        return this.#secure;
+    }
+    get queueType() {
+        return this.#queueType;
+    }
+    get timeout() {
+        return this.#timeout;
+    }
+    get heartbeatInterval() {
+        return this.#heartbeatInterval;
+    }
+    get serverTimeout() {
+        return this.#serverTimeout;
+    }
+    get token() {
+        return this.#token;
+    }
+    get mountPath() {
+        return this.#mountPath;
+    }
+    get socket() {
+        return this.#socket;
+    }
+    get connectionData() {
+        return this.#connectionData;
+    }
+    static async connect(host, port, opts = {}) {
+        if (opts.queue && !Object.values(Queue).includes(opts.queue)) {
+            throw new RangeError(`Invalid queue type: ${opts.queue}`);
+        }
+        const client = new this();
+        const reconnect = opts.reconnect && typeof opts.reconnect === 'object'
+            ? opts.reconnect
+            : {};
+        client.#host = host;
+        client.#port = port;
+        client.#queueType = opts.queue ?? Queue.None;
+        client.#secure = opts.secure ?? false;
+        client.#timeout = opts.timeout ?? 30_000;
+        client.#serverTimeout = opts.serverTimeout ?? 120_000;
+        client.#mountPath = opts.mountPath ?? '';
+        if (opts.reconnect !== false) {
+            client.#reconnectConfig = {
+                minDelay: reconnect.minDelay ?? 500,
+                maxDelay: reconnect.maxDelay ?? 30_000,
+                factor: reconnect.factor ?? 2,
+            };
+        }
+        client.#random = reconnect.random ?? Math.random;
+        await client.#establish();
+        return client;
+    }
+    #baseUrl() {
+        const protocol = this.#secure ? 'https' : 'http';
+        return `${protocol}://${this.#host}:${this.#port}${this.#mountPath}`;
+    }
+    async #createTicket() {
+        const response = await fetch(`${this.#baseUrl()}/ws`, {
+            method: 'POST',
+        });
+        return await response.json();
+    }
+    async #reclaimTicket() {
+        const url = `${this.#baseUrl()}/ws/${this.#id}`;
+        const response = await fetch(url, {
+            method: 'PUT',
+            headers: {
+                authorization: `Bearer ${this.#token}`,
+            },
+        });
+        if (!response.ok) {
+            return null;
+        }
+        return await response.json();
+    }
+    async #requestTicket() {
+        if (this.#id && this.#token) {
+            const reclaimed = await this.#reclaimTicket();
+            if (reclaimed) {
+                return reclaimed;
+            }
+        }
+        return this.#createTicket();
+    }
+    #socketUrl(ticket) {
+        const protocol = this.#secure ? 'wss' : 'ws';
+        const authority = `${this.#host}:${this.#port}${this.#mountPath}`;
+        return `${protocol}://${authority}/ws?ticket=${ticket}`;
+    }
+    #openSocket(res, succeed, fail) {
+        const socket = new WebSocket(this.#socketUrl(res.ticket));
+        this.#socket = socket;
+        this.#connectionData = res.data;
+        const onError = () => fail('Connection failed.');
+        const onWelcome = (event) => {
+            const message = JSON.parse(event.data);
+            socket.removeEventListener('message', onWelcome);
+            if (message.type !== MessageType.Welcome) {
+                fail('Expected a welcome message.');
+                return;
+            }
+            this.#id = message.clientId;
+            this.#token = message.body.token;
+            this.#heartbeatInterval = message.body.heartbeatInterval;
+            socket.addEventListener('message', ev => this.#handleMessage(ev));
+            socket.addEventListener('close', ev => this.#handleClose(ev));
+            this.#startHeartbeat();
+            this.#armLiveness();
+            this.#ready = true;
+            succeed();
+        };
+        socket.addEventListener('open', () => {
+            socket.removeEventListener('error', onError);
+            socket.addEventListener('message', onWelcome);
+        }, { once: true });
+        socket.addEventListener('error', onError);
+    }
+    #establish() {
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                this.#socket?.close();
+                reject(new Error('Connection timed out.'));
+            }, this.#timeout);
+            const fail = (message) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                clearTimeout(timer);
+                reject(new Error(message));
+            };
+            const succeed = () => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                clearTimeout(timer);
+                resolve();
+            };
+            this.#requestTicket()
+                .then(ticketData => this.#openSocket(ticketData, succeed, fail))
+                .catch(() => fail('Connection failed.'));
+        });
+    }
+    #armLiveness() {
+        if (this.#livenessTimer) {
+            clearTimeout(this.#livenessTimer);
+        }
+        this.#livenessTimer = setTimeout(() => {
+            this.#socket?.close();
+        }, this.serverTimeout);
+    }
+    #scheduleReconnect(attempt, config) {
+        const { minDelay, maxDelay, factor } = config;
+        const base = Math.min(minDelay * factor ** attempt, maxDelay);
+        const delay = base * (1 + this.#random() * RECONNECT_JITTER);
+        this.#reconnectTimer = setTimeout(async () => {
+            this.#reconnectTimer = null;
+            if (this.#closing) {
+                return;
+            }
+            try {
+                await this.#establish();
+            }
+            catch {
+                if (this.#closing) {
+                    return;
+                }
+                this.#scheduleReconnect(attempt + 1, config);
+            }
+        }, delay);
+    }
+    #startHeartbeat() {
+        this.#heartbeatTimer = setInterval(() => {
+            const message = createMessage(this.#id, MessageType.Heartbeat);
+            this.#socket.send(JSON.stringify(message));
+        }, this.#heartbeatInterval);
+    }
+    #stopHeartbeat() {
+        if (this.#heartbeatTimer) {
+            clearInterval(this.#heartbeatTimer);
+        }
+        this.#heartbeatTimer = null;
+    }
+    #normalizeRequestOpts(opts) {
+        if (opts.headers !== undefined && !(opts.headers instanceof Headers)) {
+            throw new TypeError('opts.headers must be a Headers instance');
+        }
+        const headers = opts.headers ?? new Headers();
+        const query = opts.query ?? {};
+        const body = opts.body ?? null;
+        const isJsonBody = body !== null && typeof body === 'object';
+        if (isJsonBody && !headers.has('content-type')) {
+            headers.set('content-type', JSON_CONTENT_TYPE);
+        }
+        return {
+            headers,
+            query,
+            body,
+        };
+    }
+    #sendRequest(method, route, opts = {}) {
+        if (!this.#ready) {
+            throw new Error('Socket is closed');
+        }
+        const { headers, query, body } = this.#normalizeRequestOpts(opts);
+        const fullRoute = joinRoute(this.#mountPath, route);
+        const message = createMessage(this.#id, MessageType.Request, {
+            method,
+            query,
+            body,
+            route: fullRoute,
+            headers: Object.fromEntries(headers),
+        });
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const index = this.#dispatchedMessages.findIndex(item => item.id === message.id);
+                if (index !== -1) {
+                    this.#dispatchedMessages.splice(index, 1);
+                }
+                reject(new Error('Request timed out.'));
+            }, this.#timeout);
+            this.#dispatchedMessages.push({
+                id: message.id,
+                resolve,
+                reject,
+                timer,
+                ready: false,
+                response: null,
+            });
+            this.#socket.send(JSON.stringify(message));
+        });
+    }
+    #handleClose(event) {
+        this.#ready = false;
+        this.#stopHeartbeat();
+        if (this.#livenessTimer) {
+            clearTimeout(this.#livenessTimer);
+        }
+        for (const entry of this.#dispatchedMessages) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error('Socket closed.'));
+        }
+        this.#dispatchedMessages = [];
+        this.#socket = null;
+        if (this.#closing) {
+            return;
+        }
+        if (!this.#reconnectConfig) {
+            if (!event.wasClean) {
+                throw new Error(`Socket closed unexpectedly (code: ${event.code}).`);
+            }
+            return;
+        }
+        this.#scheduleReconnect(0, this.#reconnectConfig);
+    }
+    #handleRequest(data) {
+        const entry = this.#dispatchedMessages.find(item => item.id === data.id);
+        if (!entry) {
+            return;
+        }
+        clearTimeout(entry.timer);
+        entry.response = data;
+        entry.ready = true;
+        this.#drain();
+    }
+    #handleNotification(data) {
+        this.#emit('notification', data);
+    }
+    #handleMessage(event) {
+        this.#armLiveness();
+        const data = JSON.parse(event.data);
+        switch (data.type) {
+            case MessageType.Heartbeat:
+                return;
+            case MessageType.Response:
+                return this.#handleRequest(data);
+            case MessageType.Notification:
+                return this.#handleNotification(data);
+            default:
+                throw new RangeError(`Unknown message type: "${data.type}"`);
+        }
+    }
+    #processNone() {
+        this.#dispatchedMessages = this.#dispatchedMessages.filter(entry => {
+            if (entry.ready) {
+                entry.resolve(entry.response);
+            }
+            return !entry.ready;
+        });
+    }
+    #processFifo() {
+        while (this.#dispatchedMessages[0]?.ready) {
+            const [entry] = this.#dispatchedMessages.splice(0, 1);
+            entry.resolve(entry.response);
+        }
+    }
+    #processLifo() {
+        while (this.#dispatchedMessages.at(-1)?.ready) {
+            const entry = this.#dispatchedMessages.pop();
+            entry.resolve(entry.response);
+        }
+    }
+    #drain() {
+        switch (this.#queueType) {
+            case Queue.None:
+                return this.#processNone();
+            case Queue.Fifo:
+                return this.#processFifo();
+            case Queue.Lifo:
+                return this.#processLifo();
+        }
+    }
+    #emit(event, payload) {
+        const handlers = this.#listeners.get(event);
+        if (!handlers) {
+            return;
+        }
+        for (const handler of handlers) {
+            try {
+                handler(payload);
+            }
+            catch (err) {
+                console.error(err);
+            }
+        }
+    }
+    on(event, handler) {
+        if (!this.#listeners.has(event)) {
+            this.#listeners.set(event, new Set());
+        }
+        this.#listeners.get(event).add(handler);
+    }
+    off(event, handler) {
+        this.#listeners.get(event)?.delete(handler);
+    }
+    async close() {
+        if (this.#closing) {
+            throw new Error('Socket is closed');
+        }
+        this.#closing = true;
+        this.#ready = false;
+        this.#stopHeartbeat();
+        if (this.#livenessTimer) {
+            clearTimeout(this.#livenessTimer);
+        }
+        if (this.#reconnectTimer) {
+            clearTimeout(this.#reconnectTimer);
+        }
+        this.#reconnectTimer = null;
+        if (this.#socket) {
+            await this.#socket.close();
+            this.#socket = null;
+        }
+    }
+    head(route, opts = {}) {
+        return this.#sendRequest('HEAD', route, opts);
+    }
+    get(route, opts = {}) {
+        return this.#sendRequest('GET', route, opts);
+    }
+    post(route, opts = {}) {
+        return this.#sendRequest('POST', route, opts);
+    }
+    put(route, opts = {}) {
+        return this.#sendRequest('PUT', route, opts);
+    }
+    patch(route, opts = {}) {
+        return this.#sendRequest('PATCH', route, opts);
+    }
+    delete(route, opts = {}) {
+        return this.#sendRequest('DELETE', route, opts);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/messages.d.ts

@@ -0,0 +1,26 @@
+export declare const MessageType: {
+    readonly Welcome: "welcome";
+    readonly Heartbeat: "heartbeat";
+    readonly Request: "request";
+    readonly Response: "response";
+    readonly Notification: "notification";
+};
+export type MessageType = typeof MessageType[keyof typeof MessageType];
+export type MessageHeaders = Headers | Record<string, string>;
+export type MessageOptions = {
+    id?: string;
+    headers?: MessageHeaders;
+    body?: unknown;
+    [key: string]: unknown;
+};
+export type Message = {
+    id: string;
+    clientId: string;
+    type: MessageType;
+    timestamp: string;
+    headers: MessageHeaders;
+    body: unknown;
+    [key: string]: unknown;
+};
+export declare function createMessage(clientId: string, type: MessageType, opts?: MessageOptions): Message;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;;;;;CAMd,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AAEtE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,OAAO,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAUT"}

package/dist/messages.js

@@ -0,0 +1,20 @@
+import { id } from './utils.js';
+export const MessageType = {
+    Welcome: 'welcome',
+    Heartbeat: 'heartbeat',
+    Request: 'request',
+    Response: 'response',
+    Notification: 'notification',
+};
+export function createMessage(clientId, type, opts = {}) {
+    return {
+        ...opts,
+        id: opts.id ?? id(),
+        clientId,
+        type,
+        timestamp: new Date().toISOString(),
+        headers: opts.headers ?? new Headers(),
+        body: opts.body ?? null,
+    };
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAE/B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;CACpB,CAAA;AAuBV,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,IAAiB,EACjB,OAAuB,EAAE;IAEzB,OAAO;QACL,GAAG,IAAI;QACP,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE;QACnB,QAAQ;QACR,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,OAAO,EAAE;QACtC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;KACxB,CAAA;AACH,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+export type IdGenerator = () => string;
+export declare const defaultIdGenerator: IdGenerator;
+export declare function joinRoute(...segments: string[]): string;
+export declare function id(): string;
+export declare function setIdGenerator(fn: IdGenerator): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,CAAA;AAEtC,eAAO,MAAM,kBAAkB,EAAE,WAAuC,CAAA;AAIxE,wBAAgB,SAAS,CAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAOxD;AAED,wBAAgB,EAAE,IAAK,MAAM,CAE5B;AAED,wBAAgB,cAAc,CAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAErD"}