@mindpeeker/entropy 0.1.0

package/dist/providers/solana.js

@@ -0,0 +1,83 @@
+import { EntropyError } from '../errors.js';
+import { concatBytes } from '../internal/bytes.js';
+import { base58Decode } from '../internal/encoding.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { sleep } from '../internal/rate-limit.js';
+import { beaconStream } from '../internal/stream.js';
+const INFO = Object.freeze({
+    name: 'solana',
+    kind: 'beacon',
+    privacy: 'public',
+});
+const HASH_BYTES = 32;
+const DEFAULT_URL = 'https://api.mainnet-beta.solana.com/';
+// ~400 ms slots; poll politely.
+const DEFAULT_POLL_INTERVAL_MS = 500;
+/**
+ * Solana latest blockhash as a PUBLIC crypto-beacon (fast ~400 ms slots).
+ * The slot leader influences block content, so treat it like every other
+ * chain beacon: auditable public randomness, never private entropy.
+ */
+export function solanaBeacon(opts = {}) {
+    const { url = DEFAULT_URL, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, fetch: fetchImpl } = opts;
+    async function fetchLatest(signal) {
+        const res = await fetchJson(url, {
+            provider: INFO.name,
+            method: 'POST',
+            body: { jsonrpc: '2.0', id: 1, method: 'getLatestBlockhash' },
+            signal,
+            fetchImpl,
+        });
+        const slot = res?.result?.context?.slot;
+        const blockhash = res?.result?.value?.blockhash;
+        if (!Number.isInteger(slot) || typeof blockhash !== 'string') {
+            throw new EntropyError('bad_response', 'missing blockhash/slot', { provider: INFO.name });
+        }
+        let bytes;
+        try {
+            bytes = base58Decode(blockhash);
+        }
+        catch (error) {
+            throw new EntropyError('bad_response', 'invalid base58 blockhash', {
+                provider: INFO.name,
+                cause: error,
+            });
+        }
+        if (bytes.length !== HASH_BYTES) {
+            throw new EntropyError('bad_response', `blockhash decodes to ${bytes.length} bytes`, {
+                provider: INFO.name,
+            });
+        }
+        return { slot: slot, bytes };
+    }
+    return defineProvider({
+        ...INFO,
+        defaultChunkBytes: HASH_BYTES,
+        async getBytes(length, reqOpts) {
+            // no keyless historical route — aggregate consecutive fresh slots,
+            // waiting out repeats (slots are ~400 ms, so this stays cheap)
+            const chunks = [];
+            let collected = 0;
+            let lastSlot = -1;
+            while (collected < length) {
+                const { slot, bytes } = await fetchLatest(reqOpts?.signal);
+                if (slot === lastSlot) {
+                    await sleep(pollIntervalMs, reqOpts?.signal);
+                    continue;
+                }
+                lastSlot = slot;
+                chunks.push(bytes);
+                collected += bytes.length;
+            }
+            return { bytes: concatBytes(chunks).slice(0, length), sources: [INFO] };
+        },
+        stream(streamOpts = {}) {
+            return beaconStream(async (signal) => {
+                const { slot, bytes } = await fetchLatest(signal);
+                return { id: slot, bytes };
+            }, pollIntervalMs, HASH_BYTES, INFO.name, streamOpts);
+        },
+    });
+}
+//# sourceMappingURL=solana.js.map

package/dist/providers/solana.js.map

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

package/dist/providers/superrand.d.ts

