@s2-dev/streamstore 0.17.5 → 0.18.0

package/README.md

@@ -54,9 +54,77 @@ This TypeScript SDK is an ergonomic way to consume the [S2 REST API](https://s2.
    console.log("My basins:", basins.basins.map((basin) => basin.name));
    ```
 
+## Configuration and retries
+
+The `S2` client and stream sessions support configurable retry behavior:
+
+- Configure global retry behavior when constructing `S2`:
+
+  ```ts
+  import { S2 } from "@s2-dev/streamstore";
+
+  const s2 = new S2({
+    accessToken: process.env.S2_ACCESS_TOKEN!,
+    retry: {
+      // Total attempts including the first call (1 = no retries)
+      maxAttempts: 3,
+      // Base delay (ms) between attempts; jitter is applied
+      retryBackoffDurationMillis: 100,
+      // Retry policy for append operations (see API docs for details)
+      appendRetryPolicy: "noSideEffects",
+      // Maximum time (ms) to wait for an append ack before treating it as failed
+      requestTimeoutMillis: 5000,
+    },
+  });
+  ```
+
+- Stream append/read sessions created from `S2.basin(...).stream(...)` inherit this retry configuration.
+- The `appendRetryPolicy` dictates how failed appends should be retried. If you are not using a concurrency control like `match_seq_num`, then retrying a failed append could result in duplicate data, depending on the nature of the failure. This policy can be set to tolerate potential duplicates by retrying all failures (`"all"`) or only failures guaranteed not to have had a side effect (`"noSideEffects"`). In most cases, `"noSideEffects"` is the safer default unless you have explicit deduplication downstream.
+
+See the generated API docs for the full description of `RetryConfig`, `AppendRetryPolicy` and `AppendSessionOptions`.
+
+## Append sessions
+
+The `AppendSession` represents a session for appending batches of records to a stream. There are two ways of interacting with an append session:
+- via `submit(...)`, which returns a `Promise<AppendAck>` that resolves when the batch is acknowledged by S2.
+- via the session's `.readable` and `.writable` streams (`ReadableStream<AppendAck>` / `WritableStream<AppendArgs>`).
+
+You obtain an append session from a stream via:
+
+```ts
+const session = await stream.appendSession();
+```
+
+All batches submitted to the same append session will be made durable in the same order as they are submitted, regardless of which method is used. Batches _can_ be duplicated, however, depending on the `appendRetryPolicy` used.
+
+### Transports
+
+The append session supports two transports:
+- One based on `fetch`
+- Another which uses our custom [`s2s` protocol](https://s2.dev/docs/rest/records/overview#s2s-spec) over HTTP/2.
+
+When possible, the `s2s` protocol is preferred as it allows for safe pipelining of concurrent appends over the same session, while still enforcing ordering across batches. This can't be guaranteed with the `fetch`-based transport, so it will not pipeline writes (effectively meaning there can only be one inflight, unacknowledged append at a time, thus limiting throughput).
+
+This SDK will attempt to detect whether `s2s` can be used (if the runtime has `node:http2` support), and select a transport accordingly. The transport detection also be overridden via the `forceTransport` option when creating a stream client:
+
+```typescript
+const stream = s2
+    .basin("my-basin")
+    .stream("my-stream", { forceTransport: "fetch" });
+```
+
+### Backpressure
+
+Only writing via `WritableStream` reflects backpressure. A `write(...)` call will resolve as soon as the batch is enqueued for transmission, and will block until there is capacity.
+
+Enqueuing a batch means that the session has accepted the batch, and that it is now inflight. It _doesn't_ mean that the batch has been acknowledged by S2. Because of this, if using `WritableStream`, you should also make sure to `close()` the session, as otherwise you may miss a failure. Only after closing the writer without error can the upstream contents be considered to have been safely appended to the stream.
+
+The `AppendSession` controls how many batches can be inflight at a given time, which is the origin of backpressure. This can be configured by setting either `maxInflightBatches` or `maxInflightBytes` on `AppendSessionOptions`. Writes will block until there is capacity, thus exerting backpressure on upstream writers.
+
+
 ## Examples
 
-The [`examples`](./examples) directory in this repository contains a variety of
+The [`examples`](https://github.com/s2-streamstore/s2-sdk-typescript/tree/main/examples) directory in this repository contains a variety of
 example use cases demonstrating how to use the SDK effectively.
 
 Run any example using the following command:

package/dist/cjs/accessTokens.d.ts

@@ -1,4 +1,4 @@
-import type { DataToObject, S2RequestOptions } from "./common.js";
+import type { DataToObject, RetryConfig, S2RequestOptions } from "./common.js";
 import type { Client } from "./generated/client/types.gen.js";
 import { type IssueAccessTokenData, type ListAccessTokensData, type RevokeAccessTokenData } from "./generated/index.js";
 export interface ListAccessTokensArgs extends DataToObject<ListAccessTokensData> {
@@ -9,7 +9,8 @@ export interface RevokeAccessTokenArgs extends DataToObject<RevokeAccessTokenDat
 }
 export declare class S2AccessTokens {
     readonly client: Client;
-    constructor(client: Client);
+    private readonly retryConfig?;
+    constructor(client: Client, retryConfig?: RetryConfig);
     /**
      * List access tokens.
      *

package/dist/cjs/accessTokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessTokens.d.ts","sourceRoot":"","sources":["../../src/accessTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EACN,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAE1B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,oBAChB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;CAAG;AAC9C,MAAM,WAAW,oBAChB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;CAAG;AAC9C,MAAM,WAAW,qBAChB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;CAAG;AAE/C,qBAAa,cAAc;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAI1B;;;;;;OAMG;IACU,IAAI,CAAC,IAAI,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkBzE;;;;;;;OAOG;IACU,KAAK,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkBzE;;;;OAIG;IACU,MAAM,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,gBAAgB;CAiB3E"}
+{"version":3,"file":"accessTokens.d.ts","sourceRoot":"","sources":["../../src/accessTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EACN,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAEzB,KAAK,qBAAqB,EAE1B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,oBAChB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;CAAG;AAC9C,MAAM,WAAW,oBAChB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;CAAG;AAC9C,MAAM,WAAW,qBAChB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;CAAG;AAE/C,qBAAa,cAAc;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW;IAKrD;;;;;;OAMG;IACU,IAAI,CAAC,IAAI,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAYzE;;;;;;;OAOG;IACU,KAAK,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAYzE;;;;OAIG;IACU,MAAM,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,gBAAgB;CAW3E"}

package/dist/cjs/accessTokens.js

@@ -3,10 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.S2AccessTokens = void 0;
 const error_js_1 = require("./error.js");
 const index_js_1 = require("./generated/index.js");
+const retry_js_1 = require("./lib/retry.js");
 class S2AccessTokens {
     client;
-    constructor(client) {
+    retryConfig;
+    constructor(client, retryConfig) {
         this.client = client;
+        this.retryConfig = retryConfig;
     }
     /**
      * List access tokens.
@@ -16,19 +19,13 @@ class S2AccessTokens {
      * @param args.limit Max results (up to 1000)
      */
     async list(args, options) {
-        const response = await (0, index_js_1.listAccessTokens)({
-            client: this.client,
-            query: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.listAccessTokens)({
+                client: this.client,
+                query: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
     /**
      * Issue a new access token.
@@ -39,19 +36,13 @@ class S2AccessTokens {
      * @param args.expires_at Expiration in ISO 8601; defaults to requestor's token expiry
      */
     async issue(args, options) {
-        const response = await (0, index_js_1.issueAccessToken)({
-            client: this.client,
-            body: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.issueAccessToken)({
+                client: this.client,
+                body: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
     /**
      * Revoke an access token by ID.
@@ -59,19 +50,13 @@ class S2AccessTokens {
      * @param args.id Token ID to revoke
      */
     async revoke(args, options) {
-        const response = await (0, index_js_1.revokeAccessToken)({
-            client: this.client,
-            path: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.revokeAccessToken)({
+                client: this.client,
+                path: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
 }
 exports.S2AccessTokens = S2AccessTokens;

package/dist/cjs/accessTokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessTokens.js","sourceRoot":"","sources":["../../src/accessTokens.ts"],"names":[],"mappings":";;;AACA,yCAAqC;AAErC,mDAO8B;AAS9B,MAAa,cAAc;IACjB,MAAM,CAAS;IAExB,YAAY,MAAc;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,IAA2B,EAAE,OAA0B;QACxE,MAAM,QAAQ,GAAG,MAAM,IAAA,2BAAgB,EAAC;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI;YACX,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAO,CAAC;gBACjB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO;gBAC/B,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS;gBACtC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;aAChC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,KAAK,CAAC,IAA0B,EAAE,OAA0B;QACxE,MAAM,QAAQ,GAAG,MAAM,IAAA,2BAAgB,EAAC;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI;YACV,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAO,CAAC;gBACjB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO;gBAC/B,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS;gBACtC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;aAChC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAC,IAA2B,EAAE,OAA0B;QAC1E,MAAM,QAAQ,GAAG,MAAM,IAAA,4BAAiB,EAAC;YACxC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI;YACV,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAO,CAAC;gBACjB,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO;gBAC/B,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS;gBACtC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;aAChC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC;IACtB,CAAC;CACD;AAhFD,wCAgFC"}
+{"version":3,"file":"accessTokens.js","sourceRoot":"","sources":["../../src/accessTokens.ts"],"names":[],"mappings":";;;AACA,yCAAiD;AAEjD,mDAO8B;AAC9B,6CAA6C;AAS7C,MAAa,cAAc;IACjB,MAAM,CAAS;IACP,WAAW,CAAe;IAE3C,YAAY,MAAc,EAAE,WAAyB;QACpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAAC,IAA2B,EAAE,OAA0B;QACxE,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,2BAAgB,EAAC;gBAChB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI;gBACX,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,KAAK,CAAC,IAA0B,EAAE,OAA0B;QACxE,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,2BAAgB,EAAC;gBAChB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAC,IAA2B,EAAE,OAA0B;QAC1E,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,4BAAiB,EAAC;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAhED,wCAgEC"}

package/dist/cjs/basin.d.ts

@@ -1,3 +1,4 @@
+import type { RetryConfig } from "./common.js";
 import * as Redacted from "./lib/redacted.js";
 import type { SessionTransports } from "./lib/stream/types.js";
 import { S2Stream } from "./stream.js";
@@ -5,6 +6,7 @@ import { S2Streams } from "./streams.js";
 export declare class S2Basin {
     private readonly client;
     private readonly transportConfig;
+    private readonly retryConfig?;
     readonly name: string;
     readonly streams: S2Streams;
     /**
@@ -12,14 +14,13 @@ export declare class S2Basin {
      *
      * Use this to work with streams inside a single basin.
      * @param name Basin name
-     * @param accessToken Redacted access token from the parent `S2` client
-     * @param baseUrl Base URL for the basin (e.g. `https://my-basin.b.aws.s2.dev/v1`)
-     * @param includeBasinHeader Include the `S2-Basin` header with the request
+     * @param options Configuration for the basin-scoped client
      */
     constructor(name: string, options: {
         accessToken: Redacted.Redacted;
         baseUrl: string;
         includeBasinHeader: boolean;
+        retryConfig?: RetryConfig;
     });
     /**
      * Create a stream-scoped helper bound to `this` basin.

package/dist/cjs/basin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basin.d.ts","sourceRoot":"","sources":["../../src/basin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC;;;;;;;;OAQG;gBAEF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACR,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,kBAAkB,EAAE,OAAO,CAAC;KAC5B;IAiBF;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;CAMnD;AAED,MAAM,WAAW,aAAa;IAC7B,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACnC"}
+{"version":3,"file":"basin.d.ts","sourceRoot":"","sources":["../../src/basin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC;;;;;;OAMG;gBAEF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACR,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;KAC1B;IAqBF;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;CAWnD;AAED,MAAM,WAAW,aAAa;IAC7B,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACnC"}

package/dist/cjs/basin.js

@@ -8,6 +8,7 @@ const streams_js_1 = require("./streams.js");
 class S2Basin {
     client;
     transportConfig;
+    retryConfig;
     name;
     streams;
     /**
@@ -15,22 +16,23 @@ class S2Basin {
      *
      * Use this to work with streams inside a single basin.
      * @param name Basin name
-     * @param accessToken Redacted access token from the parent `S2` client
-     * @param baseUrl Base URL for the basin (e.g. `https://my-basin.b.aws.s2.dev/v1`)
-     * @param includeBasinHeader Include the `S2-Basin` header with the request
+     * @param options Configuration for the basin-scoped client
      */
     constructor(name, options) {
         this.name = name;
+        this.retryConfig = options.retryConfig;
         this.transportConfig = {
             baseUrl: options.baseUrl,
             accessToken: options.accessToken,
+            basinName: options.includeBasinHeader ? name : undefined,
+            retry: options.retryConfig,
         };
         this.client = (0, index_js_1.createClient)((0, index_js_1.createConfig)({
             baseUrl: options.baseUrl,
             auth: () => Redacted.value(this.transportConfig.accessToken),
             headers: options.includeBasinHeader ? { "s2-basin": name } : {},
         }));
-        this.streams = new streams_js_1.S2Streams(this.client);
+        this.streams = new streams_js_1.S2Streams(this.client, this.retryConfig);
     }
     /**
      * Create a stream-scoped helper bound to `this` basin.
@@ -40,7 +42,7 @@ class S2Basin {
         return new stream_js_1.S2Stream(name, this.client, {
             ...this.transportConfig,
             forceTransport: options?.forceTransport,
-        });
+        }, this.retryConfig);
     }
 }
 exports.S2Basin = S2Basin;

package/dist/cjs/basin.js.map

@@ -1 +1 @@
-{"version":3,"file":"basin.js","sourceRoot":"","sources":["../../src/basin.ts"],"names":[],"mappings":";;;AAAA,0DAAyE;AAEzE,8CAA8C;AAE9C,2CAAuC;AACvC,6CAAyC;AAEzC,MAAa,OAAO;IACF,MAAM,CAAS;IACf,eAAe,CAAkB;IAClC,IAAI,CAAS;IACb,OAAO,CAAY;IAEnC;;;;;;;;OAQG;IACH,YACC,IAAY,EACZ,OAIC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;SAChC,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAA,uBAAY,EACzB,IAAA,uBAAY,EAAC;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;YAC5D,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;SAC/D,CAAC,CACF,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,IAAY,EAAE,OAAuB;QAClD,OAAO,IAAI,oBAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;YACtC,GAAG,IAAI,CAAC,eAAe;YACvB,cAAc,EAAE,OAAO,EAAE,cAAc;SACvC,CAAC,CAAC;IACJ,CAAC;CACD;AAhDD,0BAgDC"}
+{"version":3,"file":"basin.js","sourceRoot":"","sources":["../../src/basin.ts"],"names":[],"mappings":";;;AACA,0DAAyE;AAEzE,8CAA8C;AAE9C,2CAAuC;AACvC,6CAAyC;AAEzC,MAAa,OAAO;IACF,MAAM,CAAS;IACf,eAAe,CAAkB;IACjC,WAAW,CAAe;IAC3B,IAAI,CAAS;IACb,OAAO,CAAY;IAEnC;;;;;;OAMG;IACH,YACC,IAAY,EACZ,OAKC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACxD,KAAK,EAAE,OAAO,CAAC,WAAW;SAC1B,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAA,uBAAY,EACzB,IAAA,uBAAY,EAAC;YACZ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;YAC5D,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;SAC/D,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,OAAO,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,IAAY,EAAE,OAAuB;QAClD,OAAO,IAAI,oBAAQ,CAClB,IAAI,EACJ,IAAI,CAAC,MAAM,EACX;YACC,GAAG,IAAI,CAAC,eAAe;YACvB,cAAc,EAAE,OAAO,EAAE,cAAc;SACvC,EACD,IAAI,CAAC,WAAW,CAChB,CAAC;IACH,CAAC;CACD;AAzDD,0BAyDC"}

package/dist/cjs/basins.d.ts

@@ -1,6 +1,6 @@
-import type { DataToObject, S2RequestOptions } from "./common.js";
+import type { DataToObject, RetryConfig, S2RequestOptions } from "./common.js";
 import type { Client } from "./generated/client/types.gen.js";
-import { type CreateBasinData, type DeleteBasinData, type GetBasinConfigData, type ListBasinsData, type ReconfigureBasinData } from "./generated/index.js";
+import { type BasinConfig, type CreateBasinData, type CreateBasinResponse, type DeleteBasinData, type GetBasinConfigData, type ListBasinsData, type ListBasinsResponse, type ReconfigureBasinData, type ReconfigureBasinResponse } from "./generated/index.js";
 export interface ListBasinsArgs extends DataToObject<ListBasinsData> {
 }
 export interface CreateBasinArgs extends DataToObject<CreateBasinData> {
@@ -13,7 +13,8 @@ export interface ReconfigureBasinArgs extends DataToObject<ReconfigureBasinData>
 }
 export declare class S2Basins {
     private readonly client;
-    constructor(client: Client);
+    private readonly retryConfig;
+    constructor(client: Client, retryConfig: RetryConfig);
     /**
      * List basins.
      *
@@ -21,7 +22,7 @@ export declare class S2Basins {
      * @param args.start_after Name to start after (for pagination)
      * @param args.limit Max results (up to 1000)
      */
-    list(args?: ListBasinsArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").ListBasinsResponse>;
+    list(args?: ListBasinsArgs, options?: S2RequestOptions): Promise<ListBasinsResponse>;
     /**
      * Create a basin.
      *
@@ -29,25 +30,24 @@ export declare class S2Basins {
      * @param args.config Optional basin configuration (e.g. default stream config)
      * @param args.scope Basin scope
      */
-    create(args: CreateBasinArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").BasinInfo>;
+    create(args: CreateBasinArgs, options?: S2RequestOptions): Promise<CreateBasinResponse>;
     /**
      * Get basin configuration.
      *
      * @param args.basin Basin name
      */
-    getConfig(args: GetBasinConfigArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").BasinConfig>;
+    getConfig(args: GetBasinConfigArgs, options?: S2RequestOptions): Promise<BasinConfig>;
     /**
      * Delete a basin.
      *
      * @param args.basin Basin name
      */
-    delete(args: DeleteBasinArgs, options?: S2RequestOptions): Promise<unknown>;
+    delete(args: DeleteBasinArgs, options?: S2RequestOptions): Promise<void>;
     /**
      * Reconfigure a basin.
      *
-     * @param args.basin Basin name
-     * @param args.body Configuration fields to change (e.g. default stream config)
+     * @param args Configuration for the basin to reconfigure (including basin name and fields to change)
      */
-    reconfigure(args: ReconfigureBasinArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").BasinConfig>;
+    reconfigure(args: ReconfigureBasinArgs, options?: S2RequestOptions): Promise<ReconfigureBasinResponse>;
 }
 //# sourceMappingURL=basins.d.ts.map

package/dist/cjs/basins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basins.d.ts","sourceRoot":"","sources":["../../src/basins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EACN,KAAK,eAAe,EAEpB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAEzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAe,SAAQ,YAAY,CAAC,cAAc,CAAC;CAAG;AACvE,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;CAAG;AACzE,MAAM,WAAW,kBAAmB,SAAQ,YAAY,CAAC,kBAAkB,CAAC;CAAG;AAC/E,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;CAAG;AACzE,MAAM,WAAW,oBAChB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;CAAG;AAE9C,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAI1B;;;;;;OAMG;IACU,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkBnE;;;;;;OAMG;IACU,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkBrE;;;;OAIG;IACU,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkB3E;;;;OAIG;IACU,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAkBrE;;;;;OAKG;IACU,WAAW,CACvB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,gBAAgB;CAmB3B"}
+{"version":3,"file":"basins.d.ts","sourceRoot":"","sources":["../../src/basins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAExB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAE7B,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,cAAe,SAAQ,YAAY,CAAC,cAAc,CAAC;CAAG;AACvE,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;CAAG;AACzE,MAAM,WAAW,kBAAmB,SAAQ,YAAY,CAAC,kBAAkB,CAAC;CAAG;AAC/E,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,eAAe,CAAC;CAAG;AACzE,MAAM,WAAW,oBAChB,SAAQ,YAAY,CAAC,oBAAoB,CAAC;CAAG;AAE9C,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW;IAKpD;;;;;;OAMG;IACU,IAAI,CAChB,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAY9B;;;;;;OAMG;IACU,MAAM,CAClB,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAY/B;;;;OAIG;IACU,SAAS,CACrB,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC;IAYvB;;;;OAIG;IACU,MAAM,CAClB,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACU,WAAW,CACvB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,wBAAwB,CAAC;CAYpC"}

package/dist/cjs/basins.js

@@ -3,10 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.S2Basins = void 0;
 const error_js_1 = require("./error.js");
 const index_js_1 = require("./generated/index.js");
+const retry_js_1 = require("./lib/retry.js");
 class S2Basins {
     client;
-    constructor(client) {
+    retryConfig;
+    constructor(client, retryConfig) {
         this.client = client;
+        this.retryConfig = retryConfig;
     }
     /**
      * List basins.
@@ -16,19 +19,13 @@ class S2Basins {
      * @param args.limit Max results (up to 1000)
      */
     async list(args, options) {
-        const response = await (0, index_js_1.listBasins)({
-            client: this.client,
-            query: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.listBasins)({
+                client: this.client,
+                query: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
     /**
      * Create a basin.
@@ -38,19 +35,13 @@ class S2Basins {
      * @param args.scope Basin scope
      */
     async create(args, options) {
-        const response = await (0, index_js_1.createBasin)({
-            client: this.client,
-            body: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.createBasin)({
+                client: this.client,
+                body: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
     /**
      * Get basin configuration.
@@ -58,19 +49,13 @@ class S2Basins {
      * @param args.basin Basin name
      */
     async getConfig(args, options) {
-        const response = await (0, index_js_1.getBasinConfig)({
-            client: this.client,
-            path: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.getBasinConfig)({
+                client: this.client,
+                path: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
     /**
      * Delete a basin.
@@ -78,41 +63,28 @@ class S2Basins {
      * @param args.basin Basin name
      */
     async delete(args, options) {
-        const response = await (0, index_js_1.deleteBasin)({
-            client: this.client,
-            path: args,
-            ...options,
+        await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.deleteBasin)({
+                client: this.client,
+                path: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
     /**
      * Reconfigure a basin.
      *
-     * @param args.basin Basin name
-     * @param args.body Configuration fields to change (e.g. default stream config)
+     * @param args Configuration for the basin to reconfigure (including basin name and fields to change)
      */
     async reconfigure(args, options) {
-        const response = await (0, index_js_1.reconfigureBasin)({
-            client: this.client,
-            path: args,
-            body: args,
-            ...options,
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.reconfigureBasin)({
+                client: this.client,
+                path: args,
+                body: args,
+                ...options,
+            }));
         });
-        if (response.error) {
-            throw new error_js_1.S2Error({
-                message: response.error.message,
-                code: response.error.code ?? undefined,
-                status: response.response.status,
-            });
-        }
-        return response.data;
     }
 }
 exports.S2Basins = S2Basins;

package/dist/cjs/basins.js.map

@@ -1 +1 @@
-{"version":3,"file":"basins.js","sourceRoot":"","sources":["../../src/basins.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"basins.js","sourceRoot":"","sources":["../../src/basins.ts"],"names":[],"mappings":";;;AACA,yCAAwC;AAExC,mDAe8B;AAC9B,6CAA6C;AAS7C,MAAa,QAAQ;IACH,MAAM,CAAS;IACf,WAAW,CAAc;IAE1C,YAAY,MAAc,EAAE,WAAwB;QACnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,IAAI,CAChB,IAAqB,EACrB,OAA0B;QAE1B,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,qBAAU,EAAC;gBACV,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI;gBACX,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAClB,IAAqB,EACrB,OAA0B;QAE1B,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,sBAAW,EAAC;gBACX,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CACrB,IAAwB,EACxB,OAA0B;QAE1B,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,yBAAc,EAAC;gBACd,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAClB,IAAqB,EACrB,OAA0B;QAE1B,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YAC9C,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,sBAAW,EAAC;gBACX,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,WAAW,CACvB,IAA0B,EAC1B,OAA0B;QAE1B,OAAO,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE;YACrD,OAAO,MAAM,IAAA,qBAAU,EAAC,GAAG,EAAE,CAC5B,IAAA,2BAAgB,EAAC;gBAChB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,IAAI;gBACV,GAAG,OAAO;aACV,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAjHD,4BAiHC"}

package/dist/cjs/batch-transform.d.ts

@@ -26,7 +26,7 @@ export type BatchOutput = {
  * @example
  * ```typescript
  * const batcher = new BatchTransform<"string">({
- *   lingerDuration: 20,
+ *   lingerDurationMillis: 20,
  *   maxBatchRecords: 100,
  *   maxBatchBytes: 256 * 1024,
  *   match_seq_num: 0  // Optional: auto-increments per batch

package/dist/cjs/batch-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch-transform.d.ts","sourceRoot":"","sources":["../../src/batch-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IAClC,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,cAAe,SAAQ,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC;IAC7E,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,UAAU,CACZ;IACN,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,kBAAkB,CAAC,CAAS;gBAExB,IAAI,CAAC,EAAE,kBAAkB;IA8BrC,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,KAAK;IAgCb,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;CAMzB"}
+{"version":3,"file":"batch-transform.d.ts","sourceRoot":"","sources":["../../src/batch-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,kBAAkB;IAClC,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,cAAe,SAAQ,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC;IAC7E,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,UAAU,CACZ;IACN,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,kBAAkB,CAAC,CAAS;gBAExB,IAAI,CAAC,EAAE,kBAAkB;IAyDrC,OAAO,CAAC,YAAY;IA4CpB,OAAO,CAAC,KAAK;IAgCb,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;CAMzB"}

package/dist/cjs/batch-transform.js

@@ -12,7 +12,7 @@ const utils_js_1 = require("./utils.js");
  * @example
  * ```typescript
  * const batcher = new BatchTransform<"string">({
- *   lingerDuration: 20,
+ *   lingerDurationMillis: 20,
  *   maxBatchRecords: 100,
  *   maxBatchBytes: 256 * 1024,
  *   match_seq_num: 0  // Optional: auto-increments per batch
@@ -58,19 +58,50 @@ class BatchTransform extends TransformStream {
                 this.flush();
             },
         });
-        // Cap at maximum allowed values
-        this.maxBatchRecords = Math.min(args?.maxBatchRecords ?? 1000, 1000);
-        this.maxBatchBytes = Math.min(args?.maxBatchBytes ?? 1024 * 1024, 1024 * 1024);
+        // Validate configuration
+        if (args?.maxBatchRecords !== undefined) {
+            if (args.maxBatchRecords < 1 || args.maxBatchRecords > 1000) {
+                throw new error_js_1.S2Error({
+                    message: `maxBatchRecords must be between 1 and 1000 (inclusive); got ${args.maxBatchRecords}`,
+                    status: 400,
+                    origin: "sdk",
+                });
+            }
+        }
+        if (args?.maxBatchBytes !== undefined) {
+            const max = 1024 * 1024;
+            if (args.maxBatchBytes < 1 || args.maxBatchBytes > max) {
+                throw new error_js_1.S2Error({
+                    message: `maxBatchBytes must be between 1 and ${max} (1 MiB) bytes (inclusive); got ${args.maxBatchBytes}`,
+                    status: 400,
+                    origin: "sdk",
+                });
+            }
+        }
+        if (args?.lingerDurationMillis !== undefined) {
+            if (args.lingerDurationMillis < 0) {
+                throw new error_js_1.S2Error({
+                    message: `lingerDurationMillis must be >= 0; got ${args.lingerDurationMillis}`,
+                    status: 400,
+                    origin: "sdk",
+                });
+            }
+        }
+        // Apply defaults
+        this.maxBatchRecords = args?.maxBatchRecords ?? 1000;
+        this.maxBatchBytes = args?.maxBatchBytes ?? 1024 * 1024;
         this.lingerDuration = args?.lingerDurationMillis ?? 5;
         this.fencing_token = args?.fencing_token;
         this.next_match_seq_num = args?.match_seq_num;
     }
     handleRecord(record) {
-        const recordSize = (0, utils_js_1.meteredSizeBytes)(record);
+        const recordSize = (0, utils_js_1.meteredBytes)(record);
         // Reject individual records that exceed the max batch size
         if (recordSize > this.maxBatchBytes) {
             throw new error_js_1.S2Error({
                 message: `Record size ${recordSize} bytes exceeds maximum batch size of ${this.maxBatchBytes} bytes`,
+                status: 400,
+                origin: "sdk",
             });
         }
         // Start linger timer on first record added to an empty batch