@delali/narsil 0.2.4-next.49 → 0.2.4-next.51

package/README.md

@@ -91,7 +91,7 @@ Every hit holds the document, its id, and its BM25 score. `results.count` report
 
 **Storage.** [Persistence adapters](https://github.com/assetcorp/narsil/blob/main/docs/persistence-and-durability.md) plug in filesystem, IndexedDB, memory, or custom backends. Durability adds a write-ahead log with periodic checkpoints and automatic recovery, and snapshots capture a whole index as one portable byte array.
 
-**Scale.** [Partitioned indexes](https://github.com/assetcorp/narsil/blob/main/docs/partitions-and-workers.md) route documents by deterministic hash and reshape online through `rebalance()`, with writes buffering in a write-ahead queue during the reshape. Worker copies answer keyword queries on half the worker threads once an index holds 1,000 documents.
+**Scale.** [Partitioned indexes](https://github.com/assetcorp/narsil/blob/main/docs/partitions-and-workers.md) route documents by deterministic hash and reshape online through `rebalance()`, with writes buffering in a write-ahead queue during the reshape. Worker copies answer keyword queries on half the worker threads once an index holds 1,000 documents, and the HTTP server receives requests on the threads that hold them.
 
 **Operations.** The [HTTP server](https://github.com/assetcorp/narsil/blob/main/docs/http-server.md) subpath wraps an engine in a REST API with health probes, bulk NDJSON import, snapshot and restore endpoints, and task-based long operations. The [client](https://github.com/assetcorp/narsil/blob/main/docs/client.md) subpath reaches every one of those routes from a browser or from Node under the engine's own method names, and the [React](https://github.com/assetcorp/narsil/blob/main/docs/react.md) subpath gives those methods to components as hooks. [Events, plugins, and memory reporting](https://github.com/assetcorp/narsil/blob/main/docs/observability.md) cover observability, and [language modules](https://github.com/assetcorp/narsil/blob/main/docs/language-support.md) cover 107 languages as separate entry points, 20 of them African.
 

package/dist/{options-Dtk99qUs.d.ts → capabilities-BWm4IITU.d.ts}

@@ -1,51 +1,6 @@
 import { E as EmbeddingAdapter } from './adapters-79OIa4xm.js';
-import { C as ClusterNamespace } from './config-B41W23Us.js';
-import { h as TaskStore } from './tasks-Bn4R1NPN.js';
-
-/**
- * Marks that `POST /indexes/{name}/documents/_import` accepts `?async=true` and
- * answers with a task record.
- *
- * @public
- */
-declare const ASYNC_IMPORT_CAPABILITY = "documents.import.async";
-/**
- * Marks that `POST /tasks/{id}/_cancel` asks a running task to stop.
- *
- * @public
- */
-declare const TASK_CANCEL_CAPABILITY = "tasks.cancel";
-/**
- * Marks that `GET /tasks` filters by index, type, and status, and pages through
- * `from` and `limit`.
- *
- * @public
- */
-declare const TASK_FILTER_CAPABILITY = "tasks.filter";
-/**
- * Marks that `POST /indexes/{name}/_rebuild-analysis` reanalyses an index whose
- * language module moved on.
- *
- * @public
- */
-declare const REBUILD_ANALYSIS_CAPABILITY = "indexes.rebuildAnalysis";
-/**
- * Marks that `POST /indexes/{name}/_open` and `POST /indexes/{name}/_close`
- * load and release an index's server memory.
- *
- * @public
- */
-declare const INDEX_LIFECYCLE_CAPABILITY = "indexes.lifecycle";
-/**
- * Every capability this server announces at `/capabilities`.
- *
- * A client reads this list to find out whether an optional route or mode is
- * available before it sends a request, because a server that predates one of
- * them answers 404 rather than explaining itself.
- *
- * @public
- */
-declare const SERVER_CAPABILITIES: readonly string[];
+import { C as ClusterNamespace } from './config-Czh2YNDi.js';
+import { h as TaskStore } from './tasks-DT7L1p6w.js';
 
 /**
  * Context handed to {@link OnRequestHook} for every inbound request, captured
@@ -121,7 +76,7 @@ interface ServerLimits {
     maxLineBytes?: number;
     /** Documents handed to the engine per batch during NDJSON import; the loop yields between batches. */
     importBatchSize?: number;
-    /** Maximum requests executing engine work at once; excess is shed with 429. Omit or 0 to disable. */
+    /** Maximum requests executing engine work at once, counted across every request thread; excess is shed with 429. Omit or 0 to disable. */
     maxConcurrentRequests?: number;
     /** Ceiling for a search's `limit`, `offset`, and `group.maxPerGroup`, so one
      * request cannot ask for an unbounded result set. Excess → 400. Defaults to
@@ -228,6 +183,14 @@ interface NarsilServer {
     close(): Promise<void>;
     /** The server bound to this port, which is what you read after binding to port 0. */
     readonly listeningPort: number;
+    /**
+     * How many request threads receive connections, which is the engine's
+     * worker count on a machine with three cores or more and one below that.
+     * It reads zero while the main thread answers every request itself, which
+     * happens on a runtime without worker threads, on an engine created with
+     * `workers.enabled: false`, and on a cluster node's engine.
+     */
+    readonly requestThreadCount: number;
 }
 /**
  * The body every failed response carries, which is what an HTTP client parses
@@ -247,4 +210,49 @@ interface ErrorEnvelope {
     };
 }
 
+/**
+ * Marks that `POST /indexes/{name}/documents/_import` accepts `?async=true` and
+ * answers with a task record.
+ *
+ * @public
+ */
+declare const ASYNC_IMPORT_CAPABILITY = "documents.import.async";
+/**
+ * Marks that `POST /tasks/{id}/_cancel` asks a running task to stop.
+ *
+ * @public
+ */
+declare const TASK_CANCEL_CAPABILITY = "tasks.cancel";
+/**
+ * Marks that `GET /tasks` filters by index, type, and status, and pages through
+ * `from` and `limit`.
+ *
+ * @public
+ */
+declare const TASK_FILTER_CAPABILITY = "tasks.filter";
+/**
+ * Marks that `POST /indexes/{name}/_rebuild-analysis` reanalyses an index whose
+ * language module moved on.
+ *
+ * @public
+ */
+declare const REBUILD_ANALYSIS_CAPABILITY = "indexes.rebuildAnalysis";
+/**
+ * Marks that `POST /indexes/{name}/_open` and `POST /indexes/{name}/_close`
+ * load and release an index's server memory.
+ *
+ * @public
+ */
+declare const INDEX_LIFECYCLE_CAPABILITY = "indexes.lifecycle";
+/**
+ * Every capability this server announces at `/capabilities`.
+ *
+ * A client reads this list to find out whether an optional route or mode is
+ * available before it sends a request, because a server that predates one of
+ * them answers 404 rather than explaining itself.
+ *
+ * @public
+ */
+declare const SERVER_CAPABILITIES: readonly string[];
+
 export { ASYNC_IMPORT_CAPABILITY as A, type CorsOptions as C, type ErrorEnvelope as E, INDEX_LIFECYCLE_CAPABILITY as I, type NarsilServer as N, type OnRequestHook as O, REBUILD_ANALYSIS_CAPABILITY as R, SERVER_CAPABILITIES as S, TASK_CANCEL_CAPABILITY as T, TASK_FILTER_CAPABILITY as a, type ServerOptions as b, type RequestContext as c, type RequestDenial as d, type ServerLimits as e };

package/dist/chunk-AV4IJKD2.mjs

@@ -0,0 +1,35 @@
+// src/runtime/detect.ts
+function detectRuntimeName() {
+  if ("Bun" in globalThis) {
+    return "bun";
+  }
+  if ("Deno" in globalThis) {
+    return "deno";
+  }
+  const proc = globalThis.process;
+  if (typeof proc === "object" && proc !== null && typeof proc.versions === "object" && typeof proc.versions?.node === "string") {
+    return "node";
+  }
+  return "browser";
+}
+function getCpuCount() {
+  const nav = globalThis.navigator;
+  if (nav && typeof nav.hardwareConcurrency === "number" && nav.hardwareConcurrency >= 1) {
+    return nav.hardwareConcurrency;
+  }
+  return 1;
+}
+function detectRuntime() {
+  const runtime = detectRuntimeName();
+  return {
+    runtime,
+    cpuCount: getCpuCount(),
+    supportsWorkerThreads: runtime === "node" || runtime === "bun",
+    supportsWebWorkers: runtime === "browser" || runtime === "deno" || runtime === "bun",
+    supportsFileSystem: runtime === "node" || runtime === "bun" || runtime === "deno",
+    supportsIndexedDB: runtime === "browser" || "indexedDB" in globalThis,
+    supportsBroadcastChannel: "BroadcastChannel" in globalThis
+  };
+}
+
+export { detectRuntime };