@delali/narsil 0.3.1-next.70 → 0.3.1-next.71

package/dist/{chunk-VNMTB3KC.mjs → chunk-IOR2K26O.mjs}

@@ -8507,6 +8507,30 @@ function createWorkerOrchestrator(config, executor, indexRegistry, callbacks, ve
   };
 }
 
+// src/engine/mutations/write-visibility.ts
+async function awaitWriteVisibility(ctx, indexName) {
+  await ctx.awaitRebalanceReplay(indexName);
+  await ctx.orchestrator.awaitWrites(indexName);
+}
+
+// src/engine/write-events.ts
+var WRITE_EVENT = "write";
+function emitWriteEvent(source, indexName) {
+  const handlers = source.eventHandlers.get(WRITE_EVENT);
+  if (handlers === void 0 || handlers.size === 0) return;
+  const emit = () => {
+    emitEngineEvent(source.eventHandlers, WRITE_EVENT, { indexName });
+  };
+  awaitWriteVisibility(source.mutationCtx, indexName).then(emit, emit);
+}
+async function emitWriteEventAfter(source, indexName, write) {
+  try {
+    return await write;
+  } finally {
+    emitWriteEvent(source, indexName);
+  }
+}
+
 // src/engine/core.ts
 function createEngineCore(config, hooks, capacityScope = "index") {
   validateWorkerConfig(config?.workers, config?.lifecycle);
@@ -8646,7 +8670,11 @@ function createEngineCore(config, hooks, capacityScope = "index") {
       }
       return names;
     },