@@ -0,0 +1,35 @@
+import type { EntropyProvider } from '../types.js';
+/** The subset of the WebSocket surface this provider uses (injectable in tests). */
+export interface WebSocketLike {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    onopen: (() => void) | null;
+    onmessage: ((event: {
+        data: string;
+    }) => void) | null;
+    onerror: (() => void) | null;
+    onclose: ((event: {
+        code: number;
+        wasClean: boolean;
+    }) => void) | null;
+}
+export type WebSocketConstructor = new (url: string | URL) => WebSocketLike;
+export interface SuperRandOptions {
+    /** SuperRand API key (goes into the query string per their API design). */
+    apiKey: string;
+    fetch?: typeof fetch;
+    /** Injectable WebSocket constructor — also the Node 20 escape hatch. */
+    WebSocketCtor?: WebSocketConstructor | typeof WebSocket;
+    baseUrl?: string;
+    wsUrl?: string;
+    /** Base delay for exponential reconnect backoff. Default 500. */
+    reconnectBaseDelayMs?: number;
+}
+/**
+ * SuperRand (Spence Technologies) — electromagnetic background-noise TRNG.
+ * REST for `getBytes`; the only public entropy API with WebSocket delivery,
+ * used for `stream()`. The stream keeps exactly one request in flight per
+ * connection (the protocol has no correlation id — responses are FIFO).
+ */
+export declare function superRand(opts: SuperRandOptions): EntropyProvider;
+//# sourceMappingURL=superrand.d.ts.map

package/dist/providers/superrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"superrand.d.ts","sourceRoot":"","sources":["../../src/providers/superrand.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAA2C,MAAM,aAAa,CAAA;AAe3F,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3C,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IACrD,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;CACvE;AAED,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,EAAE,MAAM,GAAG,GAAG,KAAK,aAAa,CAAA;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,wEAAwE;IACxE,aAAa,CAAC,EAAE,oBAAoB,GAAG,OAAO,SAAS,CAAA;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AA8BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CA2NjE"}

package/dist/providers/superrand.js

