@delali/narsil 0.2.3 → 0.2.4-next.43

package/dist/embeddings/openai.mjs

@@ -1,4 +1,4 @@
-import { NarsilError, ErrorCodes } from '../chunk-GB2IIJJG.mjs';
+import { NarsilError, ErrorCodes } from '../chunk-TLRUUMVE.mjs';
 
 // src/embeddings/openai.ts
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503]);

package/dist/{engine-BE45D5ZG.d.ts → engine-CjLhdDIm.d.ts}

@@ -1,6 +1,6 @@
 import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { I as IndexInfo, f as IndexStats, P as PartitionStatsResult, B as BatchResult, L as ListParams, g as ListResult, Q as QueryParams, e as QueryResult, h as PreflightResult, i as SuggestParams, j as SuggestResult, M as MemoryStats, V as VectorMaintenanceResult } from './search-DHuXwJYk.js';
-import { I as IndexConfig, A as AnyDocument, a as InsertOptions, P as PartitionConfig } from './schema-ZRbk8BgH.js';
+import { I as IndexInfo, f as IndexStats, P as PartitionStatsResult, B as BatchResult, L as ListParams, g as ListResult, Q as QueryParams, e as QueryResult, h as PreflightResult, i as SuggestParams, j as SuggestResult, M as MemoryStats, V as VectorMaintenanceResult } from './search-BGouJxH4.js';
+import { I as IndexConfig, A as AnyDocument, a as InsertOptions, P as PartitionConfig } from './schema-DXOd96kx.js';
 
 /**
  * Every event the engine emits, with the payload each one carries.
@@ -13,18 +13,12 @@ import { I as IndexConfig, A as AnyDocument, a as InsertOptions, P as PartitionC
  * @public
  */
 type NarsilEventMap = {
-    /** A partition failed to reach the persistence adapter. */
-    persistenceError: {
-        /** The partition belongs to this index. */
-        indexName: string;
-        /** This partition failed to save. */
-        partitionId: number;
-        /** The adapter threw this. */
-        error: Error;
-        /** This turns true once the engine has given up retrying, which means the partition stays unsaved. */
-        retriesExhausted: boolean;
-    };
-    /** A worker thread died, and the engine has rebuilt the indexes it held. */
+    /**
+     * A worker thread died. The pool drops it and fails its outstanding requests
+     * with `WORKER_CRASHED`, while the remaining workers keep answering because
+     * each holds a full worker copy of every promoted index. Once no worker is
+     * left, queries fall back to the main thread, which holds every document.
+     */
     workerCrash: {
         /** This worker died. */
         workerId: number;
@@ -296,8 +290,11 @@ interface Narsil {
      */
     query<T = AnyDocument>(indexName: string, params: QueryParams): Promise<QueryResult<T>>;
     /**
-     * Counts what a query would match without building or ranking a single hit,
-     * which is how a result-count badge stays cheap.
+     * Counts what a query would match without building a single hit, which is
+     * how a result-count badge stays cheap. A full-text count also skips scoring
+     * unless the query carries `minScore`, which prunes matches by score, or a
+     * `termMatch` policy other than `any`, which prunes them by term coverage. A
+     * vector or hybrid count still runs its search.
      *
      * @param indexName - The index the query would run against.
      * @param params - The same parameters {@link Narsil.query} takes. Anything
@@ -341,13 +338,17 @@ interface Narsil {
      */
     snapshot(indexName: string): Promise<Uint8Array>;
     /**
-     * Loads an index from `.nrsl` bytes, replacing whatever the name held.
+     * Loads an index from snapshot bytes, replacing whatever the name held.
+     *
+     * The engine reads the `.nrsl` envelope {@link Narsil.snapshot} writes, and
+     * it also reads the headerless MessagePack form earlier releases wrote.
      *
      * @param indexName - The name the restored index takes.
      * @param data - Bytes a {@link Narsil.snapshot} produced.
-     * @throws A `NarsilError` with `ENVELOPE_INVALID_MAGIC` or
-     * `ENVELOPE_VERSION_MISMATCH` when the bytes are not a file this engine
-     * reads.
+     * @throws A `NarsilError` with `ENVELOPE_VERSION_MISMATCH` when the envelope
+     * carries a different format version, `PERSISTENCE_CRC_MISMATCH` when the
+     * payload fails its checksum, or `DOC_VALIDATION_FAILED` when the bytes hold
+     * no snapshot.
      */
     restore(indexName: string, data: Uint8Array): Promise<void>;
     /**