@mindpeeker/entropy 0.1.0

package/dist/node/ffmpeg-frames.d.ts

@@ -0,0 +1,27 @@
+import type { FrameSource } from '../providers/camera.js';
+export interface FfmpegFrameOptions {
+    /** avfoundation index on macOS (e.g. '0'), v4l2 device on Linux (e.g. '/dev/video0'). */
+    device: string;
+    width?: number;
+    height?: number;
+    /** Capture framerate; omit to use the device default. */
+    fps?: number;
+    ffmpegPath?: string;
+}
+interface VideoArgsInput {
+    device: string;
+    width: number;
+    height: number;
+    fps?: number;
+}
+export declare function ffmpegVideoArgs(opts: VideoArgsInput, platform: string): string[];
+/** Stateful slicer: raw byte chunks in, complete fixed-size frames out. */
+export declare function frameSlicer(frameBytes: number): (chunk: Uint8Array) => Uint8Array[];
+/**
+ * Camera frames for Node via ffmpeg (must be on PATH or given via
+ * ffmpegPath): grayscale rawvideo piped from avfoundation (macOS) or v4l2
+ * (Linux). Plug into cameraEntropy({ source: ffmpegFrameSource({...}) }).
+ */
+export declare function ffmpegFrameSource(opts: FfmpegFrameOptions): FrameSource;
+export {};
+//# sourceMappingURL=ffmpeg-frames.d.ts.map

package/dist/node/ffmpeg-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-frames.d.ts","sourceRoot":"","sources":["../../src/node/ffmpeg-frames.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEhE,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BhF;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,EAAE,CAiBnF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CA4CvE"}

package/dist/node/ffmpeg-frames.js