@@ -0,0 +1,215 @@
+import { EntropyError } from '../errors.js';
+import { concatBytes } from '../internal/bytes.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { sleep } from '../internal/rate-limit.js';
+import { byteArrayFrom } from '../internal/validate.js';
+const INFO = Object.freeze({
+    name: 'superrand',
+    kind: 'trng',
+    privacy: 'private',
+});
+// Live-verified: the API rejects count > 256 with INVALID_COUNT_RANGE.
+const MAX_PER_REQUEST = 256;
+const DEFAULT_BASE_URL = 'https://api.super-rand.io/v1/';
+const DEFAULT_WS_URL = 'wss://api.super-rand.io/v1/';
+const DEFAULT_STREAM_CHUNK = 32;
+const MAX_RECONNECTS = 3;
+const DEFAULT_REQUEST_TIMEOUT_MS = 10_000;
+// Wire format LIVE-VERIFIED 2026-07-07 against api.super-rand.io:
+// - Request (REST body and WS frame, strict schema — extra fields rejected):
+//     {request:'integer', min:0, max:255, count:n}   with n ≤ 256
+// - REST response: {res: number | number[], jobType, length, ...}
+//   (`res` is a bare number when count is 1/omitted)
+// - WS response:   {status:'success', data:{res,...}, signature}
+//                | {status:'error', error:{code,message}}
+//   No tag/id field exists; responses arrive in request (FIFO) order.
+function integerRequest(count) {
+    return { request: 'integer', min: 0, max: 255, count };
+}
+/** `res` is a bare number for single-value requests — normalize to an array. */
+function normalizeRes(res) {
+    return typeof res === 'number' ? [res] : res;
+}
+/**
+ * SuperRand (Spence Technologies) — electromagnetic background-noise TRNG.
+ * REST for `getBytes`; the only public entropy API with WebSocket delivery,
+ * used for `stream()`. The stream keeps exactly one request in flight per
+ * connection (the protocol has no correlation id — responses are FIFO).
+ */
+export function superRand(opts) {
+    if (!opts?.apiKey)
+        throw new TypeError('superRand({ apiKey }) requires a non-empty apiKey');
+    const { apiKey, baseUrl = DEFAULT_BASE_URL, wsUrl = DEFAULT_WS_URL, reconnectBaseDelayMs = 500, fetch: fetchImpl, } = opts;
+    const WebSocketCtor = (opts.WebSocketCtor ??
+        globalThis.WebSocket);
+    function openConnection() {
+        return new Promise((resolve, reject) => {
+            if (!WebSocketCtor) {
+                reject(new TypeError('superRand stream() needs a WebSocket implementation — pass WebSocketCtor (Node 20 has no global WebSocket)'));
+                return;
+            }
+            const socket = new WebSocketCtor(`${wsUrl}?key=${encodeURIComponent(apiKey)}`);
+            let pending = null;
+            let opened = false;
+            let closedByUs = false;
+            const connection = {
+                dead: false,
+                request(n, signal, timeoutMs) {
+                    return new Promise((resolveReq, rejectReq) => {
+                        if (connection.dead) {
+                            rejectReq(new EntropyError('network', 'connection is closed', { provider: INFO.name }));
+                            return;
+                        }
+                        const timer = setTimeout(() => {
+                            settle(new EntropyError('timeout', `no response within ${timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS}ms`, { provider: INFO.name }));
+                        }, timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS);
+                        const onAbort = () => settle(new EntropyError('aborted', 'request aborted', { provider: INFO.name }));
+                        const settle = (error, bytes) => {
+                            pending = null;
+                            clearTimeout(timer);
+                            signal?.removeEventListener('abort', onAbort);
+                            if (error)
+                                rejectReq(error);
+                            else
+                                resolveReq(bytes);
+                        };
+                        if (signal?.aborted) {
+                            settle(new EntropyError('aborted', 'request aborted', { provider: INFO.name }));
+                            return;
+                        }
+                        signal?.addEventListener('abort', onAbort, { once: true });
+                        pending = { expected: n, settle };
+                        socket.send(JSON.stringify(integerRequest(n)));
+                    });
+                },
+                close() {
+                    closedByUs = true;
+                    connection.dead = true;
+                    socket.close();
+                },
+            };
+            const fail = () => {
+                if (connection.dead && !pending)
+                    return;
+                connection.dead = true;
+                const error = new EntropyError('network', 'SuperRand WebSocket connection lost', {
+                    provider: INFO.name,
+                });
+                pending?.settle(error);
+                pending = null;
+                if (!opened && !closedByUs)
+                    reject(error);
+            };
+            socket.onopen = () => {
+                opened = true;
+                resolve(connection);
+            };
+            socket.onerror = fail;
+            socket.onclose = fail;
+            socket.onmessage = (event) => {
+                let message;
+                try {
+                    message = JSON.parse(String(event.data));
+                }
+                catch {
+                    return; // ignore unparseable frames
+                }
+                const entry = pending;
+                if (!entry)
+                    return; // nothing in flight — late or unsolicited frame
+                if (message.status === 'error') {
+                    entry.settle(new EntropyError('bad_response', `SuperRand error ${message.error?.code ?? 'unknown'}: ${message.error?.message ?? ''}`, { provider: INFO.name }));
+                    return;
+                }
+                try {
+                    entry.settle(null, byteArrayFrom(normalizeRes(message.data?.res), entry.expected, INFO.name));
+                }
+                catch (error) {
+                    entry.settle(error instanceof EntropyError
+                        ? error
+                        : new EntropyError('bad_response', 'malformed frame', {
+                            provider: INFO.name,
+                            cause: error,
+                        }));
+                }
+            };
+        });
+    }
+    async function* wsStream(opts) {
+        const chunkBytes = opts.chunkBytes ?? DEFAULT_STREAM_CHUNK;
+        let connection = null;
+        let failures = 0;
+        try {
+            while (true) {
+                if (opts.signal?.aborted) {
+                    throw new EntropyError('aborted', 'stream aborted', { provider: INFO.name });
+                }
+                if (!connection || connection.dead) {
+                    try {
+                        connection = await openConnection();
+                    }
+                    catch (error) {
+                        failures++;
+                        if (failures > MAX_RECONNECTS) {
+                            throw error instanceof TypeError
+                                ? error
+                                : new EntropyError('network', `SuperRand WebSocket failed after ${MAX_RECONNECTS} reconnect attempts`, { provider: INFO.name, cause: error });
+                        }
+                        await sleep(reconnectBaseDelayMs * 2 ** (failures - 1), opts.signal);
+                        continue;
+                    }
+                }
+                try {
+                    const bytes = await connection.request(chunkBytes, opts.signal, opts.timeoutMs);
+                    failures = 0;
+                    yield bytes;
+                }
+                catch (error) {
+                    if (error instanceof EntropyError &&
+                        (error.code === 'aborted' ||
+                            error.code === 'bad_response' ||
+                            error.code === 'invalid_request')) {
+                        throw error;
+                    }
+                    connection.close();
+                    connection = null;
+                    failures++;
+                    if (failures > MAX_RECONNECTS) {
+                        throw new EntropyError('network', `SuperRand WebSocket failed after ${MAX_RECONNECTS} reconnect attempts`, { provider: INFO.name, cause: error });
+                    }
+                    await sleep(reconnectBaseDelayMs * 2 ** (failures - 1), opts.signal);
+                }
+            }
+        }
+        finally {
+            // TS narrows `connection` to never after the infinite loop; widen it.
+            ;
+            connection?.close();
+        }
+    }
+    return defineProvider({
+        ...INFO,
+        defaultChunkBytes: DEFAULT_STREAM_CHUNK,
+        async getBytes(length, reqOpts) {
+            const chunks = [];
+            for (let remaining = length; remaining > 0;) {
+                const n = Math.min(MAX_PER_REQUEST, remaining);
+                const res = await fetchJson(`${baseUrl}?key=${encodeURIComponent(apiKey)}`, {
+                    provider: INFO.name,
+                    method: 'POST',
+                    body: integerRequest(n),
+                    signal: reqOpts?.signal,
+                    fetchImpl,
+                });
+                chunks.push(byteArrayFrom(normalizeRes(res?.res), n, INFO.name));
+                remaining -= n;
+            }
+            return { bytes: concatBytes(chunks), sources: [INFO] };
+        },
+        stream(opts = {}) {
+            return wsStream(opts);
+        },
+    });
+}
+//# sourceMappingURL=superrand.js.map

