@delali/narsil 0.2.2 → 0.2.3-next.32

package/README.md

@@ -12,11 +12,11 @@ Distributed search, reforged.
 
 Narsil is a distributed search engine with full-text, vector, hybrid, and geosearch. One codebase runs in two contexts: embedded in your application process, where queries answer without a network hop, and as a standalone search server with a REST API, a write-ahead log, and bulk NDJSON ingest. Both contexts run the same engine and store indexes in the same cross-language binary format (.nrsl), so an index built in one loads in the other.
 
-The engine partitions large indexes across workers and merges partition results into a single ranked answer. Its BM25 ranking matches the Anserini reference within 0.005 nDCG@10 on the BEIR datasets. On BEIR SciFact it ranks level with Elasticsearch and OpenSearch at 0.678 nDCG@10 and answers 1,020 keyword queries per second, about a quarter more than either ([benchmarks](https://github.com/assetcorp/narsil/blob/main/BENCHMARKS.md)). This TypeScript package is the reference implementation of the cross-language `.nrsl` format, and a second-language port in Go or Rust is the headline item on the [roadmap](https://github.com/assetcorp/narsil/blob/main/ROADMAP.md).
+The engine partitions large indexes across workers and merges partition results into a single ranked answer. Its BM25 ranking matches the Anserini reference within 0.006 nDCG@10 on the BEIR datasets. On BEIR SciFact it takes the top nDCG@10 at 0.681, narrowly ahead of Elasticsearch and OpenSearch at 0.679, and answers 958 keyword queries per second against their 841 and 878 ([benchmarks](https://github.com/assetcorp/narsil/blob/main/BENCHMARKS.md)). This TypeScript package is the reference implementation of the cross-language `.nrsl` format, and a second-language port in Go or Rust is the headline item on the [roadmap](https://github.com/assetcorp/narsil/blob/main/ROADMAP.md).
 
 Try it in your browser at [narsil.sondelali.com/demo](https://narsil.sondelali.com/demo). Read the full documentation at [narsil.sondelali.com/docs](https://narsil.sondelali.com/docs).
 
-> *narsil* is the sword of Elendil in Tolkien's Lord of the Rings, shattered into shards and later reforged. The name maps to the architecture: data shatters into partitions, each shard is independently persisted, and every query reforges them into a unified result.
+> *narsil* is the sword of Elendil in Tolkien's Lord of the Rings, shattered into shards and later reforged. The name maps to the architecture: data shatters into partitions, the engine persists each shard on its own, and every query reforges them into one ranked answer.
 
 ## Contents
 
@@ -79,7 +79,7 @@ const results = await narsil.query('products', {
 })
 ```
 
-Every hit carries the document, its id, and its BM25 score. `results.count` reports how many documents matched in total, and `results.elapsed` reports the query time in milliseconds.
+Every hit holds the document, its id, and its BM25 score. `results.count` reports how many documents matched in total, and `results.elapsed` reports the query time in milliseconds.
 
 ## Features
 
@@ -93,7 +93,7 @@ Every hit carries the document, its id, and its BM25 score. `results.count` repo
 
 **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 promotion moves search off the main thread once document counts cross a threshold.
 
-**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. [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.
+**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.
 
 ## Documentation
 
@@ -110,7 +110,10 @@ Every hit carries the document, its id, and its BM25 score. `results.count` repo
 | [Persistence and durability](../../docs/persistence-and-durability.md) | Storage backends, the write-ahead log, checkpoints, recovery, and snapshots |
 | [Partitions and workers](../../docs/partitions-and-workers.md) | Partition routing, online rebalancing, worker promotion, and multi-instance invalidation |
 | [Language support](../../docs/language-support.md) | The 107 language modules, analysis revisions and rebuilds, and named tokenizers and stop words |
-| [HTTP server](../../docs/http-server.md) | Wrapping an engine in a REST API, and every route it serves |
+| [HTTP server](../../docs/http-server.md) | Wrapping an engine in a REST API, every route it serves, and long-running tasks |
+| [Cluster mode](../../docs/cluster.md) | Multi-node indexes: nodes and roles, replication, routed writes, distributed searches and reads, and what a cluster refuses |
+| [Client](../../docs/client.md) | Reaching a server from a browser or Node, following a task, and the codes it raises |
+| [React](../../docs/react.md) | The hooks over the client, one shared request per key, and loading a corpus from a component |
 | [Observability](../../docs/observability.md) | Plugin hooks, engine events, and memory reporting |
 | [Errors](../../docs/errors.md) | Every error code and what throws it |
 
@@ -122,15 +125,15 @@ The [specification](../spec/) defines the `.nrsl` format, the analysis pipeline,
 | --- | --- |
 | [HTTP server](examples/http-server/README.md) | The launcher runs the engine as a REST service with durability, API-key auth, and Docker packaging, and its README documents the full API surface. |
 | [Browser](examples/browser/README.md) | The app embeds the engine in a browser with IndexedDB persistence and Web Worker search. |
-| [Server app](examples/server-app/README.md) | The app pairs a search UI with the HTTP server, including dataset loading and an embedding-backed Ask view. |
+| [Server app](examples/server-app/README.md) | The app reaches the HTTP server through the client SDK and the React hooks, loads corpora as import tasks, and answers questions from them in an Ask view. |
 
 ## Distribution
 
-`@delali/narsil/distribution` holds the building blocks of Narsil's multi-node cluster mode: node roles, replication, coordinator adapters, and query routing. The distribution layer is under active development and highly experimental. It currently runs only in-process, its APIs change without notice, and it is not ready for production deployments. The design is specified in [`packages/spec/distribution`](../spec/distribution), and this section will grow into full documentation once the cluster mode is runnable.
+`@delali/narsil/distribution` holds Narsil's multi-node cluster mode: nodes and roles, replication, coordinator adapters for etcd and in-process testing, TCP and gRPC transports with mutual TLS, and distributed query routing. A cluster node creates, drops, clears, writes, updates, searches, lists, counts, and suggests across every partition, and the [cluster example](examples/cluster) runs three node processes against etcd and survives a kill. The layer is experimental and its APIs change without notice, so pin an exact version before you depend on it. The [cluster guide](../../docs/cluster.md) covers the surface, and [`packages/spec/distribution`](../spec/distribution) specifies the contract every implementation follows.
 
 ## Search quality
 
-Ranking quality is measured against the [BEIR](https://github.com/beir-cellar/beir) SciFact corpus, 5,183 documents with 300 judged queries, where a human relevance judgment scores each query-document pair. Narsil runs in one process against Orama and MiniSearch, and every engine uses identical stop words (Lucene English, 35 terms), Porter stemming, and default BM25 parameters. Narsil takes the top nDCG@10 of the three.
+Ranking quality is measured against the [BEIR](https://github.com/beir-cellar/beir) SciFact corpus, 5,183 documents with 300 judged queries, where a human relevance judgment scores each query-document pair. Narsil runs in one process against Orama and MiniSearch, and every engine uses identical stop words (Lucene English, 33 terms) and default BM25 parameters, while each one stems English with its own implementation. Narsil takes the top nDCG@10 of the three.
 
 **What these metrics mean:**
 
@@ -154,7 +157,7 @@ Narsil also runs as a search server. On the BEIR information-retrieval datasets
 | Deno | Web Workers | Filesystem | BroadcastChannel |
 | Browser | Web Workers | IndexedDB | BroadcastChannel |
 
-The [browser example](examples/browser/README.md) shows an embedded engine with IndexedDB persistence, and the [server app example](examples/server-app/README.md) shows a full search UI backed by the HTTP server.
+The [browser example](examples/browser/README.md) shows an embedded engine with IndexedDB persistence, and the [server app example](examples/server-app/README.md) shows the same UI over the client SDK and the React hooks.
 
 ## License
 

package/dist/adapters/filesystem.d.ts

@@ -1,4 +1,4 @@
-import { b as PersistenceAdapter } from '../adapters-CVqI5NBt.js';
+import { P as PersistenceAdapter } from '../adapters-79OIa4xm.js';
 
 /**
  * Where {@link createFilesystemPersistence} writes its partitions.

package/dist/adapters/filesystem.mjs

@@ -1,4 +1,4 @@
-import { NarsilError, ErrorCodes } from '../chunk-UNJZ7ZDB.mjs';
+import { NarsilError, ErrorCodes } from '../chunk-EMI63EXP.mjs';
 
 // src/persistence/filesystem.ts
 var cachedFs = null;

package/dist/adapters/indexeddb.d.ts

@@ -1,4 +1,4 @@
-import { b as PersistenceAdapter } from '../adapters-CVqI5NBt.js';
+import { P as PersistenceAdapter } from '../adapters-79OIa4xm.js';
 
 /**
  * Which IndexedDB database and object store

package/dist/adapters/indexeddb.mjs

@@ -1,4 +1,4 @@
-import { NarsilError, ErrorCodes } from '../chunk-UNJZ7ZDB.mjs';
+import { NarsilError, ErrorCodes } from '../chunk-EMI63EXP.mjs';
 
 // src/persistence/indexeddb.ts
 var DEFAULT_DB_NAME = "narsil";

package/dist/adapters/memory.d.ts

@@ -1,4 +1,4 @@
-import { b as PersistenceAdapter } from '../adapters-CVqI5NBt.js';
+import { P as PersistenceAdapter } from '../adapters-79OIa4xm.js';
 
 /**
  * Builds a persistence adapter that keeps every partition in a map, which is

package/dist/{adapters-CVqI5NBt.d.ts → adapters-79OIa4xm.d.ts}

@@ -146,4 +146,4 @@ interface EmbeddingAdapter {
     shutdown?(): Promise<void>;
 }
 
-export type { EmbeddingAdapter as E, InvalidationAdapter as I, PartitionStatistics as P, InvalidationEvent as a, PersistenceAdapter as b };
+export type { EmbeddingAdapter as E, InvalidationAdapter as I, PersistenceAdapter as P, InvalidationEvent as a, PartitionStatistics as b };

package/dist/brute-force-DbHYCTc3.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Similarity metric a vector search ranks by.
+ *
+ * @internal
+ */
+type VectorMetric = 'cosine' | 'dotProduct' | 'euclidean';
+
+export type { VectorMetric as V };

package/dist/chunk-BFIH7OV5.mjs

@@ -0,0 +1,185 @@
+// src/core/ordering/code-points.ts
+function adjustUtf16Unit(unit) {
+  if (unit < 55296) return unit;
+  if (unit < 57344) return unit + 8192;
+  return unit - 2048;
+}
+function compareCodePoints(a, b) {
+  const shorter = a.length < b.length ? a.length : b.length;
+  let i = 0;
+  while (i < shorter && a.charCodeAt(i) === b.charCodeAt(i)) i++;
+  if (i === shorter) return a.length - b.length;
+  return adjustUtf16Unit(a.charCodeAt(i)) - adjustUtf16Unit(b.charCodeAt(i));
+}
+
+// src/core/ordering/fold-table.ts
+var SINGLE_FOLDS = "1t,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;2j,lj;b,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;2,w;1,w;1,w;1,w;1,w;1,w;1,w;y,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;4,1;2,1;2,1;3,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;3,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,-3d;1,1;2,1;2,1;2,-7g;2,5u;1,1;2,1;2,5q;1,1;2,5p;1,5p;1,1;3,27;1,5m;1,5n;1,1;2,5p;1,5r;2,5v;1,5t;1,1;4,5v;1,5x;2,5y;1,1;2,1;2,1;2,62;1,1;2,62;3,1;2,62;1,1;2,61;1,61;1,1;2,1;2,63;1,1;4,1;8,2;1,1;2,2;1,1;2,2;1,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;3,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;3,2;1,1;2,1;2,-2p;1,-1k;1,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,-3m;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;8,8bv;1,1;2,-4j;1,8bs;3,1;2,-5f;1,1x;1,1z;1,1;2,1;2,1;2,1;2,1;6v,38;17,1;2,1;4,1;9,38;7,12;2,11;1,11;1,11;2,1s;2,1r;1,1r;2,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;2,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;n,1;d,8;1,-u;1,-p;4,-f;1,-m;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,-1i;1,-1c;3,-1o;1,-1s;2,1;2,-7;1,1;3,-3m;1,-3m;1,-3m;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,28;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1d,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;a,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,f;1,1;2,1;2,1;2,1;2,1;2,1;2,1;3,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;3,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;28a,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;1,5ls;2,5ls;6,5ls;mj,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1oj,-4su;1,-4st;1,-4sk;1,-4si;1,-4si;1,-4sj;1,-4sc;1,-4ro;1,r7n;1,1;7,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;1,-2bk;3,-2bk;1,-2bk;1,-2bk;8x,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;7,-1m;5,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;a,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;9,-8;1,-8;1,-8;1,-8;1,-8;1,-8;b,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;9,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;9,-8;1,-8;1,-8;1,-8;1,-8;1,-8;c,-8;2,-8;2,-8;2,-8;9,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;1,-8;21,-8;1,-8;1,-22;1,-22;3,-5j9;a,-2e;1,-2e;1,-2e;1,-2e;d,-8;1,-8;1,-2s;1,-2s;d,-8;1,-8;1,-34;1,-34;1,-7;c,-3k;1,-3k;1,-3i;1,-3i;8b,-5st;4,-6gv;1,-6di;7,s;1a,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;1,g;k,1;mr,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1,q;1f5,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1,1c;1d,1;2,-8af;1,-2xy;1,-89z;3,1;2,1;2,1;2,-8bg;1,-8al;1,-8bj;1,-8bi;2,1;3,1;9,-8cf;1,-8cf;1,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;9,1;2,1;5,1;nym,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;k,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;3s,1;2,1;2,1;2,1;2,1;2,1;2,1;4,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;b,1;2,1;2,-r9g;1,1;2,1;2,1;2,1;2,1;5,1;2,-wmg;3,1;2,1;4,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,-wn8;1,-wnj;1,-wnf;1,-wn5;1,-wn8;2,-wlu;1,-wmi;1,-wlx;1,ps;1,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,-1c;1,-wn7;1,-raw;1,1;2,1;2,-wo7;1,1;2,1;2,1;2,1;2,1;2,1;2,1;2,1;2,-wu9;p,1;or,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;1,-tzk;ggy,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;xy,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;3t,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;1,14;4d,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;2,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;1,13;2,13;1,13;1,13;1,13;1,13;1,13;1,13;2,13;1,13;1d7,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;1,1s;4e,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;27v,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;gw1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1,w;1t,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;1,r;o5k,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;1,y;";
+var MULTI_FOLDS = "67,37,37;29,2x,lj;p,jg,32;4n,2y,lo;bk,qh,lk,ld;w,qt,lk,ld;d3,12d,136;4y7,2w,mp;1,38,lk;1,3b,lm;1,3d,lm;1,2p,ji;4,37,37;4y,qt,lv;2,qt,lv,lc;2,qt,lv,ld;2,qt,lv,n6;16,64g,qh;1,64h,qh;1,64i,qh;1,64j,qh;1,64k,qh;1,64l,qh;1,64m,qh;1,64n,qh;1,64g,qh;1,64h,qh;1,64i,qh;1,64j,qh;1,64k,qh;1,64l,qh;1,64m,qh;1,64n,qh;1,65c,qh;1,65d,qh;1,65e,qh;1,65f,qh;1,65g,qh;1,65h,qh;1,65i,qh;1,65j,qh;1,65c,qh;1,65d,qh;1,65e,qh;1,65f,qh;1,65g,qh;1,65h,qh;1,65i,qh;1,65j,qh;1,674,qh;1,675,qh;1,676,qh;1,677,qh;1,678,qh;1,679,qh;1,67a,qh;1,67b,qh;1,674,qh;1,675,qh;1,676,qh;1,677,qh;1,678,qh;1,679,qh;1,67a,qh;1,67b,qh;3,67k,qh;1,q9,qh;1,q4,qh;2,q9,n6;1,q9,n6,qh;5,q9,qh;6,67o,qh;1,qf,qh;1,q6,qh;2,qf,n6;1,qf,n6,qh;5,qf,qh;6,qh,lk,lc;1,qh,lk,ld;3,qh,n6;1,qh,lk,n6;b,qt,lk,lc;1,qt,lk,ld;1,qp,lv;2,qt,n6;1,qt,lk,n6;b,67w,qh;1,qx,qh;1,r2,qh;2,qx,n6;1,qx,n6,qh;5,qx,qh;179g,2u,2u;1,2u,2x;1,2u,30;1,2u,2u,2x;1,2u,2u,30;1,37,38;1,37,38;d,12s,12u;1,12s,12d;1,12s,12j;1,132,12u;1,12s,12l;";
+var singleTable = null;
+var multiTable = null;
+function singleFoldTable() {
+  if (singleTable === null) {
+    singleTable = /* @__PURE__ */ new Map();
+    let source = 0;
+    for (const entry of SINGLE_FOLDS.split(";")) {
+      if (entry.length === 0) continue;
+      const [delta, offset] = entry.split(",");
+      source += Number.parseInt(delta, 36);
+      singleTable.set(source, source + Number.parseInt(offset, 36));
+    }
+  }
+  return singleTable;
+}
+function multiFoldTable() {
+  if (multiTable === null) {
+    multiTable = /* @__PURE__ */ new Map();
+    let source = 0;
+    for (const entry of MULTI_FOLDS.split(";")) {
+      if (entry.length === 0) continue;
+      const parts = entry.split(",");
+      source += Number.parseInt(parts[0], 36);
+      multiTable.set(
+        source,
+        parts.slice(1).map((cp) => Number.parseInt(cp, 36))
+      );
+    }
+  }
+  return multiTable;
+}
+
+// src/core/ordering/fold-compare.ts
+var EXHAUSTED = -1;
+function nextFoldedCodePoint(text, cursor, single, multi) {
+  if (cursor.pending !== null) {
+    const cp2 = cursor.pending[cursor.pendingIndex];
+    cursor.pendingIndex++;
+    if (cursor.pendingIndex === cursor.pending.length) {
+      cursor.pending = null;
+      cursor.pendingIndex = 0;
+    }
+    return cp2;
+  }
+  if (cursor.index >= text.length) return EXHAUSTED;
+  let cp = text.charCodeAt(cursor.index);
+  cursor.index++;
+  if (cp < 128) {
+    return cp >= 65 && cp <= 90 ? cp + 32 : cp;
+  }
+  if (cp >= 55296 && cp < 56320 && cursor.index < text.length) {
+    const low = text.charCodeAt(cursor.index);
+    if (low >= 56320 && low < 57344) {
+      cp = 65536 + (cp - 55296 << 10) + (low - 56320);
+      cursor.index++;
+    }
+  }
+  const mapped = single.get(cp);
+  if (mapped !== void 0) return mapped;
+  const expansion = multi.get(cp);
+  if (expansion === void 0) return cp;
+  if (expansion.length > 1) {
+    cursor.pending = expansion;
+    cursor.pendingIndex = 1;
+  }
+  return expansion[0];
+}
+function compareCaseFolded(a, b) {
+  const shorter = a.length < b.length ? a.length : b.length;
+  let start = 0;
+  while (start < shorter && a.charCodeAt(start) === b.charCodeAt(start)) start++;
+  if (start === a.length && start === b.length) return 0;
+  if (start > 0) {
+    const previous = a.charCodeAt(start - 1);
+    if (previous >= 55296 && previous < 56320) start--;
+  }
+  const single = singleFoldTable();
+  const multi = multiFoldTable();
+  const aCursor = { index: start, pending: null, pendingIndex: 0 };
+  const bCursor = { index: start, pending: null, pendingIndex: 0 };
+  for (; ; ) {
+    const aCp = nextFoldedCodePoint(a, aCursor, single, multi);
+    const bCp = nextFoldedCodePoint(b, bCursor, single, multi);
+    if (aCp !== bCp) return aCp - bCp;
+    if (aCp === EXHAUSTED) return 0;
+  }
+}
+function compareSortStrings(a, b) {
+  const folded = compareCaseFolded(a, b);
+  if (folded !== 0) return folded;
+  return compareCodePoints(a, b);
+}
+
+// src/core/ordering/sort-values.ts
+var SORT_VALUE_MAX_CODE_POINTS = 512;
+function truncateSortString(value) {
+  if (value.length <= SORT_VALUE_MAX_CODE_POINTS) return value;
+  let index = 0;
+  let counted = 0;
+  while (index < value.length && counted < SORT_VALUE_MAX_CODE_POINTS) {
+    const unit = value.charCodeAt(index);
+    if (unit >= 55296 && unit < 56320 && index + 1 < value.length) {
+      const low = value.charCodeAt(index + 1);
+      if (low >= 56320 && low < 57344) index++;
+    }
+    index++;
+    counted++;
+  }
+  return value.slice(0, index);
+}
+function toComparableSortValue(value) {
+  if (typeof value === "string") return truncateSortString(value);
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (typeof value === "boolean") return value;
+  return null;
+}
+function readSortField(document, path) {
+  const segments = path.split(".");
+  let current = document;
+  for (const segment of segments) {
+    if (current === null || current === void 0 || typeof current !== "object") return void 0;
+    if (!Object.hasOwn(current, segment)) return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function typeRank(value) {
+  if (typeof value === "number") return 0;
+  if (typeof value === "string") return 1;
+  return 2;
+}
+function comparePresentValues(a, b) {
+  const rankDifference = typeRank(a) - typeRank(b);
+  if (rankDifference !== 0) return rankDifference;
+  if (typeof a === "number" && typeof b === "number") return a - b;
+  if (typeof a === "string" && typeof b === "string") return compareSortStrings(a, b);
+  if (a === b) return 0;
+  return a ? 1 : -1;
+}
+function compareComparableValues(a, b, direction) {
+  if (a === null && b === null) return 0;
+  if (a === null) return 1;
+  if (b === null) return -1;
+  const comparison = comparePresentValues(a, b);
+  if (comparison === 0) return 0;
+  return direction === "desc" ? -comparison : comparison;
+}
+function compareComparableKeys(aKey, bKey, directions) {
+  for (let i = 0; i < directions.length; i++) {
+    const comparison = compareComparableValues(aKey[i] ?? null, bKey[i] ?? null, directions[i]);
+    if (comparison !== 0) return comparison;
+  }
+  return 0;
+}
+function compareSortValues(aValues, bValues, directions) {
+  for (let i = 0; i < directions.length; i++) {
+    const a = toComparableSortValue(aValues[i]);
+    const b = toComparableSortValue(bValues[i]);
+    if (a === null && b === null) continue;
+    if (a === null) return 1;
+    if (b === null) return -1;
+    const comparison = comparePresentValues(a, b);
+    if (comparison !== 0) return directions[i] === "desc" ? -comparison : comparison;
+  }
+  return 0;
+}
+
+export { SORT_VALUE_MAX_CODE_POINTS, compareCodePoints, compareComparableKeys, compareComparableValues, compareSortValues, readSortField, toComparableSortValue };

package/dist/chunk-C6VVLMRX.mjs

@@ -0,0 +1,63 @@
+// src/distribution/transport/types.ts
+var DEFAULT_TRANSPORT_CONFIG = {
+  connectTimeout: 5e3,
+  requestTimeout: 3e4,
+  replicationTimeout: 1e4,
+  snapshotTimeout: 3e5
+};
+var MAX_MESSAGE_SIZE_BYTES = 67108864;
+var TransportErrorCodes = {
+  CONNECT_FAILED: "TRANSPORT_CONNECT_FAILED",
+  TIMEOUT: "TRANSPORT_TIMEOUT",
+  MESSAGE_TOO_LARGE: "TRANSPORT_MESSAGE_TOO_LARGE",
+  DECODE_FAILED: "TRANSPORT_DECODE_FAILED",
+  PEER_UNAVAILABLE: "TRANSPORT_PEER_UNAVAILABLE"
+};
+var TransportError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "TransportError";
+    this.code = code;
+    this.details = details ?? {};
+  }
+};
+var ReplicationMessageTypes = {
+  FORWARD: "replication.forward",
+  FORWARD_BATCH: "replication.forward_batch",
+  ENTRY: "replication.entry",
+  ENTRY_BATCH: "replication.entry_batch",
+  ACK: "replication.ack",
+  SYNC_REQUEST: "replication.sync_request",
+  SYNC_ENTRIES: "replication.sync_entries",
+  SNAPSHOT_START: "replication.snapshot_start",
+  SNAPSHOT_CHUNK: "replication.snapshot_chunk",
+  SNAPSHOT_END: "replication.snapshot_end",
+  SNAPSHOT_SYNC_REQUEST: "replication.snapshot_sync_request",
+  INSYNC_REMOVE: "replication.insync_remove",
+  INSYNC_CONFIRM: "replication.insync_confirm"
+};
+var QueryMessageTypes = {
+  SEARCH: "query.search",
+  SEARCH_RESULT: "query.search_result",
+  FETCH: "query.fetch",
+  FETCH_RESULT: "query.fetch_result",
+  STATS: "query.stats",
+  STATS_RESULT: "query.stats_result",
+  COUNT: "query.count",
+  COUNT_RESULT: "query.count_result",
+  LIST: "query.list",
+  LIST_RESULT: "query.list_result",
+  SUGGEST: "query.suggest",
+  SUGGEST_RESULT: "query.suggest_result",
+  PREFLIGHT: "query.preflight",
+  PREFLIGHT_RESULT: "query.preflight_result"
+};
+var ClusterMessageTypes = {
+  PING: "cluster.ping",
+  PONG: "cluster.pong",
+  BOOTSTRAP_COMPLETE: "cluster.bootstrap_complete"
+};
+
+export { ClusterMessageTypes, DEFAULT_TRANSPORT_CONFIG, MAX_MESSAGE_SIZE_BYTES, QueryMessageTypes, ReplicationMessageTypes, TransportError, TransportErrorCodes };

package/dist/{chunk-UNJZ7ZDB.mjs → chunk-EMI63EXP.mjs}

@@ -10,6 +10,7 @@ var ErrorCodes = {
   DOC_VALIDATION_FAILED: "DOC_VALIDATION_FAILED",
   INDEX_NOT_FOUND: "INDEX_NOT_FOUND",
   INDEX_ALREADY_EXISTS: "INDEX_ALREADY_EXISTS",
+  INDEX_ORPHANED: "INDEX_ORPHANED",
   PARTITION_CORRUPTED: "PARTITION_CORRUPTED",
   PARTITION_REBALANCING_BACKPRESSURE: "PARTITION_REBALANCING_BACKPRESSURE",
   WORKER_CRASHED: "WORKER_CRASHED",
@@ -27,6 +28,7 @@ var ErrorCodes = {
   SEARCH_INVALID_FILTER: "SEARCH_INVALID_FILTER",
   SEARCH_INVALID_MODE: "SEARCH_INVALID_MODE",
   SEARCH_INVALID_CURSOR: "SEARCH_INVALID_CURSOR",
+  SEARCH_RESULT_WINDOW_EXCEEDED: "SEARCH_RESULT_WINDOW_EXCEEDED",
   LANGUAGE_NOT_SUPPORTED: "LANGUAGE_NOT_SUPPORTED",
   ENVELOPE_VERSION_MISMATCH: "ENVELOPE_VERSION_MISMATCH",
   ENVELOPE_INVALID_MAGIC: "ENVELOPE_INVALID_MAGIC",
@@ -41,6 +43,7 @@ var ErrorCodes = {
   QUERY_PARTIAL_FAILURE: "QUERY_PARTIAL_FAILURE",
   QUERY_NODE_TIMEOUT: "QUERY_NODE_TIMEOUT",
   QUERY_NO_ACTIVE_REPLICA: "QUERY_NO_ACTIVE_REPLICA",
+  CLUSTER_OPERATION_UNSUPPORTED: "CLUSTER_OPERATION_UNSUPPORTED",
   ALLOCATION_NO_DATA_NODES: "ALLOCATION_NO_DATA_NODES",
   ALLOCATION_INVALID_CONFIG: "ALLOCATION_INVALID_CONFIG",
   ALLOCATION_FAILED: "ALLOCATION_FAILED",
@@ -51,6 +54,7 @@ var ErrorCodes = {
   NODE_ALREADY_JOINED: "NODE_ALREADY_JOINED",
   NODE_NOT_JOINED: "NODE_NOT_JOINED",
   COORDINATOR_DEPENDENCY_MISSING: "COORDINATOR_DEPENDENCY_MISSING",
+  TRANSPORT_DEPENDENCY_MISSING: "TRANSPORT_DEPENDENCY_MISSING",
   REPLICATION_ENTRY_INVALID: "REPLICATION_ENTRY_INVALID",
   REPLICATION_INSYNC_REMOVAL_FAILED: "REPLICATION_INSYNC_REMOVAL_FAILED",
   REPLICATION_ROLLBACK_FAILED: "REPLICATION_ROLLBACK_FAILED",
@@ -89,6 +93,27 @@ var ErrorCodes = {
   SNAPSHOT_SYNC_NOT_ASSIGNED: "SNAPSHOT_SYNC_NOT_ASSIGNED",
   SNAPSHOT_SYNC_ABORTED: "SNAPSHOT_SYNC_ABORTED"
 };
+var ServerErrorCodes = {
+  INVALID_REQUEST: "INVALID_REQUEST",
+  INVALID_JSON: "INVALID_JSON",
+  EMPTY_BODY: "EMPTY_BODY",
+  PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE",
+  NOT_FOUND: "NOT_FOUND",
+  TASK_NOT_FOUND: "TASK_NOT_FOUND",
+  TASK_NOT_CANCELLABLE: "TASK_NOT_CANCELLABLE",
+  TASK_OWNED_BY_ANOTHER_INSTANCE: "TASK_OWNED_BY_ANOTHER_INSTANCE",
+  TOO_MANY_REQUESTS: "TOO_MANY_REQUESTS",
+  HOOK_ERROR: "HOOK_ERROR",
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+};
+var ClientErrorCodes = {
+  CLIENT_CONNECTION_FAILED: "CLIENT_CONNECTION_FAILED",
+  CLIENT_REQUEST_TIMEOUT: "CLIENT_REQUEST_TIMEOUT",
+  CLIENT_REQUEST_ABORTED: "CLIENT_REQUEST_ABORTED",
+  CLIENT_INVALID_RESPONSE: "CLIENT_INVALID_RESPONSE",
+  CLIENT_TASK_TIMEOUT: "CLIENT_TASK_TIMEOUT",
+  CLIENT_UNEXPECTED_ERROR: "CLIENT_UNEXPECTED_ERROR"
+};
 var NarsilError = class extends Error {
   /** This says which failure it is. */
   code;
@@ -97,7 +122,10 @@ var NarsilError = class extends Error {
   /**
    * Builds an error carrying a code the caller can branch on.
    *
-   * @param code - The failure this error reports.
+   * @param code - The failure this error reports, from {@link ErrorCodes} for
+   * an engine failure, {@link ServerErrorCodes} for one the HTTP layer raised,
+   * or {@link ClientErrorCodes} for one that stopped a request from reaching a
+   * server.
    * @param message - Plain description, for a log or a person.
    * @param details - Values behind the failure, which reach
    * {@link NarsilError.details}.
@@ -112,5 +140,8 @@ var NarsilError = class extends Error {
 function createNarsilError(code, message, details) {
   return new NarsilError(code, message, details);
 }
+function describeError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 
-export { ErrorCodes, NarsilError, createNarsilError };
+export { ClientErrorCodes, ErrorCodes, NarsilError, ServerErrorCodes, createNarsilError, describeError };

package/dist/chunk-MFFAJ2NR.mjs

@@ -0,0 +1,135 @@
+import { MAX_MESSAGE_SIZE_BYTES, TransportError, TransportErrorCodes } from './chunk-C6VVLMRX.mjs';
+import { encode, decode } from '@msgpack/msgpack';
+
+// src/distribution/transport/tcp/types.ts
+var DEFAULT_TCP_CONFIG = {
+  host: "0.0.0.0",
+  port: 9300,
+  connectTimeout: 5e3,
+  requestTimeout: 3e4,
+  replicationTimeout: 1e4,
+  snapshotTimeout: 3e5,
+  maxConnections: 256
+};
+var LENGTH_PREFIX_BYTES = 4;
+var FRAME_TYPE_REQUEST = 1;
+var FRAME_TYPE_RESPONSE = 2;
+var FRAME_TYPE_STREAM_CHUNK = 3;
+var FRAME_TYPE_STREAM_END = 4;
+function encodeFrame(frameType, requestId, data) {
+  const envelope = encode({ frameType, requestId, data });
+  const totalLength = envelope.byteLength;
+  if (totalLength > MAX_MESSAGE_SIZE_BYTES) {
+    throw new TransportError(
+      TransportErrorCodes.MESSAGE_TOO_LARGE,
+      `Encoded frame (${totalLength} bytes) exceeds the ${MAX_MESSAGE_SIZE_BYTES} byte limit`,
+      { payloadSize: totalLength }
+    );
+  }
+  const buffer = new Uint8Array(LENGTH_PREFIX_BYTES + totalLength);
+  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+  view.setUint32(0, totalLength, false);
+  buffer.set(envelope, LENGTH_PREFIX_BYTES);
+  return buffer;
+}
+function encodeTransportMessage(message) {
+  return new Uint8Array(
+    encode({
+      type: message.type,
+      sourceId: message.sourceId,
+      requestId: message.requestId,
+      payload: message.payload
+    })
+  );
+}
+function decodeTransportMessage(data) {
+  const decoded = decode(data);
+  return {
+    type: decoded.type,
+    sourceId: decoded.sourceId,
+    requestId: decoded.requestId,
+    payload: new Uint8Array(decoded.payload)
+  };
+}
+var BUFFER_LIMIT = MAX_MESSAGE_SIZE_BYTES + LENGTH_PREFIX_BYTES;
+var FrameParser = class {
+  chunks = [];
+  totalLength = 0;
+  onFrame;
+  constructor(onFrame) {
+    this.onFrame = onFrame;
+  }
+  feed(data) {
+    this.totalLength += data.byteLength;
+    if (this.totalLength > BUFFER_LIMIT) {
+      const exceeded = this.totalLength;
+      this.chunks = [];
+      this.totalLength = 0;
+      throw new TransportError(
+        TransportErrorCodes.MESSAGE_TOO_LARGE,
+        `Accumulated buffer (${exceeded} bytes) exceeds the allowed limit`,
+        { accumulatedBytes: exceeded }
+      );
+    }
+    this.chunks.push(data);
+    let buffer = this.compact();
+    while (buffer.byteLength >= LENGTH_PREFIX_BYTES) {
+      const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+      const frameLength = view.getUint32(0, false);
+      if (frameLength > MAX_MESSAGE_SIZE_BYTES) {
+        this.chunks = [];
+        this.totalLength = 0;
+        throw new TransportError(
+          TransportErrorCodes.MESSAGE_TOO_LARGE,
+          `Incoming frame (${frameLength} bytes) exceeds the ${MAX_MESSAGE_SIZE_BYTES} byte limit`,
+          { payloadSize: frameLength }
+        );
+      }
+      const totalNeeded = LENGTH_PREFIX_BYTES + frameLength;
+      if (buffer.byteLength < totalNeeded) {
+        break;
+      }
+      const frameBytes = buffer.subarray(LENGTH_PREFIX_BYTES, totalNeeded);
+      buffer = buffer.subarray(totalNeeded);
+      try {
+        const decoded = decode(frameBytes);
+        this.onFrame({
+          frameType: decoded.frameType,
+          requestId: decoded.requestId,
+          data: new Uint8Array(decoded.data)
+        });
+      } catch (err) {
+        this.chunks = [];
+        this.totalLength = 0;
+        throw new TransportError(
+          TransportErrorCodes.DECODE_FAILED,
+          `Failed to decode frame: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    this.chunks = buffer.byteLength > 0 ? [buffer] : [];
+    this.totalLength = buffer.byteLength;
+  }
+  reset() {
+    this.chunks = [];
+    this.totalLength = 0;
+  }
+  compact() {
+    if (this.chunks.length === 0) {
+      return new Uint8Array(0);
+    }
+    if (this.chunks.length === 1) {
+      return this.chunks[0];
+    }
+    const combined = new Uint8Array(this.totalLength);
+    let offset = 0;
+    for (const chunk of this.chunks) {
+      combined.set(chunk, offset);
+      offset += chunk.byteLength;
+    }
+    this.chunks = [combined];
+    return combined;
+  }
+};
+
+export { DEFAULT_TCP_CONFIG, FRAME_TYPE_REQUEST, FRAME_TYPE_RESPONSE, FRAME_TYPE_STREAM_CHUNK, FRAME_TYPE_STREAM_END, FrameParser, decodeTransportMessage, encodeFrame, encodeTransportMessage };