@s2-dev/streamstore 0.16.11 → 0.17.0

package/dist/cjs/lib/stream/transport/fetch/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/stream/transport/fetch/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAO9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAC;AACpE,OAAO,EACN,KAAK,SAAS,EAUd,MAAM,gCAAgC,CAAC;AAMxC,OAAO,KAAK,EACX,UAAU,EAEV,YAAY,EAEZ,QAAQ,EACR,SAAS,EACT,MAAM,gBAAgB,CAAC;AAExB,wBAAsB,UAAU,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAC5E,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,gBAAgB,8BA2D1B;AAED,wBAAsB,YAAY,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,EACtC,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAClC,OAAO,CAAC,EAAE,gBAAgB,sBAqH1B"}

package/dist/cjs/lib/stream/transport/fetch/shared.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamRead = streamRead;
+exports.streamAppend = streamAppend;
+const error_js_1 = require("../../../../error.js");
+const index_js_1 = require("../../../../generated/index.js");
+const utils_js_1 = require("../../../../utils.js");
+const base64_js_1 = require("../../../base64.js");
+async function streamRead(stream, client, args, options) {
+    const { as, ...queryParams } = args ?? {};
+    const response = await (0, index_js_1.read)({
+        client,
+        path: {
+            stream,
+        },
+        headers: {
+            ...(as === "bytes" ? { "s2-format": "base64" } : {}),
+        },
+        query: queryParams,
+        ...options,
+    });
+    if (response.error) {
+        if ("message" in response.error) {
+            throw new error_js_1.S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        else {
+            // special case for 416 - Range Not Satisfiable
+            throw new error_js_1.RangeNotSatisfiableError({
+                status: response.response.status,
+            });
+        }
+    }
+    if (args?.as === "bytes") {
+        const res = {
+            ...response.data,
+            records: response.data.records?.map((record) => ({
+                ...record,
+                body: record.body ? (0, base64_js_1.decodeFromBase64)(record.body) : undefined,
+                headers: record.headers?.map((header) => header.map((h) => (0, base64_js_1.decodeFromBase64)(h))),
+            })),
+        };
+        return res;
+    }
+    else {
+        const res = {
+            ...response.data,
+            records: response.data.records.map((record) => ({
+                ...record,
+                headers: record.headers
+                    ? Object.fromEntries(record.headers)
+                    : undefined,
+            })),
+        };
+        return res;
+    }
+}
+async function streamAppend(stream, client, records, args, options) {
+    const recordsArray = Array.isArray(records) ? records : [records];
+    if (recordsArray.length === 0) {
+        throw new error_js_1.S2Error({ message: "Cannot append empty array of records" });
+    }
+    let batchMeteredSize = 0;
+    for (const record of recordsArray) {
+        batchMeteredSize += (0, utils_js_1.meteredSizeBytes)(record);
+    }
+    if (batchMeteredSize > 1024 * 1024) {
+        throw new error_js_1.S2Error({
+            message: `Batch size ${batchMeteredSize} bytes exceeds maximum of 1 MiB (1048576 bytes)`,
+        });
+    }
+    if (recordsArray.length > 1000) {
+        throw new error_js_1.S2Error({
+            message: `Batch of ${recordsArray.length} exceeds maximum batch size of 1000 records`,
+        });
+    }
+    let encodedRecords = [];
+    let hasAnyBytesRecords = false;
+    for (const record of recordsArray) {
+        const format = (0, utils_js_1.computeAppendRecordFormat)(record);
+        if (format === "bytes") {
+            const formattedRecord = record;
+            const encodedRecord = {
+                ...formattedRecord,
+                body: formattedRecord.body
+                    ? (0, base64_js_1.encodeToBase64)(formattedRecord.body)
+                    : undefined,
+                headers: formattedRecord.headers?.map((header) => header.map((h) => (0, base64_js_1.encodeToBase64)(h))),
+            };
+            encodedRecords.push(encodedRecord);
+        }
+        else {
+            // Normalize headers to array format
+            const normalizeHeaders = (headers) => {
+                if (headers === undefined) {
+                    return undefined;
+                }
+                else if (Array.isArray(headers)) {
+                    return headers;
+                }
+                else {
+                    return Object.entries(headers);
+                }
+            };
+            const formattedRecord = record;
+            const encodedRecord = {
+                ...formattedRecord,
+                headers: formattedRecord.headers
+                    ? normalizeHeaders(formattedRecord.headers)
+                    : undefined,
+            };
+            encodedRecords.push(encodedRecord);
+        }
+    }
+    const response = await (0, index_js_1.append)({
+        client,
+        path: {
+            stream,
+        },
+        body: {
+            fencing_token: args?.fencing_token,
+            match_seq_num: args?.match_seq_num,
+            records: encodedRecords,
+        },
+        headers: {
+            ...(hasAnyBytesRecords ? { "s2-format": "base64" } : {}),
+        },
+        ...options,
+    });
+    if (response.error) {
+        if ("message" in response.error) {
+            throw new error_js_1.S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        else {
+            // special case for 412 - append condition failed
+            if ("seq_num_mismatch" in response.error) {
+                throw new error_js_1.SeqNumMismatchError({
+                    message: "Append condition failed: sequence number mismatch",
+                    code: "APPEND_CONDITION_FAILED",
+                    status: response.response.status,
+                    expectedSeqNum: response.error.seq_num_mismatch,
+                });
+            }
+            else if ("fencing_token_mismatch" in response.error) {
+                throw new error_js_1.FencingTokenMismatchError({
+                    message: "Append condition failed: fencing token mismatch",
+                    code: "APPEND_CONDITION_FAILED",
+                    status: response.response.status,
+                    expectedFencingToken: response.error.fencing_token_mismatch,
+                });
+            }
+            else {
+                // fallback for unknown 412 error format
+                throw new error_js_1.S2Error({
+                    message: "Append condition failed",
+                    status: response.response.status,
+                });
+            }
+        }
+    }
+    return response.data;
+}
+//# sourceMappingURL=shared.js.map

package/dist/cjs/lib/stream/transport/fetch/shared.js.map

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

package/dist/cjs/lib/stream/transport/s2s/framing.d.ts

@@ -0,0 +1,47 @@
+/**
+ * S2S Protocol Message Framing
+ *
+ * Message format:
+ * - 3 bytes: Length prefix (total message length including flag byte, big-endian)
+ * - 1 byte: Flag byte [T][CC][RRRRR]
+ *   - T (bit 7): Terminal flag (1 = stream ends after this message)
+ *   - CC (bits 6-5): Compression (00=none, 01=zstd, 10=gzip)
+ *   - RRRRR (bits 4-0): Reserved
+ * - Variable: Body (protobuf message or JSON error for terminal frames)
+ */
+export type CompressionType = "none" | "zstd" | "gzip";
+export interface S2SFrame {
+    terminal: boolean;
+    compression: CompressionType;
+    body: Uint8Array;
+    statusCode?: number;
+}
+/**
+ * Frame a message for s2s protocol
+ */
+export declare function frameMessage(opts: {
+    terminal: boolean;
+    compression?: CompressionType;
+    body: Uint8Array;
+    statusCode?: number;
+}): Uint8Array;
+/**
+ * Parser for reading s2s frames from a stream
+ */
+export declare class S2SFrameParser {
+    private buffer;
+    /**
+     * Add data to the parser buffer
+     */
+    push(data: Uint8Array): void;
+    /**
+     * Try to parse the next frame from the buffer
+     * Returns null if not enough data available
+     */
+    parseFrame(): S2SFrame | null;
+    /**
+     * Check if parser has any buffered data
+     */
+    hasData(): boolean;
+}
+//# sourceMappingURL=framing.d.ts.map

package/dist/cjs/lib/stream/transport/s2s/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/stream/transport/s2s/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,UAAU,CA+Cb;AAED;;GAEG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAAiC;IAE/C;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAOnC;;;OAGG;IACI,UAAU,IAAI,QAAQ,GAAG,IAAI;IA8CpC;;OAEG;IACI,OAAO,IAAI,OAAO;CAGzB"}

package/dist/cjs/lib/stream/transport/s2s/framing.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * S2S Protocol Message Framing
+ *
+ * Message format:
+ * - 3 bytes: Length prefix (total message length including flag byte, big-endian)
+ * - 1 byte: Flag byte [T][CC][RRRRR]
+ *   - T (bit 7): Terminal flag (1 = stream ends after this message)
+ *   - CC (bits 6-5): Compression (00=none, 01=zstd, 10=gzip)
+ *   - RRRRR (bits 4-0): Reserved
+ * - Variable: Body (protobuf message or JSON error for terminal frames)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2SFrameParser = void 0;
+exports.frameMessage = frameMessage;
+/**
+ * Frame a message for s2s protocol
+ */
+function frameMessage(opts) {
+    const compression = opts.compression ?? "none";
+    // Build flag byte
+    let flag = 0;
+    if (opts.terminal) {
+        flag |= 0x80; // Set bit 7
+    }
+    if (compression === "zstd") {
+        flag |= 0x20; // Set bit 5
+    }
+    else if (compression === "gzip") {
+        flag |= 0x40; // Set bit 6
+    }
+    // For terminal frames with status code, prepend 2-byte status code to body
+    let body = opts.body;
+    if (opts.terminal && opts.statusCode !== undefined) {
+        const statusBytes = new Uint8Array(2);
+        statusBytes[0] = (opts.statusCode >> 8) & 0xff;
+        statusBytes[1] = opts.statusCode & 0xff;
+        body = new Uint8Array(statusBytes.length + opts.body.length);
+        body.set(statusBytes, 0);
+        body.set(opts.body, statusBytes.length);
+    }
+    // Calculate total length (flag + body)
+    const length = 1 + body.length;
+    if (length > 0xffffff) {
+        throw new Error(`Message too large: ${length} bytes (max 16MB)`);
+    }
+    // Allocate frame buffer
+    const frame = new Uint8Array(3 + length);
+    // Write 3-byte length prefix (big-endian)
+    frame[0] = (length >> 16) & 0xff;
+    frame[1] = (length >> 8) & 0xff;
+    frame[2] = length & 0xff;
+    // Write flag byte
+    frame[3] = flag;
+    // Write body
+    frame.set(body, 4);
+    return frame;
+}
+/**
+ * Parser for reading s2s frames from a stream
+ */
+class S2SFrameParser {
+    buffer = new Uint8Array(0);
+    /**
+     * Add data to the parser buffer
+     */
+    push(data) {
+        const newBuffer = new Uint8Array(this.buffer.length + data.length);
+        newBuffer.set(this.buffer, 0);
+        newBuffer.set(data, this.buffer.length);
+        this.buffer = newBuffer;
+    }
+    /**
+     * Try to parse the next frame from the buffer
+     * Returns null if not enough data available
+     */
+    parseFrame() {
+        // Need at least 4 bytes (3-byte length + 1-byte flag)
+        if (this.buffer.length < 4) {
+            return null;
+        }
+        // Read 3-byte length prefix (big-endian)
+        const length = (this.buffer[0] << 16) | (this.buffer[1] << 8) | this.buffer[2];
+        // Check if we have the full message
+        if (this.buffer.length < 3 + length) {
+            return null;
+        }
+        // Read flag byte
+        const flag = this.buffer[3];
+        const terminal = (flag & 0x80) !== 0;
+        let compression = "none";
+        if ((flag & 0x20) !== 0) {
+            compression = "zstd";
+        }
+        else if ((flag & 0x40) !== 0) {
+            compression = "gzip";
+        }
+        // Extract body (length includes flag byte, so body is length - 1 bytes)
+        let body = this.buffer.slice(4, 4 + length - 1);
+        let statusCode;
+        // For terminal frames, check for status code
+        if (terminal && body.length >= 2) {
+            statusCode = (body[0] << 8) | body[1];
+            body = body.slice(2);
+        }
+        // Remove parsed frame from buffer
+        this.buffer = this.buffer.slice(3 + length);
+        return {
+            terminal,
+            compression,
+            body,
+            statusCode,
+        };
+    }
+    /**
+     * Check if parser has any buffered data
+     */
+    hasData() {
+        return this.buffer.length > 0;
+    }
+}
+exports.S2SFrameParser = S2SFrameParser;
+//# sourceMappingURL=framing.js.map

package/dist/cjs/lib/stream/transport/s2s/framing.js.map

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

package/dist/cjs/lib/stream/transport/s2s/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * S2S HTTP/2 transport for Node.js
+ * Uses the s2s binary protocol over HTTP/2 for efficient streaming
+ *
+ * This file should only be imported in Node.js environments
+ */
+import type { S2RequestOptions } from "../../../../common.js";
+import type { AppendSession, AppendSessionOptions, ReadArgs, ReadSession, SessionTransport, TransportConfig } from "../../types.js";
+export declare class S2STransport implements SessionTransport {
+    private readonly client;
+    private readonly transportConfig;
+    private connection?;
+    private connectionPromise?;
+    constructor(config: TransportConfig);
+    makeAppendSession(stream: string, sessionOptions?: AppendSessionOptions, requestOptions?: S2RequestOptions): Promise<AppendSession>;
+    makeReadSession<Format extends "string" | "bytes" = "string">(stream: string, args?: ReadArgs<Format>, options?: S2RequestOptions): Promise<ReadSession<Format>>;
+    /**
+     * Get or create HTTP/2 connection (one per transport)
+     */
+    private getConnection;
+    private createConnection;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/lib/stream/transport/s2s/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/stream/transport/s2s/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAgB9D,OAAO,KAAK,EAGX,aAAa,EACb,oBAAoB,EACpB,QAAQ,EAER,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,MAAM,gBAAgB,CAAC;AAGxB,qBAAa,YAAa,YAAW,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,UAAU,CAAC,CAA2B;IAC9C,OAAO,CAAC,iBAAiB,CAAC,CAAoC;gBAElD,MAAM,EAAE,eAAe;IAU7B,iBAAiB,CACtB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,oBAAoB,EACrC,cAAc,CAAC,EAAE,gBAAgB,GAC/B,OAAO,CAAC,aAAa,CAAC;IAWnB,eAAe,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACjE,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAW/B;;OAEG;YACW,aAAa;YAyBb,gBAAgB;CA4B9B"}