package/dist/providers/superrand.js.map

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

package/dist/providers/tezos.d.ts

@@ -0,0 +1,13 @@
+import type { EntropyProvider } from '../types.js';
+export interface TezosBeaconOptions {
+    fetch?: typeof fetch;
+    baseUrl?: string;
+    pollIntervalMs?: number;
+}
+/**
+ * Tezos head block hashes as a PUBLIC crypto-beacon, read through the TzKT
+ * indexer — note the extra trust in a third-party indexer on top of the usual
+ * baker influence. Auditable public randomness only.
+ */
+export declare function tezosBeacon(opts?: TezosBeaconOptions): EntropyProvider;
+//# sourceMappingURL=tezos.d.ts.map

package/dist/providers/tezos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tezos.d.ts","sourceRoot":"","sources":["../../src/providers/tezos.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAA;AAcrE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAqCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,eAAe,CAuD1E"}

package/dist/providers/tezos.js

@@ -0,0 +1,92 @@
+import { EntropyError } from '../errors.js';
+import { concatBytes } from '../internal/bytes.js';
+import { base58Decode } from '../internal/encoding.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { beaconStream } from '../internal/stream.js';
+const INFO = Object.freeze({
+    name: 'tezos',
+    kind: 'beacon',
+    privacy: 'public',
+});
+const HASH_BYTES = 32;
+const PREFIX_BYTES = 2; // Tezos block hashes: base58check payload starts [1, 52]
+const CHECKSUM_BYTES = 4;
+const DEFAULT_BASE_URL = 'https://api.tzkt.io';
+// ~8 s blocks.
+const DEFAULT_POLL_INTERVAL_MS = 10_000;
+/** base58check-decode a Tezos block hash and return its 32 payload bytes. */
+async function decodeBlockHash(hash) {
+    let full;
+    try {
+        full = base58Decode(hash);
+    }
+    catch (error) {
+        throw new EntropyError('bad_response', 'invalid base58 block hash', {
+            provider: INFO.name,
+            cause: error,
+        });
+    }
+    if (full.length !== PREFIX_BYTES + HASH_BYTES + CHECKSUM_BYTES) {
+        throw new EntropyError('bad_response', `block hash decodes to ${full.length} bytes`, {
+            provider: INFO.name,
+        });
+    }
+    const payload = full.slice(0, PREFIX_BYTES + HASH_BYTES);
+    const checksum = full.slice(PREFIX_BYTES + HASH_BYTES);
+    const first = new Uint8Array(await crypto.subtle.digest('SHA-256', payload));
+    const second = new Uint8Array(await crypto.subtle.digest('SHA-256', first));
+    for (let i = 0; i < CHECKSUM_BYTES; i++) {
+        if (checksum[i] !== second[i]) {
+            throw new EntropyError('bad_response', 'block hash checksum mismatch', {
+                provider: INFO.name,
+            });
+        }
+    }
+    return payload.slice(PREFIX_BYTES);
+}
+/**
+ * Tezos head block hashes as a PUBLIC crypto-beacon, read through the TzKT
+ * indexer — note the extra trust in a third-party indexer on top of the usual
+ * baker influence. Auditable public randomness only.
+ */
+export function tezosBeacon(opts = {}) {
+    const { baseUrl = DEFAULT_BASE_URL, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, fetch: fetchImpl, } = opts;
+    async function fetchBlock(path, signal) {
+        const res = await fetchJson(`${baseUrl}${path}`, {
+            provider: INFO.name,
+            signal,
+            fetchImpl,
+        });
+        if (typeof res?.hash !== 'string' || !Number.isInteger(res?.level)) {
+            throw new EntropyError('bad_response', 'missing block hash/level', { provider: INFO.name });
+        }
+        return { level: res.level, bytes: await decodeBlockHash(res.hash) };
+    }
+    return defineProvider({
+        ...INFO,
+        defaultChunkBytes: HASH_BYTES,
+        async getBytes(length, reqOpts) {
+            const blocksNeeded = Math.ceil(length / HASH_BYTES);
+            const head = await fetchBlock('/v1/head', reqOpts?.signal);
+            const chunks = [head.bytes];
+            for (let i = 1; i < blocksNeeded; i++) {
+                const level = head.level - i;
+                if (level < 1) {
+                    throw new EntropyError('insufficient_entropy', 'not enough blocks for request', {
+                        provider: INFO.name,
+                    });
+                }
+                chunks.push((await fetchBlock(`/v1/blocks/${level}`, reqOpts?.signal)).bytes);
+            }
+            return { bytes: concatBytes(chunks).slice(0, length), sources: [INFO] };
+        },
+        stream(streamOpts = {}) {
+            return beaconStream(async (signal) => {
+                const head = await fetchBlock('/v1/head', signal);
+                return { id: head.level, bytes: head.bytes };
+            }, pollIntervalMs, HASH_BYTES, INFO.name, streamOpts);
+        },
+    });
+}
+//# sourceMappingURL=tezos.js.map

