@delali/narsil 0.2.3-next.34 → 0.2.3-next.36

package/dist/embeddings/openai.mjs

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

package/dist/{engine-DScGlT2Z.d.ts → engine-BE45D5ZG.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-CQ-9bKxo.js';
-import { I as IndexConfig, A as AnyDocument, a as InsertOptions, P as PartitionConfig } from './schema-emTQfEiX.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';
 
 /**
  * Every event the engine emits, with the payload each one carries.
@@ -455,4 +455,4 @@ interface Narsil {
     shutdown(): Promise<void>;
 }
 
-export type { Narsil as N, NarsilEventMap as a };
+export type { NarsilEventMap as N, Narsil as a };

package/dist/index.browser.mjs

@@ -55,6 +55,8 @@ var ErrorCodes = {
   NODE_BOOTSTRAP_FAILED: "NODE_BOOTSTRAP_FAILED",
   NODE_ALREADY_JOINED: "NODE_ALREADY_JOINED",
   NODE_NOT_JOINED: "NODE_NOT_JOINED",
+  NODE_NOT_READY: "NODE_NOT_READY",
+  NODE_NOT_CONTROLLER: "NODE_NOT_CONTROLLER",
   COORDINATOR_DEPENDENCY_MISSING: "COORDINATOR_DEPENDENCY_MISSING",
   TRANSPORT_DEPENDENCY_MISSING: "TRANSPORT_DEPENDENCY_MISSING",
   REPLICATION_ENTRY_INVALID: "REPLICATION_ENTRY_INVALID",
@@ -2544,6 +2546,9 @@ function metadataToWire(meta) {
   if (meta.indexUuid !== void 0) {
     wire.index_uuid = meta.indexUuid;
   }
+  if (meta.heldPartitions !== void 0) {
+    wire.held_partitions = meta.heldPartitions;
+  }
   return wire;
 }
 function wireToMetadata(raw) {
@@ -2633,8 +2638,14 @@ function wireToMetadata(raw) {
   if (typeof raw.index_uuid === "string" && raw.index_uuid.length > 0) {
     meta.indexUuid = raw.index_uuid;
   }
+  if (Array.isArray(raw.held_partitions) && raw.held_partitions.every(isNonNegativeInteger)) {
+    meta.heldPartitions = raw.held_partitions;
+  }
   return meta;
 }
+function isNonNegativeInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
 function isPositiveInteger2(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 1;
 }
@@ -15845,7 +15856,7 @@ function normalizePartitions(raw) {
   }
   const result = [];
   for (const entry of raw) {
-    if (!isNonNegativeInteger(entry?.partitionId)) {
+    if (!isNonNegativeInteger2(entry?.partitionId)) {
       throw new NarsilError(ErrorCodes.PERSISTENCE_LOAD_FAILED, "Segment manifest has a partition without a valid id", {
         partitionId: entry?.partitionId
       });
@@ -15880,7 +15891,7 @@ function normalizeSegments(raw, partitionId) {
   const seenIds = /* @__PURE__ */ new Set();
   const result = [];
   for (const segment of raw) {
-    if (!isSegmentId(segment?.id) || !isNonNegativeInteger(segment.docCount) || !isNonNegativeInteger(segment.tombstoneCount) || !isKey(segment.key)) {
+    if (!isSegmentId(segment?.id) || !isNonNegativeInteger2(segment.docCount) || !isNonNegativeInteger2(segment.tombstoneCount) || !isKey(segment.key)) {
       throw new NarsilError(ErrorCodes.PERSISTENCE_LOAD_FAILED, "Segment manifest has an invalid segment reference", {
         partitionId,
         segment
@@ -15932,7 +15943,7 @@ function normalizeVectors(raw, partitionId) {
   }
   const result = [];
   for (const vector of raw) {
-    if (typeof vector?.fieldPath !== "string" || !isNonNegativeInteger(vector.generation) || !isKey(vector.key)) {
+    if (typeof vector?.fieldPath !== "string" || !isNonNegativeInteger2(vector.generation) || !isKey(vector.key)) {
       throw new NarsilError(ErrorCodes.PERSISTENCE_LOAD_FAILED, "Segment manifest has an invalid vector reference", {
         partitionId,
         vector
@@ -15942,7 +15953,7 @@ function normalizeVectors(raw, partitionId) {
   }
   return result;
 }
-function isNonNegativeInteger(value) {
+function isNonNegativeInteger2(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 0;
 }
 function isSegmentId(value) {
@@ -17728,6 +17739,7 @@ function createDurabilityManager(config, hooks, directoryOverride) {
   const mode = config.mode ?? "sync";
   const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_ASYNC_FLUSH_INTERVAL_MS;
   const indexes = /* @__PURE__ */ new Map();
+  const metadataWrites = /* @__PURE__ */ new Map();
   let checkpointTimer = null;
   let asyncFlushTimer = null;
   let shuttingDown = false;
@@ -17780,6 +17792,15 @@ function createDurabilityManager(config, hooks, directoryOverride) {
     }
     return partition;
   }
+  function queueMetadataWrite(indexName, write) {
+    const previous = metadataWrites.get(indexName) ?? Promise.resolve();
+    const queued = previous.then(write);
+    metadataWrites.set(
+      indexName,
+      queued.catch(() => void 0)
+    );
+    return queued;
+  }
   function startCheckpointTimer() {
     if (checkpointTimer !== null || shuttingDown || fatalError !== null || checkpointIntervalMs <= 0) {
       return;
@@ -17937,6 +17958,9 @@ function createDurabilityManager(config, hooks, directoryOverride) {
       }
       startCheckpointTimer();
     },
+    highestPersistedSeqNo(indexName, partitionId) {
+      return indexes.get(indexName)?.partitions.get(partitionId)?.appliedSeqNo ?? 0;
+    },
     async recordMutation(record) {
       if (fatalError !== null) {
         throw fatalError;
@@ -17984,14 +18008,16 @@ function createDurabilityManager(config, hooks, directoryOverride) {
       }
       return allocatedSeqNo;
     },
-    async persistMetadata(indexName) {
-      const metadata = hooks.buildMetadata(indexName);
-      if (metadata === void 0) {
-        return;
-      }
-      const bytes = await writeMetadataEnvelope(metadata, { checksum: true });
-      await directory.atomicWrite(`${indexName}/meta`, bytes);
-      getOrCreateIndexState(indexName);
+    persistMetadata(indexName) {
+      return queueMetadataWrite(indexName, async () => {
+        const metadata = hooks.buildMetadata(indexName);
+        if (metadata === void 0) {
+          return;
+        }
+        const bytes = await writeMetadataEnvelope(metadata, { checksum: true });
+        await directory.atomicWrite(`${indexName}/meta`, bytes);
+        getOrCreateIndexState(indexName);
+      });
     },
     checkpoint(indexName) {
       return checkpointIndex(indexName);
@@ -18048,6 +18074,7 @@ function createSnapshotOnlyManager(adapter, config, hooks, publisher) {
   const checkpointIntervalMs = config.checkpointIntervalMs ?? DEFAULT_CHECKPOINT_INTERVAL_MS;
   const checkpointMutationThreshold = config.checkpointMutationThreshold ?? DEFAULT_CHECKPOINT_MUTATION_THRESHOLD;
   const indexes = /* @__PURE__ */ new Map();
+  const metadataWrites = /* @__PURE__ */ new Map();
   let checkpointTimer = null;
   let shuttingDown = false;
   function getOrCreateIndexState(indexName) {
@@ -18126,6 +18153,15 @@ function createSnapshotOnlyManager(adapter, config, hooks, publisher) {
     indexState.checkpointInFlight = run;
     return run;
   }
+  function queueMetadataWrite(indexName, write) {
+    const previous = metadataWrites.get(indexName) ?? Promise.resolve();
+    const queued = previous.then(write);
+    metadataWrites.set(
+      indexName,
+      queued.catch(() => void 0)
+    );
+    return queued;
+  }
   async function recoverIndex(indexName) {
     const metaBytes = await adapter.load(metadataKey(indexName));
     if (metaBytes === null) {
@@ -18160,6 +18196,9 @@ function createSnapshotOnlyManager(adapter, config, hooks, publisher) {
       }
       startCheckpointTimer();
     },
+    highestPersistedSeqNo() {
+      return 0;
+    },
     async recordMutation(record) {
       const indexState = getOrCreateIndexState(record.indexName);
       const buffered = indexState.applyChain.then(() => record.apply());
@@ -18174,14 +18213,16 @@ function createSnapshotOnlyManager(adapter, config, hooks, publisher) {
       }
       return 0;
     },
-    async persistMetadata(indexName) {
-      const metadata = hooks.buildMetadata(indexName);
-      if (metadata === void 0) {
-        return;
-      }
-      const bytes = await writeMetadataEnvelope(metadata, { checksum: true });
-      await adapter.save(metadataKey(indexName), bytes);
-      getOrCreateIndexState(indexName);
+    persistMetadata(indexName) {
+      return queueMetadataWrite(indexName, async () => {
+        const metadata = hooks.buildMetadata(indexName);
+        if (metadata === void 0) {
+          return;
+        }
+        const bytes = await writeMetadataEnvelope(metadata, { checksum: true });
+        await adapter.save(metadataKey(indexName), bytes);
+        getOrCreateIndexState(indexName);
+      });
     },
     checkpoint(indexName) {
       return checkpointIndex(indexName);
@@ -18274,6 +18315,9 @@ function buildMetadata(indexName, hooks) {
   if (config.indexUuid !== void 0) {
     metadata.indexUuid = config.indexUuid;
   }
+  if (config.heldPartitions !== void 0) {
+    metadata.heldPartitions = config.heldPartitions;
+  }
   return metadata;
 }
 function createDurabilityIntegration(tier, hooks) {
@@ -18335,6 +18379,7 @@ function createDurabilityFromTier(tier, wiring) {
       } : void 0;
       return {
         ...entry.indexUuid !== null ? { indexUuid: entry.indexUuid } : {},
+        ...entry.heldPartitions !== null ? { heldPartitions: entry.heldPartitions } : {},
         schema: flattenSchema(entry.config.schema),
         language: entry.language.name,
         k1: entry.config.bm25?.k1 ?? 1.2,
@@ -19446,7 +19491,8 @@ function createEngineCore(config) {
       embeddingAdapter,
       embeddingAdapterName: adapterName,
       vectorFieldPaths: getVectorFieldPaths(indexConfig.schema),
-      indexUuid: metadata.indexUuid ?? null
+      indexUuid: metadata.indexUuid ?? null,
+      heldPartitions: metadata.heldPartitions ?? null
     });
     if (metadata.analysisRevision !== language.revision) {
       analysisRebuild.markStale({
@@ -19726,7 +19772,8 @@ async function createEngineIndex(core, config, name, indexConfig, indexUuid) {
     embeddingAdapter: resolvedEmbeddingAdapter,
     embeddingAdapterName,
     vectorFieldPaths: getVectorFieldPaths(indexConfig.schema),
-    indexUuid: null
+    indexUuid: null,
+    heldPartitions: null
   });
   if (core.durability) {
     await core.durability.manager.persistMetadata(name);
@@ -21656,7 +21703,8 @@ async function restoreFromSnapshot(indexName, data, deps) {
     embeddingAdapter,
     embeddingAdapterName: adapterName,
     vectorFieldPaths: vectorFieldPaths2,
-    indexUuid: null
+    indexUuid: null,
+    heldPartitions: null
   });
   try {
     const manager = deps.requireManager(indexName);
@@ -22181,6 +22229,23 @@ function partitionsFor(manager, partitionIds) {
   }
   return partitions;
 }
+function coverageFor(manager, partitionIds) {
+  if (partitionIds === void 0) {
+    return {
+      totalPartitions: manager.partitionCount,
+      queriedPartitions: manager.partitionCount,
+      timedOutPartitions: 0,
+      failedPartitions: 0
+    };
+  }
+  const queriedPartitions = partitionsFor(manager, partitionIds).length;
+  return {
+    totalPartitions: partitionIds.length,
+    queriedPartitions,
+    timedOutPartitions: 0,
+    failedPartitions: partitionIds.length - queriedPartitions
+  };
+}
 function partitionsForVectorSearch(manager, vecIndex, partitionIds) {
   if (partitionIds === void 0) {
     return void 0;
@@ -22642,7 +22707,8 @@ async function executeQuery(params, context) {
     elapsed,
     cursor: nextCursor,
     facets,
-    groups
+    groups,
+    coverage: coverageFor(manager, context.partitionIds)
   };
 }
 async function executePreflight(params, context) {

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import { c as StopWordOverride, C as CustomTokenizer } from './schema-emTQfEiX.js';
-export { A as AnyDocument, B as BM25Params, E as EmbeddingFieldConfig, F as FieldType, I as IndexConfig, a as InsertOptions, P as PartitionConfig, S as SchemaDefinition, b as ScoringMode, V as VectorIndexConfig, d as VectorQuantizationMode } from './schema-emTQfEiX.js';
+import { c as StopWordOverride, C as CustomTokenizer } from './schema-ZRbk8BgH.js';
+export { A as AnyDocument, B as BM25Params, E as EmbeddingFieldConfig, F as FieldType, I as IndexConfig, a as InsertOptions, P as PartitionConfig, S as SchemaDefinition, b as ScoringMode, V as VectorIndexConfig, d as VectorQuantizationMode } from './schema-ZRbk8BgH.js';
 import { L as LanguageModule } from './language-DB8KG1z5.js';
 export { T as TokenizerConfig } from './language-DB8KG1z5.js';
-export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, k as ComparisonFilter, D as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, l as FacetResult, m as FieldFilter, n as FilterExpression, G as GeoFilter, o as GeoPolygonFilter, p as GeoRadiusFilter, q as GroupConfig, r as GroupReducer, s as GroupResult, H as HighlightConfig, t as HighlightMatch, u as Hit, v as HybridConfig, I as IndexInfo, f as IndexStats, L as ListParams, g as ListResult, w as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, P as PartitionStatsResult, h as PreflightResult, x as PresenceFilter, y as ProcessMemoryReport, Q as QueryParams, e as QueryResult, z as ScoreComponents, J as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, K as SortField, O as SortSpec, R as StringFilter, i as SuggestParams, j as SuggestResult, T as TermMatchPolicy, V as VectorMaintenanceResult, U as VectorQueryConfig } from './search-CQ-9bKxo.js';
-import { N as NarsilConfig } from './config-ChZ7lfqc.js';
-export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as InsertContext, b as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, c as StaleAnalysis, U as UpdateContext, W as WorkerConfig, d as WorkerContext } from './config-ChZ7lfqc.js';
-import { N as Narsil } from './engine-DScGlT2Z.js';
-export { a as NarsilEventMap } from './engine-DScGlT2Z.js';
+export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, k as ComparisonFilter, D as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, l as FacetResult, m as FieldFilter, n as FilterExpression, G as GeoFilter, o as GeoPolygonFilter, p as GeoRadiusFilter, q as GroupConfig, r as GroupReducer, s as GroupResult, H as HighlightConfig, t as HighlightMatch, u as Hit, v as HybridConfig, I as IndexInfo, f as IndexStats, L as ListParams, g as ListResult, w as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, P as PartitionStatsResult, h as PreflightResult, x as PresenceFilter, y as ProcessMemoryReport, z as QueryCoverage, Q as QueryParams, e as QueryResult, J as ScoreComponents, K as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, O as SortField, R as SortSpec, T as StringFilter, i as SuggestParams, j as SuggestResult, U as TermMatchPolicy, V as VectorMaintenanceResult, W as VectorQueryConfig } from './search-DHuXwJYk.js';
+import { N as NarsilConfig } from './config-Byyl1QqH.js';
+export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as InsertContext, b as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, c as StaleAnalysis, U as UpdateContext, W as WorkerConfig, d as WorkerContext } from './config-Byyl1QqH.js';
+import { a as Narsil } from './engine-BE45D5ZG.js';
+export { N as NarsilEventMap } from './engine-BE45D5ZG.js';
 export { E as EmbeddingAdapter, I as InvalidationAdapter, a as InvalidationEvent, b as PartitionStatistics, P as PersistenceAdapter } from './adapters-79OIa4xm.js';
 
 /**

package/dist/index.mjs

@@ -1,6 +1,7 @@
-export { VERSION, createNarsil } from './chunk-GN7KF675.mjs';
-import './chunk-36ER4WCG.mjs';
-export { clearNormalizationCache, configureNormalizationCache, getLanguage, getNormalizationCacheSize, getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerLanguage, registerStopWords, registerTokenizer, resetNormalizationCache } from './chunk-RO4EFWE6.mjs';
+export { VERSION, createNarsil } from './chunk-MMSWEEZT.mjs';
+import './chunk-JQUL2T6I.mjs';
+import './chunk-WU2UZEVD.mjs';
+export { clearNormalizationCache, configureNormalizationCache, getLanguage, getNormalizationCacheSize, getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerLanguage, registerStopWords, registerTokenizer, resetNormalizationCache } from './chunk-GRWFY2HI.mjs';
 import './chunk-TGP5M5R7.mjs';
 import './chunk-OBXS7OZM.mjs';
 export { isSimdAvailable } from './chunk-WDL632CN.mjs';
@@ -8,4 +9,4 @@ import './chunk-KMMJMDUA.mjs';
 import './chunk-U2BKYEC7.mjs';
 import './chunk-BFIH7OV5.mjs';
 import './chunk-WTONLDU3.mjs';
-export { ClientErrorCodes, ErrorCodes, NarsilError, ServerErrorCodes } from './chunk-EMI63EXP.mjs';
+export { ClientErrorCodes, ErrorCodes, NarsilError, ServerErrorCodes } from './chunk-GB2IIJJG.mjs';

package/dist/{options-BORJg5XB.d.ts → options-EXYFcem-.d.ts}

@@ -1,3 +1,4 @@
+import { C as ClusterNamespace } from './config-fLC4lbmg.js';
 import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
 import { h as TaskStore } from './tasks-CnMLpfk-.js';
 
@@ -194,6 +195,14 @@ interface ServerOptions {
      * is controlled elsewhere.
      */
     allowInsecure?: boolean;
+    /**
+     * The cluster-facing side of the node this server fronts, which is
+     * `node.cluster` on a {@link ClusterNode}. With it set, `/readyz` answers
+     * 200 only while the node reports `SERVING`, `/cluster` reports the
+     * topology, and `/indexes/:name/cluster` reports one index's allocation.
+     * Without it, both cluster routes answer 501.
+     */
+    cluster?: ClusterNamespace;
 }
 /**
  * The running HTTP server, as {@link createServer} returns it.

package/dist/persistence/durability/checkpoint-worker.d.ts

@@ -1,10 +1,12 @@
-import { P as PartitionConfig, b as ScoringMode, V as VectorIndexConfig } from '../../schema-emTQfEiX.js';
+import { P as PartitionConfig, b as ScoringMode, V as VectorIndexConfig } from '../../schema-ZRbk8BgH.js';
 import '../../adapters-79OIa4xm.js';
 
 interface IndexMetadata {
     indexName: string;
     /** The identity a cluster gave the index at creation; absent on a single engine. */
     indexUuid?: string;
+    /** The partitions this copy holds, which a cluster node answers a partition-stores request from. */
+    heldPartitions?: number[];
     schema: Record<string, string>;
     language: string;
     partitionCount: number;

package/dist/persistence/durability/checkpoint-worker.mjs

@@ -1,6 +1,7 @@
-import { createDurableDirectory, writeSegmentedCheckpoint } from '../../chunk-GN7KF675.mjs';
-import '../../chunk-36ER4WCG.mjs';
-import '../../chunk-RO4EFWE6.mjs';
+import { createDurableDirectory, writeSegmentedCheckpoint } from '../../chunk-MMSWEEZT.mjs';
+import '../../chunk-JQUL2T6I.mjs';
+import '../../chunk-WU2UZEVD.mjs';
+import '../../chunk-GRWFY2HI.mjs';
 import '../../chunk-TGP5M5R7.mjs';
 import '../../chunk-OBXS7OZM.mjs';
 import '../../chunk-WDL632CN.mjs';
@@ -8,7 +9,7 @@ import '../../chunk-KMMJMDUA.mjs';
 import '../../chunk-U2BKYEC7.mjs';
 import '../../chunk-BFIH7OV5.mjs';
 import '../../chunk-WTONLDU3.mjs';
-import '../../chunk-EMI63EXP.mjs';
+import '../../chunk-GB2IIJJG.mjs';
 
 // src/persistence/durability/rebuild.ts
 async function rebuildSnapshotFromDurable(root, metadata, targets, compactionThreshold) {

package/dist/react.d.ts

@@ -1,10 +1,10 @@
-import { N as NarsilError, L as ListParams, g as ListResult, I as IndexInfo, f as IndexStats, Q as QueryParams, h as PreflightResult, e as QueryResult, i as SuggestParams, j as SuggestResult } from './search-CQ-9bKxo.js';
-export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './search-CQ-9bKxo.js';
+import { N as NarsilError, L as ListParams, g as ListResult, I as IndexInfo, f as IndexStats, Q as QueryParams, h as PreflightResult, e as QueryResult, i as SuggestParams, j as SuggestResult } from './search-DHuXwJYk.js';
+export { C as ClientErrorCode, a as ClientErrorCodes, E as ErrorCode, b as ErrorCodes, c as NarsilErrorCode, S as ServerErrorCode, d as ServerErrorCodes } from './search-DHuXwJYk.js';
 import { e as TaskRecord, d as TaskProgress, b as ImportResult, c as TaskListQuery, T as TaskListPage } from './tasks-CnMLpfk-.js';
 export { I as ImportError, f as TaskStatus, g as TaskType } from './tasks-CnMLpfk-.js';
 import { ReactNode, ReactElement } from 'react';
-import { N as NarsilClient, I as ImportSource } from './client-DQHB_swQ.js';
-import { A as AnyDocument } from './schema-emTQfEiX.js';
+import { N as NarsilClient, I as ImportSource } from './client-BobVnoIK.js';
+import { A as AnyDocument } from './schema-ZRbk8BgH.js';
 import './adapters-79OIa4xm.js';
 
 /**

package/dist/react.mjs

@@ -55,6 +55,8 @@ var ErrorCodes = {
   NODE_BOOTSTRAP_FAILED: "NODE_BOOTSTRAP_FAILED",
   NODE_ALREADY_JOINED: "NODE_ALREADY_JOINED",
   NODE_NOT_JOINED: "NODE_NOT_JOINED",
+  NODE_NOT_READY: "NODE_NOT_READY",
+  NODE_NOT_CONTROLLER: "NODE_NOT_CONTROLLER",
   COORDINATOR_DEPENDENCY_MISSING: "COORDINATOR_DEPENDENCY_MISSING",
   TRANSPORT_DEPENDENCY_MISSING: "TRANSPORT_DEPENDENCY_MISSING",
   REPLICATION_ENTRY_INVALID: "REPLICATION_ENTRY_INVALID",

package/dist/{schema-emTQfEiX.d.ts → schema-ZRbk8BgH.d.ts}

@@ -9,6 +9,7 @@ import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
  * @public
  */
 type AnyDocument = Record<string, unknown> & {
+    /** Identifier the engine stores this document under when you insert without passing one separately. */
     id?: string;
 };
 /**

package/dist/{search-CQ-9bKxo.d.ts → search-DHuXwJYk.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnyDocument, S as SchemaDefinition, b as ScoringMode } from './schema-emTQfEiX.js';
+import { A as AnyDocument, S as SchemaDefinition, b as ScoringMode } from './schema-ZRbk8BgH.js';
 
 /**
  * Every code a {@link NarsilError} carries, grouped by the part of the engine
@@ -64,6 +64,8 @@ declare const ErrorCodes: {
     readonly NODE_BOOTSTRAP_FAILED: "NODE_BOOTSTRAP_FAILED";
     readonly NODE_ALREADY_JOINED: "NODE_ALREADY_JOINED";
     readonly NODE_NOT_JOINED: "NODE_NOT_JOINED";
+    readonly NODE_NOT_READY: "NODE_NOT_READY";
+    readonly NODE_NOT_CONTROLLER: "NODE_NOT_CONTROLLER";
     readonly COORDINATOR_DEPENDENCY_MISSING: "COORDINATOR_DEPENDENCY_MISSING";
     readonly TRANSPORT_DEPENDENCY_MISSING: "TRANSPORT_DEPENDENCY_MISSING";
     readonly REPLICATION_ENTRY_INVALID: "REPLICATION_ENTRY_INVALID";
@@ -229,6 +231,29 @@ interface QueryResult<T = AnyDocument> {
     groups?: GroupResult[];
     /** This turns true when the index's terms came from an older analysis than its language module produces now. */
     analysisStale?: boolean;
+    /** The search read this much of the index, which is how you spot a degraded answer. */
+    coverage: QueryCoverage;
+}
+/**
+ * How much of an index one search read, which is what you check before you
+ * trust a count or a ranking.
+ *
+ * An embedded engine reads every partition it holds, so `queriedPartitions`
+ * matches `totalPartitions` there and the other two stay zero. A search across
+ * a cluster may find a node slow or unreachable, which it counts here while
+ * still returning the hits the other nodes gave it.
+ *
+ * @public
+ */
+interface QueryCoverage {
+    /** The search should have read this many partitions. */
+    totalPartitions: number;
+    /** The search read this many of them. */
+    queriedPartitions: number;
+    /** The search counts a partition here when the node holding it took longer than the query allowed. */
+    timedOutPartitions: number;
+    /** The search counts a partition here when the node holding it returned an error, and when no active replica served it. */
+    failedPartitions: number;
 }
 /**
  * One matching document, with the score that ranked it.
@@ -806,7 +831,9 @@ interface QueryParams {
  * @public
  */
 type DocumentProjection = boolean | {
+    /** Names the fields to keep, so every field left out of this list is dropped. */
     include?: string[];
+    /** Names the fields to drop, so every other field is kept. */
     exclude?: string[];
 };
 /**
@@ -996,4 +1023,4 @@ interface ListParams {
     document?: DocumentProjection;
 }
 
-export { type ArrayFilter as A, type BatchResult as B, type ClientErrorCode as C, type DocumentProjection as D, type ErrorCode as E, type FacetConfig as F, type GeoFilter as G, type HighlightConfig as H, type IndexInfo as I, type SearchMode as J, type SortField as K, type ListParams as L, type MemoryStats as M, NarsilError as N, type SortSpec as O, type PartitionStatsResult as P, type QueryParams as Q, type StringFilter as R, type ServerErrorCode as S, type TermMatchPolicy as T, type VectorQueryConfig as U, type VectorMaintenanceResult as V, ClientErrorCodes as a, ErrorCodes as b, type NarsilErrorCode as c, ServerErrorCodes as d, type QueryResult as e, type IndexStats as f, type ListResult as g, type PreflightResult as h, type SuggestParams as i, type SuggestResult as j, type ComparisonFilter as k, type FacetResult as l, type FieldFilter as m, type FilterExpression as n, type GeoPolygonFilter as o, type GeoRadiusFilter as p, type GroupConfig as q, type GroupReducer as r, type GroupResult as s, type HighlightMatch as t, type Hit as u, type HybridConfig as v, type ListedDocument as w, type PresenceFilter as x, type ProcessMemoryReport as y, type ScoreComponents as z };
+export { type ArrayFilter as A, type BatchResult as B, type ClientErrorCode as C, type DocumentProjection as D, type ErrorCode as E, type FacetConfig as F, type GeoFilter as G, type HighlightConfig as H, type IndexInfo as I, type ScoreComponents as J, type SearchMode as K, type ListParams as L, type MemoryStats as M, NarsilError as N, type SortField as O, type PartitionStatsResult as P, type QueryParams as Q, type SortSpec as R, type ServerErrorCode as S, type StringFilter as T, type TermMatchPolicy as U, type VectorMaintenanceResult as V, type VectorQueryConfig as W, ClientErrorCodes as a, ErrorCodes as b, type NarsilErrorCode as c, ServerErrorCodes as d, type QueryResult as e, type IndexStats as f, type ListResult as g, type PreflightResult as h, type SuggestParams as i, type SuggestResult as j, type ComparisonFilter as k, type FacetResult as l, type FieldFilter as m, type FilterExpression as n, type GeoPolygonFilter as o, type GeoRadiusFilter as p, type GroupConfig as q, type GroupReducer as r, type GroupResult as s, type HighlightMatch as t, type Hit as u, type HybridConfig as v, type ListedDocument as w, type PresenceFilter as x, type ProcessMemoryReport as y, type QueryCoverage as z };

package/dist/server.d.ts

@@ -1,11 +1,15 @@
-import { b as ServerOptions, N as NarsilServer } from './options-BORJg5XB.js';
-export { A as ASYNC_IMPORT_CAPABILITY, C as CorsOptions, E as ErrorEnvelope, O as OnRequestHook, R as REBUILD_ANALYSIS_CAPABILITY, c as RequestContext, d as RequestDenial, S as SERVER_CAPABILITIES, e as ServerLimits, T as TASK_CANCEL_CAPABILITY, a as TASK_FILTER_CAPABILITY } from './options-BORJg5XB.js';
-import { N as Narsil } from './engine-DScGlT2Z.js';
+import { b as ServerOptions, N as NarsilServer } from './options-EXYFcem-.js';
+export { A as ASYNC_IMPORT_CAPABILITY, C as CorsOptions, E as ErrorEnvelope, O as OnRequestHook, R as REBUILD_ANALYSIS_CAPABILITY, c as RequestContext, d as RequestDenial, S as SERVER_CAPABILITIES, e as ServerLimits, T as TASK_CANCEL_CAPABILITY, a as TASK_FILTER_CAPABILITY } from './options-EXYFcem-.js';
+import { a as Narsil } from './engine-BE45D5ZG.js';
 import { h as TaskStore, e as TaskRecord, d as TaskProgress, b as ImportResult } from './tasks-CnMLpfk-.js';
 export { C as CapabilitiesResponse, a as CreateIndexEmbedding, i as CreateIndexRequest, H as HttpIndexConfig, I as ImportError, T as TaskListPage, c as TaskListQuery, f as TaskStatus, g as TaskType } from './tasks-CnMLpfk-.js';
-export { d as ServerErrorCodes } from './search-CQ-9bKxo.js';
+export { d as ServerErrorCodes } from './search-DHuXwJYk.js';
+import './config-fLC4lbmg.js';
+import './config-Byyl1QqH.js';
 import './adapters-79OIa4xm.js';
-import './schema-emTQfEiX.js';
+import './schema-ZRbk8BgH.js';
+import './types-B5Tsaalz.js';
+import './types-D5OwhtsQ.js';
 
 /**
  * Wraps a Narsil engine in an HTTP server. The caller builds and owns the engine