albex 0.1.0 → 0.3.0

package/dist/persistence.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Albex persistence layer.
+ *
+ * Backends:
+ *   - OPFS  (preferred, available in Chrome 102+, Safari 15.2+, Firefox 111+)
+ *   - IndexedDB (universal fallback)
+ *
+ * Both store a single binary blob per snapshot name. The format is opaque to
+ * this layer — see the snapshot header documented in `wasm/src/lib.rs`.
+ *
+ * API surface is intentionally minimal:
+ *   savePersisted(name, bytes)  → void
+ *   loadPersisted(name)         → Uint8Array | null
+ *   deletePersisted(name)       → void
+ *   listPersisted()             → string[]
+ */
+export declare function savePersisted(name: string, bytes: Uint8Array): Promise<void>;
+export declare function loadPersisted(name: string): Promise<Uint8Array | null>;
+export declare function deletePersisted(name: string): Promise<void>;
+export declare function listPersisted(): Promise<string[]>;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA0IH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAI5E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAIvD"}

package/dist/persistence.js

@@ -0,0 +1,174 @@
+/*!
+ * albex v0.3.0
+ * Zero-config local full-text search for documents — runs entirely in the browser, no server, no upload.
+ * (c) 2026 RafaCalRob
+ * @license MIT
+ * https://github.com/RafaCalRob/Albex#readme
+ */
+/**
+ * Albex persistence layer.
+ *
+ * Backends:
+ *   - OPFS  (preferred, available in Chrome 102+, Safari 15.2+, Firefox 111+)
+ *   - IndexedDB (universal fallback)
+ *
+ * Both store a single binary blob per snapshot name. The format is opaque to
+ * this layer — see the snapshot header documented in `wasm/src/lib.rs`.
+ *
+ * API surface is intentionally minimal:
+ *   savePersisted(name, bytes)  → void
+ *   loadPersisted(name)         → Uint8Array | null
+ *   deletePersisted(name)       → void
+ *   listPersisted()             → string[]
+ */
+const DB_NAME = 'albex';
+const STORE_NAME = 'snapshots';
+const OPFS_DIR = 'albex-snapshots';
+// ─────────────────────────────────────────────────────────────────────────────
+// Backend detection
+// ─────────────────────────────────────────────────────────────────────────────
+function hasOpfs() {
+    // navigator.storage.getDirectory is the OPFS entry point.
+    return typeof navigator !== 'undefined'
+        && typeof navigator.storage?.getDirectory === 'function';
+}
+function hasIdb() {
+    return typeof indexedDB !== 'undefined';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// OPFS backend
+// ─────────────────────────────────────────────────────────────────────────────
+async function opfsDir() {
+    const root = await navigator.storage.getDirectory();
+    return root.getDirectoryHandle(OPFS_DIR, { create: true });
+}
+async function opfsSave(name, bytes) {
+    const dir = await opfsDir();
+    const file = await dir.getFileHandle(name, { create: true });
+    const w = await file.createWritable();
+    // FileSystemWritableFileStream.write demands ArrayBuffer specifically (not
+    // ArrayBufferLike); copy through a plain Uint8Array to satisfy the type.
+    const plain = new Uint8Array(bytes.byteLength);
+    plain.set(bytes);
+    await w.write(plain);
+    await w.close();
+}
+async function opfsLoad(name) {
+    try {
+        const dir = await opfsDir();
+        const file = await dir.getFileHandle(name);
+        const f = await file.getFile();
+        return new Uint8Array(await f.arrayBuffer());
+    }
+    catch {
+        return null;
+    }
+}
+async function opfsDelete(name) {
+    try {
+        const dir = await opfsDir();
+        await dir.removeEntry(name);
+    }
+    catch { /* not found */ }
+}
+async function opfsList() {
+    const dir = await opfsDir();
+    const out = [];
+    // @ts-expect-error: async iterator on FileSystemDirectoryHandle (Web Spec)
+    for await (const [name] of dir.entries())
+        out.push(name);
+    return out;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// IndexedDB backend
+// ─────────────────────────────────────────────────────────────────────────────
+function idbOpen() {
+    return new Promise((resolve, reject) => {
+        const req = indexedDB.open(DB_NAME, 1);
+        req.onupgradeneeded = () => {
+            const db = req.result;
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                db.createObjectStore(STORE_NAME);
+            }
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+function idbReq(req) {
+    return new Promise((resolve, reject) => {
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
+}
+async function idbSave(name, bytes) {
+    const db = await idbOpen();
+    const tx = db.transaction(STORE_NAME, 'readwrite');
+    // structured-clone of a TypedArray copies the buffer once. That's the price
+    // of the IDB fallback; OPFS path avoids it.
+    tx.objectStore(STORE_NAME).put(bytes, name);
+    await new Promise((res, rej) => {
+        tx.oncomplete = () => res();
+        tx.onerror = () => rej(tx.error);
+    });
+    db.close();
+}
+async function idbLoad(name) {
+    const db = await idbOpen();
+    const tx = db.transaction(STORE_NAME, 'readonly');
+    const got = await idbReq(tx.objectStore(STORE_NAME).get(name));
+    db.close();
+    if (got instanceof Uint8Array)
+        return got;
+    if (got instanceof ArrayBuffer)
+        return new Uint8Array(got);
+    return null;
+}
+async function idbDelete(name) {
+    const db = await idbOpen();
+    const tx = db.transaction(STORE_NAME, 'readwrite');
+    tx.objectStore(STORE_NAME).delete(name);
+    await new Promise((res, rej) => {
+        tx.oncomplete = () => res();
+        tx.onerror = () => rej(tx.error);
+    });
+    db.close();
+}
+async function idbList() {
+    const db = await idbOpen();
+    const tx = db.transaction(STORE_NAME, 'readonly');
+    const keys = await idbReq(tx.objectStore(STORE_NAME).getAllKeys());
+    db.close();
+    return keys.map(k => String(k));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Backend router
+// ─────────────────────────────────────────────────────────────────────────────
+export async function savePersisted(name, bytes) {
+    if (hasOpfs())
+        return opfsSave(name, bytes);
+    if (hasIdb())
+        return idbSave(name, bytes);
+    throw new Error('No persistence backend available (OPFS or IndexedDB)');
+}
+export async function loadPersisted(name) {
+    if (hasOpfs())
+        return opfsLoad(name);
+    if (hasIdb())
+        return idbLoad(name);
+    return null;
+}
+export async function deletePersisted(name) {
+    if (hasOpfs())
+        return opfsDelete(name);
+    if (hasIdb())
+        return idbDelete(name);
+}
+export async function listPersisted() {
+    if (hasOpfs())
+        return opfsList();
+    if (hasIdb())
+        return idbList();
+    return [];
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/pool/coordinator.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pool coordinator.
+ *
+ * Runs on the main thread and orchestrates N `AlbexEngineWorker`-style
+ * shards. The corpus is split round-robin by document at index time:
+ *
+ *   indexFile(doc_i) → workers[i % N]
+ *
+ * Search broadcasts the query to every shard, collects each shard's
+ * top-K results, and performs a global heap-merge — preserving the
+ * relevance ordering of the unsharded engine. Ties broken by score.
+ *
+ * **Modes:**
+ *  - `'replicated'` (default): each worker holds its own copy of its shard.
+ *    Works in every browser, no special headers needed.
+ *  - `'shared'`: backed by SharedArrayBuffer, requires cross-origin isolation
+ *    (COOP+COEP). Single source of truth, halves the memory cost at the
+ *    expense of harder deployment.
+ *
+ * Today we ship `replicated` — `shared` is wired up to detect availability
+ * (so consumers can opt in once we land the WASM-side `SharedArrayBuffer`
+ * variant in a future iteration) but defaults to off.
+ */
+import type { AlbexOptions, IndexedDocument, SearchOptions, SearchResult, EngineStats, SearchStats } from '../albex.js';
+import type { Tier } from '../profile.js';
+export interface AlbexPoolOptions extends AlbexOptions {
+    /** Worker runtime URL (the `worker-runtime.js` from this package). */
+    workerUrl: string | URL;
+    /**
+     * Number of worker shards. `'auto'` (default) uses half of
+     * `navigator.hardwareConcurrency`, clamped to [1, 8].
+     *
+     * Pass an explicit number to override — for example `1` to debug, or
+     * a higher fixed value if you know your corpus benefits from more
+     * shards on a specific deployment.
+     */
+    workers?: number | 'auto';
+    /** Memory-sharing strategy. */
+    mode?: 'replicated' | 'shared';
+}
+export declare class AlbexPool {
+    private readonly _opts;
+    private _shards;
+    private _docsCache;
+    private _rrCursor;
+    private _lastSearch;
+    private _tier;
+    constructor(opts: AlbexPoolOptions);
+    init(): Promise<void>;
+    private _spawnShard;
+    private _send;
+    private _broadcast;
+    private _rehydrate;
+    indexFile(file: File): Promise<IndexedDocument>;
+    /**
+     * Map-reduce search:
+     *   1. broadcast the query to every shard,
+     *   2. each shard runs its local Bloom→Bitap→top-K,
+     *   3. coordinator merges the K-best from each shard,
+     *   4. global top-K returned in descending score order.
+     *
+     * Capped to `setMaxResults` results (default 50) AFTER merge.
+     */
+    search(query: string, opts?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Cooperative variant of `search`. The coordinator awaits every shard,
+     * merges, sorts, and then iterates out the result list — the iterator
+     * shape exists so callers can `break` early. Streaming individual
+     * results before the cross-shard merge would deliver them in arbitrary
+     * order; that's why we materialise first.
+     */
+    searchCooperative(query: string, opts?: SearchOptions): AsyncIterable<SearchResult>;
+    /**
+     * @deprecated Renamed to `searchCooperative` in 0.3.0. Alias removed in 0.4.0.
+     */
+    searchStream(query: string, opts?: SearchOptions): AsyncIterable<SearchResult>;
+    /**
+     * Remove a document from whichever shard owns it. Tries each shard until
+     * one reports success. O(workers) — acceptable since N ≤ 8.
+     */
+    removeDocument(id: string): Promise<boolean>;
+    compact(): Promise<void>;
+    reset(): Promise<void>;
+    /** Aggregate engine stats across all shards. */
+    getStats(): Promise<EngineStats>;
+    getLastSearchStats(): SearchStats | null;
+    getDocuments(): Promise<readonly IndexedDocument[]>;
+    setMaxErrors(n: 0 | 1 | 2 | 3): Promise<void>;
+    setThreshold(n: number): Promise<void>;
+    setMaxResults(n: number): Promise<void>;
+    setLanguage(lang: 'off' | 'es'): Promise<void>;
+    /** Number of shards currently running. */
+    get workerCount(): number;
+    /** Tier loaded by the shards (same value across all of them). */
+    get tier(): Tier | null;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/pool/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/pool/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAS1C,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;CAChC;AAkBD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,KAAK,CAAqB;gBAEtB,IAAI,EAAE,gBAAgB;IAI5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC3B,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAYZ,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAerD;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkC9E;;;;;;OAMG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,aAAa,CAAC,YAAY,CAAC;IAK9F;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,aAAa,CAAC,YAAY,CAAC;IAQzF;;;OAGG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,gDAAgD;IAC1C,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAmBtC,kBAAkB,IAAI,WAAW,GAAG,IAAI;IAIlC,YAAY,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAInD,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAS,OAAO,CAAC,IAAI,CAAC;IACnD,YAAY,CAAC,CAAC,EAAE,MAAM,GAAgB,OAAO,CAAC,IAAI,CAAC;IACnD,aAAa,CAAC,CAAC,EAAE,MAAM,GAAe,OAAO,CAAC,IAAI,CAAC;IACnD,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,GAAQ,OAAO,CAAC,IAAI,CAAC;IAEzD,0CAA0C;IAC1C,IAAI,WAAW,IAAI,MAAM,CAAgC;IAEzD,iEAAiE;IACjE,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,CAAuB;IAE9C,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CASzB"}

package/dist/pool/coordinator.js

@@ -0,0 +1,247 @@
+/**
+ * Pool coordinator.
+ *
+ * Runs on the main thread and orchestrates N `AlbexEngineWorker`-style
+ * shards. The corpus is split round-robin by document at index time:
+ *
+ *   indexFile(doc_i) → workers[i % N]
+ *
+ * Search broadcasts the query to every shard, collects each shard's
+ * top-K results, and performs a global heap-merge — preserving the
+ * relevance ordering of the unsharded engine. Ties broken by score.
+ *
+ * **Modes:**
+ *  - `'replicated'` (default): each worker holds its own copy of its shard.
+ *    Works in every browser, no special headers needed.
+ *  - `'shared'`: backed by SharedArrayBuffer, requires cross-origin isolation
+ *    (COOP+COEP). Single source of truth, halves the memory cost at the
+ *    expense of harder deployment.
+ *
+ * Today we ship `replicated` — `shared` is wired up to detect availability
+ * (so consumers can opt in once we land the WASM-side `SharedArrayBuffer`
+ * variant in a future iteration) but defaults to off.
+ */
+import { detectProfile, pickWorkerCount } from '../profile.js';
+import { AlbexInitError, AlbexError } from '../errors.js';
+let _poolSearchStreamWarned = false;
+export class AlbexPool {
+    _opts;
+    _shards = [];
+    _docsCache = [];
+    _rrCursor = 0;
+    _lastSearch = null;
+    _tier = null;
+    constructor(opts) {
+        this._opts = opts;
+    }
+    async init() {
+        const profile = await detectProfile();
+        const n = typeof this._opts.workers === 'number' && this._opts.workers > 0
+            ? Math.floor(this._opts.workers)
+            : pickWorkerCount(profile);
+        // `shared` mode would require SharedArrayBuffer + COOP/COEP. The check
+        // here is informational — actually using SAB inside the worker requires
+        // a corresponding WASM-side rework that is not yet shipped. Falling back
+        // to replicated is the safe path.
+        if (this._opts.mode === 'shared' && !profile.coopCoep) {
+            console.warn('[albex] pool mode=shared requested but cross-origin isolation is not active; falling back to replicated');
+        }
+        const shardOpts = {
+            wasmUrl: this._opts.wasmUrl,
+            wasmBaseUrl: this._opts.wasmBaseUrl,
+            pdfWasmUrl: this._opts.pdfWasmUrl,
+            tier: this._opts.tier,
+            simd: this._opts.simd,
+        };
+        for (let i = 0; i < n; i++) {
+            const shard = this._spawnShard();
+            await this._send(shard, { kind: 'init', opts: shardOpts });
+            this._shards.push(shard);
+        }
+        // Tier is the same across shards — capture it from shard 0 stats.
+        const stats0 = await this._send(this._shards[0], { kind: 'getStats' });
+        this._tier = stats0.tier;
+    }
+    // ── Shard plumbing ─────────────────────────────────────────────────────
+    _spawnShard() {
+        const worker = new Worker(this._opts.workerUrl, { type: 'module' });
+        const shard = { worker, nextId: 1, pending: new Map(), docCount: 0 };
+        worker.onmessage = (ev) => {
+            const p = shard.pending.get(ev.data.id);
+            if (!p)
+                return;
+            shard.pending.delete(ev.data.id);
+            if (ev.data.ok)
+                p.resolve(ev.data.result);
+            else
+                p.reject(this._rehydrate(ev.data.error));
+        };
+        worker.onerror = (e) => {
+            const err = new AlbexInitError(`Pool shard crashed: ${e.message}`);
+            for (const [, p] of shard.pending)
+                p.reject(err);
+            shard.pending.clear();
+        };
+        return shard;
+    }
+    _send(shard, op, transfer = []) {
+        const id = shard.nextId++;
+        const req = { id, op };
+        return new Promise((resolve, reject) => {
+            shard.pending.set(id, { resolve: resolve, reject });
+            shard.worker.postMessage(req, transfer);
+        });
+    }
+    _broadcast(op) {
+        return Promise.all(this._shards.map(s => this._send(s, op)));
+    }
+    _rehydrate(e) {
+        // Re-importing the rich subclasses here would create a circular dep
+        // with the engine wrapper; we forward the kind unchanged in a generic
+        // AlbexError instance instead.
+        if (e.kind)
+            return new AlbexError(e.kind, e.message);
+        const err = new Error(e.message);
+        err.name = e.name;
+        return err;
+    }
+    // ── Public API (mirrors AlbexEngine) ──────────────────────────────────
+    async indexFile(file) {
+        if (this._shards.length === 0)
+            throw new AlbexInitError('Pool not initialised');
+        const idx = this._rrCursor++ % this._shards.length;
+        const shard = this._shards[idx];
+        const buffer = await file.arrayBuffer();
+        const doc = await this._send(shard, { kind: 'indexFile', name: file.name, buffer }, [buffer]);
+        shard.docCount++;
+        this._docsCache.push(doc);
+        return doc;
+    }
+    /**
+     * Map-reduce search:
+     *   1. broadcast the query to every shard,
+     *   2. each shard runs its local Bloom→Bitap→top-K,
+     *   3. coordinator merges the K-best from each shard,
+     *   4. global top-K returned in descending score order.
+     *
+     * Capped to `setMaxResults` results (default 50) AFTER merge.
+     */
+    async search(query, opts = {}) {
+        if (this._shards.length === 0)
+            return [];
+        const t0 = performance.now();
+        const buckets = await Promise.all(this._shards.map(s => this._send(s, { kind: 'search', query, options: opts })));
+        // Merge: simple flatten + sort (descending). Each shard already returned
+        // up to its local cap; the global cap could be different but in practice
+        // matches the per-shard cap.
+        const merged = buckets.flat();
+        merged.sort((a, b) => b.score - a.score);
+        // Aggregate search stats across shards.
+        const stats = await Promise.all(this._shards.map(s => this._send(s, { kind: 'getLastSearchStats' })));
+        let bloomTested = 0, bloomPassed = 0, bitapMatched = 0;
+        for (const s of stats) {
+            if (!s)
+                continue;
+            bloomTested += s.bloomTested;
+            bloomPassed += s.bloomPassed;
+            bitapMatched += s.bitapMatched;
+        }
+        this._lastSearch = {
+            query,
+            timeMs: performance.now() - t0,
+            results: merged.length,
+            bloomTested, bloomPassed, bitapMatched,
+        };
+        return merged;
+    }
+    /**
+     * Cooperative variant of `search`. The coordinator awaits every shard,
+     * merges, sorts, and then iterates out the result list — the iterator
+     * shape exists so callers can `break` early. Streaming individual
+     * results before the cross-shard merge would deliver them in arbitrary
+     * order; that's why we materialise first.
+     */
+    async *searchCooperative(query, opts = {}) {
+        const results = await this.search(query, opts);
+        for (const r of results)
+            yield r;
+    }
+    /**
+     * @deprecated Renamed to `searchCooperative` in 0.3.0. Alias removed in 0.4.0.
+     */
+    async *searchStream(query, opts = {}) {
+        if (!_poolSearchStreamWarned) {
+            _poolSearchStreamWarned = true;
+            console.warn('[albex] `AlbexPool.searchStream` is deprecated; rename to `searchCooperative`. Alias removed in 0.4.0.');
+        }
+        yield* this.searchCooperative(query, opts);
+    }
+    /**
+     * Remove a document from whichever shard owns it. Tries each shard until
+     * one reports success. O(workers) — acceptable since N ≤ 8.
+     */
+    async removeDocument(id) {
+        for (const shard of this._shards) {
+            const ok = await this._send(shard, { kind: 'removeDocument', id });
+            if (ok) {
+                shard.docCount = Math.max(0, shard.docCount - 1);
+                this._docsCache = this._docsCache.filter(d => d.name !== id && d.contentHash !== id);
+                return true;
+            }
+        }
+        return false;
+    }
+    async compact() {
+        await this._broadcast({ kind: 'compact' });
+    }
+    async reset() {
+        await this._broadcast({ kind: 'reset' });
+        this._docsCache = [];
+        for (const s of this._shards)
+            s.docCount = 0;
+    }
+    /** Aggregate engine stats across all shards. */
+    async getStats() {
+        const all = await this._broadcast({ kind: 'getStats' });
+        let documents = 0, chunks = 0, textUsed = 0, textCapacity = 0, wasmMemoryBytes = 0;
+        let maxChunks = 0, maxDocs = 0;
+        for (const s of all) {
+            documents += s.documents;
+            chunks += s.chunks;
+            textUsed += s.textUsed;
+            textCapacity += s.textCapacity;
+            wasmMemoryBytes += s.wasmMemoryBytes;
+            maxChunks += s.maxChunks;
+            maxDocs += s.maxDocs;
+        }
+        return {
+            documents, chunks, textUsed, textCapacity, wasmMemoryBytes,
+            tier: this._tier, maxChunks, maxDocs,
+        };
+    }
+    getLastSearchStats() {
+        return this._lastSearch;
+    }
+    async getDocuments() {
+        return this._docsCache.slice();
+    }
+    async setMaxErrors(n) { await this._broadcast({ kind: 'setMaxErrors', n }); }
+    async setThreshold(n) { await this._broadcast({ kind: 'setThreshold', n }); }
+    async setMaxResults(n) { await this._broadcast({ kind: 'setMaxResults', n }); }
+    async setLanguage(lang) { await this._broadcast({ kind: 'setLanguage', lang }); }
+    /** Number of shards currently running. */
+    get workerCount() { return this._shards.length; }
+    /** Tier loaded by the shards (same value across all of them). */
+    get tier() { return this._tier; }
+    [Symbol.dispose]() {
+        for (const s of this._shards) {
+            for (const [, p] of s.pending)
+                p.reject(new AlbexError('disposed', 'Pool disposed'));
+            s.pending.clear();
+            s.worker.terminate();
+        }
+        this._shards = [];
+        this._docsCache = [];
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/pool/coordinator.js.map

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