@s2-dev/streamstore 0.16.12 → 0.17.0

package/dist/esm/index.js

@@ -1,4 +1,5 @@
+export { BatchTransform } from "./batch-transform.js";
 export { FencingTokenMismatchError, RangeNotSatisfiableError, S2Error, SeqNumMismatchError, } from "./error.js";
 export { S2 } from "./s2.js";
-export { AppendRecord } from "./utils.js";
+export { AppendRecord, meteredSizeBytes, utf8ByteLength } from "./utils.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACN,yBAAyB,EACzB,wBAAwB,EACxB,OAAO,EACP,mBAAmB,GACnB,MAAM,YAAY,CAAC;AAuCpB,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAe7B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACN,yBAAyB,EACzB,wBAAwB,EACxB,OAAO,EACP,mBAAmB,GACnB,MAAM,YAAY,CAAC;AA8CpB,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAQ7B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/lib/stream/factory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Transport factory - selects the appropriate transport based on runtime
+ */
+import type { SessionTransport, TransportConfig } from "./types.js";
+/**
+ * Create a transport instance based on the runtime environment
+ *
+ * - In Node.js with HTTP/2 support: uses S2STransport (binary protocol over HTTP/2)
+ * - Everywhere else: uses FetchTransport (JSON over HTTP/1.1)
+ *
+ * @param config Transport configuration
+ * @param preferHttp2 Force HTTP/2 or HTTP/1.1 (default: auto-detect)
+ */
+export declare function createSessionTransport(config: TransportConfig): Promise<SessionTransport>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/esm/lib/stream/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/stream/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC3C,MAAM,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAkB3B"}

package/dist/esm/lib/stream/factory.js

@@ -0,0 +1,33 @@
+/**
+ * Transport factory - selects the appropriate transport based on runtime
+ */
+import { supportsHttp2 } from "./runtime.js";
+import { FetchTransport } from "./transport/fetch/index.js";
+/**
+ * Create a transport instance based on the runtime environment
+ *
+ * - In Node.js with HTTP/2 support: uses S2STransport (binary protocol over HTTP/2)
+ * - Everywhere else: uses FetchTransport (JSON over HTTP/1.1)
+ *
+ * @param config Transport configuration
+ * @param preferHttp2 Force HTTP/2 or HTTP/1.1 (default: auto-detect)
+ */
+export async function createSessionTransport(config) {
+    // Check if user explicitly disabled HTTP/2
+    if (config?.forceTransport === "fetch") {
+        return new FetchTransport(config);
+    }
+    else if (config?.forceTransport === "s2s") {
+        const { S2STransport } = await import("./transport/s2s/index.js");
+        return new S2STransport(config);
+    }
+    // Check if HTTP/2 is available
+    if (supportsHttp2()) {
+        // Dynamic import for Node.js-specific transport
+        const { S2STransport } = await import("./transport/s2s/index.js");
+        return new S2STransport(config);
+    }
+    // Fallback to fetch
+    return new FetchTransport(config);
+}
+//# sourceMappingURL=factory.js.map

package/dist/esm/lib/stream/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/lib/stream/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,MAAuB;IAEvB,2CAA2C;IAC3C,IAAI,MAAM,EAAE,cAAc,KAAK,OAAO,EAAE,CAAC;QACxC,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;SAAM,IAAI,MAAM,EAAE,cAAc,KAAK,KAAK,EAAE,CAAC;QAC7C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAClE,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,+BAA+B;IAC/B,IAAI,aAAa,EAAE,EAAE,CAAC;QACrB,gDAAgD;QAChD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAClE,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,oBAAoB;IACpB,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/esm/lib/stream/runtime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runtime environment detection for transport selection
+ */
+export type Runtime = "node" | "browser" | "deno" | "bun" | "unknown";
+/**
+ * Detect the current JavaScript runtime
+ */
+export declare function detectRuntime(): Runtime;
+/**
+ * Check if the current runtime supports HTTP/2 for s2s protocol
+ */
+export declare function supportsHttp2(): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/esm/lib/stream/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/lib/stream/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtE;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAuBvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAkBvC"}

