@spinajs/http-socket-client 0.0.0-stage → 3.0.1

package/lib/mjs/reconnect.d.ts

@@ -0,0 +1,21 @@
+export interface ReconnectOptions {
+    minMs: number;
+    maxMs: number;
+    /** Fraction in [0, 1] by which a delay is randomly varied. */
+    jitter: number;
+}
+/** Ceiling for a server-provided retry hint, independent of the backoff ceiling. */
+export declare const MAX_SERVER_HINT_MS = 300000;
+export declare const DEFAULT_RECONNECT: Readonly<ReconnectOptions>;
+export declare class ReconnectPolicy {
+    private readonly random;
+    readonly options: Readonly<ReconnectOptions>;
+    constructor(options?: Partial<ReconnectOptions>, random?: () => number);
+    /**
+     * Delay before retry `attempt` (0 = the first retry after a failure). Jitter only shortens the
+     * exponential delay, so maxMs is a hard ceiling. A server hint is a floor, spread upwards so that
+     * clients told the same retryAfterMs do not all come back at once.
+     */
+    delay(attempt: number, retryAfterMs?: number): number;
+}
+//# sourceMappingURL=reconnect.d.ts.map

package/lib/mjs/reconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.d.ts","sourceRoot":"","sources":["../../src/reconnect.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAE1C,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,gBAAgB,CAA6D,CAAC;AAEvH,qBAAa,eAAe;IAG2B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAF5E,SAAgB,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAEpD,YAAY,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,EAAmB,MAAM,GAAE,MAAM,MAAoB,EAMvG;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3D;CACF"}

package/lib/mjs/reconnect.js

@@ -0,0 +1,33 @@
+/** Ceiling for a server-provided retry hint, independent of the backoff ceiling. */
+export const MAX_SERVER_HINT_MS = 300_000;
+export const DEFAULT_RECONNECT = Object.freeze({ minMs: 500, maxMs: 30_000, jitter: 0.3 });
+export class ReconnectPolicy {
+    constructor(options = {}, random = Math.random) {
+        this.random = random;
+        const merged = { ...DEFAULT_RECONNECT, ...options };
+        if (!(merged.minMs >= 0))
+            throw new RangeError(`reconnect.minMs must be >= 0, got ${merged.minMs}`);
+        if (!(merged.maxMs >= merged.minMs))
+            throw new RangeError(`reconnect.maxMs must be >= minMs, got ${merged.maxMs}`);
+        if (!(merged.jitter >= 0 && merged.jitter <= 1))
+            throw new RangeError(`reconnect.jitter must be within [0, 1], got ${merged.jitter}`);
+        this.options = Object.freeze(merged);
+    }
+    /**
+     * Delay before retry `attempt` (0 = the first retry after a failure). Jitter only shortens the
+     * exponential delay, so maxMs is a hard ceiling. A server hint is a floor, spread upwards so that
+     * clients told the same retryAfterMs do not all come back at once.
+     */
+    delay(attempt, retryAfterMs) {
+        const { minMs, maxMs, jitter } = this.options;
+        // clamped: 2 ** 1024 is Infinity, and 0 * Infinity is NaN
+        const exponential = Math.min(maxMs, minMs * 2 ** Math.min(attempt, 64));
+        const backoff = Math.round(exponential * (1 - jitter * this.random()));
+        if (retryAfterMs === undefined || !Number.isFinite(retryAfterMs) || retryAfterMs <= 0)
+            return backoff;
+        // a hostile or buggy server must not park the client for days
+        const hinted = Math.min(Math.round(retryAfterMs * (1 + jitter * this.random())), MAX_SERVER_HINT_MS);
+        return Math.max(backoff, hinted);
+    }
+}
+//# sourceMappingURL=reconnect.js.map

package/lib/mjs/reconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect.js","sourceRoot":"","sources":["../../src/reconnect.ts"],"names":[],"mappings":"AAOA,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAA+B,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAEvH,MAAM,OAAO,eAAe;IAG1B,YAAY,OAAO,GAA8B,EAAE,EAAmB,MAAM,GAAiB,IAAI,CAAC,MAAM;sBAAlC,MAAM;QAC1E,MAAM,MAAM,GAAG,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,qCAAqC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACpG,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,yCAAyC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACnH,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,+CAA+C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACtI,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAe,EAAE,YAAqB;QACjD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9C,0DAA0D;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC;QACtG,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;CACF"}