package/dist/providers/tezos.js.map

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

package/dist/providers/uchile.d.ts

@@ -0,0 +1,11 @@
+import { type NistFamilyOptions } from '../internal/nist-pulse.js';
+import type { EntropyProvider } from '../types.js';
+export interface UchileOptions extends NistFamilyOptions {
+}
+/**
+ * Random UChile (CLCERT, Universidad de Chile) — hybrid beacon mixing a local
+ * quantum device with seismic, radio and other public inputs; 512 bits every
+ * 60 seconds. PUBLIC randomness.
+ */
+export declare function uchile(opts?: UchileOptions): EntropyProvider;
+//# sourceMappingURL=uchile.d.ts.map

package/dist/providers/uchile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uchile.d.ts","sourceRoot":"","sources":["../../src/providers/uchile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,2BAA2B,CAAA;AACnF,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAA;AAQrE,MAAM,WAAW,aAAc,SAAQ,iBAAiB;CAAG;AAE3D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,eAAe,CAYhE"}

package/dist/providers/uchile.js

@@ -0,0 +1,22 @@
+import { nistPulseBeacon } from '../internal/nist-pulse.js';
+const INFO = Object.freeze({
+    name: 'uchile',
+    kind: 'beacon',
+    privacy: 'public',
+});
+/**
+ * Random UChile (CLCERT, Universidad de Chile) — hybrid beacon mixing a local
+ * quantum device with seismic, radio and other public inputs; 512 bits every
+ * 60 seconds. PUBLIC randomness.
+ */
+export function uchile(opts = {}) {
+    return nistPulseBeacon({
+        info: INFO,
+        defaultBaseUrl: 'https://random.uchile.cl/beacon/2.1-beta',
+        // NB: their '/pulse/last' route is a genuine 404 — the query form is
+        // the working "latest" endpoint.
+        latestPath: '/pulse?chainId=last&pulseId=last',
+        defaultPollIntervalMs: 60_000,
+    }, opts);
+}
+//# sourceMappingURL=uchile.js.map