package/dist/esm/lib/stream/runtime.js

@@ -0,0 +1,46 @@
+/**
+ * Runtime environment detection for transport selection
+ */
+/**
+ * Detect the current JavaScript runtime
+ */
+export function detectRuntime() {
+    // Check for Deno
+    // @ts-expect-error - Deno global not in types
+    if (typeof Deno !== "undefined") {
+        return "deno";
+    }
+    // Check for Bun
+    if (typeof Bun !== "undefined") {
+        return "bun";
+    }
+    // Check for Node.js
+    if (typeof process !== "undefined" && process.versions?.node !== undefined) {
+        return "node";
+    }
+    // Check for browser
+    if (typeof window !== "undefined" && typeof document !== "undefined") {
+        return "browser";
+    }
+    return "unknown";
+}
+/**
+ * Check if the current runtime supports HTTP/2 for s2s protocol
+ */
+export function supportsHttp2() {
+    const runtime = detectRuntime();
+    switch (runtime) {
+        case "node":
+        case "deno":
+        case "bun":
+            // via node:http2
+            return true;
+        case "browser":
+            // Browsers don't expose raw HTTP/2 - they handle it internally
+            // but we can't use s2s protocol
+            return false;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/esm/lib/stream/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../../src/lib/stream/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,aAAa;IAC5B,iBAAiB;IACjB,8CAA8C;IAC9C,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,GAAG,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5E,OAAO,MAAM,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC5B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACT,iBAAiB;YACjB,OAAO,IAAI,CAAC;QAEb,KAAK,SAAS;YACb,+DAA+D;YAC/D,gCAAgC;YAChC,OAAO,KAAK,CAAC;QAEd;YACC,OAAO,KAAK,CAAC;IACf,CAAC;AACF,CAAC"}

package/dist/esm/lib/stream/transport/fetch/index.d.ts

@@ -0,0 +1,79 @@
+import type { S2RequestOptions } from "../../../../common.js";
+import { type Client } from "../../../../generated/client/index.js";
+import type { AppendAck, StreamPosition } from "../../../../generated/index.js";
+import { EventStream } from "../../../event-stream.js";
+import type { AppendArgs, AppendRecord, AppendSession, AppendSessionOptions, ReadArgs, ReadRecord, ReadSession, SessionTransport, TransportConfig } from "../../types.js";
+export declare class FetchReadSession<Format extends "string" | "bytes" = "string"> extends EventStream<ReadRecord<Format>> {
+    static create<Format extends "string" | "bytes" = "string">(client: Client, name: string, args?: ReadArgs<Format>, options?: S2RequestOptions): Promise<FetchReadSession<Format>>;
+    private _lastReadPosition;
+    private constructor();
+    lastReadPosition(): StreamPosition | undefined;
+}
+declare class AcksStream extends ReadableStream<AppendAck> implements AsyncDisposable {
+    constructor(setController: (controller: ReadableStreamDefaultController<AppendAck>) => void);
+    [Symbol.asyncDispose](): Promise<void>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<AppendAck>;
+}
+/**
+ * Session for appending records to a stream.
+ * Queues append requests and ensures only one is in-flight at a time.
+ */
+export declare class FetchAppendSession implements ReadableWritablePair<AppendAck, AppendArgs>, AsyncDisposable {
+    private _lastAckedPosition;
+    private queue;
+    private pendingResolvers;
+    private inFlight;
+    private readonly options?;
+    private readonly stream;
+    private acksController;
+    private _readable;
+    private _writable;
+    private closed;
+    private processingPromise;
+    private queuedBytes;
+    private readonly maxQueuedBytes;
+    private waitingForCapacity;
+    private readonly client;
+    readonly readable: ReadableStream<AppendAck>;
+    readonly writable: WritableStream<AppendArgs>;
+    static create(stream: string, transportConfig: TransportConfig, sessionOptions?: AppendSessionOptions, requestOptions?: S2RequestOptions): Promise<FetchAppendSession>;
+    private constructor();
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Get a stream of acknowledgements for appends.
+     */
+    acks(): AcksStream;
+    /**
+     * Close the append session.
+     * Waits for all pending appends to complete before resolving.
+     */
+    close(): Promise<void>;
+    /**
+     * Submit an append request to the session.
+     * The request will be queued and sent when no other request is in-flight.
+     * Returns a promise that resolves when the append is acknowledged or rejects on error.
+     */
+    submit(records: AppendRecord | AppendRecord[], args?: {
+        fencing_token?: string;
+        match_seq_num?: number;
+    }, precalculatedSize?: number): Promise<AppendAck>;
+    /**
+     * Main processing loop that sends queued requests one at a time.
+     */
+    private processLoop;
+    private waitForDrain;
+    lastAckedPosition(): AppendAck | undefined;
+}
+/**
+ * Fetch-based transport using HTTP/1.1 + JSON
+ * Works in all JavaScript environments (browser, Node.js, Deno, etc.)
+ */
+export declare class FetchTransport implements SessionTransport {
+    private readonly client;
+    private readonly transportConfig;
+    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>>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/lib/stream/transport/fetch/index.d.ts.map

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

package/dist/esm/lib/stream/transport/fetch/index.js

@@ -0,0 +1,376 @@
+import { RangeNotSatisfiableError, S2Error } from "../../../../error.js";
+import { createClient, createConfig, } from "../../../../generated/client/index.js";
+import { read } from "../../../../generated/index.js";
+import { meteredSizeBytes } from "../../../../utils.js";
+import { decodeFromBase64 } from "../../../base64.js";
+import { EventStream } from "../../../event-stream.js";
+import * as Redacted from "../../../redacted.js";
+import { streamAppend } from "./shared.js";
+export class FetchReadSession extends EventStream {
+    static async create(client, name, args, options) {
+        const { as, ...queryParams } = args ?? {};
+        const response = await read({
+            client,
+            path: {
+                stream: name,
+            },
+            headers: {
+                accept: "text/event-stream",
+                ...(as === "bytes" ? { "s2-format": "base64" } : {}),
+            },
+            query: queryParams,
+            parseAs: "stream",
+            ...options,
+        });
+        if (response.error) {
+            if ("message" in response.error) {
+                throw new S2Error({
+                    message: response.error.message,
+                    code: response.error.code ?? undefined,
+                    status: response.response.status,
+                });
+            }
+            else {
+                // special case for 416 - Range Not Satisfiable
+                throw new RangeNotSatisfiableError({
+                    status: response.response.status,
+                });
+            }
+        }
+        if (!response.response.body) {
+            throw new S2Error({
+                message: "No body in SSE response",
+            });
+        }
+        const format = (args?.as ?? "string");
+        return new FetchReadSession(response.response.body, format);
+    }
+    _lastReadPosition = undefined;
+    constructor(stream, format) {
+        super(stream, (msg) => {
+            // Parse SSE events according to the S2 protocol
+            if (msg.event === "batch" && msg.data) {
+                const rawBatch = JSON.parse(msg.data);
+                const batch = (() => {
+                    // If format is bytes, decode base64 to Uint8Array
+                    if (format === "bytes") {
+                        return {
+                            ...rawBatch,
+                            records: rawBatch.records.map((record) => ({
+                                ...record,
+                                body: record.body ? decodeFromBase64(record.body) : undefined,
+                                headers: record.headers?.map((header) => header.map((h) => decodeFromBase64(h))),
+                            })),
+                        };
+                    }
+                    else {
+                        return {
+                            ...rawBatch,
+                            records: rawBatch.records.map((record) => ({
+                                ...record,
+                                headers: record.headers
+                                    ? Object.fromEntries(record.headers)
+                                    : undefined,
+                            })),
+                        };
+                    }
+                })();
+                if (batch.tail) {
+                    this._lastReadPosition = batch.tail;
+                }
+                return { done: false, batch: true, value: batch.records ?? [] };
+            }
+            if (msg.event === "error") {
+                // Handle error events
+                throw new S2Error({ message: msg.data ?? "Unknown error" });
+            }
+            // Skip ping events and other events
+            return { done: false };
+        });
+    }
+    lastReadPosition() {
+        return this._lastReadPosition;
+    }
+}
+class AcksStream extends ReadableStream {
+    constructor(setController) {
+        super({
+            start: (controller) => {
+                setController(controller);
+            },
+        });
+    }
+    async [Symbol.asyncDispose]() {
+        await this.cancel("disposed");
+    }
+    // Polyfill for older browsers
+    [Symbol.asyncIterator]() {
+        const fn = ReadableStream.prototype[Symbol.asyncIterator];
+        if (typeof fn === "function")
+            return fn.call(this);
+        const reader = this.getReader();
+        return {
+            next: async () => {
+                const r = await reader.read();
+                if (r.done) {
+                    reader.releaseLock();
+                    return { done: true, value: undefined };
+                }
+                return { done: false, value: r.value };
+            },
+            throw: async (e) => {
+                await reader.cancel(e);
+                reader.releaseLock();
+                return { done: true, value: undefined };
+            },
+            return: async () => {
+                await reader.cancel("done");
+                reader.releaseLock();
+                return { done: true, value: undefined };
+            },
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+        };
+    }
+}
+/**
+ * Session for appending records to a stream.
+ * Queues append requests and ensures only one is in-flight at a time.
+ */
+export class FetchAppendSession {
+    _lastAckedPosition = undefined;
+    queue = [];
+    pendingResolvers = [];
+    inFlight = false;
+    options;
+    stream;
+    acksController;
+    _readable;
+    _writable;
+    closed = false;
+    processingPromise = null;
+    queuedBytes = 0;
+    maxQueuedBytes;
+    waitingForCapacity = [];
+    client;
+    readable;
+    writable;
+    static async create(stream, transportConfig, sessionOptions, requestOptions) {
+        return new FetchAppendSession(stream, transportConfig, sessionOptions, requestOptions);
+    }
+    constructor(stream, transportConfig, sessionOptions, requestOptions) {
+        this.options = requestOptions;
+        this.stream = stream;
+        this.maxQueuedBytes = sessionOptions?.maxQueuedBytes ?? 10 * 1024 * 1024; // 10 MiB default
+        this.client = createClient(createConfig({
+            baseUrl: transportConfig.baseUrl,
+            auth: () => Redacted.value(transportConfig.accessToken),
+        }));
+        // Create the readable stream for acks
+        this._readable = new AcksStream((controller) => {
+            this.acksController = controller;
+        });
+        this.readable = this._readable;
+        // Create the writable stream
+        let writableController;
+        this._writable = new WritableStream({
+            start: (controller) => {
+                writableController = controller;
+            },
+            write: async (chunk) => {
+                // Calculate batch size
+                let batchMeteredSize = 0;
+                for (const record of chunk.records) {
+                    batchMeteredSize += meteredSizeBytes(record);
+                }
+                // Wait for capacity if needed
+                while (this.queuedBytes + batchMeteredSize > this.maxQueuedBytes &&
+                    !this.closed) {
+                    await new Promise((resolve) => {
+                        this.waitingForCapacity.push(resolve);
+                    });
+                }
+                // Submit the batch
+                this.submit(chunk.records, {
+                    fencing_token: chunk.fencing_token ?? undefined,
+                    match_seq_num: chunk.match_seq_num ?? undefined,
+                }, batchMeteredSize);
+            },
+            close: async () => {
+                this.closed = true;
+                await this.waitForDrain();
+            },
+            abort: async (reason) => {
+                this.closed = true;
+                this.queue = [];
+                this.queuedBytes = 0;
+                // Reject all pending promises
+                const error = new S2Error({
+                    message: `AppendSession was aborted: ${reason}`,
+                });
+                for (const resolver of this.pendingResolvers) {
+                    resolver.reject(error);
+                }
+                this.pendingResolvers = [];
+                // Reject all waiting for capacity
+                for (const resolver of this.waitingForCapacity) {
+                    resolver();
+                }
+                this.waitingForCapacity = [];
+            },
+        });
+        this.writable = this._writable;
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    /**
+     * Get a stream of acknowledgements for appends.
+     */
+    acks() {
+        return this._readable;
+    }
+    /**
+     * Close the append session.
+     * Waits for all pending appends to complete before resolving.
+     */
+    async close() {
+        await this.writable.close();
+    }
+    /**
+     * Submit an append request to the session.
+     * The request will be queued and sent when no other request is in-flight.
+     * Returns a promise that resolves when the append is acknowledged or rejects on error.
+     */
+    submit(records, args, precalculatedSize) {
+        if (this.closed) {
+            return Promise.reject(new S2Error({ message: "AppendSession is closed" }));
+        }
+        const recordsArray = Array.isArray(records) ? records : [records];
+        // Validate batch size limits
+        if (recordsArray.length > 1000) {
+            return Promise.reject(new S2Error({
+                message: `Batch of ${recordsArray.length} exceeds maximum batch size of 1000 records`,
+            }));
+        }
+        // Validate metered size (use precalculated if provided)
+        let batchMeteredSize = precalculatedSize ?? 0;
+        if (batchMeteredSize === 0) {
+            for (const record of recordsArray) {
+                batchMeteredSize += meteredSizeBytes(record);
+            }
+        }
+        if (batchMeteredSize > 1024 * 1024) {
+            return Promise.reject(new S2Error({
+                message: `Batch size ${batchMeteredSize} bytes exceeds maximum of 1 MiB (1048576 bytes)`,
+            }));
+        }
+        return new Promise((resolve, reject) => {
+            this.queue.push({
+                records: recordsArray,
+                fencing_token: args?.fencing_token,
+                match_seq_num: args?.match_seq_num,
+                meteredSize: batchMeteredSize,
+            });
+            this.queuedBytes += batchMeteredSize;
+            this.pendingResolvers.push({ resolve, reject });
+            // Start processing if not already running
+            if (!this.processingPromise) {
+                this.processingPromise = this.processLoop();
+            }
+        });
+    }
+    /**
+     * Main processing loop that sends queued requests one at a time.
+     */
+    async processLoop() {
+        while (this.queue.length > 0) {
+            this.inFlight = true;
+            const args = this.queue.shift();
+            const resolver = this.pendingResolvers.shift();
+            try {
+                const ack = await streamAppend(this.stream, this.client, args.records, {
+                    fencing_token: args.fencing_token,
+                    match_seq_num: args.match_seq_num,
+                }, this.options);
+                this._lastAckedPosition = ack;
+                // Emit ack to the acks stream if it exists
+                if (this.acksController) {
+                    this.acksController.enqueue(ack);
+                }
+                // Resolve the promise for this request
+                resolver.resolve(ack);
+                // Release capacity and wake up waiting writers
+                this.queuedBytes -= args.meteredSize;
+                while (this.waitingForCapacity.length > 0) {
+                    const waiter = this.waitingForCapacity.shift();
+                    waiter();
+                    // Only wake one at a time - let them check capacity again
+                    break;
+                }
+            }
+            catch (error) {
+                this.inFlight = false;
+                this.processingPromise = null;
+                // Reject the promise for this request
+                resolver.reject(error);
+                // Reject all remaining pending promises
+                for (const pendingResolver of this.pendingResolvers) {
+                    pendingResolver.reject(error);
+                }
+                this.pendingResolvers = [];
+                // Clear the queue and reset queued bytes
+                this.queue = [];
+                this.queuedBytes = 0;
+                // Wake up all waiting writers (they'll see the closed state or retry)
+                for (const waiter of this.waitingForCapacity) {
+                    waiter();
+                }
+                this.waitingForCapacity = [];
+                // Do not rethrow here to avoid unhandled rejection; callers already received rejection
+            }
+            this.inFlight = false;
+        }
+        this.processingPromise = null;
+    }
+    async waitForDrain() {
+        // Wait for processing to complete
+        if (this.processingPromise) {
+            await this.processingPromise;
+        }
+        // Wait until queue is empty and nothing is in flight
+        while (this.queue.length > 0 || this.inFlight) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+        // Close the acks stream if it exists
+        if (this.acksController) {
+            this.acksController.close();
+        }
+    }
+    lastAckedPosition() {
+        return this._lastAckedPosition;
+    }
+}
+/**
+ * Fetch-based transport using HTTP/1.1 + JSON
+ * Works in all JavaScript environments (browser, Node.js, Deno, etc.)
+ */
+export class FetchTransport {
+    client;
+    transportConfig;
+    constructor(config) {
+        this.client = createClient(createConfig({
+            baseUrl: config.baseUrl,
+            auth: () => Redacted.value(config.accessToken),
+        }));
+        this.transportConfig = config;
+    }
+    async makeAppendSession(stream, sessionOptions, requestOptions) {
+        return FetchAppendSession.create(stream, this.transportConfig, sessionOptions, requestOptions);
+    }
+    async makeReadSession(stream, args, options) {
+        return FetchReadSession.create(this.client, stream, args, options);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/stream/transport/fetch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/lib/stream/transport/fetch/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAEN,YAAY,EACZ,YAAY,GACZ,MAAM,uCAAuC,CAAC;AAM/C,OAAO,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AAajD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,OAAO,gBAEX,SAAQ,WAA+B;IACxC,MAAM,CAAC,KAAK,CAAC,MAAM,CAClB,MAAc,EACd,IAAY,EACZ,IAAuB,EACvB,OAA0B;QAE1B,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;YAC3B,MAAM;YACN,IAAI,EAAE;gBACL,MAAM,EAAE,IAAI;aACZ;YACD,OAAO,EAAE;gBACR,MAAM,EAAE,mBAAmB;gBAC3B,GAAG,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD;YACD,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,QAAQ;YACjB,GAAG,OAAO;SACV,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,IAAI,SAAS,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,IAAI,OAAO,CAAC;oBACjB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO;oBAC/B,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS;oBACtC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;iBAChC,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACP,+CAA+C;gBAC/C,MAAM,IAAI,wBAAwB,CAAC;oBAClC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;iBAChC,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,OAAO,CAAC;gBACjB,OAAO,EAAE,yBAAyB;aAClC,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,QAAQ,CAAW,CAAC;QAChD,OAAO,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAEO,iBAAiB,GAA+B,SAAS,CAAC;IAElE,YAAoB,MAAkC,EAAE,MAAc;QACrE,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,gDAAgD;YAChD,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACvC,MAAM,QAAQ,GAAuB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1D,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE;oBACnB,kDAAkD;oBAClD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;wBACxB,OAAO;4BACN,GAAG,QAAQ;4BACX,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gCAC1C,GAAG,MAAM;gCACT,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gCAC7D,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACvC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CACR;6BAC/B,CAAC,CAAC;yBAC0B,CAAC;oBAChC,CAAC;yBAAM,CAAC;wBACP,OAAO;4BACN,GAAG,QAAQ;4BACX,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gCAC1C,GAAG,MAAM;gCACT,OAAO,EAAE,MAAM,CAAC,OAAO;oCACtB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;oCACpC,CAAC,CAAC,SAAS;6BACZ,CAAC,CAAC;yBAC2B,CAAC;oBACjC,CAAC;gBACF,CAAC,CAAC,EAAuB,CAAC;gBAC1B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC;gBACrC,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACjE,CAAC;YACD,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC3B,sBAAsB;gBACtB,MAAM,IAAI,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,eAAe,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,oCAAoC;YACpC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACJ,CAAC;IAEM,gBAAgB;QACtB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,UAAW,SAAQ,cAAyB;IACjD,YACC,aAES;QAET,KAAK,CAAC;YACL,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;gBACrB,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,8BAA8B;IAC9B,CAAC,MAAM,CAAC,aAAa,CAAC;QACrB,MAAM,EAAE,GAAI,cAAc,CAAC,SAAiB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACnE,IAAI,OAAO,EAAE,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO;YACN,IAAI,EAAE,KAAK,IAAI,EAAE;gBAChB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;oBACZ,MAAM,CAAC,WAAW,EAAE,CAAC;oBACrB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;gBACzC,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACxC,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;gBAClB,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,WAAW,EAAE,CAAC;gBACrB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACzC,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,MAAM,CAAC,WAAW,EAAE,CAAC;gBACrB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACzC,CAAC;YACD,CAAC,MAAM,CAAC,aAAa,CAAC;gBACrB,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;IACH,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAGtB,kBAAkB,GAA0B,SAAS,CAAC;IACtD,KAAK,GAKR,EAAE,CAAC;IACA,gBAAgB,GAGnB,EAAE,CAAC;IACA,QAAQ,GAAG,KAAK,CAAC;IACR,OAAO,CAAoB;IAC3B,MAAM,CAAS;IACxB,cAAc,CAET;IACL,SAAS,CAAa;IACtB,SAAS,CAA6B;IACtC,MAAM,GAAG,KAAK,CAAC;IACf,iBAAiB,GAAyB,IAAI,CAAC;IAC/C,WAAW,GAAG,CAAC,CAAC;IACP,cAAc,CAAS;IAChC,kBAAkB,GAAsB,EAAE,CAAC;IAClC,MAAM,CAAS;IAEhB,QAAQ,CAA4B;IACpC,QAAQ,CAA6B;IAErD,MAAM,CAAC,KAAK,CAAC,MAAM,CAClB,MAAc,EACd,eAAgC,EAChC,cAAqC,EACrC,cAAiC;QAEjC,OAAO,IAAI,kBAAkB,CAC5B,MAAM,EACN,eAAe,EACf,cAAc,EACd,cAAc,CACd,CAAC;IACH,CAAC;IAED,YACC,MAAc,EACd,eAAgC,EAChC,cAAqC,EACrC,cAAiC;QAEjC,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,cAAc,EAAE,cAAc,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,iBAAiB;QAC3F,IAAI,CAAC,MAAM,GAAG,YAAY,CACzB,YAAY,CAAC;YACZ,OAAO,EAAE,eAAe,CAAC,OAAO;YAChC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC;SACvD,CAAC,CACF,CAAC;QACF,sCAAsC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAC,CAAC,UAAU,EAAE,EAAE;YAC9C,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAE/B,6BAA6B;QAC7B,IAAI,kBAAmD,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAa;YAC/C,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE;gBACrB,kBAAkB,GAAG,UAAU,CAAC;YACjC,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACtB,uBAAuB;gBACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;gBACzB,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACpC,gBAAgB,IAAI,gBAAgB,CAAC,MAAsB,CAAC,CAAC;gBAC9D,CAAC;gBAED,8BAA8B;gBAC9B,OACC,IAAI,CAAC,WAAW,GAAG,gBAAgB,GAAG,IAAI,CAAC,cAAc;oBACzD,CAAC,IAAI,CAAC,MAAM,EACX,CAAC;oBACF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;wBACnC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACvC,CAAC,CAAC,CAAC;gBACJ,CAAC;gBAED,mBAAmB;gBACnB,IAAI,CAAC,MAAM,CACV,KAAK,CAAC,OAAO,EACb;oBACC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,SAAS;oBAC/C,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,SAAS;iBAC/C,EACD,gBAAgB,CAChB,CAAC;YACH,CAAC;YACD,KAAK,EAAE,KAAK,IAAI,EAAE;gBACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3B,CAAC;YACD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;gBACnB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;gBAErB,8BAA8B;gBAC9B,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC;oBACzB,OAAO,EAAE,8BAA8B,MAAM,EAAE;iBAC/C,CAAC,CAAC;gBACH,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC9C,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxB,CAAC;gBACD,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;gBAE3B,kCAAkC;gBAClC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBAChD,QAAQ,EAAE,CAAC;gBACZ,CAAC;gBACD,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;YAC9B,CAAC;SACD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,IAAI;QACH,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,MAAM,CACL,OAAsC,EACtC,IAAyD,EACzD,iBAA0B;QAE1B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,MAAM,CACpB,IAAI,OAAO,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CACnD,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAElE,6BAA6B;QAC7B,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,MAAM,CACpB,IAAI,OAAO,CAAC;gBACX,OAAO,EAAE,YAAY,YAAY,CAAC,MAAM,6CAA6C;aACrF,CAAC,CACF,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,gBAAgB,GAAG,iBAAiB,IAAI,CAAC,CAAC;QAC9C,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBACnC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACF,CAAC;QAED,IAAI,gBAAgB,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACpC,OAAO,OAAO,CAAC,MAAM,CACpB,IAAI,OAAO,CAAC;gBACX,OAAO,EAAE,cAAc,gBAAgB,iDAAiD;aACxF,CAAC,CACF,CAAC;QACH,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACf,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,IAAI,EAAE,aAAa;gBAClC,aAAa,EAAE,IAAI,EAAE,aAAa;gBAClC,WAAW,EAAE,gBAAgB;aAC7B,CAAC,CAAC;YACH,IAAI,CAAC,WAAW,IAAI,gBAAgB,CAAC;YACrC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAEhD,0CAA0C;YAC1C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC7B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7C,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAG,CAAC;YAEhD,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,MAAM,YAAY,CAC7B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ;oBACC,aAAa,EAAE,IAAI,CAAC,aAAa;oBACjC,aAAa,EAAE,IAAI,CAAC,aAAa;iBACjC,EACD,IAAI,CAAC,OAAO,CACZ,CAAC;gBACF,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC;gBAE9B,2CAA2C;gBAC3C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACzB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAClC,CAAC;gBAED,uCAAuC;gBACvC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAEtB,+CAA+C;gBAC/C,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC;gBACrC,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAG,CAAC;oBAChD,MAAM,EAAE,CAAC;oBACT,0DAA0D;oBAC1D,MAAM;gBACP,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACtB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;gBAE9B,sCAAsC;gBACtC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAEvB,wCAAwC;gBACxC,KAAK,MAAM,eAAe,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACrD,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBACD,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;gBAE3B,yCAAyC;gBACzC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;gBAErB,sEAAsE;gBACtE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBAC9C,MAAM,EAAE,CAAC;gBACV,CAAC;gBACD,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;gBAE7B,uFAAuF;YACxF,CAAC;YAED,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,YAAY;QACzB,kCAAkC;QAClC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,iBAAiB,CAAC;QAC9B,CAAC;QAED,qDAAqD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,qCAAqC;QACrC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,iBAAiB;QAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IAChC,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IACT,MAAM,CAAS;IACf,eAAe,CAAkB;IAClD,YAAY,MAAuB;QAClC,IAAI,CAAC,MAAM,GAAG,YAAY,CACzB,YAAY,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;SAC9C,CAAC,CACF,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,iBAAiB,CACtB,MAAc,EACd,cAAqC,EACrC,cAAiC;QAEjC,OAAO,kBAAkB,CAAC,MAAM,CAC/B,MAAM,EACN,IAAI,CAAC,eAAe,EACpB,cAAc,EACd,cAAc,CACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CACpB,MAAc,EACd,IAAuB,EACvB,OAA0B;QAE1B,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;CACD"}

package/dist/esm/lib/stream/transport/fetch/shared.d.ts

@@ -0,0 +1,7 @@
+import type { S2RequestOptions } from "../../../../common.js";
+import type { Client } from "../../../../generated/client/index.js";
+import { type AppendAck } from "../../../../generated/index.js";
+import type { AppendArgs, AppendRecord, ReadArgs, ReadBatch } from "../../types.js";
+export declare function streamRead<Format extends "string" | "bytes" = "string">(stream: string, client: Client, args?: ReadArgs<Format>, options?: S2RequestOptions): Promise<ReadBatch<Format>>;
+export declare function streamAppend(stream: string, client: Client, records: AppendRecord | AppendRecord[], args?: Omit<AppendArgs, "records">, options?: S2RequestOptions): Promise<AppendAck>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/esm/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"}