@delali/narsil 0.2.4-next.43 → 0.2.4-next.45

package/dist/embeddings/openai.mjs

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

package/dist/{engine-CjLhdDIm.d.ts → engine-Cjr1uBLa.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-BGouJxH4.js';
-import { I as IndexConfig, A as AnyDocument, a as InsertOptions, P as PartitionConfig } from './schema-DXOd96kx.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-DDHjfXhJ.js';
+import { I as IndexConfig, A as AnyDocument, b as InsertOptions, P as PartitionConfig } from './schema-B7juWg8Q.js';
 
 /**
  * Every event the engine emits, with the payload each one carries.
@@ -88,6 +88,28 @@ type NarsilEventMap = {
     };
 };
 
+/**
+ * Opens and closes durable indexes without deleting them.
+ *
+ * @public
+ */
+interface IndexLifecycleOperations {
+    /**
+     * Loads a closed index from its durable checkpoint and resets a parked recovery failure.
+     *
+     * @param indexName - The index to load.
+     * @returns A promise that settles when the index is ready for operations.
+     */
+    open(indexName: string): Promise<void>;
+    /**
+     * Drains active work, checkpoints the index, releases its memory, and keeps its durable files.
+     *
+     * @param indexName - The index to close.
+     * @returns A promise that settles after the index releases its memory.
+     */
+    close(indexName: string): Promise<void>;
+}
+
 /**
  * The search engine, and everything you do with it.
  *
@@ -97,7 +119,7 @@ type NarsilEventMap = {
  *
  * @public
  */
-interface Narsil {
+interface Narsil extends IndexLifecycleOperations {
     /**
      * Creates an index you can insert documents into and query.
      *
@@ -140,7 +162,7 @@ interface Narsil {
      * an index grows unevenly or a rebalance is worth running.
      *
      * @param indexName - The index to describe.
-     * @returns One entry per partition, in partition order.
+     * @returns One entry per open partition, in partition order, or an empty list while the index is closed.
      */
     getPartitionStats(indexName: string): PartitionStatsResult[];
     /**
@@ -422,7 +444,7 @@ interface Narsil {
      * optimisation would cost.
      *
      * @param indexName - The index to describe.
-     * @returns One entry per vector field.
+     * @returns One entry per vector field, or an empty list while the index is closed.
      */
     vectorMaintenanceStatus(indexName: string): VectorMaintenanceResult[];
     /**
@@ -456,4 +478,4 @@ interface Narsil {
     shutdown(): Promise<void>;
 }
 
-export type { NarsilEventMap as N, Narsil as a };
+export type { IndexLifecycleOperations as I, NarsilEventMap as N, Narsil as a };