package/dist/providers/uchile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uchile.js","sourceRoot":"","sources":["../../src/providers/uchile.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAGnF,MAAM,IAAI,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAA;AAIF;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,OAAsB,EAAE;IAC7C,OAAO,eAAe,CACpB;QACE,IAAI,EAAE,IAAI;QACV,cAAc,EAAE,0CAA0C;QAC1D,qEAAqE;QACrE,iCAAiC;QACjC,UAAU,EAAE,kCAAkC;QAC9C,qBAAqB,EAAE,MAAM;KAC9B,EACD,IAAI,CACL,CAAA;AACH,CAAC"}

package/dist/strategies/fallback.d.ts

@@ -0,0 +1,12 @@
+import type { EntropyProvider } from '../types.js';
+export interface FallbackOptions {
+    /** Budget per member attempt before moving to the next. Default 10_000. */
+    attemptTimeoutMs?: number;
+}
+/**
+ * Try providers strictly in array order; the first success wins. An attempt
+ * that fails or exceeds `attemptTimeoutMs` moves the chain along; a caller
+ * abort stops the chain immediately. Attribution reports the winner's sources.
+ */
+export declare function fallback(providers: EntropyProvider[], opts?: FallbackOptions): EntropyProvider;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/strategies/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/strategies/fallback.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,eAAe,EAAE,EAC5B,IAAI,GAAE,eAAoB,GACzB,eAAe,CAkCjB"}

package/dist/strategies/fallback.js

@@ -0,0 +1,45 @@
+import { EntropyError } from '../errors.js';
+import { abortedError, commonKind, compositeName, pessimisticPrivacy, requireProviders, toEntropyError, } from '../internal/composite.js';
+import { defineProvider } from '../internal/provider.js';
+/**
+ * Try providers strictly in array order; the first success wins. An attempt
+ * that fails or exceeds `attemptTimeoutMs` moves the chain along; a caller
+ * abort stops the chain immediately. Attribution reports the winner's sources.
+ */
+export function fallback(providers, opts = {}) {
+    requireProviders(providers, 'fallback');
+    const members = [...providers];
+    const attemptTimeoutMs = opts.attemptTimeoutMs ?? 10_000;
+    const name = compositeName('fallback', members);
+    return defineProvider({
+        name,
+        kind: commonKind(members),
+        privacy: pessimisticPrivacy(members),
+        // Leave room for every member to use its full attempt budget by default.
+        defaultTimeoutMs: attemptTimeoutMs * members.length + 1000,
+        async getBytes(length, reqOpts) {
+            const errors = [];
+            for (const member of members) {
+                if (reqOpts?.signal?.aborted)
+                    throw abortedError(name);
+                try {
+                    return await member.getBytes(length, {
+                        signal: reqOpts?.signal,
+                        timeoutMs: attemptTimeoutMs,
+                    });
+                }
+                catch (error) {
+                    const entropyError = toEntropyError(error, member.name);
+                    if (entropyError.code === 'aborted')
+                        throw entropyError;
+                    errors.push(entropyError);
+                }
+            }
+            throw new EntropyError('insufficient_entropy', `all ${members.length} providers failed`, {
+                provider: name,
+                cause: new AggregateError(errors, `all providers in ${name} failed`),
+            });
+        },
+    });
+}
+//# sourceMappingURL=fallback.js.map