package/lib/mjs/streams.d.ts

@@ -0,0 +1,91 @@
+import { type Chunk, type SocketError, type StreamEnd } from '@spinajs/http-socket-common';
+import type { CommandOptions } from './commands.js';
+import type { Connection } from './connection.js';
+export interface StreamOptions extends CommandOptions {
+    /**
+     * Chunks the server may send ahead of the consumer: the most that are ever in flight or buffered.
+     * More are granted as the consumer reads. At most the server's `http.socket.streams.maxCredits` ( 64 ).
+     */
+    credits?: number;
+}
+export declare const DEFAULT_STREAM_CREDITS = 8;
+interface StreamHost {
+    readonly connection: Connection;
+    readonly defaultTimeoutMs: number;
+    nextId(): string;
+    hold(stream: ClientStream<unknown>): void;
+    register(id: string, stream: ClientStream<unknown>): void;
+    release(stream: ClientStream<unknown>): void;
+}
+/** Routes stream frames to their ClientStream and fails or resumes streams on connection changes. */
+export declare class StreamDispatcher implements StreamHost {
+    readonly connection: Connection;
+    private readonly ids;
+    readonly defaultTimeoutMs: number;
+    private readonly waiting;
+    private readonly open;
+    constructor(connection: Connection, ids: () => string, defaultTimeoutMs: number);
+    /** @internal streams held offline plus streams sent or open; 0 once every stream has settled */
+    get activeStreams(): number;
+    stream<T>(name: string, payload?: unknown, options?: StreamOptions): ClientStream<T>;
+    nextId(): string;
+    hold(stream: ClientStream<unknown>): void;
+    register(id: string, stream: ClientStream<unknown>): void;
+    release(stream: ClientStream<unknown>): void;
+    private onState;
+}
+/**
+ * One stream reply as an async iterator. It starts on the first `next()`. It keeps
+ * `granted − consumed ≤ credits`, so no more than `credits` chunks are ever in flight or buffered.
+ */
+export declare class ClientStream<T> implements AsyncIterableIterator<T> {
+    private readonly host;
+    private readonly name;
+    private readonly payload;
+    private readonly options;
+    private phase;
+    private requestId;
+    private readonly buffer;
+    private reader;
+    private failure;
+    private received;
+    private granted;
+    private consumed;
+    private deadlineAt;
+    private timer;
+    private readonly window;
+    private readonly timeoutMs;
+    private readonly onAbort;
+    constructor(host: StreamHost, name: string, payload: unknown, options: StreamOptions);
+    /** The request id; empty until the request is sent. */
+    get id(): string;
+    /** @internal chunks received and not yet read */
+    get buffered(): number;
+    [Symbol.asyncIterator](): this;
+    /** Reads one item. Calls must not overlap: a second next() while one is pending rejects with a TypeError. */
+    next(): Promise<IteratorResult<T>>;
+    /** `for await` calls it on break or throw: the server is told to stop and its generator's `finally` runs. */
+    return(): Promise<IteratorResult<T>>;
+    /** @internal sends the request now, or again once online for a held stream */
+    transmit(): void;
+    /** @internal */
+    onChunk(frame: Chunk): void;
+    /** @internal */
+    onEnd(frame: StreamEnd): void;
+    /** @internal the chunks received before the failure are still delivered */
+    onFail(error: SocketError): void;
+    /** @internal the connection dropped or the client closed; the chunks received are still delivered */
+    abandon(error: SocketError): void;
+    private start;
+    private onReply;
+    private take;
+    /** Grants in batches of at least half the window, so a fast consumer does not send one frame per chunk. */
+    private replenish;
+    /** Ends the stream from this side: buffered items are dropped and the server is told to stop. */
+    private stop;
+    private finish;
+    private arm;
+    private disarm;
+}
+export {};
+//# sourceMappingURL=streams.d.ts.map

package/lib/mjs/streams.d.ts.map

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

package/lib/mjs/streams.js

