@q-ching/core 0.1.0

package/dist/entropy/qrng.js

@@ -0,0 +1,130 @@
+import { fromHex, getCrypto } from '../util.js';
+export function localCsprng(numBytes) {
+    const out = new Uint8Array(numBytes);
+    getCrypto().getRandomValues(out);
+    return out;
+}
+function getFetch(config) {
+    const f = config.fetchImpl ?? globalThis.fetch;
+    if (!f)
+        throw new Error('No fetch implementation available.');
+    return f;
+}
+async function withTimeout(p, ms) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), ms);
+    try {
+        return await p(controller.signal);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * NIST Randomness Beacon (v2). Public, keyless, quantum-seeded. Publishes a
+ * 512-bit value every 60s — the same for everyone in a given minute, which is
+ * its own kind of poetry: the cosmic pulse at the moment you asked.
+ */
+export async function fetchNistBeacon(numBytes, config = {}) {
+    const fetchImpl = getFetch(config);
+    try {
+        const res = await withTimeout((signal) => fetchImpl('https://beacon.nist.gov/beacon/2.0/pulse/last', { signal }), config.timeoutMs ?? 6000);
+        if (!res.ok)
+            return { source: 'nist', ok: false, bytes: null, detail: `HTTP ${res.status}` };
+        const json = (await res.json());
+        const hex = json?.pulse?.outputValue;
+        if (!hex)
+            return { source: 'nist', ok: false, bytes: null, detail: 'no outputValue' };
+        const full = fromHex(hex);
+        return { source: 'nist', ok: true, bytes: full.subarray(0, numBytes) };
+    }
+    catch (err) {
+        return { source: 'nist', ok: false, bytes: null, detail: String(err) };
+    }
+}
+/**
+ * ANU Quantum Random Numbers — vacuum fluctuations. The classic public
+ * endpoint is now rate-limited and may require an API key; we pass one if
+ * provided and fail gracefully otherwise.
+ */
+export async function fetchAnu(numBytes, config = {}) {
+    const fetchImpl = getFetch(config);
+    try {
+        const url = `https://qrng.anu.edu.au/API/jsonI.php?length=${numBytes}&type=uint8`;
+        const headers = {};
+        if (config.anuApiKey)
+            headers['x-api-key'] = config.anuApiKey;
+        const res = await withTimeout((signal) => fetchImpl(url, { headers, signal }), config.timeoutMs ?? 6000);
+        if (!res.ok)
+            return { source: 'anu', ok: false, bytes: null, detail: `HTTP ${res.status}` };
+        const json = (await res.json());
+        if (!json?.success || !Array.isArray(json.data)) {
+            return { source: 'anu', ok: false, bytes: null, detail: 'unsuccessful response' };
+        }
+        return { source: 'anu', ok: true, bytes: Uint8Array.from(json.data.slice(0, numBytes)) };
+    }
+    catch (err) {
+        return { source: 'anu', ok: false, bytes: null, detail: String(err) };
+    }
+}
+/** RANDOM.ORG atmospheric noise (JSON-RPC v4). Requires an API key. */
+export async function fetchRandomOrg(numBytes, config = {}) {
+    const fetchImpl = getFetch(config);
+    if (!config.randomOrgApiKey) {
+        return { source: 'random.org', ok: false, bytes: null, detail: 'no API key' };
+    }
+    try {
+        const body = {
+            jsonrpc: '2.0',
+            method: 'generateIntegers',
+            params: { apiKey: config.randomOrgApiKey, n: numBytes, min: 0, max: 255, replacement: true },
+            id: 1,
+        };
+        const res = await withTimeout((signal) => fetchImpl('https://api.random.org/json-rpc/4/invoke', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+            signal,
+        }), config.timeoutMs ?? 6000);
+        if (!res.ok)
+            return { source: 'random.org', ok: false, bytes: null, detail: `HTTP ${res.status}` };
+        const json = (await res.json());
+        const data = json?.result?.random?.data;
+        if (!Array.isArray(data)) {
+            return { source: 'random.org', ok: false, bytes: null, detail: 'no data' };
+        }
+        return { source: 'random.org', ok: true, bytes: Uint8Array.from(data) };
+    }
+    catch (err) {
+        return { source: 'random.org', ok: false, bytes: null, detail: String(err) };
+    }
+}
+/**
+ * Attempt every configured source concurrently and always include the local
+ * CSPRNG. Returns one result per attempted source (failures included, so the
+ * UI can show what answered the call).
+ */
+export async function gatherEntropy(numBytes, config = {}) {
+    const requested = config.sources ?? ['nist', 'csprng'];
+    const set = new Set(requested);
+    set.add('csprng'); // guaranteed fallback, always present
+    const jobs = [];
+    for (const source of set) {
+        switch (source) {
+            case 'nist':
+                jobs.push(fetchNistBeacon(numBytes, config));
+                break;
+            case 'anu':
+                jobs.push(fetchAnu(numBytes, config));
+                break;
+            case 'random.org':
+                jobs.push(fetchRandomOrg(numBytes, config));
+                break;
+            case 'csprng':
+                jobs.push(Promise.resolve({ source: 'csprng', ok: true, bytes: localCsprng(numBytes) }));
+                break;
+        }
+    }
+    return Promise.all(jobs);
+}
+//# sourceMappingURL=qrng.js.map

package/dist/entropy/qrng.js.map

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

package/dist/hexagram-data.d.ts

@@ -0,0 +1,2 @@
+import type { RawHexagram } from './types.js';
+export declare const HEXAGRAM_DATA: RawHexagram[];