package/dist/strategies/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/strategies/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAQxD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,SAA4B,EAC5B,OAAwB,EAAE;IAE1B,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACvC,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;IAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAA;IACxD,MAAM,IAAI,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAE/C,OAAO,cAAc,CAAC;QACpB,IAAI;QACJ,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC;QACzB,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC;QACpC,yEAAyE;QACzE,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI;QAE1D,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO;YAC5B,MAAM,MAAM,GAAmB,EAAE,CAAA;YACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO;oBAAE,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;gBACtD,IAAI,CAAC;oBACH,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;wBACnC,MAAM,EAAE,OAAO,EAAE,MAAM;wBACvB,SAAS,EAAE,gBAAgB;qBAC5B,CAAC,CAAA;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;oBACvD,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS;wBAAE,MAAM,YAAY,CAAA;oBACvD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;gBAC3B,CAAC;YACH,CAAC;YACD,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,OAAO,OAAO,CAAC,MAAM,mBAAmB,EAAE;gBACvF,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,IAAI,cAAc,CAAC,MAAM,EAAE,oBAAoB,IAAI,SAAS,CAAC;aACrE,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/strategies/race.d.ts

@@ -0,0 +1,7 @@
+import type { EntropyProvider } from '../types.js';
+/**
+ * Start ALL members simultaneously; the first fulfillment wins and the losers
+ * are cancelled via AbortSignal. Attribution reports only the winner.
+ */
+export declare function race(providers: EntropyProvider[]): EntropyProvider;
+//# sourceMappingURL=race.d.ts.map

package/dist/strategies/race.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.d.ts","sourceRoot":"","sources":["../../src/strategies/race.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,CAsClE"}

package/dist/strategies/race.js

@@ -0,0 +1,41 @@
+import { EntropyError } from '../errors.js';
+import { abortedError, commonKind, compositeName, pessimisticPrivacy, requireProviders, toEntropyError, } from '../internal/composite.js';
+import { defineProvider } from '../internal/provider.js';
+/**
+ * Start ALL members simultaneously; the first fulfillment wins and the losers
+ * are cancelled via AbortSignal. Attribution reports only the winner.
+ */
+export function race(providers) {
+    requireProviders(providers, 'race');
+    const members = [...providers];
+    const name = compositeName('race', members);
+    return defineProvider({
+        name,
+        kind: commonKind(members),
+        privacy: pessimisticPrivacy(members),
+        async getBytes(length, reqOpts) {
+            const controller = new AbortController();
+            const signal = reqOpts?.signal
+                ? AbortSignal.any([reqOpts.signal, controller.signal])
+                : controller.signal;
+            const tasks = members.map((member) => member.getBytes(length, { signal, timeoutMs: reqOpts?.timeoutMs }).catch((error) => {
+                throw toEntropyError(error, member.name);
+            }));
+            try {
+                return await Promise.any(tasks);
+            }
+            catch (error) {
+                if (reqOpts?.signal?.aborted)
+                    throw abortedError(name);
+                throw new EntropyError('insufficient_entropy', `all ${members.length} providers failed in ${name}`, {
+                    provider: name,
+                    cause: error,
+                });
+            }
+            finally {
+                controller.abort(); // cancel the losers (no-op if everything settled)
+            }
+        },
+    });
+}
+//# sourceMappingURL=race.js.map