-    reloadIndex: (indexName) => durability?.manager.reloadIndex?.(indexName) ?? Promise.resolve(),
+    reloadIndex: (indexName) => emitWriteEventAfter(
+      { eventHandlers, mutationCtx },
+      indexName,
+      durability?.manager.reloadIndex?.(indexName) ?? Promise.resolve()
+    ),
     onError(error) {
       if (emitEngineEvent(eventHandlers, "invalidationError", { error }) === 0) {
         console.warn("Invalidation error:", error);
@@ -9011,12 +9039,6 @@ async function rollbackUpdatedDocument(ctx, indexName, docId, restoreDoc, origin
   }
 }
 
-// src/engine/mutations/write-visibility.ts
-async function awaitWriteVisibility(ctx, indexName) {
-  await ctx.awaitRebalanceReplay(indexName);
-  await ctx.orchestrator.awaitWrites(indexName);
-}
-
 // src/engine/mutations/insert.ts
 async function insertDocument(ctx, indexName, document, docId, options) {
   ctx.guardShutdown();
@@ -10885,15 +10907,18 @@ function createNarsilFromCore(core, config) {
       release();
     }
   }
+  function withOpenIndexWrite(indexName, action) {
+    return emitWriteEventAfter(core, indexName, withOpenIndex(indexName, action));
+  }
   const narsil = {
     createIndex(name, indexConfig) {
-      return createEngineIndex(core, config, name, indexConfig);
+      return emitWriteEventAfter(core, name, createEngineIndex(core, config, name, indexConfig));
     },
     registerEmbeddingAdapter(name, adapter) {
       registerEngineEmbeddingAdapter(core, name, adapter);
     },
     dropIndex(name) {
-      return dropEngineIndex(core, name);
+      return emitWriteEventAfter(core, name, dropEngineIndex(core, name));
     },
     open(indexName) {
       guardShutdown();
@@ -10939,22 +10964,22 @@ function createNarsilFromCore(core, config) {
       return executor.getManager(indexName)?.getPartitionStats() ?? [];
     },
     insert(indexName, document, docId, options) {
-      return withOpenIndex(indexName, () => insertDocument(mutationCtx, indexName, document, docId, options));
+      return withOpenIndexWrite(indexName, () => insertDocument(mutationCtx, indexName, document, docId, options));
     },
     insertBatch(indexName, documents, options) {
-      return withOpenIndex(indexName, () => insertDocumentBatch(mutationCtx, indexName, documents, options));
+      return withOpenIndexWrite(indexName, () => insertDocumentBatch(mutationCtx, indexName, documents, options));
     },
     remove(indexName, docId, options) {
-      return withOpenIndex(indexName, () => removeDocument(mutationCtx, indexName, docId, options));
+      return withOpenIndexWrite(indexName, () => removeDocument(mutationCtx, indexName, docId, options));
     },
     removeBatch(indexName, docIds, options) {
-      return withOpenIndex(indexName, () => removeDocumentBatch(mutationCtx, indexName, docIds, options));
+      return withOpenIndexWrite(indexName, () => removeDocumentBatch(mutationCtx, indexName, docIds, options));
     },
     update(indexName, docId, document, options) {
-      return withOpenIndex(indexName, () => updateDocument(mutationCtx, indexName, docId, document, options));
+      return withOpenIndexWrite(indexName, () => updateDocument(mutationCtx, indexName, docId, document, options));
     },
     updateBatch(indexName, updates, options) {
-      return withOpenIndex(indexName, () => updateDocumentBatch(mutationCtx, indexName, updates, options));
+      return withOpenIndexWrite(indexName, () => updateDocumentBatch(mutationCtx, indexName, updates, options));
     },
     waitForWrites(indexName) {
       guardShutdown();
@@ -11002,7 +11027,7 @@ function createNarsilFromCore(core, config) {
     async rebuildAnalysis(indexName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, () => core.analysisRebuild.rebuild(indexName));
+      await withOpenIndexWrite(indexName, () => core.analysisRebuild.rebuild(indexName));
     },
     async snapshot(indexName) {
       guardShutdown();
@@ -11010,11 +11035,11 @@ function createNarsilFromCore(core, config) {
     },
     async restore(indexName, data) {
       guardShutdown();
-      await restoreFromSnapshot(indexName, data, {
+      const restored = restoreFromSnapshot(indexName, data, {
         executor,
         indexRegistry,
         getVectorFieldPaths,
-        dropIndex: narsil.dropIndex.bind(narsil),
+        dropIndex: (name) => dropEngineIndex(core, name),
         announceIndexCreated: (name, restoredConfig) => announceIndexCreated(core, name, restoredConfig),
         requireManager,
         durability,
@@ -11025,6 +11050,7 @@ function createNarsilFromCore(core, config) {
         clearAnalysisStale: core.analysisRebuild.clearStale,
         indexState: core.indexState
       });
+      await emitWriteEventAfter(core, indexName, restored);
       core.heapPressureNotifier.check(indexName);
     },
     async checkpoint(indexName) {
@@ -11037,7 +11063,7 @@ function createNarsilFromCore(core, config) {
     async clear(indexName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, async () => {
+      await withOpenIndexWrite(indexName, async () => {
         await executor.execute({ type: "clear", indexName, requestId: indexName });
         await orchestrator.replicateToWorkers({ type: "clear", indexName, requestId: `replicate-clear-${indexName}` });
         core.watermarkNotifier.forget(indexName);
@@ -11046,7 +11072,7 @@ function createNarsilFromCore(core, config) {
     async rebalance(indexName, targetPartitionCount) {
       guardShutdown();
       requireIndex(indexName);
-      return withOpenIndex(
+      return withOpenIndexWrite(
         indexName,
         () => executeRebalance(requireManager(indexName), indexName, targetPartitionCount, rebalanceCtx)
       );
@@ -11112,14 +11138,14 @@ function createNarsilFromCore(core, config) {
     async compactVectors(indexName, fieldName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, async () => {
+      await withOpenIndexWrite(indexName, async () => {
         compactVectors(requireManager(indexName), indexName, fieldName);
       });
     },
     async optimizeVectors(indexName, fieldName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, () => optimizeVectors(requireManager(indexName), indexName, fieldName));
+      await withOpenIndexWrite(indexName, () => optimizeVectors(requireManager(indexName), indexName, fieldName));
     },
     vectorMaintenanceStatus(indexName) {
       guardShutdown();

package/dist/distribution.d.ts

@@ -1,6 +1,6 @@
 import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-rBpbgTw8.js';
 export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-rBpbgTw8.js';
-import { N as NarsilEventMap, a as Narsil } from './engine-CXKfmK7I.js';
+import { N as NarsilEventMap, a as Narsil } from './engine-igk0aMpQ.js';
 import { B as BatchResult, L as ListParams, g as ListResult, j as SuggestParams, k as SuggestResult, Q as QueryParams, h as PreflightResult, f as IndexStats, P as PartitionStatsResult, M as MemoryStats, e as QueryResult } from './memory-C7UMCMH3.js';
 import { I as IndexConfig, A as AnyDocument, a as InsertOptions } from './schema-Bgzr4g7b.js';
 import { b as NodeCapacity, N as NodeRole } from './types-gOUqhs2F.js';

package/dist/distribution.mjs

@@ -1,6 +1,6 @@
 import { MAX_MESSAGE_SIZE_BYTES } from './chunk-UNEEFTEU.mjs';
 import { validateIndexName, indexConfigKey, indexSettingsOf, putIndexMetadata, withPartitionCount, getIndexMetadata, getClusterIndexConfig } from './chunk-3JGWULDF.mjs';
-import { requireKnownConfig, resolveRunnableConfig, createEngineCore, startEngineCore, createNarsilFromCore, runEngineQueryStats, runEngineListDocuments, runEngineSuggest, runEnginePreflight, runEngineQuery, createEngineIndex, applyIndexEntry, applyDeleteEntry, validateEntryBatchPayload, createAckMessage, validateEntryPayload, validateForwardBatchPayload, createForwardBatchResultMessage, createForwardBatchMessage, validateForwardBatchResultPayload, createForwardMessage, validateReplicationEntry, computeEntryChecksum, createEntryMessage, createEntryBatchMessage, createInsyncConfirmMessage, validateAckPayload, createInsyncRemoveMessage, validateInsyncConfirmPayload, createInsyncAddMessage } from './chunk-VNMTB3KC.mjs';
+import { requireKnownConfig, resolveRunnableConfig, createEngineCore, startEngineCore, createNarsilFromCore, runEngineQueryStats, runEngineListDocuments, runEngineSuggest, runEnginePreflight, runEngineQuery, createEngineIndex, applyIndexEntry, applyDeleteEntry, validateEntryBatchPayload, createAckMessage, validateEntryPayload, validateForwardBatchPayload, createForwardBatchResultMessage, createForwardBatchMessage, validateForwardBatchResultPayload, createForwardMessage, validateReplicationEntry, computeEntryChecksum, createEntryMessage, createEntryBatchMessage, createInsyncConfirmMessage, validateAckPayload, createInsyncRemoveMessage, validateInsyncConfirmPayload, createInsyncAddMessage } from './chunk-IOR2K26O.mjs';
 import { ReplicationMessageTypes, TransportErrorCodes, ClusterMessageTypes, QueryMessageTypes, TransportError } from './chunk-GCM3JFVA.mjs';
 import { providedDocId, MAX_PARTITION_COUNT, MAX_REPLICATION_FACTOR, WIRE_BATCH_BUDGET } from './chunk-FVLQ63B7.mjs';
 import { generateId, deserializePayloadV2, createPartitionIndex, FILTER_EXPRESSION_KEYS, FIELD_FILTER_OPERATORS } from './chunk-M76V3OGJ.mjs';

package/dist/{engine-CXKfmK7I.d.ts → engine-igk0aMpQ.d.ts}

@@ -3,124 +3,166 @@ import { B as BatchResult, I as IndexInfo, f as IndexStats, P as PartitionStatsR
 import { A as AnyDocument, a as InsertOptions, W as WriteOptions, I as IndexConfig, P as PartitionConfig } from './schema-Bgzr4g7b.js';
 
 /**
- * Every event the engine emits, with the payload each one carries.
+ * This map lists every event that the engine emits, with the payload of each
+ * one.
  *
- * {@link Narsil.on} takes a key from this map and hands your listener the
- * matching payload. These events report work the engine does on its own, away
- * from the call that triggered it, so a failure here never rejects a promise
- * you are holding.
+ * {@link Narsil.on} registers a listener under a key from this map, so that the
+ * engine can pass the matching payload to that listener. Most of these events
+ * report work that the engine does in the background, away from the call that
+ * started it, so a failure that such an event reports never rejects a promise
+ * that you are holding.
  *
  * @public
  */
 type NarsilEventMap = {
     /**
-     * A worker thread died. The pool drops it and fails the requests that it was
-     * serving with `WORKER_CRASHED`, and the engine answers each of those queries
-     * again on the main thread, so the caller receives a result and no error.
-     * The remaining workers keep answering, because each holds a full worker
-     * copy of every promoted index. After a delay the
-     * engine spawns a replacement, loads every copy onto it, and puts it back
-     * into rotation. Once no worker is left, queries fall back to the main
-     * thread, which holds every document, and the next request after the delay
-     * starts a new pool. The delay starts at one second and doubles up to a
-     * minute while replacements keep failing.
+     * The engine emits this event after a call changes what a read returns from
+     * an index. The calls are the inserts, updates, and removals, singly or in a
+     * batch, together with `clear`, `restore`, `rebalance`, `rebuildAnalysis`,
+     * `compactVectors`, `optimizeVectors`, `createIndex`, and `dropIndex`. The
+     * engine emits the event after a call that throws as well, because a call can
+     * change the index before it throws. It also emits the event after it reloads
+     * an index, once a shared invalidation adapter reports that another instance
+     * saved that index. The engine emits one event per batch, however many
+     * documents the batch holds.
+     *
+     * The engine emits the event once a query can see the change, which means
+     * after every worker copy applies the change and after any rebalance in
+     * progress replays it. A query that a listener sends from its handler
+     * therefore returns results that include the change. The engine waits for the
+     * change to become visible only while a listener is registered for the event.
+     */
+    write: {
+        /** This is the name of the index that changed. */
+        indexName: string;
+    };
+    /**
+     * A worker thread exited unexpectedly. The pool removes the thread and fails
+     * the requests that the thread was serving with `WORKER_CRASHED`. The engine
+     * then sends each of those queries again on the main thread, so the caller
+     * receives a result with no error. The remaining workers keep serving
+     * queries, because each of them holds a full worker copy of every promoted
+     * index.
+     *
+     * After a delay, the engine spawns a replacement and loads every copy onto
+     * it before it sends queries to the replacement. Once no worker is left, the
+     * main thread serves every query, because it holds every document. The first
+     * request after the delay then starts a new pool. The delay starts at one
+     * second and doubles up to a minute while replacements keep failing.
      */
     workerCrash: {
-        /** This worker died. */
+        /** This is the id of the worker that exited. */
         workerId: number;
-        /** That worker was holding these indexes. */
+        /** These are the indexes that the worker held. */
         indexNames: string[];
-        /** This ended the worker. */
+        /** This is the error that ended the worker. */
         error: Error;
     };
-    /** An index gained worker copies, whether it reached the copy threshold or loaded its copies again after an idle spell. */
+    /** An index gained worker copies, either because it reached the copy
+     * threshold or because a request loaded its copies again after an idle
+     * spell. */
     workerPromote: {
-        /** The pool holds this many workers. */
+        /** This is the number of workers in the pool. */
         workerCount: number;
-        /** The index gained its copies for this reason, such as the copy threshold it reached. */
+        /** This is the reason that the index gained its copies, such as the copy
+         * threshold that it reached. */
         reason: string;
     };
-    /** An index could not gain worker copies. It keeps answering on the main thread. */
+    /** An index could not gain worker copies, so the main thread keeps serving
+     * its queries. */
     workerPromoteFailure: {
-        /** The engine tried to load the copies for this reason. */
+        /** This is the reason that the engine tried to load the copies. */
         reason: string;
-        /** This stopped it. */
+        /** This is the error that stopped the load. */
         error: Error;
-        /** This turns true when the engine will try again on a later threshold. */
+        /** This is true when the engine will try again at a later threshold. */
         retryable: boolean;
     };
-    /** An index finished spreading its documents across a new partition count. */
+    /** An index finished spreading its documents across a new number of
+     * partitions. */
     partitionRebalance: {
-        /** This index was rebalanced. */
+        /** This is the name of the index that the engine rebalanced. */
         indexName: string;
-        /** The index held this many partitions before. */
+        /** This is the number of partitions before the rebalance. */
         oldCount: number;
-        /** The index holds this many partitions now. */
+        /** This is the number of partitions after the rebalance. */
         newCount: number;
     };
     /**
      * An index passed its watermark, so its partitions are close to their
      * capacity. On a cluster node, the engine reports the document count and the
-     * capacity of the one partition that `partitionId` names, which is a
-     * partition that this node leads.
+     * capacity of the one partition that `partitionId` identifies, which this
+     * node leads.
      */
     partitionWatermark: {
-        /** This index crossed the mark. */
+        /** This is the name of the index that crossed the mark. */
         indexName: string;
-        /** The index holds this many documents, or the partition does on a cluster node. */
+        /** This is the number of documents in the index, or in the partition on a
+         * cluster node. */
         documentCount: number;
-        /** The index can hold this many across its current partitions, or the partition can on a cluster node. */
+        /** This is the number of documents that the current partitions of the
+         * index can hold, or that the partition can hold on a cluster node. */
         capacity: number;
-        /** The index holds this many partitions. */
+        /** This is the number of partitions in the index. */
         partitionCount: number;
-        /** On a cluster node, this partition crossed the mark. The field is absent outside a cluster. */
+        /** On a cluster node, this is the partition that crossed the mark, while
+         * outside a cluster the field is absent. */
         partitionId?: number;
     };
     /**
-     * The process uses nine tenths of its heap, measured during a write or a
-     * load, so the next large index may end the process with an out-of-memory
-     * error. Where `--max-old-space-size` or `--max-old-space-size-percentage`
-     * sets a limit, on the command line or in `NODE_OPTIONS`, the engine measures
-     * the used bytes against that figure and `heapLimit` reports it. Where
-     * neither flag sets one, the engine compares the used bytes with the headroom
-     * that V8 reports, which runs about 192 MB above the true ceiling, so a
-     * default heap below about 2 GB may end before this event fires. The engine
-     * emits the event once per crossing and arms it again once the headroom
-     * recovers to two tenths. Raise the limit with
+     * The process uses nine tenths of its heap, as measured during a write or a
+     * load, so the next large index can end the process with an out-of-memory
+     * error.
+     *
+     * Where `--max-old-space-size` or `--max-old-space-size-percentage` sets a
+     * limit, on the command line or in `NODE_OPTIONS`, the engine measures the
+     * used bytes against that limit, which `heapLimit` then reports. Where
+     * neither flag sets a limit, the engine measures the share of the heap that
+     * V8 reports as no longer available. V8 reports a limit about 192 MB above
+     * the true ceiling, so a process on a default heap below about 2 GB can end before
+     * this event fires.
+     *
+     * The engine emits the event once per crossing, then arms it again once the
+     * free share of the heap recovers to two tenths. Raise the limit with
      * `--max-old-space-size-percentage` or `--max-old-space-size`, or close an
      * idle index; see {@link ProcessMemoryReport.heapLimit}.
      */
     heapPressure: {
-        /** The heap reaches that point during a write to this index or a load of it. */
+        /** This is the index that a write or a load was touching when the heap
+         * reached that point. */
         indexName: string;
-        /** The process uses this much heap, in bytes. */
+        /** This is the heap that the process uses, in bytes. */
         heapUsed: number;
-        /** The heap may grow to this many bytes. */
+        /** This is the size in bytes that the heap can grow to. */
         heapLimit: number;
-        /** The engine estimates that the index holds this many bytes. */
+        /** This is the estimate of the bytes that the index holds. */
         estimatedMemoryBytes: number;
     };
-    /** A rebuild is bringing an index's terms up to its language module's current analysis. */
+    /** The engine started, completed, or failed a rebuild that brings the terms
+     * of an index up to the current analysis of its language module. */
     analysisRebuild: {
-        /** This index is being rebuilt. */
+        /** This is the name of the index under rebuild. */
         indexName: string;
-        /** The rebuild stands here. */
+        /** This is the stage that the rebuild has reached. */
         status: 'started' | 'completed' | 'failed';
-        /** The rebuild has covered this many partitions so far. */
+        /** This is the number of partitions that the rebuild has covered so far. */
         partitionsRebuilt: number;
-        /** The rebuild covers this many partitions in total. */
+        /** This is the number of partitions that the rebuild covers in total. */
         partitionCount: number;
-        /** This stopped the rebuild, and only a `failed` status carries it. */
+        /** This is the error that stopped the rebuild, which only a `failed`
+         * status includes. */
         error?: Error;
     };
-    /** The write-ahead log or a checkpoint failed, so writes since the last checkpoint are at risk. */
+    /** A write to the write-ahead log or a checkpoint failed, so the writes since
+     * the last checkpoint are at risk. */
     durabilityError: {
-        /** The durability layer threw this. */
+        /** This is the error that the durability layer threw. */
         error: Error;
     };
-    /** The invalidation channel failed, so this instance may be reading partitions another instance has changed. */
+    /** The invalidation channel failed, so this instance can serve partitions
+     * that another instance has since changed. */
     invalidationError: {
-        /** The adapter threw this. */
+        /** This is the error that the adapter threw. */
         error: Error;
     };
 };

package/dist/index.browser.mjs

@@ -28040,6 +28040,30 @@ function createWorkerOrchestrator(config, executor, indexRegistry, callbacks, ve
   };
 }
 
+// src/engine/mutations/write-visibility.ts
+async function awaitWriteVisibility(ctx, indexName) {
+  await ctx.awaitRebalanceReplay(indexName);
+  await ctx.orchestrator.awaitWrites(indexName);
+}
+
+// src/engine/write-events.ts
+var WRITE_EVENT = "write";
+function emitWriteEvent(source, indexName) {
+  const handlers = source.eventHandlers.get(WRITE_EVENT);
+  if (handlers === void 0 || handlers.size === 0) return;
+  const emit = () => {
+    emitEngineEvent(source.eventHandlers, WRITE_EVENT, { indexName });
+  };
+  awaitWriteVisibility(source.mutationCtx, indexName).then(emit, emit);
+}
+async function emitWriteEventAfter(source, indexName, write) {
+  try {
+    return await write;
+  } finally {
+    emitWriteEvent(source, indexName);
+  }
+}
+
 // src/engine/core.ts
 function createEngineCore(config, hooks, capacityScope = "index") {
   validateWorkerConfig(config?.workers, config?.lifecycle);
@@ -28179,7 +28203,11 @@ function createEngineCore(config, hooks, capacityScope = "index") {
       }
       return names;
     },
-    reloadIndex: (indexName) => durability?.manager.reloadIndex?.(indexName) ?? Promise.resolve(),
+    reloadIndex: (indexName) => emitWriteEventAfter(
+      { eventHandlers, mutationCtx },
+      indexName,
+      durability?.manager.reloadIndex?.(indexName) ?? Promise.resolve()
+    ),
     onError(error) {
       if (emitEngineEvent(eventHandlers, "invalidationError", { error }) === 0) {
         console.warn("Invalidation error:", error);
@@ -28872,12 +28900,6 @@ async function embedChunkDocuments(entry, documents, chunkStart, chunkEnd, signa
   }
 }
 
-// src/engine/mutations/write-visibility.ts
-async function awaitWriteVisibility(ctx, indexName) {
-  await ctx.awaitRebalanceReplay(indexName);
-  await ctx.orchestrator.awaitWrites(indexName);
-}
-
 // src/engine/mutations/insert.ts
 async function insertDocument(ctx, indexName, document2, docId, options) {
   ctx.guardShutdown();
@@ -32316,15 +32338,18 @@ function createNarsilFromCore(core, config) {
       release();
     }
   }
+  function withOpenIndexWrite(indexName, action) {
+    return emitWriteEventAfter(core, indexName, withOpenIndex(indexName, action));
+  }
   const narsil = {
     createIndex(name, indexConfig) {
-      return createEngineIndex(core, config, name, indexConfig);
+      return emitWriteEventAfter(core, name, createEngineIndex(core, config, name, indexConfig));
     },
     registerEmbeddingAdapter(name, adapter) {
       registerEngineEmbeddingAdapter(core, name, adapter);
     },
     dropIndex(name) {
-      return dropEngineIndex(core, name);
+      return emitWriteEventAfter(core, name, dropEngineIndex(core, name));
     },
     open(indexName) {
       guardShutdown();
@@ -32370,22 +32395,22 @@ function createNarsilFromCore(core, config) {
       return executor.getManager(indexName)?.getPartitionStats() ?? [];
     },
     insert(indexName, document2, docId, options) {
-      return withOpenIndex(indexName, () => insertDocument(mutationCtx, indexName, document2, docId, options));
+      return withOpenIndexWrite(indexName, () => insertDocument(mutationCtx, indexName, document2, docId, options));
     },
     insertBatch(indexName, documents, options) {
-      return withOpenIndex(indexName, () => insertDocumentBatch(mutationCtx, indexName, documents, options));
+      return withOpenIndexWrite(indexName, () => insertDocumentBatch(mutationCtx, indexName, documents, options));
     },
     remove(indexName, docId, options) {
-      return withOpenIndex(indexName, () => removeDocument(mutationCtx, indexName, docId, options));
+      return withOpenIndexWrite(indexName, () => removeDocument(mutationCtx, indexName, docId, options));
     },
     removeBatch(indexName, docIds, options) {
-      return withOpenIndex(indexName, () => removeDocumentBatch(mutationCtx, indexName, docIds, options));
+      return withOpenIndexWrite(indexName, () => removeDocumentBatch(mutationCtx, indexName, docIds, options));
     },
     update(indexName, docId, document2, options) {
-      return withOpenIndex(indexName, () => updateDocument(mutationCtx, indexName, docId, document2, options));
+      return withOpenIndexWrite(indexName, () => updateDocument(mutationCtx, indexName, docId, document2, options));
     },
     updateBatch(indexName, updates, options) {
-      return withOpenIndex(indexName, () => updateDocumentBatch(mutationCtx, indexName, updates, options));
+      return withOpenIndexWrite(indexName, () => updateDocumentBatch(mutationCtx, indexName, updates, options));
     },
     waitForWrites(indexName) {
       guardShutdown();
@@ -32433,7 +32458,7 @@ function createNarsilFromCore(core, config) {
     async rebuildAnalysis(indexName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, () => core.analysisRebuild.rebuild(indexName));
+      await withOpenIndexWrite(indexName, () => core.analysisRebuild.rebuild(indexName));
     },
     async snapshot(indexName) {
       guardShutdown();
@@ -32441,11 +32466,11 @@ function createNarsilFromCore(core, config) {
     },
     async restore(indexName, data) {
       guardShutdown();
-      await restoreFromSnapshot(indexName, data, {
+      const restored = restoreFromSnapshot(indexName, data, {
         executor,
         indexRegistry,
         getVectorFieldPaths,
-        dropIndex: narsil.dropIndex.bind(narsil),
+        dropIndex: (name) => dropEngineIndex(core, name),
         announceIndexCreated: (name, restoredConfig) => announceIndexCreated(core, name, restoredConfig),
         requireManager,
         durability,
@@ -32456,6 +32481,7 @@ function createNarsilFromCore(core, config) {
         clearAnalysisStale: core.analysisRebuild.clearStale,
         indexState: core.indexState
       });
+      await emitWriteEventAfter(core, indexName, restored);
       core.heapPressureNotifier.check(indexName);
     },
     async checkpoint(indexName) {
@@ -32468,7 +32494,7 @@ function createNarsilFromCore(core, config) {
     async clear(indexName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, async () => {
+      await withOpenIndexWrite(indexName, async () => {
         await executor.execute({ type: "clear", indexName, requestId: indexName });
         await orchestrator.replicateToWorkers({ type: "clear", indexName, requestId: `replicate-clear-${indexName}` });
         core.watermarkNotifier.forget(indexName);
@@ -32477,7 +32503,7 @@ function createNarsilFromCore(core, config) {
     async rebalance(indexName, targetPartitionCount) {
       guardShutdown();
       requireIndex(indexName);
-      return withOpenIndex(
+      return withOpenIndexWrite(
         indexName,
         () => executeRebalance(requireManager(indexName), indexName, targetPartitionCount, rebalanceCtx)
       );
@@ -32543,14 +32569,14 @@ function createNarsilFromCore(core, config) {
     async compactVectors(indexName, fieldName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, async () => {
+      await withOpenIndexWrite(indexName, async () => {
         compactVectors(requireManager(indexName), indexName, fieldName);
       });
     },
     async optimizeVectors(indexName, fieldName) {
       guardShutdown();
       requireIndex(indexName);
-      await withOpenIndex(indexName, () => optimizeVectors(requireManager(indexName), indexName, fieldName));
+      await withOpenIndexWrite(indexName, () => optimizeVectors(requireManager(indexName), indexName, fieldName));
     },
     vectorMaintenanceStatus(indexName) {
       guardShutdown();

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export { T as TokenizerConfig } from './language-DB8KG1z5.js';
 export { A as ArrayFilter, B as BatchResult, C as ClientErrorCode, a as ClientErrorCodes, l as ComparisonFilter, D as DocumentProjection, E as ErrorCode, b as ErrorCodes, F as FacetConfig, m as FacetResult, n as FieldFilter, o as FilterExpression, G as GeoFilter, p as GeoPolygonFilter, q as GeoRadiusFilter, r as GroupConfig, s as GroupReducer, t as GroupResult, H as HighlightConfig, u as HighlightMatch, v as Hit, w as HybridConfig, I as IndexInfo, f as IndexStats, L as ListParams, g as ListResult, x as ListedDocument, M as MemoryStats, N as NarsilError, c as NarsilErrorCode, P as PartitionStatsResult, h as PreflightResult, y as PresenceFilter, z as ProcessMemoryReport, J as QueryCoverage, Q as QueryParams, e as QueryResult, K as ScoreComponents, O as SearchMode, S as ServerErrorCode, d as ServerErrorCodes, R as SortField, T as SortSpec, U as StringFilter, j as SuggestParams, k as SuggestResult, W as TermMatchPolicy, V as VectorMaintenanceResult, X as VectorQueryConfig, Y as WorkerCopyReport, i as isNarsilError } from './memory-C7UMCMH3.js';
 import { N as NarsilConfig } from './config-Dfanyqqt.js';
 export { A as AnalysisConfig, D as DurabilityConfig, I as IndexContext, a as IndexLifecycleConfig, b as InsertContext, M as MainCopyQueries, c as NarsilPlugin, P as PartitionContext, R as RemoveContext, S as SearchContext, d as StaleAnalysis, U as UpdateContext, W as WorkerConfig, e as WorkerContext } from './config-Dfanyqqt.js';
-import { a as Narsil } from './engine-CXKfmK7I.js';
-export { D as DocumentWriteOperations, I as IndexLifecycleOperations, N as NarsilEventMap } from './engine-CXKfmK7I.js';
+import { a as Narsil } from './engine-igk0aMpQ.js';
+export { D as DocumentWriteOperations, I as IndexLifecycleOperations, N as NarsilEventMap } from './engine-igk0aMpQ.js';
 export { E as EmbeddingAdapter, I as InvalidationAdapter, a as InvalidationEvent, b as PartitionStatistics, P as PersistenceAdapter } from './adapters-79OIa4xm.js';
 export { i as isSimdAvailable } from './simd-DW5AtJ6B.js';
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { VERSION, createNarsil } from './chunk-VNMTB3KC.mjs';
+export { VERSION, createNarsil } from './chunk-IOR2K26O.mjs';
 import './chunk-GCM3JFVA.mjs';
 import './chunk-FVLQ63B7.mjs';
 export { getStopWords, getTokenizer, hasStopWords, hasTokenizer, registerStopWords, registerTokenizer } from './chunk-M76V3OGJ.mjs';

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

@@ -1,4 +1,4 @@
-import { CHECKPOINT_WORKER_HEARTBEAT_MS, createDurableDirectory, writeCheckpointSegments } from '../../chunk-VNMTB3KC.mjs';
+import { CHECKPOINT_WORKER_HEARTBEAT_MS, createDurableDirectory, writeCheckpointSegments } from '../../chunk-IOR2K26O.mjs';
 import '../../chunk-GCM3JFVA.mjs';
 import '../../chunk-FVLQ63B7.mjs';
 import '../../chunk-M76V3OGJ.mjs';