@@ -0,0 +1,297 @@
+import { SocketException, WIRE_EVENTS, isChunk, isSocketError, isStreamEnd, isStreamFail } from '@spinajs/http-socket-common';
+import { assertTimeoutMs } from './timeout.js';
+export const DEFAULT_STREAM_CREDITS = 8;
+const CLOSED = { code: 'unavailable', message: 'the client is closed', retryable: false };
+const OFFLINE = { code: 'unavailable', message: 'the client is offline', retryable: true };
+const STAYED_OFFLINE = { code: 'unavailable', message: 'the client stayed offline until the timeout', retryable: true };
+const CONNECTION_LOST = { code: 'unavailable', message: 'the connection dropped during the stream', retryable: true };
+const NO_REPLY = { code: 'deadline_exceeded', message: 'no reply before the timeout', retryable: true };
+const NO_FRAME = { code: 'deadline_exceeded', message: 'no stream frame before the timeout', retryable: true };
+const CANCELLED = { code: 'cancelled', message: 'the stream was cancelled', retryable: false };
+const NOT_A_STREAM = { code: 'failed_precondition', message: 'the command does not reply with a stream; use command()', retryable: false };
+const MALFORMED_REPLY = { code: 'internal', message: 'malformed reply', retryable: false };
+const MALFORMED_FAIL = { code: 'internal', message: 'malformed stream fail frame', retryable: false };
+const OUT_OF_ORDER = { code: 'internal', message: 'stream frames arrived out of order', retryable: false };
+const OVER_CREDIT = { code: 'internal', message: 'the server sent more chunks than it had credit for', retryable: false };
+function assertCredits(value) {
+    if (!(Number.isSafeInteger(value) && value > 0)) {
+        throw new RangeError(`credits must be a positive integer, got ${value}`);
+    }
+}
+/** Routes stream frames to their ClientStream and fails or resumes streams on connection changes. */
+export class StreamDispatcher {
+    constructor(connection, ids, defaultTimeoutMs) {
+        this.connection = connection;
+        this.ids = ids;
+        this.defaultTimeoutMs = defaultTimeoutMs;
+        this.waiting = new Set();
+        this.open = new Map();
+        assertTimeoutMs('defaultTimeoutMs', defaultTimeoutMs);
+        connection.listen(WIRE_EVENTS.chunk, (frame) => {
+            if (isChunk(frame))
+                this.open.get(frame.id)?.onChunk(frame);
+        });
+        connection.listen(WIRE_EVENTS.end, (frame) => {
+            if (isStreamEnd(frame))
+                this.open.get(frame.id)?.onEnd(frame);
+        });
+        connection.listen(WIRE_EVENTS.fail, (frame) => {
+            if (isStreamFail(frame))
+                this.open.get(frame.id)?.onFail(frame.error);
+            else if (typeof frame?.id === 'string')
+                this.open.get(frame.id)?.onFail(MALFORMED_FAIL);
+        });
+        connection.events.on('state', (state, previous) => this.onState(state, previous));
+    }
+    /** @internal streams held offline plus streams sent or open; 0 once every stream has settled */
+    get activeStreams() {
+        return this.waiting.size + this.open.size;
+    }
+    stream(name, payload, options = {}) {
+        return new ClientStream(this, name, payload, options);
+    }
+    nextId() {
+        return this.ids();
+    }
+    hold(stream) {
+        this.waiting.add(stream);
+    }
+    register(id, stream) {
+        this.open.set(id, stream);
+    }
+    release(stream) {
+        this.waiting.delete(stream);
+        if (this.open.get(stream.id) === stream)
+            this.open.delete(stream.id);
+    }
+    onState(state, previous) {
+        if (state === 'closed') {
+            for (const stream of [...this.waiting, ...this.open.values()])
+                stream.abandon(CLOSED);
+            return;
+        }
+        if (previous === 'online')
+            for (const stream of [...this.open.values()])
+                stream.abandon(CONNECTION_LOST);
+        if (state === 'online')
+            for (const stream of [...this.waiting])
+                stream.transmit();
+    }
+}
+/**
+ * One stream reply as an async iterator. It starts on the first `next()`. It keeps
+ * `granted − consumed ≤ credits`, so no more than `credits` chunks are ever in flight or buffered.
+ */
+export class ClientStream {
+    constructor(host, name, payload, options) {
+        this.host = host;
+        this.name = name;
+        this.payload = payload;
+        this.options = options;
+        this.phase = 'idle';
+        this.requestId = '';
+        this.buffer = [];
+        this.reader = null;
+        this.failure = null;
+        this.received = 0;
+        this.granted = 0;
+        this.consumed = 0;
+        this.deadlineAt = 0;
+        this.onAbort = () => this.stop(CANCELLED);
+        this.window = options.credits ?? DEFAULT_STREAM_CREDITS;
+        this.timeoutMs = options.timeoutMs ?? host.defaultTimeoutMs;
+    }
+    /** The request id; empty until the request is sent. */
+    get id() {
+        return this.requestId;
+    }
+    /** @internal chunks received and not yet read */
+    get buffered() {
+        return this.buffer.length;
+    }
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+    /** Reads one item. Calls must not overlap: a second next() while one is pending rejects with a TypeError. */
+    next() {
+        if (this.phase === 'idle')
+            this.start();
+        if (this.buffer.length > 0)
+            return Promise.resolve({ value: this.take(), done: false });
+        if (this.phase === 'done')
+            return this.failure === null ? Promise.resolve({ value: undefined, done: true }) : Promise.reject(this.failure);
+        if (this.reader)
+            return Promise.reject(new TypeError('next() called before the previous next() settled'));
+        return new Promise((resolve, reject) => {
+            this.reader = { resolve, reject };
+            if (this.phase === 'open')
+                this.arm(this.timeoutMs, NO_FRAME);
+        });
+    }
+    /** `for await` calls it on break or throw: the server is told to stop and its generator's `finally` runs. */
+    async return() {
+        this.stop(null);
+        this.failure = null;
+        return { value: undefined, done: true };
+    }
+    /** @internal sends the request now, or again once online for a held stream */
+    transmit() {
+        if (this.phase !== 'idle' && this.phase !== 'waiting')
+            return;
+        this.host.release(this);
+        this.requestId = this.host.nextId();
+        this.granted = this.window;
+        this.phase = 'sent';
+        this.host.register(this.requestId, this);
+        const remaining = Math.max(1, this.deadlineAt - Date.now());
+        // deadline: relative, so client/server clock skew cannot expire it; it bounds the reply only
+        const request = { id: this.requestId, name: this.name, payload: this.payload, credits: this.window, deadline: remaining };
+        if (this.options.traceparent !== undefined)
+            request.traceparent = this.options.traceparent;
+        this.arm(remaining, NO_REPLY);
+        const sent = this.host.connection.request(WIRE_EVENTS.command, request, (reply) => this.onReply(reply));
+        if (!sent)
+            this.finish(CONNECTION_LOST);
+    }
+    /** @internal */
+    onChunk(frame) {
+        if (this.phase !== 'sent' && this.phase !== 'open')
+            return;
+        if (frame.seq !== this.received)
+            return this.stop(OUT_OF_ORDER);
+        if (this.received >= this.granted)
+            return this.stop(OVER_CREDIT);
+        this.received++;
+        const value = frame.data;
+        const reader = this.reader;
+        if (!reader) {
+            this.buffer.push(value);
+            return;
+        }
+        this.reader = null;
+        // before the ack the armed timer is the reply timeout, which must keep running
+        if (this.phase === 'open')
+            this.disarm();
+        this.consumed++;
+        this.replenish();
+        reader.resolve({ value, done: false });
+    }
+    /** @internal */
+    onEnd(frame) {
+        if (this.phase !== 'sent' && this.phase !== 'open')
+            return;
+        if (frame.seq !== this.received)
+            return this.stop(OUT_OF_ORDER);
+        this.finish(null);
+    }
+    /** @internal the chunks received before the failure are still delivered */
+    onFail(error) {
+        if (this.phase !== 'sent' && this.phase !== 'open')
+            return;
+        this.finish(error);
+    }
+    /** @internal the connection dropped or the client closed; the chunks received are still delivered */
+    abandon(error) {
+        this.finish(error);
+    }
+    start() {
+        try {
+            assertTimeoutMs('timeoutMs', this.timeoutMs);
+            assertCredits(this.window);
+        }
+        catch (error) {
+            this.phase = 'done';
+            this.failure = error;
+            return;
+        }
+        const connection = this.host.connection;
+        if (connection.state === 'closed')
+            return this.finish(CLOSED);
+        if (this.options.signal?.aborted)
+            return this.finish(CANCELLED);
+        if (!connection.connected && (this.options.whenOffline ?? 'fail') === 'fail')
+            return this.finish(OFFLINE);
+        this.deadlineAt = Date.now() + this.timeoutMs;
+        this.options.signal?.addEventListener('abort', this.onAbort, { once: true });
+        if (connection.connected)
+            return this.transmit();
+        this.phase = 'waiting';
+        this.host.hold(this);
+        this.arm(this.timeoutMs, STAYED_OFFLINE);
+    }
+    onReply(reply) {
+        if (this.phase !== 'sent')
+            return;
+        if (typeof reply !== 'object' || reply === null || typeof reply.ok !== 'boolean')
+            return this.stop(MALFORMED_REPLY);
+        if (!reply.ok)
+            return this.finish(isSocketError(reply.error) ? reply.error : MALFORMED_REPLY);
+        if (!('stream' in reply) || reply.stream !== true)
+            return this.finish(NOT_A_STREAM);
+        this.phase = 'open';
+        this.disarm();
+        // chunks read before the ack were not credited back
+        this.replenish();
+        if (this.reader)
+            this.arm(this.timeoutMs, NO_FRAME);
+    }
+    take() {
+        const value = this.buffer.shift();
+        this.consumed++;
+        this.replenish();
+        return value;
+    }
+    /** Grants in batches of at least half the window, so a fast consumer does not send one frame per chunk. */
+    replenish() {
+        if (this.phase !== 'open')
+            return;
+        const free = this.window - (this.granted - this.consumed);
+        if (free < Math.max(1, Math.floor(this.window / 2)))
+            return;
+        const credit = { id: this.requestId, credits: free };
+        if (this.host.connection.send(WIRE_EVENTS.credit, credit))
+            this.granted += free;
+    }
+    /** Ends the stream from this side: buffered items are dropped and the server is told to stop. */
+    stop(error) {
+        this.buffer.length = 0;
+        if (this.phase === 'sent' || this.phase === 'open') {
+            const cancel = { id: this.requestId };
+            this.host.connection.send(WIRE_EVENTS.cancel, cancel);
+        }
+        this.finish(error);
+    }
+    finish(error) {
+        if (this.phase === 'done')
+            return;
+        this.phase = 'done';
+        this.disarm();
+        this.options.signal?.removeEventListener('abort', this.onAbort);
+        this.host.release(this);
+        if (error !== null)
+            this.failure = SocketException.fromWire(error);
+        // a waiting reader means the buffer is empty
+        const reader = this.reader;
+        if (!reader)
+            return;
+        this.reader = null;
+        if (this.failure === null)
+            reader.resolve({ value: undefined, done: true });
+        else
+            reader.reject(this.failure);
+    }
+    arm(ms, error) {
+        this.disarm();
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            this.stop(error);
+        }, ms);
+    }
+    disarm() {
+        if (this.timer === undefined)
+            return;
+        clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+}
+//# sourceMappingURL=streams.js.map

package/lib/mjs/streams.js.map

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

package/lib/mjs/timeout.d.ts

@@ -0,0 +1,4 @@
+/** setTimeout fires immediately for a delay above this (a 32-bit signed integer). */
+export declare const MAX_TIMER_MS = 2147483647;
+export declare function assertTimeoutMs(name: string, value: number): number;
+//# sourceMappingURL=timeout.d.ts.map

package/lib/mjs/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/timeout.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,YAAY,aAAgB,CAAC;AAE1C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnE"}

package/lib/mjs/timeout.js

@@ -0,0 +1,9 @@
+/** setTimeout fires immediately for a delay above this (a 32-bit signed integer). */
+export const MAX_TIMER_MS = 2_147_483_647;
+export function assertTimeoutMs(name, value) {
+    if (!(Number.isFinite(value) && value > 0 && value <= MAX_TIMER_MS)) {
+        throw new RangeError(`${name} must be a finite number within (0, ${MAX_TIMER_MS}], got ${value}`);
+    }
+    return value;
+}
+//# sourceMappingURL=timeout.js.map

package/lib/mjs/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/timeout.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,YAAY,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,uCAAuC,YAAY,UAAU,KAAK,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}