@delali/narsil 0.2.4-next.42 → 0.2.4-next.44

package/dist/client.mjs

@@ -1,7 +1,6 @@
 // src/errors.ts
 var ErrorCodes = {
   SCHEMA_INVALID_TYPE: "SCHEMA_INVALID_TYPE",
-  SCHEMA_MISSING_FIELD: "SCHEMA_MISSING_FIELD",
   SCHEMA_DEPTH_EXCEEDED: "SCHEMA_DEPTH_EXCEEDED",
   SCHEMA_INVALID_VECTOR_DIMENSION: "SCHEMA_INVALID_VECTOR_DIMENSION",
   SCHEMA_INVALID_GEOPOINT: "SCHEMA_INVALID_GEOPOINT",
@@ -11,6 +10,7 @@ var ErrorCodes = {
   INDEX_NOT_FOUND: "INDEX_NOT_FOUND",
   INDEX_ALREADY_EXISTS: "INDEX_ALREADY_EXISTS",
   INDEX_ORPHANED: "INDEX_ORPHANED",
+  INDEX_REOPEN_CAPACITY_EXHAUSTED: "INDEX_REOPEN_CAPACITY_EXHAUSTED",
   PARTITION_CORRUPTED: "PARTITION_CORRUPTED",
   PARTITION_REBALANCING_BACKPRESSURE: "PARTITION_REBALANCING_BACKPRESSURE",
   WORKER_CRASHED: "WORKER_CRASHED",
@@ -23,7 +23,6 @@ var ErrorCodes = {
   PERSISTENCE_WAL_CORRUPT: "PERSISTENCE_WAL_CORRUPT",
   PERSISTENCE_FSYNC_FAILED: "PERSISTENCE_FSYNC_FAILED",
   SEARCH_INVALID_FIELD: "SEARCH_INVALID_FIELD",
-  SEARCH_INVALID_VECTOR_SIZE: "SEARCH_INVALID_VECTOR_SIZE",
   VECTOR_DIMENSION_MISMATCH: "VECTOR_DIMENSION_MISMATCH",
   SEARCH_INVALID_FILTER: "SEARCH_INVALID_FILTER",
   SEARCH_INVALID_MODE: "SEARCH_INVALID_MODE",
@@ -47,8 +46,6 @@ var ErrorCodes = {
   ALLOCATION_NO_DATA_NODES: "ALLOCATION_NO_DATA_NODES",
   ALLOCATION_INVALID_CONFIG: "ALLOCATION_INVALID_CONFIG",
   ALLOCATION_FAILED: "ALLOCATION_FAILED",
-  CONTROLLER_LEASE_LOST: "CONTROLLER_LEASE_LOST",
-  CONTROLLER_NOT_ACTIVE: "CONTROLLER_NOT_ACTIVE",
   CONTROLLER_METADATA_INVALID: "CONTROLLER_METADATA_INVALID",
   NODE_BOOTSTRAP_FAILED: "NODE_BOOTSTRAP_FAILED",
   NODE_ALREADY_JOINED: "NODE_ALREADY_JOINED",
@@ -104,6 +101,7 @@ var ServerErrorCodes = {
   TASK_NOT_FOUND: "TASK_NOT_FOUND",
   TASK_NOT_CANCELLABLE: "TASK_NOT_CANCELLABLE",
   TASK_OWNED_BY_ANOTHER_INSTANCE: "TASK_OWNED_BY_ANOTHER_INSTANCE",
+  TASK_INTERRUPTED: "TASK_INTERRUPTED",
   TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS",
   HOOK_ERROR: "HOOK_ERROR",
   INTERNAL_ERROR: "INTERNAL_ERROR"
@@ -148,11 +146,13 @@ var ASYNC_IMPORT_CAPABILITY = "documents.import.async";
 var TASK_CANCEL_CAPABILITY = "tasks.cancel";
 var TASK_FILTER_CAPABILITY = "tasks.filter";
 var REBUILD_ANALYSIS_CAPABILITY = "indexes.rebuildAnalysis";
+var INDEX_LIFECYCLE_CAPABILITY = "indexes.lifecycle";
 var SERVER_CAPABILITIES = [
   ASYNC_IMPORT_CAPABILITY,
   TASK_CANCEL_CAPABILITY,
   TASK_FILTER_CAPABILITY,
-  REBUILD_ANALYSIS_CAPABILITY
+  REBUILD_ANALYSIS_CAPABILITY,
+  INDEX_LIFECYCLE_CAPABILITY
 ];
 
 // src/json-encoding.ts
@@ -672,6 +672,12 @@ function createIndexOperations(transport) {
     },
     async clear(indexName, options) {
       await transport.json({ method: "POST", path: `${indexPath(indexName)}/_clear`, options });
+    },
+    async open(indexName, options) {
+      await transport.json({ method: "POST", path: `${indexPath(indexName)}/_open`, options });
+    },
+    async close(indexName, options) {
+      await transport.json({ method: "POST", path: `${indexPath(indexName)}/_close`, options });
     }
   };
 }
@@ -842,4 +848,4 @@ function createNarsilClient(options) {
   };
 }
 
-export { ASYNC_IMPORT_CAPABILITY, ClientErrorCodes, ErrorCodes, NarsilError, REBUILD_ANALYSIS_CAPABILITY, SERVER_CAPABILITIES, ServerErrorCodes, TASK_CANCEL_CAPABILITY, TASK_FILTER_CAPABILITY, createNarsilClient };
+export { ASYNC_IMPORT_CAPABILITY, ClientErrorCodes, ErrorCodes, INDEX_LIFECYCLE_CAPABILITY, NarsilError, REBUILD_ANALYSIS_CAPABILITY, SERVER_CAPABILITIES, ServerErrorCodes, TASK_CANCEL_CAPABILITY, TASK_FILTER_CAPABILITY, createNarsilClient };

package/dist/{config-fLC4lbmg.d.ts → config-B-ZI-ft5.d.ts}

@@ -1,5 +1,5 @@
-import { N as NarsilConfig } from './config-Byyl1QqH.js';
-import { A as AllocationTable, N as NodeRole, a as NodeRegistration, C as ClusterCoordinator, b as NodeCapacity } from './types-B5Tsaalz.js';
+import { N as NarsilConfig } from './config-BZRExglL.js';
+import { A as AllocationTable, N as NodeRole, a as NodeRegistration, C as ClusterCoordinator, b as NodeCapacity } from './types-DsSSjY4d.js';
 import { N as NodeTransport } from './types-D5OwhtsQ.js';
 
 /**

package/dist/{config-Byyl1QqH.d.ts → config-BZRExglL.d.ts}

@@ -1,6 +1,6 @@
 import { P as PersistenceAdapter, I as InvalidationAdapter, E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { Q as QueryParams, e as QueryResult } from './search-DHuXwJYk.js';
-import { I as IndexConfig, A as AnyDocument } from './schema-ZRbk8BgH.js';
+import { Q as QueryParams, e as QueryResult } from './search-DDHjfXhJ.js';
+import { I as IndexConfig, A as AnyDocument } from './schema-B7juWg8Q.js';
 
 /**
  * Hooks that run alongside the engine's own work, which is how you add
@@ -158,6 +158,23 @@ interface NarsilConfig {
     durability?: DurabilityConfig;
     /** These settings control what the engine does when an index's stored analysis differs from its language module. */
     analysis?: AnalysisConfig;
+    /** These limits close indexes while keeping their durable files ready to reopen. */
+    lifecycle?: IndexLifecycleConfig;
+}
+/**
+ * Limits on the indexes one engine keeps open in memory.
+ *
+ * @public
+ */
+interface IndexLifecycleConfig {
+    /** An index closes after this many milliseconds without activity. */
+    idleTimeoutMs?: number;
+    /** The engine keeps at most this many indexes open at once. */
+    maxOpenIndexes?: number;
+    /** Open indexes may use at most this many estimated bytes in total. */
+    maxOpenBytes?: number;
+    /** At most this many callers may wait behind one index reopen. */
+    maxReopenWaiters?: number;
 }
 /**
  * Describes an index whose stored terms came from an older analysis than the
@@ -253,4 +270,4 @@ interface WorkerConfig {
     bootstrapModule?: string;
 }
 
-export type { AnalysisConfig as A, DurabilityConfig as D, IndexContext as I, NarsilConfig as N, PartitionContext as P, RemoveContext as R, SearchContext as S, UpdateContext as U, WorkerConfig as W, InsertContext as a, NarsilPlugin as b, StaleAnalysis as c, WorkerContext as d };
+export type { AnalysisConfig as A, DurabilityConfig as D, IndexContext as I, NarsilConfig as N, PartitionContext as P, RemoveContext as R, SearchContext as S, UpdateContext as U, WorkerConfig as W, IndexLifecycleConfig as a, InsertContext as b, NarsilPlugin as c, StaleAnalysis as d, WorkerContext as e };

package/dist/{direct-executor-MSJEVPZU.mjs → direct-executor-IMXNRS7O.mjs}

@@ -1,8 +1,8 @@
-export { createDirectExecutor } from './chunk-GRWFY2HI.mjs';
+export { createDirectExecutor } from './chunk-XNCJFU2E.mjs';
 import './chunk-TGP5M5R7.mjs';
 import './chunk-OBXS7OZM.mjs';
 import './chunk-WDL632CN.mjs';
 import './chunk-U2BKYEC7.mjs';
 import './chunk-BFIH7OV5.mjs';
 import './chunk-WTONLDU3.mjs';
-import './chunk-GB2IIJJG.mjs';
+import './chunk-P4ELXVJQ.mjs';

package/dist/distribution/coordinator/etcd.d.ts

@@ -1,5 +1,5 @@
-import { C as ClusterCoordinator } from '../../types-B5Tsaalz.js';
-import '../../schema-ZRbk8BgH.js';
+import { C as ClusterCoordinator } from '../../types-DsSSjY4d.js';
+import '../../schema-B7juWg8Q.js';
 import '../../adapters-79OIa4xm.js';
 
 /**

package/dist/distribution/coordinator/etcd.mjs

@@ -1,5 +1,5 @@
 import { compareCodePoints } from '../../chunk-BFIH7OV5.mjs';
-import { NarsilError, ErrorCodes } from '../../chunk-GB2IIJJG.mjs';
+import { NarsilError, ErrorCodes } from '../../chunk-P4ELXVJQ.mjs';
 import { decode, encode } from '@msgpack/msgpack';
 
 // src/distribution/coordinator/etcd/types.ts

package/dist/distribution/coordinator/in-memory.d.ts

@@ -1,5 +1,5 @@
-import { C as ClusterCoordinator } from '../../types-B5Tsaalz.js';
-import '../../schema-ZRbk8BgH.js';
+import { C as ClusterCoordinator } from '../../types-DsSSjY4d.js';
+import '../../schema-B7juWg8Q.js';
 import '../../adapters-79OIa4xm.js';
 
 /**

package/dist/distribution/transport/grpc.mjs

@@ -1,6 +1,6 @@
 import { decodeTransportMessage, encodeTransportMessage } from '../../chunk-PM52SMBT.mjs';
 import { TransportError, TransportErrorCodes, MAX_MESSAGE_SIZE_BYTES } from '../../chunk-JQUL2T6I.mjs';
-import { NarsilError, ErrorCodes } from '../../chunk-GB2IIJJG.mjs';
+import { NarsilError, ErrorCodes } from '../../chunk-P4ELXVJQ.mjs';
 
 // src/distribution/transport/grpc/codec.ts
 var FIELD_ONE_LENGTH_DELIMITED_KEY = 10;

package/dist/distribution.d.ts

@@ -1,12 +1,12 @@
-import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-fLC4lbmg.js';
-export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-fLC4lbmg.js';
-import { N as NarsilEventMap, a as Narsil } from './engine-BE45D5ZG.js';
-import { B as BatchResult, L as ListParams, g as ListResult, i as SuggestParams, j as SuggestResult, Q as QueryParams, h as PreflightResult, f as IndexStats, P as PartitionStatsResult, M as MemoryStats, e as QueryResult } from './search-DHuXwJYk.js';
-import { I as IndexConfig, A as AnyDocument, a as InsertOptions } from './schema-ZRbk8BgH.js';
-import { b as NodeCapacity, N as NodeRole } from './types-B5Tsaalz.js';
-export { c as AllocationConstraints, d as AllocationEvent, A as AllocationTable, C as ClusterCoordinator, e as NodeEvent, a as NodeRegistration, P as PartitionAssignment, f as PartitionState, S as SchemaEvent, U as UnassignedReason } from './types-B5Tsaalz.js';
+import { a as CreateIndexOptions, C as ClusterNamespace, b as ClusterNodeConfig } from './config-B-ZI-ft5.js';
+export { c as ClusterControllerConfig, d as ClusterNodeInfo, e as ClusterQueryConfig, N as NodeReadiness, R as ReplicationConfig } from './config-B-ZI-ft5.js';
+import { N as NarsilEventMap, a as Narsil } from './engine-Cjr1uBLa.js';
+import { B as BatchResult, L as ListParams, g as ListResult, i as SuggestParams, j as SuggestResult, Q as QueryParams, h as PreflightResult, f as IndexStats, P as PartitionStatsResult, M as MemoryStats, e as QueryResult } from './search-DDHjfXhJ.js';
+import { I as IndexConfig, A as AnyDocument, b as InsertOptions } from './schema-B7juWg8Q.js';
+import { b as NodeCapacity, N as NodeRole } from './types-DsSSjY4d.js';
+export { c as AllocationConstraints, d as AllocationEvent, A as AllocationTable, C as ClusterCoordinator, e as NodeEvent, a as NodeRegistration, P as PartitionAssignment, f as PartitionState, S as SchemaEvent, U as UnassignedReason } from './types-DsSSjY4d.js';
 export { L as ListenHandler, N as NodeTransport, R as RespondFn, T as TransportConfig, a as TransportMessage } from './types-D5OwhtsQ.js';
-import './config-Byyl1QqH.js';
+import './config-BZRExglL.js';
 import './adapters-79OIa4xm.js';
 
 /**
@@ -48,6 +48,20 @@ interface ClusterNode {
     readonly nodeId: string;
     /** The node holds these roles in the cluster. */
     readonly roles: ReadonlyArray<NodeRole>;
+    /**
+     * Loads this node's local copy of an index from durable storage.
+     *
+     * @param indexName - The index to load on this node.
+     * @returns A promise that settles when the local copy is ready for operations.
+     */
+    open(indexName: string): Promise<void>;
+    /**
+     * Checkpoints and releases this node's local copy of an index.
+     *
+     * @param indexName - The index to close on this node.
+     * @returns A promise that settles after the local copy releases its memory.
+     */
+    close(indexName: string): Promise<void>;
     /**
      * Creates an index across the cluster, publishing its schema and allocating
      * its partitions to nodes.
@@ -325,8 +339,8 @@ interface ClusterEngineOptions {
  *
  * Writes, updates, searches, suggestions, listings, counts, index creation,
  * index removal, and document reads route through the cluster. Checkpointing,
- * memory statistics, and engine events reach this node's local engine, because
- * each covers a per-node fact. Every other operation fails with
+ * memory statistics, index opens, index closes, and engine events reach this
+ * node's local engine, because each covers a per-node fact. Every other operation fails with
  * `CLUSTER_OPERATION_UNSUPPORTED`, which the HTTP server answers with status
  * 501, so a caller learns the operation is missing rather than reading a
  * wrong answer. That covers `getStats`, `getPartitionStats`, and