albex 0.3.0 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,281 @@ All notable changes to Albex are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and Albex follows [Semantic Versioning](https://semver.org/).
 
+## [0.6.0] — 2026-05-31
+
+Release de auditoría algorítmica + robustez. Cierra los hallazgos #1–#8 de
+la revisión externa en profundidad: sube la selectividad del pre-filtro de
+forma drástica, elimina dos clases de corrupción/pérdida silenciosa de
+datos, y de paso corrige una falta de _soundness_ del filtro Bloom bajo
+matching difuso que existía desde el principio. El binario crece ~2 KB
+(33 KB baseline · 37 KB SIMD) por el código del pre-filtro de trigramas.
+
+### Breaking changes
+
+- **ABI WASM v2 → v3** (hallazgo #7). El binario principal exporta ahora
+  `getLastIndexOverflow` y el host fija el rango ABI aceptado a `[3, 3]`
+  (antes `[1, 2]`, con un mínimo inalcanzable que la lista de exports
+  requeridos ya hacía imposible). Un `.wasm` cacheado de 0.5.x falla con
+  `AlbexAbiMismatchError` claro en `init()` en vez de petar más tarde.
+
+### Added
+
+- **Pre-filtro de trigramas q-gram** (hallazgo #1). El Bloom de 64 bits
+  (un bit por `c & 0x3F`) está saturado en chunks de prosa de 512 bytes —
+  cada chunk contiene casi todo el alfabeto, así que no poda y el Bitap
+  acababa ejecutándose sobre todo el corpus. Se añade una firma de 256
+  bits de los **trigramas** de cada chunk (`CHUNK_SIG`, BSS, no infla el
+  `.wasm`) como segundo pre-filtro mucho más selectivo. Es **sound bajo
+  matching difuso**: una ocurrencia con `e` errores conserva ≥ `N − 3e`
+  de los trigramas exactos del token (lema q-gram), y la firma no tiene
+  falsos negativos, así que nunca descarta un match real — solo poda
+  chunks que demostrablemente no pueden contenerlo. El Bitap confirma
+  cada superviviente: la corrección no cambia, solo se encoge el conjunto
+  candidato.
+- **`AlbexCapacityError` con campo `limit`** (`'chunks' | 'text' | 'docs'
+  | 'names'`). El nuevo export `getLastIndexOverflow()` señaliza qué pool
+  se llenó durante el último `begin..endDocument`.
+
+### Fixed
+
+- **Pérdida silenciosa de datos al agotar capacidad** (hallazgo #3). Los
+  pools del WASM se llenaban en silencio y `indexFile` devolvía un
+  documento a medio indexar indistinguible de uno completo (`getStats()`
+  mentía). Ahora `indexFile` lee el overflow y lanza `AlbexCapacityError`.
+  El documento que desborda se **revierte atómicamente** en el WASM
+  (`endDocument` restaura `chunk_count`/`text_used`/`name_used` al inicio
+  del doc): indexación all-or-nothing por fichero, sin chunks huérfanos
+  sin nombre.
+- **Re-entrancy en el path async** (hallazgo #2). Una única instancia WASM
+  con estado global y ops async que ceden al scheduler entre slices: dos
+  operaciones solapadas se corrompían (un `searchBegin` nuevo reseteaba el
+  cursor de una búsqueda cooperativa en vuelo). Las ops async se serializan
+  ahora con una cola interna; los mutadores/búsquedas síncronos rechazan
+  ejecutarse a media operación (`AlbexError` kind `'busy'`) en vez de
+  corromper. El worker-runtime procesa mensajes estrictamente en orden.
+- **Bloom no-sound bajo fuzzy** (corolario del #1). El filtro Bloom de
+  caracteres rechazaba un match aproximado cuando el carácter sustituido
+  no estaba en el chunk (bug latente pre-0.6.0). Ahora el Bloom solo se
+  aplica a tokens exactos (`eff_errors == 0`); los tokens difusos se
+  filtran solo con el conteo de trigramas, que sí es sound.
+- **Frase + `windowed`** (hallazgo #7). El post-filtro de frase corría
+  contra el snippet recortado, así que `{ windowed: true }` podía descartar
+  un match válido cuyo segundo término caía fuera de la ventana. Ahora la
+  comprobación de adyacencia corre contra el **texto completo** del chunk;
+  el windowing solo afecta a la visualización.
+- **GPU + OR**: el hash del pre-filtro GPU usaba siempre el patrón de la
+  rama 0, generando una máscara de candidatos errónea para las ramas i≠0 de
+  una query OR y descartando sus hits en silencio (hallazgo #6).
+- **Corte de chunk a mitad de codepoint UTF-8** (hallazgo #7): el corte duro
+  a 512 bytes podía partir una secuencia multibyte; ahora retrocede a la
+  frontera de codepoint y el snippet del borde no renderiza `�`.
+- **`replaceDocument` sin reclamar espacio** (hallazgo #7): repetidos
+  replaces dejaban tombstones en el text pool; ahora se compacta de forma
+  oportunista bajo presión.
+
+### Performance
+
+- `prepareQuery` ya no hace un `memset` de 64 KB en pila por query (hallazgo
+  #4). La query de trabajo se acota a `MAX_QUERY_BYTES` (1 KB).
+
+### Tooling
+
+- `npm run relaunch`: limpia artefactos, recompila WASM (baseline + SIMD) +
+  PDF + TS + OCR, corre los tests, empaqueta la librería (`npm pack`) y
+  levanta el demo en `http://localhost:5173/demo/`. Scripts auxiliares
+  `clean` / `clean:all` / `build:ocr`.
+- Cobertura: +16 tests (110 en total) — selectividad del trigram, soundness
+  fuzzy, supervivencia de firmas tras compact/restore, error de capacidad,
+  guard de concurrencia, frase+windowed.
+
+## [0.5.0] — 2026-05-30
+
+Release de endurecimiento — cierra las cinco clases de bugs accionables
+de la auditoría externa de código. Sin nuevas features que pidan datos
+reales para ser correctas. El binario crece ~2 KB respecto a 0.4.0 por
+la lógica de query parsing en Rust + ABI version.
+
+### Breaking changes
+
+- **`@albex/ocr` ahora requiere `engine.attachOcr()`** (audit 3.8). El
+  patrón anterior de mutar `engine.ocrImage = ...` y
+  `engine.ocrConfig = ...` directamente queda eliminado. Para
+  integradores que usaban `@albex/ocr`, **el cambio es transparente** —
+  `enableOcr(engine)` sigue siendo la misma llamada. Para quien tuviera
+  un adaptador manual: usar `engine.attachOcr({ recognize, options })`.
+- **Tiers eliminados** (audit 4.1). Mini/std/pro × baseline/SIMD (6
+  binarios) consolidados a **baseline + SIMD** (2 binarios). El
+  parámetro `tier` de `AlbexOptions` queda como noop deprecado. El alias
+  `albex_wasm_bg.wasm` se mantiene para compatibilidad con `0.4.x`.
+- `pickTier(profile)` siempre devuelve `'std'` ahora. La función queda
+  exportada para compatibilidad de código fuente, no de comportamiento.
+
+### Fixed
+
+- **Validación runtime de la ABI WASM** (audit 3.2). `asAlbexExports` y
+  `asAlbexPdfExports` ya no son `as unknown as` ceremoniales — verifican
+  que `memory` sea una `WebAssembly.Memory`, que cada export requerido
+  exista, y que `abiVersion()` esté en el rango soportado. Lanzan
+  `AlbexAbiMismatchError` con la lista de exports faltantes cuando algo
+  no encaja. Antes, un binario incompatible instanciaba en silencio y
+  petaba en el primer call site que tocaba la función ausente.
+- **`makePdfWasmImports` falla rápido** ante imports desconocidos
+  (compatibilidad con el cambio anterior de 0.3.1; ya estaba pero ahora
+  alineado con la ABI version del módulo).
+
+### Added
+
+- **Canal de diagnósticos estructurado** (audit 3.6). Los `console.warn`
+  diseminados por el path de indexación desaparecen — los reemplaza un
+  buffer interno de `AlbexDiagnostic[]` consultable con
+  `engine.takeDiagnostics()`. Cada entrada es `{kind, stage, message, file?,
+  page?}` con `kind` en `'recovered' | 'skipped' | 'fallback' | 'info'`.
+  Cubre: fallback PDF→OCR, OCR fail por imagen, GPU caída a CPU, descarga
+  PDF WASM en red restringida. Capped a 256 entradas para no explotar en
+  corpus muy corruptos. La API de "best-effort" se mantiene, pero el
+  caller ahora puede inspeccionar qué se perdió.
+- **`engine.attachOcr(adapter)`** — extension point formal. Devuelve un
+  `OcrHandle` con `dispose()`. El motor valida el contrato y rechaza
+  un segundo `attachOcr` mientras haya uno activo. La propiedad pública
+  `engine.ocrImage` se mantiene como getter de feature-detect pero no es
+  asignable — para evitar el patrón anti-encapsulación del audit.
+- **`abiVersion()` exportada por ambos módulos WASM**. Main = v2 (incluye
+  query parser nuevo); PDF = v3 (incluye image extraction). El validador
+  TS rechaza binarios fuera de rango.
+
+### Architecture — query parsing moves to WASM (audit "two truths")
+
+Pre-0.5.0 el TypeScript dueño de `parseQuery`, `tokenize`,
+`tokensToWasmQuery`, mientras Rust tokenizaba al indexar. Dos verdades
+sobre qué era un "token".
+
+- Nuevos exports WASM: `prepareQuery`, `getQueryKind`,
+  `getQueryBranchCount`, `getQueryBranchPattern`, `selectQueryBranch`.
+- Hasta **8 branches OR** soportadas, **4 tokens por branch**, **256
+  bytes por pattern compilado** — todo en static BSS, sin alocación.
+- `containsPhrase` queda en TS porque opera sobre snippets (output del
+  WASM), no sobre la query — no es divergencia de tokenizer.
+- `parseQuery`, `tokenize`, `tokensToWasmQuery` eliminados del TS.
+- Un único algoritmo de "qué es un token" entre indexación y querying.
+
+### Build & maintenance
+
+- **`prepublishOnly` rebuildea WASM + corre tests** desde 0.3.1, ya
+  garantizado en 0.5.0.
+- Build pipeline simplificada: `scripts/build-wasm.mjs` produce solo
+  dos binarios. `npm pack --dry-run` muestra 4 archivos `.wasm` en lugar
+  de 8.
+- `wasm/Cargo.toml` añade `wee_alloc` (~1 KB) para el staging Vec del
+  restore atómico de 0.4.0.
+
+### Tests
+
+- 94 vitest cases verdes (era 88 en 0.4.0). Cinco tests del tier matrix
+  eliminados (mini/std/pro ya no existen). Tests nuevos:
+  - `tests/abi-validation.test.ts` (5): valida que `AlbexAbiMismatchError`
+    se lanza ante exports faltantes, abiVersion fuera de rango, memory
+    inválida.
+  - `tests/diagnostics.test.ts` (4): valida `takeDiagnostics()` drena,
+    cap a 256, reset limpia.
+
+### Postponed con razón
+
+Cosas del audit que NO se cierran en 0.5.0 porque cerrarlas sin datos
+reales sería adivinar:
+
+- **3.5 OCR paralelización**: optimización sin profiling no es ingeniería.
+- **3.9 Adaptive runtime con métricas reales**: requiere corpus y uso
+  reales para validar decisiones.
+- **4.3 GPU equivalence test**: requiere corpus >20k chunks que aún no
+  está checked in.
+- **7 parsers lite a WASM**: ~3 semanas serias. Separable. No es bug
+  fix, es mejora arquitectural más limpia con tiempo dedicado.
+
+## [0.4.0] — 2026-05-30
+
+Cierre de dos clases enteras de bugs identificadas por la auditoría externa
+de código. Sin cambios cosméticos — el binario crece ~4 KB por la lógica
+de atomicidad y el allocator necesario para el staging buffer.
+
+### Fixed — atomic snapshot restore (audit 3.4)
+
+- **Snapshot v3 con formato por campos**. Reemplaza la copia byte a byte
+  de los structs internos `Chunk`/`DocEntry` (`from_raw_parts`) por un
+  encoding explícito little-endian. El formato deja de depender del
+  layout en memoria de Rust, del target, del padding o de cambios en
+  los tipos. Lo que va al disco es un contrato.
+- **`restoreCommit()` — protocolo de 3 fases atómico**. El antiguo
+  `restoreBegin` reseteaba el estado y escribía los counters antes de
+  recibir un solo byte del payload. Si `restoreFeed` fallaba a mitad,
+  el corpus previo quedaba destruido. v3 acumula todo el payload en un
+  staging buffer y solo aplica al estado vivo cuando `restoreCommit`
+  valida que el tamaño completo coincide con el header. Un commit
+  fallido deja el motor con el corpus previo intacto.
+- **Compatibilidad backwards**. v1 y v2 siguen cargando — para ellos
+  `restoreBegin` mantiene la semántica vieja (no-atómica) y
+  `restoreCommit` es no-op que devuelve 1. El primer `save()` tras
+  cargar un snapshot viejo lo reescribe como v3.
+- Binarios crecen ~4 KB por la lógica nueva y por `wee_alloc` (única
+  fuente de alocación en el módulo, usada por el staging Vec).
+
+### Fixed — single source of truth for content hash (audit "two truths")
+
+- **FNV-1a 64-bit ahora vive en Rust**. La implementación TypeScript que
+  duplicaba el algoritmo desaparece. Tres nuevos exports
+  (`hashBegin`/`hashFeed`/`hashFinish`) implementan el hash en streaming
+  para archivos mayores que el scratchpad. El método privado del engine
+  `_contentHash` produce exactamente el mismo string hex de 16
+  caracteres que devolvía la versión TS — ningún caller cambia.
+
+### Added — tests
+
+- `tests/load-restores-docs.test.ts`: nuevo test "a v3 restore that
+  never commits leaves the previous index intact". Verifica
+  explícitamente la atomicidad: trunca el payload de un snapshot al
+  75 %, intenta cargarlo, verifica que `load()` devuelve `false` y que
+  el corpus previo sigue indexado y consultable.
+- `tests/hash.test.ts`: reescrito para validar el hash WASM contra el
+  engine real (la versión vieja era una re-implementación TS standalone
+  comparándose consigo misma). Cubre shape, determinismo, sensibilidad
+  a un byte, FNV offset basis, streaming sobre 96 KB (> scratchpad).
+- 88 tests verdes (era 85 en 0.3.1).
+
+### Postponed
+
+- Mover el tokenizador y query parser a WASM (audit "wrapper TS hace
+  demasiado") se traslada a 0.5.0. Es mejora arquitectural, no cierre
+  de bug — y tiene suficientes trade-offs de diseño (semánticas de OR,
+  post-filter de phrase) como para no publicar una API a medio cocer.
+
+## [0.3.1] — 2026-05-30
+
+Hardening pass after an external code audit. No new features; three
+specific issues addressed.
+
+### Fixed
+
+- **Debug logs removed from the indexing hot path.** Three `console.log`
+  statements added during the OCR-worker-abort diagnostic session were
+  firing on every PDF (hybrid OCR decision) and every embedded image
+  (kind / len / magic-byte trace). They are gone; the legitimate
+  `console.warn` messages for actual failures stay.
+
+- **`makePdfWasmImports` now fails fast on unknown imports.** Previously
+  any unrecognised import was satisfied with a `console.warn` stub,
+  which let the module instantiate and defer the real failure to an
+  arbitrary call inside `extractPdf`. The loader now throws
+  `AlbexInitError` at boot with a clear "rebuild your binary" message.
+  An unknown import means the wasm-bindgen / lopdf / getrandom graph
+  drifted from what this loader was written for; better to surface that
+  immediately than to hang or crash mid-extraction.
+
+- **`prepublishOnly` now rebuilds every WASM artifact and runs the
+  entire test suite.** It was running only `tsc + banner.mjs`, which
+  meant the WASM binaries published to npm could be out of sync with
+  the current Rust source. The script is now `npm run build:all && npm
+  test`. Publishing takes longer, but the package is guaranteed to
+  contain binaries reproducible from the source it ships.
+
 ## [0.3.0] — 2026-05-30
 
 ### Hybrid PDF OCR (opt-in)

package/README.md

@@ -69,7 +69,7 @@ That's the entire onboarding. Read on for what else the engine can do.
 - **Bundler-friendly default** — `new AlbexEngine()` works without extra
   configuration in bundlers that recognise the `new URL(..., import.meta.url)`
   asset pattern (see the "Install" section for the tested matrix).
-- **Fuzzy matching** — finds `"contrato"` even if you type `"conttrato"` (Bitap with adaptive edit distance).
+- **Fuzzy matching** — finds `"contrato"` even if you type `"conttrato"` (Bitap with adaptive edit distance). Sound under a two-stage pre-filter (character Bloom for exact tokens, a 256-bit **trigram q-gram signature** for everything) that prunes the candidate set ~10× on prose without ever dropping a real approximate match.
 - **Accent-insensitive** — `"accion"` matches `"acción"`, `"espana"` matches `"España"`, plus Latin Extended (Polish, Czech, Slovak, Turkish…).
 - **11 formats with varying depth** — DOCX · XLSX · PDF · HTML · MD · JSON · CSV · EML · RTF · TXT · XML. See the support table below; several formats are deliberately "lite" (CSV is RFC-4180-lite, EML is MIME-lite, RTF is regex-stripped, etc.).
 - **Phrase + OR queries** — `"contrato marco"` and `contrato | acuerdo` work out of the box.
@@ -81,8 +81,10 @@ That's the entire onboarding. Read on for what else the engine can do.
 - **WebGPU pre-filter** — experimental, opt-in (`gpu: 'auto'`). Implemented for corpora over 20 k chunks; no reproducible speedup number yet — the bench in this repo runs on a 200-document synthetic corpus only.
 - **SIMD opportunistic** — picks a SIMD-accelerated variant when the host supports v128.
 - **Tiered storage** — `TieredStore` keeps recent docs hot, evicts cold ones to OPFS, promotes on demand.
+- **Capacity-safe** — when a pool fills (`docs`/`chunks`/`text`/`names`), `indexFile` throws `AlbexCapacityError` with a `limit` field instead of silently truncating the corpus.
+- **Re-entrancy-safe** — async operations on one engine serialize; sync `search`/`compact`/`reset` refuse to run mid-operation (`AlbexError` kind `busy`) rather than corrupting the shared WASM state. Use `searchCooperative` for overlapping search-as-you-type.
 - **Typed errors** — `AlbexParseError`, `AlbexUnsupportedFormatError`, `AlbexCapacityError`, `AlbexInitError`. All extend `AlbexError`.
-- **Tiny core** — main WASM 24 KB (27 KB SIMD). PDF module (~1.2 MB) loads on demand. The OCR companion (`@albex/ocr`) is a separate package and pulls Tesseract.js (~3.5 MB) only when you call `enableOcr()`.
+- **Tiny core** — main WASM 33 KB (37 KB SIMD). PDF module (~1.2 MB) loads on demand. The OCR companion (`@albex/ocr`) is a separate package and pulls Tesseract.js (~3.5 MB) only when you call `enableOcr()`.
 
 ---
 

package/dist/albex-worker.js

@@ -1,5 +1,5 @@
 /*!
- * albex v0.3.0
+ * albex v0.6.0
  * Zero-config local full-text search for documents — runs entirely in the browser, no server, no upload.
  * (c) 2026 RafaCalRob
  * @license MIT

package/dist/albex.d.ts

@@ -45,6 +45,8 @@ export interface AlbexOptions {
      * Override the tier auto-detection. Pass `'auto'` (default), or an
      * explicit tier when you know the constraints of your target environment.
      */
+    /** @deprecated Removed in 0.5.0. Albex no longer has capacity tiers;
+     * pass `'auto'` or omit. Other values are accepted and ignored. */
     tier?: 'auto' | 'mini' | 'std' | 'pro';
     /**
      * SIMD selection. When `'auto'` (default), Albex probes for v128 support
@@ -143,6 +145,25 @@ export interface SearchStats {
     bloomPassed: number;
     bitapMatched: number;
 }
+/**
+ * One structured warning recorded by the engine during indexFile or
+ * load. Replaces the pre-0.5.0 pattern of scattered `console.warn`
+ * calls. Inspect via `engine.takeDiagnostics()` after the operation.
+ */
+export interface AlbexDiagnostic {
+    /** Coarse kind. `'recovered'` means the engine handled the issue and
+     * kept going; `'skipped'` means content was dropped; `'fallback'` means
+     * an alternate code path was used (e.g. lopdf after pdf-extract trap). */
+    kind: 'recovered' | 'skipped' | 'fallback' | 'info';
+    /** Where in the pipeline this happened. Free-form short tag. */
+    stage: 'pdf' | 'ocr' | 'gpu' | 'persistence' | 'network';
+    /** Human-readable message safe to surface in a UI. */
+    message: string;
+    /** Optional file the issue belongs to. */
+    file?: string;
+    /** Optional page number (1-based for PDFs). */
+    page?: number;
+}
 /**
  * Result shape returned by an attached OCR module. Kept structural here so
  * the main package has no runtime dependency on `@albex/ocr` — the optional
@@ -157,6 +178,36 @@ export interface OcrAttachedOptions {
     lang?: string;
     hint?: string;
 }
+/**
+ * Contract the engine accepts from an OCR plugin. `@albex/ocr` is the
+ * canonical implementation, but any module that satisfies this interface
+ * can be attached via `engine.attachOcr(adapter)`.
+ */
+export interface OcrAdapter {
+    /** Invoked by the engine to OCR a single image. Receives whatever the
+     * caller passes (Blob, ArrayBuffer, etc.); the adapter is responsible
+     * for accepting that input. Must return text + confidence. */
+    recognize(image: unknown, opts?: OcrAttachedOptions): Promise<OcrAttachedResult>;
+    /** Engine-side switches the adapter wants honoured. The only one
+     * defined today is `alwaysExtractEmbeddedImages`, which turns on the
+     * hybrid PDF OCR pass. New flags can be added without breaking the
+     * adapter interface. */
+    options?: {
+        /** When true, every PDF (native or scanned) is walked for embedded
+         * images and each qualifying image is sent to `recognize`. Off by
+         * default to keep performance predictable on native PDFs. */
+        alwaysExtractEmbeddedImages?: boolean;
+    };
+}
+/** Returned by `attachOcr`. Holds the lifecycle handles for the plugin.
+ * Calling `dispose()` removes the adapter from the engine; subsequent
+ * `engine.ocrImage` access returns `undefined` again. */
+export interface OcrHandle {
+    /** Detach the plugin and tear down any resources it holds. After this,
+     * the engine reverts to "no OCR" — scanned PDFs go back to registering
+     * with zero chunks. */
+    dispose(): Promise<void>;
+}
 export declare class AlbexEngine {
     private _wasm;
     private _mem;
@@ -166,28 +217,26 @@ export declare class AlbexEngine {
      * runtime dependency on OCR — this is a structural slot that the optional
      * companion package fills.
      */
-    ocrImage?: (image: unknown, opts?: OcrAttachedOptions) => Promise<OcrAttachedResult>;
     /**
-     * Optional OCR-side configuration set by `@albex/ocr::enableOcr`. Read
-     * by the engine to decide whether to invoke OCR on top of the text it
-     * already extracted from a PDF (hybrid PDFs: native text + images that
-     * also contain text, like stamps, scanned annexes, or diagrams with
-     * labels).
-     *
-     * When `alwaysExtractEmbeddedImages` is true, every page of every PDF
-     * passes through `extractPageImages` after the normal text extraction;
-     * any image that meets the size filter (200×200 in Rust) is fed to
-     * `ocrImage`. Performance cost: 1–3 s per qualifying image.
-     *
-     * Off by default — set this opt-in via the OCR module's options.
+     * Public OCR entry point. Forwards to the attached OCR adapter installed
+     * via `attachOcr()`. Reading this property is a feature-detect for
+     * integrators: `if (engine.ocrImage) { ... OCR available ... }`. Writing
+     * to it directly is no longer supported in 0.5.0+ — use `attachOcr`.
      */
-    ocrConfig?: {
-        alwaysExtractEmbeddedImages?: boolean;
-    };
+    get ocrImage(): ((image: unknown, opts?: OcrAttachedOptions) => Promise<OcrAttachedResult>) | undefined;
+    /** Private adapter slot. Holds the OCR plugin contract installed by
+     * `attachOcr()`. The engine reads `recognize` and `options` here; the
+     * caller never gets a reference to this object directly. */
+    private _ocrAdapter;
     private _pdfWasm;
     private _pdfMem;
     private _docs;
     private _lastSearch;
+    /** Structured diagnostics collected during the most recent operation.
+     * Drained by `takeDiagnostics()`. Capped at 256 entries to avoid
+     * unbounded memory growth in pathological cases (very corrupted
+     * corpora producing thousands of recovery warnings). */
+    private _diagnostics;
     private _tier;
     private _simd;
     private _profile;
@@ -196,7 +245,17 @@ export declare class AlbexEngine {
     private _gpuChunkCountUploaded;
     private _unsubscribeResources;
     private readonly _opts;
+    private _opChain;
+    private _busy;
     constructor(opts: AlbexOptions);
+    /** Serialize an async engine operation behind any in-flight one. */
+    private _exclusive;
+    /** Guard a synchronous mutator/search: refuse to run mid-async-operation
+     * rather than silently corrupt the shared WASM state. */
+    private _assertIdle;
+    /** Compact opportunistically when tombstones pile up under text pressure,
+     * so repeated removeDocument/replaceDocument don't exhaust the pool. */
+    private _autoCompactIfNeeded;
     /** Load and initialise the main WASM module. Must be called before any other method. */
     init(): Promise<void>;
     /**
@@ -250,6 +309,15 @@ export declare class AlbexEngine {
     private _writeStr;
     private _readPad;
     private _feedText;
+    /**
+     * Compute the FNV-1a 64-bit content hash of `bytes` via the WASM
+     * streaming API. Returns a 16-character hex string identical in shape
+     * to what the TS implementation in 0.3.x returned, so all callers
+     * stay unchanged. Single source of truth — same hash whether we use
+     * it for indexFile dedup, for snapshot v2 persistence, or anywhere
+     * else. Large inputs are chunked at FEED_SIZE just like _feedText.
+     */
+    private _contentHash;
     private _feedXmlBytes;
     private _ensurePdfWasm;
     private _indexDocx;
@@ -340,6 +408,7 @@ export declare class AlbexEngine {
      * Throws for unsupported formats or parse errors.
      */
     indexFile(file: File): Promise<IndexedDocument>;
+    private _indexFileInner;
     /**
      * Mark a previously indexed document as removed. Searches no longer return
      * its chunks. Storage is reclaimed only after `compact()`.
@@ -348,6 +417,7 @@ export declare class AlbexEngine {
      * Returns `true` if a matching document was found and tombstoned.
      */
     removeDocument(id: string): boolean;
+    private _removeDocumentInner;
     /**
      * Replace a previously indexed document with new content. Equivalent to
      * `removeDocument(name)` + `indexFile(newFile)` but does not trigger the
@@ -372,6 +442,10 @@ export declare class AlbexEngine {
      * markers instead of full chunk text. Defaults: 60 bytes before, 120 after.
      */
     search(query: string, opts?: SearchOptions): SearchResult[];
+    /** Read the WASM-compiled tokens of branch `i` for phrase post-filter.
+     * The bytes returned are exactly what the WASM tokenizer produced —
+     * no TS re-tokenization. */
+    private _branchTokens;
     /**
      * Cooperative search. Processes the corpus in slices, yielding to the
      * event loop between them so the host UI thread keeps a chance to paint
@@ -387,6 +461,9 @@ export declare class AlbexEngine {
      * Pass `opts.frameBudgetMs` to control the slice size (default 8 ms).
      */
     searchCooperative(query: string, opts?: SearchOptions): AsyncIterable<SearchResult>;
+    /** Materialise a cooperative search to a sorted result array. Runs inside
+     * the exclusivity lock. Frame-budget yielding lives in _runSearchBudgeted. */
+    private _searchCooperativeCollect;
     /**
      * @deprecated Renamed to `searchCooperative` in 0.3.0. The original name
      * was misleading — this method does not stream incremental results, it
@@ -404,9 +481,19 @@ export declare class AlbexEngine {
      * may eat the entire budget, which is also fine.
      */
     private _runSearchBudgeted;
-    /** Materialise results [0..count) into the public SearchResult shape. */
+    /** Materialise results [0..count) into the public SearchResult shape.
+     * When `phraseTokens` is given, each result is kept only if those tokens
+     * appear adjacently in the FULL chunk text — independent of any display
+     * windowing — so phrase queries stay correct under `{ windowed: true }`. */
     private _collectResults;
+    /** Run all OR branches and merge dedup-by-(doc, location, match). The
+     * branches are already compiled inside the WASM (by prepareQuery); we
+     * iterate them with selectQueryBranch. The "rawQuery" param is kept
+     * only for the lastSearch.query field. */
     private _searchOr;
+    /** Execute a single search using whichever query branch is currently
+     * active (set via selectQueryBranch). Returns the materialised
+     * SearchResult[]. Caller is responsible for activating a branch first. */
     private _runSearch;
     /** Returns current engine statistics. */
     getStats(): EngineStats;
@@ -433,6 +520,57 @@ export declare class AlbexEngine {
     setLanguage(lang: 'off' | 'es'): void;
     /** Full reset — clears all indexed documents and chunks. */
     reset(): void;
+    private _resetInner;
+    /**
+     * Drain and return the diagnostics collected since the last call (or
+     * since the engine was created). Use this to surface recoverable
+     * issues to the caller after `indexFile`, `load`, or any other
+     * operation that may run into a "best-effort" path.
+     *
+     * Example diagnostics:
+     *   - `{kind:'fallback', stage:'pdf', message:'pdf-extract crashed,
+     *      attempting OCR-only fallback', file:'invoice.pdf'}`
+     *   - `{kind:'skipped', stage:'ocr', message:'Tesseract abort on page
+     *      3 image 1; remaining images on this page skipped', file:'...',
+     *      page:3}`
+     *   - `{kind:'fallback', stage:'gpu', message:'GPU pre-filter failed,
+     *      using CPU'}`
+     *
+     * The buffer is cleared on each call; callers should consume the
+     * returned array immediately (e.g. log to their telemetry, surface
+     * a UI banner). After `reset()` the buffer is also cleared.
+     */
+    takeDiagnostics(): AlbexDiagnostic[];
+    /** Internal: record a diagnostic. Capped at 256 to bound memory. */
+    private _diag;
+    /**
+     * Install an OCR adapter. Returns a handle whose `dispose()` removes the
+     * adapter from the engine.
+     *
+     * The contract: the adapter must provide `recognize(image, opts)` that
+     * returns `Promise<OcrAttachedResult>`. The engine validates the
+     * contract at attach time and refuses adapters that don't expose a
+     * recognise function. Only one adapter can be attached at a time; a
+     * second call to `attachOcr` while one is active throws — the caller
+     * must dispose the previous one first.
+     *
+     * @example
+     * ```ts
+     * import { enableOcr } from '@albex/ocr';
+     * const handle = enableOcr(engine);   // internally calls attachOcr
+     * // ... later ...
+     * await handle.dispose();
+     * ```
+     *
+     * Direct use without the companion package:
+     * ```ts
+     * const handle = engine.attachOcr({
+     *   recognize: async (blob) => myCustomOcr(blob),
+     *   options: { alwaysExtractEmbeddedImages: false },
+     * });
+     * ```
+     */
+    attachOcr(adapter: OcrAdapter): OcrHandle;
     /**
      * Persist the current index to OPFS (or IndexedDB as fallback) under `name`.
      *
@@ -441,12 +579,14 @@ export declare class AlbexEngine {
      * state in roughly O(total bytes), bypassing re-parsing.
      */
     save(name: string): Promise<void>;
+    private _saveInner;
     /**
      * Restore an index previously saved with `save(name)`. Returns `true` on
      * success, `false` if the snapshot is missing or has an incompatible
      * header (wrong magic, version, or struct sizes).
      */
     load(name: string): Promise<boolean>;
+    private _loadInner;
     /**
      * Convenience: load if the snapshot exists, otherwise leave the engine
      * empty. Returns whether a load actually happened.

package/dist/albex.d.ts.map

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