@s2-dev/streamstore 0.20.0 → 0.22.0

package/dist/esm/producer.js

@@ -0,0 +1,300 @@
+import createDebug from "debug";
+import { BatchTransform } from "./batch-transform.js";
+import { S2Error } from "./error.js";
+import { AppendInput } from "./types.js";
+const debugProducer = createDebug("s2:producer");
+const toS2Error = (err) => err instanceof S2Error
+    ? err
+    : new S2Error({
+        message: String(err),
+        status: 500,
+        origin: "sdk",
+    });
+export class IndexedAppendAck {
+    index;
+    ack;
+    constructor(index, ack) {
+        this.index = index;
+        this.ack = ack;
+    }
+    batchAppendAck() {
+        return this.ack;
+    }
+    seqNum() {
+        return this.ack.start.seqNum + this.index;
+    }
+}
+export class RecordSubmitTicket {
+    ackPromise;
+    constructor(ackPromise) {
+        this.ackPromise = ackPromise;
+        // Avoid unhandled rejections if the caller never awaits ack().
+        this.ackPromise.catch(() => { });
+    }
+    /**
+     * Returns a promise that resolves with the IndexedAppendAck once the record is durable.
+     */
+    ack() {
+        return this.ackPromise;
+    }
+}
+/**
+ * Producer provides per-record append semantics on top of a batched AppendSession.
+ *
+ * - submit(record) returns a Promise<RecordSubmitTicket> that resolves once the record
+ *   has been accepted (written to the batch transform). Backpressure is applied
+ *   automatically via the transform stream when the AppendSession is at capacity.
+ * - ticket.ack() returns a Promise<IndexedAppendAck> that resolves once the record is durable.
+ *
+ * See the "Producer API" section of the root README for guidance on sizing batches,
+ * wiring transforms, and handling application-level ids.
+ *
+ * @example
+ * ```ts
+ * const appendSession = await stream.appendSession();
+ * const producer = new Producer(new BatchTransform(), appendSession);
+ * const writer = producer.writable.getWriter();
+ * await writer.write(AppendRecord.string({ body: "hello" }));
+ * await writer.close();
+ *
+ * for await (const ack of producer.readable) {
+ *   console.log("record durable at seq", ack.seqNum());
+ * }
+ *
+ * await producer.close();
+ * ```
+ */
+export class Producer {
+    batchTransform;
+    transformWriter;
+    transformReader;
+    pump;
+    appendSession;
+    readable;
+    writable;
+    inflightRecords = [];
+    pumpError = null;
+    readableController = null;
+    debugName;
+    submitCounter = 0;
+    constructor(batchTransform, appendSession, debugName) {
+        this.debugName = debugName ?? `producer-${Date.now()}`;
+        this.batchTransform = batchTransform;
+        this.transformWriter = batchTransform.writable.getWriter();
+        this.transformReader = batchTransform.readable.getReader();
+        this.appendSession = appendSession;
+        debugProducer("[%s] created", this.debugName);
+        // Create readable stream that emits individual record acknowledgements
+        this.readable = new ReadableStream({
+            start: (controller) => {
+                this.readableController = controller;
+            },
+            cancel: () => {
+                this.close().catch(() => {
+                    // Ignore errors during cleanup
+                });
+            },
+        });
+        // Create writable stream that accepts individual records
+        this.writable = new WritableStream({
+            write: async (record) => {
+                await this.submit(record);
+            },
+            close: async () => {
+                await this.close();
+            },
+            abort: async (reason) => {
+                this.pumpError = toS2Error(reason);
+                await this.close();
+            },
+        });
+        this.pump = this.runPump();
+    }
+    /**
+     * Main pump loop: reads batches from transform, submits to session, handles acks.
+     */
+    async runPump() {
+        debugProducer("[%s] pump started", this.debugName);
+        try {
+            while (true) {
+                const { value: batch, done } = await this.transformReader.read();
+                if (done) {
+                    debugProducer("[%s] pump done (transform closed)", this.debugName);
+                    break;
+                }
+                debugProducer("[%s] pump got batch: records=%d, match_seq_num=%s, inflightRecords=%d", this.debugName, batch.records.length, batch.matchSeqNum ?? "none", this.inflightRecords.length);
+                // Associate records with this batch (FIFO correspondence)
+                const recordCount = batch.records.length;
+                const associatedRecords = this.inflightRecords.splice(0, recordCount);
+                if (associatedRecords.length !== recordCount) {
+                    throw new S2Error({
+                        message: `Internal error: flushed ${recordCount} records but only ${associatedRecords.length} inflight entries`,
+                        status: 500,
+                        origin: "sdk",
+                    });
+                }
+                // Submit to AppendSession (blocks on capacity)
+                let ticket;
+                try {
+                    debugProducer("[%s] pump submitting to session: records=%d, match_seq_num=%s", this.debugName, batch.records.length, batch.matchSeqNum ?? "none");
+                    const input = AppendInput.create(batch.records, {
+                        fencingToken: batch.fencingToken,
+                        matchSeqNum: batch.matchSeqNum,
+                    });
+                    ticket = await this.appendSession.submit(input);
+                    debugProducer("[%s] pump submit returned ticket", this.debugName);
+                }
+                catch (err) {
+                    const error = toS2Error(err);
+                    debugProducer("[%s] pump submit error: %s", this.debugName, error.message);
+                    if (!this.pumpError) {
+                        this.pumpError = error;
+                    }
+                    // Reject acks for records in this batch
+                    for (const record of associatedRecords) {
+                        record.rejectAck(error);
+                    }
+                    if (this.readableController) {
+                        this.readableController.error(error);
+                    }
+                    continue;
+                }
+                // Handle ack asynchronously (non-blocking)
+                ticket
+                    .ack()
+                    .then((ack) => {
+                    debugProducer("[%s] pump ack received: seq_num=%d-%d", this.debugName, ack.start.seqNum, ack.end.seqNum);
+                    for (const [i, record] of associatedRecords.entries()) {
+                        const indexedAck = new IndexedAppendAck(i, ack);
+                        record.resolveAck(indexedAck);
+                        if (this.readableController) {
+                            this.readableController.enqueue(indexedAck);
+                        }
+                    }
+                })
+                    .catch((err) => {
+                    const error = toS2Error(err);
+                    debugProducer("[%s] pump ack error: %s", this.debugName, error.message);
+                    if (!this.pumpError) {
+                        this.pumpError = error;
+                    }
+                    for (const record of associatedRecords) {
+                        record.rejectAck(error);
+                    }
+                    if (this.readableController) {
+                        this.readableController.error(error);
+                    }
+                });
+            }
+        }
+        catch (err) {
+            const error = toS2Error(err);
+            debugProducer("[%s] pump caught error: %s", this.debugName, error.message);
+            if (!this.pumpError) {
+                this.pumpError = error;
+            }
+            // Reject all remaining inflight records
+            for (const record of this.inflightRecords.splice(0)) {
+                record.rejectAck(error);
+            }
+            // Error the readable stream
+            if (this.readableController) {
+                this.readableController.error(error);
+                this.readableController = null;
+            }
+        }
+    }
+    /**
+     * Submit a single record for appending.
+     *
+     * Returns a promise that resolves to a RecordSubmitTicket once the record has been
+     * accepted. The promise blocks if the underlying AppendSession is at capacity
+     * (backpressure is applied via the transform stream).
+     *
+     * @throws S2Error if the Producer has failed
+     */
+    async submit(record) {
+        const submitId = ++this.submitCounter;
+        debugProducer("[%s] submit #%d: inflightRecords=%d", this.debugName, submitId, this.inflightRecords.length);
+        // Check if pump has already failed
+        if (this.pumpError) {
+            debugProducer("[%s] submit #%d: pump already failed", this.debugName, submitId);
+            throw new S2Error({
+                message: `Cannot submit: producer has failed: ${this.pumpError.message}`,
+                status: 500,
+                origin: "sdk",
+            });
+        }
+        // Create the ack promise (resolved later by pump)
+        let resolveAck;
+        let rejectAck;
+        const ackPromise = new Promise((resolve, reject) => {
+            resolveAck = resolve;
+            rejectAck = reject;
+        });
+        // Suppress unhandled rejection if write fails before we return the ticket
+        ackPromise.catch(() => { });
+        // Track this record
+        const entry = { resolveAck, rejectAck };
+        this.inflightRecords.push(entry);
+        debugProducer("[%s] submit #%d: pushed to inflightRecords (now %d), writing to transform", this.debugName, submitId, this.inflightRecords.length);
+        try {
+            // Write to transform - BLOCKS on backpressure
+            await this.transformWriter.write(record);
+            debugProducer("[%s] submit #%d: write completed", this.debugName, submitId);
+        }
+        catch (err) {
+            debugProducer("[%s] submit #%d: write failed: %s", this.debugName, submitId, err);
+            // Remove from inflight if the write failed
+            const idx = this.inflightRecords.indexOf(entry);
+            if (idx >= 0) {
+                this.inflightRecords.splice(idx, 1);
+            }
+            const error = toS2Error(err);
+            rejectAck(error);
+            throw error;
+        }
+        // Write succeeded - return ticket immediately
+        return new RecordSubmitTicket(ackPromise);
+    }
+    /**
+     * Close the Producer gracefully.
+     *
+     * Waits for all pending records to be flushed, submitted, and acknowledged.
+     * If any error occurred during the Producer's lifetime, this method throws it.
+     */
+    async close() {
+        debugProducer("[%s] close requested", this.debugName);
+        // Close the writer to signal no more records
+        await this.transformWriter.close();
+        // Wait for the pump to finish processing all batches
+        await this.pump;
+        // Close the underlying session
+        await this.appendSession.close();
+        // Reject any remaining inflight records (shouldn't happen in normal operation)
+        if (this.inflightRecords.length > 0) {
+            const closingError = new S2Error({
+                message: "Producer closed with pending records",
+                status: 499,
+                origin: "sdk",
+            });
+            for (const record of this.inflightRecords.splice(0)) {
+                record.rejectAck(closingError);
+            }
+        }
+        // Close the readable stream
+        if (this.readableController) {
+            this.readableController.close();
+            this.readableController = null;
+        }
+        debugProducer("[%s] close complete", this.debugName);
+        // If an error occurred, throw it
+        if (this.pumpError) {
+            throw this.pumpError;
+        }
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+}
+//# sourceMappingURL=producer.js.map

package/dist/esm/producer.js.map

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

package/dist/esm/s2.d.ts

@@ -11,8 +11,7 @@ import { S2Metrics } from "./metrics.js";
 export declare class S2 {
     private readonly accessToken;
     private readonly client;
-    private readonly makeBasinBaseUrl;
-    private readonly includeBasinHeader;
+    private readonly endpoints;
     private readonly retryConfig;
     /**
      * Account-scoped basin management operations.

package/dist/esm/s2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"s2.d.ts","sourceRoot":"","sources":["../../src/s2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAShE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAMzC;;;;GAIG;AACH,qBAAa,EAAE;IACd,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;OAIG;IACH,SAAgB,MAAM,EAAE,QAAQ,CAAC;IACjC,kEAAkE;IAClE,SAAgB,YAAY,EAAE,cAAc,CAAC;IAC7C,+CAA+C;IAC/C,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC;;;;OAIG;gBACS,OAAO,EAAE,eAAe;IA0BpC;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM;CAQzB"}
+{"version":3,"file":"s2.d.ts","sourceRoot":"","sources":["../../src/s2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAUhE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,EAAE;IACd,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;OAIG;IACH,SAAgB,MAAM,EAAE,QAAQ,CAAC;IACjC,kEAAkE;IAClE,SAAgB,YAAY,EAAE,cAAc,CAAC;IAC7C,+CAA+C;IAC/C,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC;;;;OAIG;gBACS,OAAO,EAAE,eAAe;IA4BpC;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM;CAQzB"}

package/dist/esm/s2.js

@@ -1,13 +1,12 @@
 import { S2AccessTokens } from "./accessTokens.js";
 import { S2Basin } from "./basin.js";
 import { S2Basins } from "./basins.js";
+import { S2Endpoints } from "./endpoints.js";
 import { makeServerError } from "./error.js";
 import { createClient, createConfig } from "./generated/client/index.js";
 import * as Redacted from "./lib/redacted.js";
 import { canSetUserAgentHeader, DEFAULT_USER_AGENT, } from "./lib/stream/runtime.js";
 import { S2Metrics } from "./metrics.js";
-const defaultBaseUrl = "https://aws.s2.dev/v1";
-const defaultMakeBasinBaseUrl = (basin) => `https://${basin}.b.aws.s2.dev/v1`;
 /**
  * Top-level S2 SDK client.
  *
@@ -16,8 +15,7 @@ const defaultMakeBasinBaseUrl = (basin) => `https://${basin}.b.aws.s2.dev/v1`;
 export class S2 {
     accessToken;
     client;
-    makeBasinBaseUrl;
-    includeBasinHeader;
+    endpoints;
     retryConfig;
     /**
      * Account-scoped basin management operations.
@@ -37,12 +35,16 @@ export class S2 {
     constructor(options) {
         this.accessToken = Redacted.make(options.accessToken);
         this.retryConfig = options.retry ?? {};
+        this.endpoints =
+            options.endpoints instanceof S2Endpoints
+                ? options.endpoints
+                : new S2Endpoints(options.endpoints);
         const headers = {};
         if (canSetUserAgentHeader()) {
             headers["user-agent"] = DEFAULT_USER_AGENT;
         }
         this.client = createClient(createConfig({
-            baseUrl: options.baseUrl ?? defaultBaseUrl,
+            baseUrl: this.endpoints.accountBaseUrl(),
             auth: () => Redacted.value(this.accessToken),
             headers: headers,
         }));
@@ -52,8 +54,6 @@ export class S2 {
         this.basins = new S2Basins(this.client, this.retryConfig);
         this.accessTokens = new S2AccessTokens(this.client, this.retryConfig);
         this.metrics = new S2Metrics(this.client, this.retryConfig);
-        this.makeBasinBaseUrl = options.makeBasinBaseUrl ?? defaultMakeBasinBaseUrl;
-        this.includeBasinHeader = !!options.makeBasinBaseUrl;
     }
     /**
      * Create a basin-scoped client bound to a specific basin name.
@@ -63,8 +63,8 @@ export class S2 {
     basin(name) {
         return new S2Basin(name, {
             accessToken: this.accessToken,
-            baseUrl: this.makeBasinBaseUrl(name),
-            includeBasinHeader: this.includeBasinHeader,
+            baseUrl: this.endpoints.basinBaseUrl(name),
+            includeBasinHeader: this.endpoints.includeBasinHeader,
             retryConfig: this.retryConfig,
         });
     }

package/dist/esm/s2.js.map

@@ -1 +1 @@
-{"version":3,"file":"s2.js","sourceRoot":"","sources":["../../src/s2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACN,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,uBAAuB,GAAG,CAAC,KAAa,EAAE,EAAE,CACjD,WAAW,KAAK,kBAAkB,CAAC;AAEpC;;;;GAIG;AACH,MAAM,OAAO,EAAE;IACG,WAAW,CAAoB;IAC/B,MAAM,CAAS;IACf,gBAAgB,CAA4B;IAC5C,kBAAkB,CAAU;IAC5B,WAAW,CAAc;IAE1C;;;;OAIG;IACa,MAAM,CAAW;IACjC,kEAAkE;IAClD,YAAY,CAAiB;IAC7C,+CAA+C;IAC/B,OAAO,CAAY;IAEnC;;;;OAIG;IACH,YAAY,OAAwB;QACnC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,qBAAqB,EAAE,EAAE,CAAC;YAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,YAAY,CACzB,YAAY,CAAC;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc;YAC1C,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;YAC5C,OAAO,EAAE,OAAO;SAChB,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC/C,OAAO,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;QAC5E,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAY;QACxB,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACpC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;IACJ,CAAC;CACD"}
+{"version":3,"file":"s2.js","sourceRoot":"","sources":["../../src/s2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACN,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;GAIG;AACH,MAAM,OAAO,EAAE;IACG,WAAW,CAAoB;IAC/B,MAAM,CAAS;IACf,SAAS,CAAc;IACvB,WAAW,CAAc;IAE1C;;;;OAIG;IACa,MAAM,CAAW;IACjC,kEAAkE;IAClD,YAAY,CAAiB;IAC7C,+CAA+C;IAC/B,OAAO,CAAY;IAEnC;;;;OAIG;IACH,YAAY,OAAwB;QACnC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,SAAS;YACb,OAAO,CAAC,SAAS,YAAY,WAAW;gBACvC,CAAC,CAAC,OAAO,CAAC,SAAS;gBACnB,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,qBAAqB,EAAE,EAAE,CAAC;YAC7B,OAAO,CAAC,YAAY,CAAC,GAAG,kBAAkB,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,YAAY,CACzB,YAAY,CAAC;YACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE;YACxC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;YAC5C,OAAO,EAAE,OAAO;SAChB,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC/C,OAAO,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAY;QACxB,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC;YAC1C,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB;YACrD,WAAW,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/esm/stream.d.ts

@@ -1,24 +1,32 @@
 import type { RetryConfig, S2RequestOptions } from "./common.js";
 import type { Client } from "./generated/client/types.gen.js";
-import { type AppendAck } from "./generated/index.js";
-import type { AppendArgs, AppendRecord, AppendSession, AppendSessionOptions, ReadArgs, ReadBatch, ReadSession, TransportConfig } from "./lib/stream/types.js";
+import type { AppendSession, ReadSession, TransportConfig } from "./lib/stream/types.js";
+import type * as Types from "./types.js";
+/**
+ * Basin-scoped stream helper for append/read operations.
+ *
+ * Created via {@link S2Basin.stream}. Provides direct methods plus factories for read/append sessions.
+ */
 export declare class S2Stream {
     private readonly client;
     private readonly transportConfig;
     private readonly retryConfig?;
     private _transport?;
+    private closed;
+    private closePromise?;
     readonly name: string;
     constructor(name: string, client: Client, transportConfig: TransportConfig, retryConfig?: RetryConfig);
     /**
      * Get or create the transport instance
      */
     private getTransport;
+    private ensureOpen;
     /**
      * Check the tail of the stream.
      *
      * Returns the next sequence number and timestamp to be assigned (`tail`).
      */
-    checkTail(options?: S2RequestOptions): Promise<import("./generated/types.gen.js").TailResponse>;
+    checkTail(options?: S2RequestOptions): Promise<Types.TailResponse>;
     /**
      * Read records from the stream.
      *
@@ -27,29 +35,33 @@ export declare class S2Stream {
      * - Non-streaming reads are bounded by `count` and `bytes` (defaults 1000 and 1 MiB).
      * - Use `readSession` for streaming reads
      */
-    read<Format extends "string" | "bytes" = "string">(args?: ReadArgs<Format>, options?: S2RequestOptions): Promise<ReadBatch<Format>>;
+    read<Format extends "string" | "bytes" = "string">(input?: Types.ReadInput, options?: S2RequestOptions & {
+        as?: Format;
+    }): Promise<Types.ReadBatch<Format>>;
     /**
-     * Append one or more records to the stream.
+     * Append a batch of records to the stream.
      *
      * - Automatically base64-encodes when format is "bytes".
-     * - Supports conditional appends via `fencing_token` and `match_seq_num`.
+     * - Supports conditional appends via `fencingToken` and `matchSeqNum` in the input.
      * - Returns the acknowledged range and the stream tail after the append.
+     * - All records in a batch must use the same format (either all string or all bytes).
      *
-     * All records in a single append call must use the same format (either all string or all bytes).
+     * Use {@link AppendInput.create} to construct a validated AppendInput.
      * For high-throughput sequential appends, use `appendSession()` instead.
      *
-     * @param records The record(s) to append
-     * @param args Optional append arguments (fencing_token, match_seq_num)
+     * @param input The append input containing records and optional conditions
      * @param options Optional request options
      */
-    append(records: AppendRecord | AppendRecord[], args?: Omit<AppendArgs, "records">, options?: S2RequestOptions): Promise<AppendAck>;
+    append(input: Types.AppendInput, options?: S2RequestOptions): Promise<Types.AppendAck>;
     /**
      * Open a streaming read session
      *
      * Use the returned session as an async iterable or as a readable stream.
      * When `as: "bytes"` is provided, bodies and headers are decoded to `Uint8Array`.
      */
-    readSession<Format extends "string" | "bytes" = "string">(args?: ReadArgs<Format>, options?: S2RequestOptions): Promise<ReadSession<Format>>;
+    readSession<Format extends "string" | "bytes" = "string">(input?: Types.ReadInput, options?: S2RequestOptions & {
+        as?: Format;
+    }): Promise<ReadSession<Format>>;
     /**
      * Create an append session that guarantees ordering of submissions.
      *
@@ -59,6 +71,8 @@ export declare class S2Stream {
      * @param sessionOptions Options that control append session behavior
      * @param requestOptions Optional request options
      */
-    appendSession(sessionOptions?: AppendSessionOptions, requestOptions?: S2RequestOptions): Promise<AppendSession>;
+    appendSession(sessionOptions?: Types.AppendSessionOptions, requestOptions?: S2RequestOptions): Promise<AppendSession>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
 }
 //# sourceMappingURL=stream.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,sBAAsB,CAAC;AAOjE,OAAO,KAAK,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,SAAS,EACT,WAAW,EAEX,eAAe,EACf,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,OAAO,CAAC,UAAU,CAAC,CAAmB;IAEtC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,WAAW,CAAC,EAAE,WAAW;IAQ1B;;OAEG;YACW,YAAY;IAO1B;;;;OAIG;IACU,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB;IAcjD;;;;;;;OAOG;IACU,IAAI,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAC7D,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAK7B;;;;;;;;;;;;;OAaG;IACU,MAAM,CAClB,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,EACtC,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,CAAC;IAuBrB;;;;;OAKG;IACU,WAAW,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACpE,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAI/B;;;;;;;;OAQG;IACU,aAAa,CACzB,cAAc,CAAC,EAAE,oBAAoB,EACrC,cAAc,CAAC,EAAE,gBAAgB,GAC/B,OAAO,CAAC,aAAa,CAAC;CAQzB"}
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAc9D,OAAO,KAAK,EACX,aAAa,EAEb,WAAW,EAEX,eAAe,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAgB;IAErC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,eAAe,EAChC,WAAW,CAAC,EAAE,WAAW;IAQ1B;;OAEG;YACW,YAAY;IAQ1B,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACU,SAAS,CACrB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;IAgB9B;;;;;;;OAOG;IACU,IAAI,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,EACvB,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAuBnC;;;;;;;;;;;;;OAaG;IACU,MAAM,CAClB,KAAK,EAAE,KAAK,CAAC,WAAW,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;IAkB3B;;;;;OAKG;IACU,WAAW,CAAC,MAAM,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,EACpE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,EACvB,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAW/B;;;;;;;;OAQG;IACU,aAAa,CACzB,cAAc,CAAC,EAAE,KAAK,CAAC,oBAAoB,EAC3C,cAAc,CAAC,EAAE,gBAAgB,GAC/B,OAAO,CAAC,aAAa,CAAC;IASZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B7B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5C"}