zydecodb 0.9.0-beta.2

package/dist/connection.js

@@ -0,0 +1,173 @@
+import net from "node:net";
+import { once } from "node:events";
+import { ConnectionError, fromStatus } from "./errors.js";
+import { encodeHeader, HEADER_LEN, PROTO_VERSION, Status, Cmd } from "./protocol.js";
+/**
+ * A single TCP connection to a ZydecoDB server. Safe for concurrent use:
+ * requests are pipelined. The writer queue respects OS backpressure (drain),
+ * and the reader loop continuously consumes frames to resolve promises in FIFO order.
+ */
+export class Connection {
+    socket = null;
+    inFlight = [];
+    writeQueue = [];
+    writing = false;
+    dead = false;
+    lastUsed = 0;
+    host;
+    port;
+    timeoutMs;
+    apiKey;
+    constructor(host, port, timeoutMs, apiKey) {
+        this.host = host;
+        this.port = port;
+        this.timeoutMs = timeoutMs;
+        this.apiKey = apiKey;
+    }
+    get connected() {
+        return this.socket !== null && !this.dead;
+    }
+    connect() {
+        return new Promise((resolve, reject) => {
+            const socket = net.connect({ host: this.host, port: this.port });
+            socket.setNoDelay(true); // requests are small and latency-sensitive
+            const onError = (err) => {
+                this.fail(new ConnectionError(`connect to ${this.host}:${this.port} failed`, { cause: err }));
+                reject(this.lastError(err));
+            };
+            socket.once("error", onError);
+            socket.once("connect", () => {
+                socket.removeListener("error", onError);
+                this.socket = socket;
+                this.lastUsed = Date.now();
+                // Start the async reader loop
+                this.readLoop(socket).catch(err => {
+                    this.fail(new ConnectionError("read loop failed", { cause: err }));
+                });
+                socket.on("error", (err) => this.fail(new ConnectionError("socket error", { cause: err })));
+                socket.on("close", () => this.fail(new ConnectionError("connection closed")));
+                if (this.apiKey) {
+                    this.sessionInit(this.apiKey).then(resolve, reject);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    lastError(cause) {
+        return new ConnectionError("connection error", { cause });
+    }
+    async sessionInit(apiKey) {
+        const res = await this.request(Cmd.SessionInit, Buffer.from(apiKey, "utf8"));
+        if (res.status !== Status.Ok) {
+            throw fromStatus(res.status, "SessionInit", res.body);
+        }
+    }
+    /** Send one framed request and resolve with the framed response. */
+    request(command, payload = Buffer.alloc(0)) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || this.dead) {
+                reject(new ConnectionError("not connected"));
+                return;
+            }
+            const timer = setTimeout(() => {
+                this.fail(new ConnectionError("request timed out"));
+            }, this.timeoutMs);
+            this.inFlight.push({ resolve, reject, timer });
+            const frame = Buffer.concat([encodeHeader(command, payload.length), payload]);
+            this.writeQueue.push({ frame, reject });
+            this.pumpWrites();
+        });
+    }
+    async pumpWrites() {
+        if (this.writing || !this.socket || this.dead)
+            return;
+        this.writing = true;
+        try {
+            this.socket.cork();
+            while (this.writeQueue.length > 0) {
+                if (this.dead || !this.socket)
+                    break;
+                const task = this.writeQueue.shift();
+                const canContinue = this.socket.write(task.frame, (err) => {
+                    if (err) {
+                        task.reject(new ConnectionError("write failed", { cause: err }));
+                        this.fail(new ConnectionError("write failed", { cause: err }));
+                    }
+                });
+                // Respect backpressure
+                if (!canContinue && !this.dead && this.socket) {
+                    this.socket.uncork();
+                    await once(this.socket, "drain");
+                    if (!this.dead && this.socket)
+                        this.socket.cork();
+                }
+            }
+            if (!this.dead && this.socket)
+                this.socket.uncork();
+        }
+        catch (err) {
+            this.fail(new ConnectionError("write loop error", { cause: err }));
+        }
+        finally {
+            this.writing = false;
+        }
+    }
+    async readLoop(socket) {
+        let inbox = Buffer.alloc(0);
+        for await (const chunk of socket) {
+            inbox = inbox.length === 0 ? chunk : Buffer.concat([inbox, chunk]);
+            while (inbox.length >= HEADER_LEN) {
+                const version = inbox.readUInt8(0);
+                if (version !== PROTO_VERSION) {
+                    throw new ConnectionError(`unexpected protocol version 0x${version.toString(16)}`);
+                }
+                const status = inbox.readUInt8(1);
+                const length = inbox.readUInt32BE(2);
+                if (inbox.length < HEADER_LEN + length)
+                    break; // wait for more chunks
+                const body = inbox.subarray(HEADER_LEN, HEADER_LEN + length);
+                inbox = inbox.subarray(HEADER_LEN + length);
+                const pending = this.inFlight.shift();
+                if (!pending) {
+                    throw new ConnectionError("received response with no pending request");
+                }
+                clearTimeout(pending.timer);
+                this.lastUsed = Date.now();
+                pending.resolve({ status, body: Buffer.from(body) });
+            }
+        }
+    }
+    /** Tear down the connection and reject any in-flight requests. */
+    fail(err) {
+        if (this.dead)
+            return;
+        this.dead = true;
+        const queue = this.inFlight;
+        this.inFlight = [];
+        for (const pending of queue) {
+            clearTimeout(pending.timer);
+            pending.reject(err);
+        }
+        this.close();
+    }
+    close() {
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            this.socket.destroy();
+            this.socket = null;
+        }
+    }
+    /** Send a keepalive; resolves true if the server answered OK. */
+    async ping() {
+        try {
+            const res = await this.request(Cmd.Ping);
+            return res.status === Status.Ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,36 @@
+/** Base class for every error thrown by this driver. */
+export declare class ZydecoError extends Error {
+}
+/**
+ * A transport-level failure (connect/write/read). Safe to retry for idempotent
+ * operations; the client does this automatically.
+ */
+export declare class ConnectionError extends ZydecoError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * A non-OK response from the server. `status` is the wire status byte so callers
+ * can branch on the failure class without string-matching messages.
+ */
+export declare class ServerError extends ZydecoError {
+    readonly status: number;
+    readonly op: string;
+    constructor(op: string, status: number, detail: string);
+}
+/** A constraint conflict, e.g. a unique-index violation (status 0x03). */
+export declare class ConflictError extends ServerError {
+}
+/** Unauthorized or forbidden (status 0x0B / 0x0C). */
+export declare class AuthError extends ServerError {
+}
+/** The server is shedding load (status 0x07). Retried automatically. */
+export declare class ServerBusyError extends ServerError {
+}
+/** The server rejected the request as malformed or invalid. */
+export declare class InvalidRequestError extends ServerError {
+}
+/** Build the most specific ServerError for a non-OK response. */
+export declare function fromStatus(status: number, op: string, payload: Buffer): ServerError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAEzC;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOvD;AAED,0EAA0E;AAC1E,qBAAa,aAAc,SAAQ,WAAW;CAAG;AAEjD,sDAAsD;AACtD,qBAAa,SAAU,SAAQ,WAAW;CAAG;AAE7C,wEAAwE;AACxE,qBAAa,eAAgB,SAAQ,WAAW;CAAG;AAEnD,+DAA+D;AAC/D,qBAAa,mBAAoB,SAAQ,WAAW;CAAG;AAEvD,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAiBnF"}

package/dist/errors.js

@@ -0,0 +1,61 @@
+import { Status, statusName } from "./protocol.js";
+/** Base class for every error thrown by this driver. */
+export class ZydecoError extends Error {
+}
+/**
+ * A transport-level failure (connect/write/read). Safe to retry for idempotent
+ * operations; the client does this automatically.
+ */
+export class ConnectionError extends ZydecoError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ConnectionError";
+    }
+}
+/**
+ * A non-OK response from the server. `status` is the wire status byte so callers
+ * can branch on the failure class without string-matching messages.
+ */
+export class ServerError extends ZydecoError {
+    status;
+    op;
+    constructor(op, status, detail) {
+        const base = `${op} failed: ${statusName(status)}`;
+        super(detail ? `${base} (${detail})` : base);
+        this.name = "ServerError";
+        this.op = op;
+        this.status = status;
+    }
+}
+/** A constraint conflict, e.g. a unique-index violation (status 0x03). */
+export class ConflictError extends ServerError {
+}
+/** Unauthorized or forbidden (status 0x0B / 0x0C). */
+export class AuthError extends ServerError {
+}
+/** The server is shedding load (status 0x07). Retried automatically. */
+export class ServerBusyError extends ServerError {
+}
+/** The server rejected the request as malformed or invalid. */
+export class InvalidRequestError extends ServerError {
+}
+/** Build the most specific ServerError for a non-OK response. */
+export function fromStatus(status, op, payload) {
+    const detail = payload.length ? payload.toString("utf8") : "";
+    switch (status) {
+        case Status.Conflict:
+            return new ConflictError(op, status, detail);
+        case Status.Unauthorized:
+        case Status.Forbidden:
+            return new AuthError(op, status, detail);
+        case Status.EngineBusy:
+            return new ServerBusyError(op, status, detail);
+        case Status.ProtocolError:
+        case Status.InvalidKey:
+        case Status.InvalidValue:
+            return new InvalidRequestError(op, status, detail);
+        default:
+            return new ServerError(op, status, detail);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnD,wDAAwD;AACxD,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAEzC;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IACjC,MAAM,CAAS;IACf,EAAE,CAAS;IAEpB,YAAY,EAAU,EAAE,MAAc,EAAE,MAAc;QACpD,MAAM,IAAI,GAAG,GAAG,EAAE,YAAY,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,aAAc,SAAQ,WAAW;CAAG;AAEjD,sDAAsD;AACtD,MAAM,OAAO,SAAU,SAAQ,WAAW;CAAG;AAE7C,wEAAwE;AACxE,MAAM,OAAO,eAAgB,SAAQ,WAAW;CAAG;AAEnD,+DAA+D;AAC/D,MAAM,OAAO,mBAAoB,SAAQ,WAAW;CAAG;AAEvD,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,EAAU,EAAE,OAAe;IACpE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,QAAQ;YAClB,OAAO,IAAI,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,YAAY,CAAC;QACzB,KAAK,MAAM,CAAC,SAAS;YACnB,OAAO,IAAI,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,UAAU;YACpB,OAAO,IAAI,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,aAAa,CAAC;QAC1B,KAAK,MAAM,CAAC,UAAU,CAAC;QACvB,KAAK,MAAM,CAAC,YAAY;YACtB,OAAO,IAAI,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACrD;YACE,OAAO,IAAI,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Client, generateId } from "./client.ts";
+export type { ClientOptions, FindOptions, UpdateResult } from "./client.ts";
+export { Collection } from "./collection.ts";
+export type { Document, QueryOptions } from "./collection.ts";
+export { AuthError, ConflictError, ConnectionError, InvalidRequestError, ServerBusyError, ServerError, ZydecoError, } from "./errors.ts";
+export type { Projection, Row, SortKey } from "./protocol.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Client, generateId } from "./client.js";
+export { Collection } from "./collection.js";
+export { AuthError, ConflictError, ConnectionError, InvalidRequestError, ServerBusyError, ServerError, ZydecoError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,SAAS,EACT,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/pool.d.ts

@@ -0,0 +1,35 @@
+import { Connection } from "./connection.ts";
+export interface PoolOptions {
+    host: string;
+    port: number;
+    apiKey: string | null;
+    timeoutMs: number;
+    maxSize: number;
+    acquireTimeoutMs?: number;
+    keepaliveIdleMs?: number;
+}
+/**
+ * A multiplexing connection pool. Because the server executes requests serially
+ * per connection but processes pipelined frames without requiring a round-trip
+ * between them, we can safely and efficiently multiplex many concurrent requests
+ * across a small pool of open connections. This avoids artificial queueing
+ * timeouts and allows high-throughput `Promise.all` patterns.
+ */
+export declare class ConnectionPool {
+    private readonly connections;
+    private total;
+    private nextIdx;
+    private closed;
+    private connecting;
+    private readonly keepaliveIdleMs;
+    private readonly opts;
+    constructor(opts: PoolOptions);
+    private newConnection;
+    acquire(): Promise<Connection>;
+    /** Release is a no-op in a multiplexing pool, but we validate it is alive. */
+    release(conn: Connection): void;
+    /** Permanently drop a (presumed-broken) connection, freeing its slot. */
+    discard(conn: Connection): void;
+    close(): void;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAoC;IAEtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;gBAEvB,IAAI,EAAE,WAAW;IAK7B,OAAO,CAAC,aAAa;IAIf,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAoDpC,8EAA8E;IAC9E,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAM/B,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAS/B,KAAK,IAAI,IAAI;CAMd"}

package/dist/pool.js

@@ -0,0 +1,94 @@
+import { Connection } from "./connection.js";
+import { ConnectionError } from "./errors.js";
+/**
+ * A multiplexing connection pool. Because the server executes requests serially
+ * per connection but processes pipelined frames without requiring a round-trip
+ * between them, we can safely and efficiently multiplex many concurrent requests
+ * across a small pool of open connections. This avoids artificial queueing
+ * timeouts and allows high-throughput `Promise.all` patterns.
+ */
+export class ConnectionPool {
+    connections = [];
+    total = 0;
+    nextIdx = 0;
+    closed = false;
+    connecting = null;
+    keepaliveIdleMs;
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+        this.keepaliveIdleMs = opts.keepaliveIdleMs ?? 30_000;
+    }
+    newConnection() {
+        return new Connection(this.opts.host, this.opts.port, this.opts.timeoutMs, this.opts.apiKey);
+    }
+    async acquire() {
+        if (this.closed)
+            throw new ConnectionError("pool is closed");
+        // Clean out dead connections
+        for (let i = this.connections.length - 1; i >= 0; i--) {
+            const c = this.connections[i];
+            if (c && !c.connected) {
+                this.connections.splice(i, 1);
+                this.total -= 1;
+            }
+        }
+        // Lazily grow the pool up to maxSize if we're under capacity.
+        if (this.total < this.opts.maxSize) {
+            if (!this.connecting) {
+                this.connecting = (async () => {
+                    try {
+                        const fresh = this.newConnection();
+                        await fresh.connect();
+                        this.connections.push(fresh);
+                        this.total += 1;
+                        return fresh;
+                    }
+                    finally {
+                        this.connecting = null;
+                    }
+                })();
+            }
+            // If we literally have 0 active connections, we MUST wait for this first one.
+            if (this.connections.length === 0) {
+                return this.connecting;
+            }
+            // Otherwise, fall through and multiplex on the existing ones 
+            // while the new connection builds in the background!
+        }
+        // Multiplex round-robin
+        const conn = this.connections[this.nextIdx % this.connections.length];
+        this.nextIdx++;
+        // Idle validation
+        if (Date.now() - conn.lastUsed > this.keepaliveIdleMs) {
+            if (!(await conn.ping())) {
+                this.discard(conn);
+                return this.acquire(); // Try again
+            }
+        }
+        return conn;
+    }
+    /** Release is a no-op in a multiplexing pool, but we validate it is alive. */
+    release(conn) {
+        if (this.closed || !conn.connected) {
+            this.discard(conn);
+        }
+    }
+    /** Permanently drop a (presumed-broken) connection, freeing its slot. */
+    discard(conn) {
+        conn.close();
+        const idx = this.connections.indexOf(conn);
+        if (idx >= 0) {
+            this.connections.splice(idx, 1);
+            this.total -= 1;
+        }
+    }
+    close() {
+        this.closed = true;
+        for (const conn of this.connections)
+            conn.close();
+        this.total = 0;
+        this.connections.length = 0;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../src/pool.ts"],"names":[],"mappings":"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"}

package/dist/protocol.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Binary wire protocol: command/status codes and the encode/decode of payload
+ * bodies, with no I/O. Mirrors the Rust definitions in
+ * crates/zydecodb-engine/src/frame.rs and crates/zydecodb-document/src/wire.rs
+ * and is verified byte-for-byte against clients/conformance/vectors.json.
+ */
+export declare const PROTO_VERSION = 1;
+export declare const HEADER_LEN = 6;
+export declare const Cmd: {
+    readonly Put: 1;
+    readonly Get: 2;
+    readonly Del: 3;
+    readonly Query: 32;
+    readonly DocPut: 33;
+    readonly DocDel: 34;
+    readonly Find: 35;
+    readonly Update: 36;
+    readonly Delete: 37;
+    readonly Count: 38;
+    readonly IndexDef: 48;
+    readonly SessionInit: 64;
+    readonly Ping: 240;
+    readonly Stats: 241;
+};
+export declare const Proj: {
+    readonly None: 0;
+    readonly Include: 1;
+    readonly Exclude: 2;
+};
+export declare const Status: {
+    readonly Ok: 0;
+    readonly NotFound: 1;
+    readonly Error: 2;
+    readonly Conflict: 3;
+    readonly IoError: 4;
+    readonly InvalidKey: 5;
+    readonly InvalidValue: 6;
+    readonly EngineBusy: 7;
+    readonly ProtocolError: 8;
+    readonly Unauthorized: 11;
+    readonly Forbidden: 12;
+};
+export declare function statusName(status: number): string;
+/** Build the 6-byte request envelope header. */
+export declare function encodeHeader(command: number, payloadLen: number): Buffer;
+/** Build a Put payload. */
+export declare function encodePut(key: Buffer, value: Buffer, expiresAt?: number | bigint): Buffer;
+/** Build a Key payload for Get/Del. */
+export declare function encodeKey(key: Buffer): Buffer;
+/**
+ * DocPut payload: [collection][doc_id][body][flags]. `body` is already-
+ * serialized JSON (the codec treats it as opaque bytes).
+ */
+export declare function encodeDocPut(collection: string, docId: Buffer, body: Buffer, relaxed: boolean): Buffer;
+/** DocDel payload: [collection][doc_id]. */
+export declare function encodeDocDel(collection: string, docId: Buffer): Buffer;
+/** IndexDef payload: [collection][index][unique u8][field_count u32]{[field]}. */
+export declare function encodeIndexDef(collection: string, index: string, fields: string[], unique: boolean): Buffer;
+/** By-id Query payload: [mode][collection][doc_id]. */
+export declare function encodeQueryById(collection: string, docId: Buffer): Buffer;
+/**
+ * Index-range Query payload: [mode][collection][index][limit u32][lo][hi][cursor].
+ * `lo`/`hi` are JSON-array bound bytes (empty = unbounded); `cursor` is an
+ * opaque page token (empty = first page).
+ */
+export declare function encodeQueryIndexRange(collection: string, index: string, lo: Buffer, hi: Buffer, cursor: Buffer, limit: number): Buffer;
+/** One ordering term: a dotted field path and its direction. */
+export interface SortKey {
+    field: string;
+    ascending: boolean;
+}
+/** Field selection. `mode` is Proj.None/Include/Exclude. */
+export interface Projection {
+    mode: number;
+    fields: string[];
+}
+/** Find payload. `filter` is opaque JSON bytes (empty = match all). */
+export declare function encodeFind(collection: string, filter: Buffer, sort: SortKey[], projection: Projection, skip: number, limit: number, cursor: Buffer): Buffer;
+/** Update payload: [collection][filter][update][multi u8][flags]. */
+export declare function encodeUpdate(collection: string, filter: Buffer, update: Buffer, multi: boolean, relaxed: boolean): Buffer;
+/** Filter-based Delete payload: [collection][filter][multi u8][flags]. */
+export declare function encodeDelete(collection: string, filter: Buffer, multi: boolean, relaxed: boolean): Buffer;
+/** Count payload: [mode][collection][filter]. */
+export declare function encodeCount(collection: string, filter: Buffer): Buffer;
+/** Distinct payload: [mode][collection][filter][field]. */
+export declare function encodeDistinct(collection: string, filter: Buffer, field: string): Buffer;
+/** One decoded row from a query/find response page. */
+export interface Row {
+    docId: Buffer;
+    body: Buffer;
+}
+/** A decoded response page. `cursor` is null when there are no more pages. */
+export interface Page {
+    rows: Row[];
+    cursor: Buffer | null;
+}
+/** Decode a response page: [row_count u32]{[doc_id][body]}[cursor]. */
+export declare function decodePage(buf: Buffer): Page;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}