@@ -0,0 +1,102 @@
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { EntropyError } from '../errors.js';
+import { concatBytes } from '../internal/bytes.js';
+export function ffmpegVideoArgs(opts, platform) {
+    const { device, width, height, fps } = opts;
+    // Cameras only accept specific native modes, so capture at the device
+    // default and CROP a center region: scaling would average pixels and
+    // smooth away the very sensor noise we harvest.
+    const framerate = fps !== undefined ? ['-framerate', String(fps)] : [];
+    const input = platform === 'darwin'
+        ? ['-f', 'avfoundation', ...framerate, '-i', device]
+        : ['-f', 'v4l2', ...framerate, '-i', device];
+    return [
+        '-hide_banner',
+        '-loglevel',
+        'error',
+        ...input,
+        '-vf',
+        `crop=${width}:${height}`,
+        '-pix_fmt',
+        'gray',
+        '-f',
+        'rawvideo',
+        // write each captured frame exactly once — the default rate sync
+        // duplicates frames massively against avfoundation wall-clock timestamps
+        '-fps_mode',
+        'passthrough',
+        '-an',
+        'pipe:1',
+    ];
+}
+/** Stateful slicer: raw byte chunks in, complete fixed-size frames out. */
+export function frameSlicer(frameBytes) {
+    let pending = [];
+    let size = 0;
+    return (chunk) => {
+        pending.push(chunk);
+        size += chunk.length;
+        if (size < frameBytes)
+            return [];
+        let all = concatBytes(pending);
+        const frames = [];
+        while (all.length >= frameBytes) {
+            frames.push(all.slice(0, frameBytes));
+            all = all.slice(frameBytes);
+        }
+        pending = all.length > 0 ? [all] : [];
+        size = all.length;
+        return frames;
+    };
+}
+/**
+ * Camera frames for Node via ffmpeg (must be on PATH or given via
+ * ffmpegPath): grayscale rawvideo piped from avfoundation (macOS) or v4l2
+ * (Linux). Plug into cameraEntropy({ source: ffmpegFrameSource({...}) }).
+ */
+export function ffmpegFrameSource(opts) {
+    // avfoundation defaults to 29.97 fps, which most cameras reject — they
+    // support exact modes like 15/30. Default to 30 on macOS; v4l2 negotiates.
+    const defaultFps = process.platform === 'darwin' ? 30 : undefined;
+    const { device, width = 640, height = 480, fps = defaultFps, ffmpegPath = 'ffmpeg' } = opts;
+    if (!device)
+        throw new TypeError('ffmpegFrameSource({ device }) requires a capture device');
+    return {
+        async *frames(signal) {
+            const child = spawn(ffmpegPath, ffmpegVideoArgs({ device, width, height, fps }, process.platform), {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderr = '';
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            try {
+                await once(child, 'spawn');
+            }
+            catch (error) {
+                throw new EntropyError('network', `ffmpeg failed to start: ${error.message}`, {
+                    provider: 'camera',
+                    cause: error,
+                });
+            }
+            const slice = frameSlicer(width * height);
+            try {
+                for await (const chunk of child.stdout) {
+                    if (signal?.aborted)
+                        throw signal.reason ?? new DOMException('aborted', 'AbortError');
+                    for (const data of slice(new Uint8Array(chunk))) {
+                        yield { width, height, data, channels: 1 };
+                    }
+                }
+                throw new EntropyError('network', `ffmpeg exited: ${stderr.trim().slice(0, 300)}`, {
+                    provider: 'camera',
+                });
+            }
+            finally {
+                child.kill('SIGKILL');
+            }
+        },
+    };
+}
+//# sourceMappingURL=ffmpeg-frames.js.map

package/dist/node/ffmpeg-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-frames.js","sourceRoot":"","sources":["../../src/node/ffmpeg-frames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAoBlD,MAAM,UAAU,eAAe,CAAC,IAAoB,EAAE,QAAgB;IACpE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAC3C,sEAAsE;IACtE,qEAAqE;IACrE,gDAAgD;IAChD,MAAM,SAAS,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACtE,MAAM,KAAK,GACT,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC;QACpD,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAChD,OAAO;QACL,cAAc;QACd,WAAW;QACX,OAAO;QACP,GAAG,KAAK;QACR,KAAK;QACL,QAAQ,KAAK,IAAI,MAAM,EAAE;QACzB,UAAU;QACV,MAAM;QACN,IAAI;QACJ,UAAU;QACV,iEAAiE;QACjE,yEAAyE;QACzE,WAAW;QACX,aAAa;QACb,KAAK;QACL,QAAQ;KACT,CAAA;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,IAAI,OAAO,GAAiB,EAAE,CAAA;IAC9B,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAA;QACpB,IAAI,IAAI,GAAG,UAAU;YAAE,OAAO,EAAE,CAAA;QAChC,IAAI,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;QAC9B,MAAM,MAAM,GAAiB,EAAE,CAAA;QAC/B,OAAO,GAAG,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAA;YACrC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAC7B,CAAC;QACD,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACrC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAA;QACjB,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,uEAAuE;IACvE,2EAA2E;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IACjE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAA;IAC3F,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAA;IAE3F,OAAO;QACL,KAAK,CAAC,CAAC,MAAM,CAAC,MAAoB;YAChC,MAAM,KAAK,GAAG,KAAK,CACjB,UAAU,EACV,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,EACjE;gBACE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CACF,CAAA;YACD,IAAI,MAAM,GAAG,EAAE,CAAA;YACf,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC3B,CAAC,CAAC,CAAA;YACF,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,2BAA4B,KAAe,CAAC,OAAO,EAAE,EAAE;oBACvF,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,KAAK;iBACb,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,CAAA;YACzC,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,MAA+B,EAAE,CAAC;oBAChE,IAAI,MAAM,EAAE,OAAO;wBAAE,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;oBACrF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;wBAChD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;oBAC5C,CAAC;gBACH,CAAC;gBACD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,kBAAkB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE;oBACjF,QAAQ,EAAE,QAAQ;iBACnB,CAAC,CAAA;YACJ,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/node/ffmpeg-samples.d.ts

@@ -0,0 +1,21 @@
+import type { SampleSource } from '../providers/microphone.js';
+export interface FfmpegSampleOptions {
+    /** avfoundation audio spec on macOS (e.g. ':0'), alsa device on Linux (e.g. 'default'). */
+    device: string;
+    sampleRate?: number;
+    ffmpegPath?: string;
+}
+interface AudioArgsInput {
+    device: string;
+    sampleRate: number;
+}
+export declare function ffmpegAudioArgs(opts: AudioArgsInput, platform: string): string[];
+/** Stateful little-endian int16 decoder that carries odd trailing bytes. */
+export declare function int16Chunker(): (chunk: Uint8Array) => Int16Array;
+/**
+ * Microphone PCM for Node via ffmpeg: mono s16le piped from avfoundation
+ * (macOS) or alsa (Linux). Plug into micEntropy({ source: ffmpegSampleSource({...}) }).
+ */
+export declare function ffmpegSampleSource(opts: FfmpegSampleOptions): SampleSource;
+export {};
+//# sourceMappingURL=ffmpeg-samples.d.ts.map

package/dist/node/ffmpeg-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-samples.d.ts","sourceRoot":"","sources":["../../src/node/ffmpeg-samples.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,mBAAmB;IAClC,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBhF;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,CAWhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAoC1E"}

package/dist/node/ffmpeg-samples.js

@@ -0,0 +1,81 @@
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { EntropyError } from '../errors.js';
+import { concatBytes } from '../internal/bytes.js';
+export function ffmpegAudioArgs(opts, platform) {
+    const { device, sampleRate } = opts;
+    const input = platform === 'darwin' ? ['-f', 'avfoundation', '-i', device] : ['-f', 'alsa', '-i', device];
+    return [
+        '-hide_banner',
+        '-loglevel',
+        'error',
+        ...input,
+        '-ar',
+        String(sampleRate),
+        '-ac',
+        '1',
+        '-f',
+        's16le',
+        'pipe:1',
+    ];
+}
+/** Stateful little-endian int16 decoder that carries odd trailing bytes. */
+export function int16Chunker() {
+    let carry = null;
+    return (chunk) => {
+        const bytes = carry ? concatBytes([carry, chunk]) : chunk;
+        const even = bytes.length - (bytes.length % 2);
+        carry = bytes.length % 2 === 1 ? bytes.slice(even) : null;
+        const out = new Int16Array(even / 2);
+        const view = new DataView(bytes.buffer, bytes.byteOffset, even);
+        for (let i = 0; i < out.length; i++)
+            out[i] = view.getInt16(i * 2, true);
+        return out;
+    };
+}
+/**
+ * Microphone PCM for Node via ffmpeg: mono s16le piped from avfoundation
+ * (macOS) or alsa (Linux). Plug into micEntropy({ source: ffmpegSampleSource({...}) }).
+ */
+export function ffmpegSampleSource(opts) {
+    const { device, sampleRate = 48_000, ffmpegPath = 'ffmpeg' } = opts;
+    if (!device)
+        throw new TypeError('ffmpegSampleSource({ device }) requires a capture device');
+    return {
+        async *samples(signal) {
+            const child = spawn(ffmpegPath, ffmpegAudioArgs({ device, sampleRate }, process.platform), {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stderr = '';
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            try {
+                await once(child, 'spawn');
+            }
+            catch (error) {
+                throw new EntropyError('network', `ffmpeg failed to start: ${error.message}`, {
+                    provider: 'microphone',
+                    cause: error,
+                });
+            }
+            const decode = int16Chunker();
+            try {
+                for await (const chunk of child.stdout) {
+                    if (signal?.aborted)
+                        throw signal.reason ?? new DOMException('aborted', 'AbortError');
+                    const samples = decode(new Uint8Array(chunk));
+                    if (samples.length > 0)
+                        yield samples;
+                }
+                throw new EntropyError('network', `ffmpeg exited: ${stderr.trim().slice(0, 300)}`, {
+                    provider: 'microphone',
+                });
+            }
+            finally {
+                child.kill('SIGKILL');
+            }
+        },
+    };
+}
+//# sourceMappingURL=ffmpeg-samples.js.map

package/dist/node/ffmpeg-samples.js.map

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

package/dist/node/hwrng.d.ts

@@ -0,0 +1,12 @@
+import type { ConditioningOptions } from '../internal/condition.js';
+import type { EntropyProvider } from '../types.js';
+export interface HwRngOptions extends ConditioningOptions {
+    /** Default /dev/hwrng — whatever hardware RNG the kernel trusts. */
+    path?: string;
+}
+/**
+ * The kernel's hardware RNG character device (Linux/Raspberry Pi; also how a
+ * plugged-in ChaosKey surfaces). Usually root-only by default.
+ */
+export declare function hwRng(opts?: HwRngOptions): EntropyProvider;
+//# sourceMappingURL=hwrng.d.ts.map

package/dist/node/hwrng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hwrng.d.ts","sourceRoot":"","sources":["../../src/node/hwrng.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,GAAE,YAAiB,GAAG,eAAe,CA6C9D"}

package/dist/node/hwrng.js

@@ -0,0 +1,43 @@
+import { createReadStream } from 'node:fs';
+import { EntropyError } from '../errors.js';
+import { sampledProvider } from '../internal/sampled.js';
+/**
+ * The kernel's hardware RNG character device (Linux/Raspberry Pi; also how a
+ * plugged-in ChaosKey surfaces). Usually root-only by default.
+ */
+export function hwRng(opts = {}) {
+    const { path = '/dev/hwrng' } = opts;
+    async function* open() {
+        const stream = createReadStream(path, { highWaterMark: 4096 });
+        try {
+            for await (const chunk of stream) {
+                yield new Uint8Array(chunk);
+            }
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === 'EACCES' || code === 'EPERM') {
+                throw new EntropyError('network', `${path} is usually root-only — run with sufficient privileges or adjust the device permissions`, { provider: 'hwrng', cause: error });
+            }
+            if (code === 'ENOENT') {
+                throw new EntropyError('network', `${path} does not exist — this system exposes no kernel hardware RNG`, { provider: 'hwrng', cause: error });
+            }
+            throw new EntropyError('network', `failed reading ${path}: ${error.message}`, {
+                provider: 'hwrng',
+                cause: error,
+            });
+        }
+        finally {
+            stream.destroy();
+        }
+    }
+    return sampledProvider({
+        name: 'hwrng',
+        kind: 'trng',
+        privacy: 'private',
+        open,
+        defaultMinEntropyPerSample: 7,
+        defaultSafetyFactor: 2,
+    }, opts);
+}
+//# sourceMappingURL=hwrng.js.map

package/dist/node/hwrng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hwrng.js","sourceRoot":"","sources":["../../src/node/hwrng.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAQxD;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,OAAqB,EAAE;IAC3C,MAAM,EAAE,IAAI,GAAG,YAAY,EAAE,GAAG,IAAI,CAAA;IAEpC,KAAK,SAAS,CAAC,CAAC,IAAI;QAClB,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAA+B,EAAE,CAAC;gBAC1D,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;YAC7B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;YAClD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1C,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,GAAG,IAAI,yFAAyF,EAChG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CACpC,CAAA;YACH,CAAC;YACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,MAAM,IAAI,YAAY,CACpB,SAAS,EACT,GAAG,IAAI,8DAA8D,EACrE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CACpC,CAAA;YACH,CAAC;YACD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,kBAAkB,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,EAAE;gBACvF,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,KAAK;aACb,CAAC,CAAA;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CACpB;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;QAClB,IAAI;QACJ,0BAA0B,EAAE,CAAC;QAC7B,mBAAmB,EAAE,CAAC;KACvB,EACD,IAAI,CACL,CAAA;AACH,CAAC"}

package/dist/node/index.d.ts

@@ -0,0 +1,9 @@
+export type { FfmpegFrameOptions } from './ffmpeg-frames.js';
+export { ffmpegFrameSource } from './ffmpeg-frames.js';
+export type { FfmpegSampleOptions } from './ffmpeg-samples.js';
+export { ffmpegSampleSource } from './ffmpeg-samples.js';
+export type { HwRngOptions } from './hwrng.js';
+export { hwRng } from './hwrng.js';
+export type { NodeSerialOptions, NodeSerialStream } from './serial-source.js';
+export { nodeSerialSource } from './serial-source.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/node/index.js

@@ -0,0 +1,7 @@
+// Node-only adapters — import from '@mindpeeker/entropy/node'.
+// The root '@mindpeeker/entropy' entry stays browser-safe.
+export { ffmpegFrameSource } from './ffmpeg-frames.js';
+export { ffmpegSampleSource } from './ffmpeg-samples.js';
+export { hwRng } from './hwrng.js';
+export { nodeSerialSource } from './serial-source.js';
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2DAA2D;AAG3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/node/rtl-sdr.d.ts

@@ -0,0 +1,31 @@
+export interface RtlSdrOptions {
+    /** Tuned frequency in Hz. Default 70 MHz — quiet spectrum, away from broadcast bands. */
+    frequencyHz?: number;
+    /** Default 2_400_000 (2.4 MS/s — higher rates drop USB samples). */
+    sampleRate?: number;
+    /** Manual tuner gain in dB. Default 49.6 (R820T max) — NEVER auto/AGC, which
+     * external transmitters modulate. */
+    gain?: number;
+    deviceIndex?: number;
+    rtlSdrPath?: string;
+}
+export interface RtlSdrStream extends AsyncIterable<Uint8Array> {
+    close(): void;
+}
+export declare function rtlSdrArgs(opts: {
+    frequencyHz: number;
+    sampleRate: number;
+    gain: number;
+    deviceIndex: number;
+}): string[];
+/**
+ * Spawn `rtl_sdr` and stream its raw IQ bytes. Needs the rtl-sdr CLI tools
+ * (apt install rtl-sdr / brew install librtlsdr) and a dongle. RTL-SDR Blog
+ * V4 dongles require the rtlsdrblog driver fork — stock librtlsdr silently
+ * produces corrupted output on V4, which is exactly why sdrEntropy runs
+ * health tests on the raw stream.
+ *
+ *   sdrEntropy({ source: await rtlSdrSource() })
+ */
+export declare function rtlSdrSource(opts?: RtlSdrOptions): Promise<RtlSdrStream>;
+//# sourceMappingURL=rtl-sdr.d.ts.map

package/dist/node/rtl-sdr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl-sdr.d.ts","sourceRoot":"","sources":["../../src/node/rtl-sdr.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;yCACqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa,CAAC,UAAU,CAAC;IAC7D,KAAK,IAAI,IAAI,CAAA;CACd;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,MAAM,EAAE,CAYX;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2ClF"}

package/dist/node/rtl-sdr.js

@@ -0,0 +1,63 @@
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { EntropyError } from '../errors.js';
+export function rtlSdrArgs(opts) {
+    return [
+        '-f',
+        String(opts.frequencyHz),
+        '-s',
+        String(opts.sampleRate),
+        '-g',
+        String(opts.gain),
+        '-d',
+        String(opts.deviceIndex),
+        '-', // raw interleaved uint8 IQ to stdout
+    ];
+}
+/**
+ * Spawn `rtl_sdr` and stream its raw IQ bytes. Needs the rtl-sdr CLI tools
+ * (apt install rtl-sdr / brew install librtlsdr) and a dongle. RTL-SDR Blog
+ * V4 dongles require the rtlsdrblog driver fork — stock librtlsdr silently
+ * produces corrupted output on V4, which is exactly why sdrEntropy runs
+ * health tests on the raw stream.
+ *
+ *   sdrEntropy({ source: await rtlSdrSource() })
+ */
+export async function rtlSdrSource(opts = {}) {
+    const { frequencyHz = 70_000_000, sampleRate = 2_400_000, gain = 49.6, deviceIndex = 0, rtlSdrPath = 'rtl_sdr', } = opts;
+    const child = spawn(rtlSdrPath, rtlSdrArgs({ frequencyHz, sampleRate, gain, deviceIndex }), {
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let stderr = '';
+    child.stderr?.on('data', (data) => {
+        stderr += data.toString();
+    });
+    try {
+        await once(child, 'spawn');
+    }
+    catch (error) {
+        throw new EntropyError('network', `rtl_sdr failed to start: ${error.message}`, {
+            provider: 'sdr',
+            cause: error,
+        });
+    }
+    let closedByUs = false;
+    return {
+        async *[Symbol.asyncIterator]() {
+            for await (const chunk of child.stdout) {
+                yield new Uint8Array(chunk);
+            }
+            if (!closedByUs) {
+                // the dongle stream must never end on its own
+                throw new EntropyError('network', `rtl_sdr exited: ${stderr.trim().slice(0, 300)}`, {
+                    provider: 'sdr',
+                });
+            }
+        },
+        close: () => {
+            closedByUs = true;
+            child.kill('SIGKILL');
+        },
+    };
+}
+//# sourceMappingURL=rtl-sdr.js.map

package/dist/node/rtl-sdr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl-sdr.js","sourceRoot":"","sources":["../../src/node/rtl-sdr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAkB3C,MAAM,UAAU,UAAU,CAAC,IAK1B;IACC,OAAO;QACL,IAAI;QACJ,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QACxB,IAAI;QACJ,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;QACvB,IAAI;QACJ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACjB,IAAI;QACJ,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QACxB,GAAG,EAAE,qCAAqC;KAC3C,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB,EAAE;IACzD,MAAM,EACJ,WAAW,GAAG,UAAU,EACxB,UAAU,GAAG,SAAS,EACtB,IAAI,GAAG,IAAI,EACX,WAAW,GAAG,CAAC,EACf,UAAU,GAAG,SAAS,GACvB,GAAG,IAAI,CAAA;IAER,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE;QAC1F,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAA;IACF,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;IACF,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,4BAA6B,KAAe,CAAC,OAAO,EAAE,EAAE;YACxF,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,KAAK;SACb,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,UAAU,GAAG,KAAK,CAAA;IACtB,OAAO;QACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,MAA+B,EAAE,CAAC;gBAChE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;YAC7B,CAAC;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,8CAA8C;gBAC9C,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,mBAAmB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE;oBAClF,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,UAAU,GAAG,IAAI,CAAA;YACjB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/node/serial-source.d.ts

@@ -0,0 +1,22 @@
+export interface NodeSerialOptions {
+    /** Serial device path, e.g. /dev/cu.usbserial-110 (macOS) or /dev/ttyUSB0 (Linux). */
+    path: string;
+    /** Default 921_600 — the AetherOnePi ESP32 firmware rate. */
+    baudRate?: number;
+    /** Override the stty binary (tests). */
+    sttyPath?: string;
+}
+export interface NodeSerialStream extends AsyncIterable<Uint8Array> {
+    close(): void;
+}
+/** stty argv per platform: -f (BSD/macOS) vs -F (GNU/Linux). */
+export declare function sttyArgs(devicePath: string, baudRate: number, platform: string): string[];
+/**
+ * Zero-npm-dependency serial reader for macOS/Linux: configures the tty via
+ * stty, then streams the character device with fs.createReadStream. Windows
+ * users should inject a `serialport` instance into serialEntropy instead.
+ *
+ *   serialEntropy({ source: await nodeSerialSource({ path }), name: 'esp32' })
+ */
+export declare function nodeSerialSource(opts: NodeSerialOptions): Promise<NodeSerialStream>;
+//# sourceMappingURL=serial-source.d.ts.map

package/dist/node/serial-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-source.d.ts","sourceRoot":"","sources":["../../src/node/serial-source.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAiB,SAAQ,aAAa,CAAC,UAAU,CAAC;IACjE,KAAK,IAAI,IAAI,CAAA;CACd;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzF;AA8BD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoBzF"}

package/dist/node/serial-source.js

@@ -0,0 +1,63 @@
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { createReadStream } from 'node:fs';
+import { EntropyError } from '../errors.js';
+/** stty argv per platform: -f (BSD/macOS) vs -F (GNU/Linux). */
+export function sttyArgs(devicePath, baudRate, platform) {
+    return [platform === 'darwin' ? '-f' : '-F', devicePath, String(baudRate), 'raw', '-echo'];
+}
+function configurePort(sttyPath, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(sttyPath, args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('error', (error) => {
+            reject(new EntropyError('network', `stty failed to start: ${error.message}`, {
+                provider: 'serial',
+                cause: error,
+            }));
+        });
+        child.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else {
+                reject(new EntropyError('network', `stty exited with ${code}: ${stderr.trim().slice(0, 200)}`, {
+                    provider: 'serial',
+                }));
+            }
+        });
+    });
+}
+/**
+ * Zero-npm-dependency serial reader for macOS/Linux: configures the tty via
+ * stty, then streams the character device with fs.createReadStream. Windows
+ * users should inject a `serialport` instance into serialEntropy instead.
+ *
+ *   serialEntropy({ source: await nodeSerialSource({ path }), name: 'esp32' })
+ */
+export async function nodeSerialSource(opts) {
+    const { path, baudRate = 921_600, sttyPath = 'stty' } = opts;
+    if (!path)
+        throw new TypeError('nodeSerialSource({ path }) requires a device path');
+    // Open our fd BEFORE running stty: tty settings reset when the last file
+    // descriptor closes (stty's own), which would silently drop the port back
+    // to 9600 baud. Holding the stream open keeps the configuration applied.
+    const stream = createReadStream(path, { highWaterMark: 4096 });
+    try {
+        await once(stream, 'open');
+        await configurePort(sttyPath, sttyArgs(path, baudRate, process.platform));
+    }
+    catch (error) {
+        stream.destroy();
+        throw error;
+    }
+    return {
+        [Symbol.asyncIterator]: () => stream[Symbol.asyncIterator](),
+        close: () => {
+            stream.destroy();
+        },
+    };
+}
+//# sourceMappingURL=serial-source.js.map

package/dist/node/serial-source.js.map

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

package/dist/providers/anu-legacy.d.ts

@@ -0,0 +1,17 @@
+import type { EntropyProvider } from '../types.js';
+export interface AnuLegacyOptions {
+    fetch?: typeof fetch;
+    baseUrl?: string;
+    /**
+     * Client-side spacing between requests. ANU's server limit is 1/minute
+     * (signalled as HTTP 500); default stays just above it.
+     */
+    minIntervalMs?: number;
+}
+/**
+ * ANU's legacy free QRNG API. Zero-config but limited to one request per
+ * minute and officially slated for retirement — use it as a fallback link,
+ * not a primary source.
+ */
+export declare function anuLegacy(opts?: AnuLegacyOptions): EntropyProvider;
+//# sourceMappingURL=anu-legacy.d.ts.map

package/dist/providers/anu-legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anu-legacy.d.ts","sourceRoot":"","sources":["../../src/providers/anu-legacy.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAA;AAWrE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,eAAe,CAqCtE"}

package/dist/providers/anu-legacy.js

@@ -0,0 +1,56 @@
+import { EntropyError } from '../errors.js';
+import { concatBytes } from '../internal/bytes.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { MinIntervalGate } from '../internal/rate-limit.js';
+import { byteArrayFrom } from '../internal/validate.js';
+const INFO = Object.freeze({
+    name: 'anu-legacy',
+    kind: 'qrng',
+    privacy: 'private',
+});
+const MAX_PER_REQUEST = 1024;
+const DEFAULT_BASE_URL = 'https://qrng.anu.edu.au/API/jsonI.php';
+const RATE_LIMIT_SNIPPET = 'limited to 1 requests per minute';
+/**
+ * ANU's legacy free QRNG API. Zero-config but limited to one request per
+ * minute and officially slated for retirement — use it as a fallback link,
+ * not a primary source.
+ */
+export function anuLegacy(opts = {}) {
+    const { baseUrl = DEFAULT_BASE_URL, minIntervalMs = 61_000, fetch: fetchImpl } = opts;
+    const gate = new MinIntervalGate(minIntervalMs);
+    return defineProvider({
+        ...INFO,
+        // At 1 request/minute, make every poll pull a full request's worth.
+        defaultChunkBytes: MAX_PER_REQUEST,
+        async getBytes(length, reqOpts) {
+            const chunks = [];
+            for (let remaining = length; remaining > 0;) {
+                const n = Math.min(MAX_PER_REQUEST, remaining);
+                await gate.wait(reqOpts?.signal);
+                const query = new URLSearchParams({ length: String(n), type: 'uint8' });
+                const res = await fetchJson(`${baseUrl}?${query}`, {
+                    provider: INFO.name,
+                    signal: reqOpts?.signal,
+                    fetchImpl,
+                    onErrorResponse: (status, body) => status === 500 && body.includes(RATE_LIMIT_SNIPPET)
+                        ? new EntropyError('rate_limited', 'ANU legacy API allows 1 request per minute', {
+                            provider: INFO.name,
+                            retryAfterMs: 60_000,
+                        })
+                        : undefined,
+                });
+                if (res?.success !== true) {
+                    throw new EntropyError('bad_response', 'ANU QRNG returned an unsuccessful response', {
+                        provider: INFO.name,
+                    });
+                }
+                chunks.push(byteArrayFrom(res.data, n, INFO.name));
+                remaining -= n;
+            }
+            return { bytes: concatBytes(chunks), sources: [INFO] };
+        },
+    });
+}
+//# sourceMappingURL=anu-legacy.js.map

package/dist/providers/anu-legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anu-legacy.js","sourceRoot":"","sources":["../../src/providers/anu-legacy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAGvD,MAAM,IAAI,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACnB,CAAC,CAAA;AACF,MAAM,eAAe,GAAG,IAAI,CAAA;AAC5B,MAAM,gBAAgB,GAAG,uCAAuC,CAAA;AAChE,MAAM,kBAAkB,GAAG,kCAAkC,CAAA;AAiB7D;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB,EAAE;IACnD,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,aAAa,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IACrF,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,aAAa,CAAC,CAAA;IAE/C,OAAO,cAAc,CAAC;QACpB,GAAG,IAAI;QACP,oEAAoE;QACpE,iBAAiB,EAAE,eAAe;QAClC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO;YAC5B,MAAM,MAAM,GAAiB,EAAE,CAAA;YAC/B,KAAK,IAAI,SAAS,GAAG,MAAM,EAAE,SAAS,GAAG,CAAC,GAAI,CAAC;gBAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;gBAC9C,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBAChC,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;gBACvE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAoB,GAAG,OAAO,IAAI,KAAK,EAAE,EAAE;oBACpE,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,MAAM,EAAE,OAAO,EAAE,MAAM;oBACvB,SAAS;oBACT,eAAe,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAChC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;wBACjD,CAAC,CAAC,IAAI,YAAY,CAAC,cAAc,EAAE,4CAA4C,EAAE;4BAC7E,QAAQ,EAAE,IAAI,CAAC,IAAI;4BACnB,YAAY,EAAE,MAAM;yBACrB,CAAC;wBACJ,CAAC,CAAC,SAAS;iBAChB,CAAC,CAAA;gBACF,IAAI,GAAG,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;oBAC1B,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,4CAA4C,EAAE;wBACnF,QAAQ,EAAE,IAAI,CAAC,IAAI;qBACpB,CAAC,CAAA;gBACJ,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;gBAClD,SAAS,IAAI,CAAC,CAAA;YAChB,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAA;QACxD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}