@s2-dev/streamstore 0.20.0 → 0.21.0

package/LICENSE

@@ -1,201 +1,21 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1.  Definitions.
-
-    "License" shall mean the terms and conditions for use, reproduction,
-    and distribution as defined by Sections 1 through 9 of this document.
-
-    "Licensor" shall mean the copyright owner or entity authorized by
-    the copyright owner that is granting the License.
-
-    "Legal Entity" shall mean the union of the acting entity and all
-    other entities that control, are controlled by, or are under common
-    control with that entity. For the purposes of this definition,
-    "control" means (i) the power, direct or indirect, to cause the
-    direction or management of such entity, whether by contract or
-    otherwise, or (ii) ownership of fifty percent (50%) or more of the
-    outstanding shares, or (iii) beneficial ownership of such entity.
-
-    "You" (or "Your") shall mean an individual or Legal Entity
-    exercising permissions granted by this License.
-
-    "Source" form shall mean the preferred form for making modifications,
-    including but not limited to software source code, documentation
-    source, and configuration files.
-
-    "Object" form shall mean any form resulting from mechanical
-    transformation or translation of a Source form, including but
-    not limited to compiled object code, generated documentation,
-    and conversions to other media types.
-
-    "Work" shall mean the work of authorship, whether in Source or
-    Object form, made available under the License, as indicated by a
-    copyright notice that is included in or attached to the work
-    (an example is provided in the Appendix below).
-
-    "Derivative Works" shall mean any work, whether in Source or Object
-    form, that is based on (or derived from) the Work and for which the
-    editorial revisions, annotations, elaborations, or other modifications
-    represent, as a whole, an original work of authorship. For the purposes
-    of this License, Derivative Works shall not include works that remain
-    separable from, or merely link (or bind by name) to the interfaces of,
-    the Work and Derivative Works thereof.
-
-    "Contribution" shall mean any work of authorship, including
-    the original version of the Work and any modifications or additions
-    to that Work or Derivative Works thereof, that is intentionally
-    submitted to Licensor for inclusion in the Work by the copyright owner
-    or by an individual or Legal Entity authorized to submit on behalf of
-    the copyright owner. For the purposes of this definition, "submitted"
-    means any form of electronic, verbal, or written communication sent
-    to the Licensor or its representatives, including but not limited to
-    communication on electronic mailing lists, source code control systems,
-    and issue tracking systems that are managed by, or on behalf of, the
-    Licensor for the purpose of discussing and improving the Work, but
-    excluding communication that is conspicuously marked or otherwise
-    designated in writing by the copyright owner as "Not a Contribution."
-
-    "Contributor" shall mean Licensor and any individual or Legal Entity
-    on behalf of whom a Contribution has been received by Licensor and
-    subsequently incorporated within the Work.
-
-2.  Grant of Copyright License. Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    copyright license to reproduce, prepare Derivative Works of,
-    publicly display, publicly perform, sublicense, and distribute the
-    Work and such Derivative Works in Source or Object form.
-
-3.  Grant of Patent License. Subject to the terms and conditions of
-    this License, each Contributor hereby grants to You a perpetual,
-    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-    (except as stated in this section) patent license to make, have made,
-    use, offer to sell, sell, import, and otherwise transfer the Work,
-    where such license applies only to those patent claims licensable
-    by such Contributor that are necessarily infringed by their
-    Contribution(s) alone or by combination of their Contribution(s)
-    with the Work to which such Contribution(s) was submitted. If You
-    institute patent litigation against any entity (including a
-    cross-claim or counterclaim in a lawsuit) alleging that the Work
-    or a Contribution incorporated within the Work constitutes direct
-    or contributory patent infringement, then any patent licenses
-    granted to You under this License for that Work shall terminate
-    as of the date such litigation is filed.
-
-4.  Redistribution. You may reproduce and distribute copies of the
-    Work or Derivative Works thereof in any medium, with or without
-    modifications, and in Source or Object form, provided that You
-    meet the following conditions:
-
-    (a) You must give any other recipients of the Work or
-    Derivative Works a copy of this License; and
-
-    (b) You must cause any modified files to carry prominent notices
-    stating that You changed the files; and
-
-    (c) You must retain, in the Source form of any Derivative Works
-    that You distribute, all copyright, patent, trademark, and
-    attribution notices from the Source form of the Work,
-    excluding those notices that do not pertain to any part of
-    the Derivative Works; and
-
-    (d) If the Work includes a "NOTICE" text file as part of its
-    distribution, then any Derivative Works that You distribute must
-    include a readable copy of the attribution notices contained
-    within such NOTICE file, excluding those notices that do not
-    pertain to any part of the Derivative Works, in at least one
-    of the following places: within a NOTICE text file distributed
-    as part of the Derivative Works; within the Source form or
-    documentation, if provided along with the Derivative Works; or,
-    within a display generated by the Derivative Works, if and
-    wherever such third-party notices normally appear. The contents
-    of the NOTICE file are for informational purposes only and
-    do not modify the License. You may add Your own attribution
-    notices within Derivative Works that You distribute, alongside
-    or as an addendum to the NOTICE text from the Work, provided
-    that such additional attribution notices cannot be construed
-    as modifying the License.
-
-    You may add Your own copyright statement to Your modifications and
-    may provide additional or different license terms and conditions
-    for use, reproduction, or distribution of Your modifications, or
-    for any such Derivative Works as a whole, provided Your use,
-    reproduction, and distribution of the Work otherwise complies with
-    the conditions stated in this License.
-
-5.  Submission of Contributions. Unless You explicitly state otherwise,
-    any Contribution intentionally submitted for inclusion in the Work
-    by You to the Licensor shall be under the terms and conditions of
-    this License, without any additional terms or conditions.
-    Notwithstanding the above, nothing herein shall supersede or modify
-    the terms of any separate license agreement you may have executed
-    with Licensor regarding such Contributions.
-
-6.  Trademarks. This License does not grant permission to use the trade
-    names, trademarks, service marks, or product names of the Licensor,
-    except as required for reasonable and customary use in describing the
-    origin of the Work and reproducing the content of the NOTICE file.
-
-7.  Disclaimer of Warranty. Unless required by applicable law or
-    agreed to in writing, Licensor provides the Work (and each
-    Contributor provides its Contributions) on an "AS IS" BASIS,
-    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-    implied, including, without limitation, any warranties or conditions
-    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-    PARTICULAR PURPOSE. You are solely responsible for determining the
-    appropriateness of using or redistributing the Work and assume any
-    risks associated with Your exercise of permissions under this License.
-
-8.  Limitation of Liability. In no event and under no legal theory,
-    whether in tort (including negligence), contract, or otherwise,
-    unless required by applicable law (such as deliberate and grossly
-    negligent acts) or agreed to in writing, shall any Contributor be
-    liable to You for damages, including any direct, indirect, special,
-    incidental, or consequential damages of any character arising as a
-    result of this License or out of the use or inability to use the
-    Work (including but not limited to damages for loss of goodwill,
-    work stoppage, computer failure or malfunction, or any and all
-    other commercial damages or losses), even if such Contributor
-    has been advised of the possibility of such damages.
-
-9.  Accepting Warranty or Additional Liability. While redistributing
-    the Work or Derivative Works thereof, You may choose to offer,
-    and charge a fee for, acceptance of support, warranty, indemnity,
-    or other liability obligations and/or rights consistent with this
-    License. However, in accepting such obligations, You may act only
-    on Your own behalf and on Your sole responsibility, not on behalf
-    of any other Contributor, and only if You agree to indemnify,
-    defend, and hold each Contributor harmless for any liability
-    incurred by, or claims asserted against, such Contributor by reason
-    of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-Copyright [yyyy] [name of copyright owner]
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+MIT License
+
+Copyright (c) 2026 Stream Store
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -18,26 +18,76 @@ bun add @s2-dev/streamstore
 
 Generate an access token from the S2 console at <https://s2.dev/dashboard>, then:
 
+<!-- snippet:start quick-start -->
 ```ts
-import { S2, AppendRecord } from "@s2-dev/streamstore";
+import {
+	AppendAck,
+	AppendInput,
+	AppendRecord,
+	S2,
+	S2Environment,
+} from "@s2-dev/streamstore";
+
+const basinName = process.env.S2_BASIN ?? "my-existing-basin";
+const streamName = process.env.S2_STREAM ?? "my-new-stream";
 
 const s2 = new S2({
-  accessToken: process.env.S2_ACCESS_TOKEN!,
+	...S2Environment.parse(),
+	accessToken: process.env.S2_ACCESS_TOKEN ?? "my-access-token",
 });
 
-const basin = s2.basin("my-basin");
-const stream = basin.stream("my-stream");
+// Create a basin (namespace) client for basin-level operations.
+const basin = s2.basin(basinName);
+
+// Make a new stream within the basin, using the default configuration.
+const streamResponse = await basin.streams.create({ stream: streamName });
+console.dir(streamResponse, { depth: null });
+
+// Create a stream client on our new stream.
+const stream = basin.stream(streamName);
+
+// Make a single append call.
+const append: Promise<AppendAck> = stream.append(
+	// `append` expects an input batch of one or many records.
+	AppendInput.create([
+		// Records can use a string encoding...
+		AppendRecord.string({
+			body: "Hello from the docs snippet!",
+			headers: [["content-type", "text/plain"]],
+		}),
+		// ...or contain raw binary data.
+		AppendRecord.bytes({
+			body: new TextEncoder().encode("Bytes payload"),
+		}),
+	]),
+);
 
-await stream.append([
-  AppendRecord.make("Hello, world!", { foo: "bar" }),
-]);
+// When the promise resolves, the data is fully durable and present on the stream.
+const ack = await append;
+console.log(
+	`Appended records ${ack.start.seqNum} through ${ack.end.seqNum} (exclusive).`,
+);
+console.dir(ack, { depth: null });
 
-const result = await stream.read({ seq_num: 0, count: 10 });
-console.log(result.records);
+// Read the two records back as binary.
+const batch = await stream.read(
+	{
+		start: { from: { seqNum: ack.start.seqNum } },
+		stop: { limits: { count: 2 } },
+	},
+	{ as: "bytes" },
+);
+
+for (const record of batch.records) {
+	console.dir(record, { depth: null });
+	console.log("decoded body: %s", new TextDecoder().decode(record.body));
+}
 ```
+<!-- snippet:end quick-start -->
+
+> Tip: snippets look for `S2_ACCESS_TOKEN`, `S2_BASIN`, and `S2_STREAM` so you can run them with `npx tsx examples/<file>.ts`.
 
 ## More documentation
 
 - Full SDK overview and additional examples: see the root repo README at <https://github.com/s2-streamstore/s2-sdk-typescript>.
 - S2 service docs: <https://s2.dev/docs>.
-

package/dist/cjs/accessTokens.d.ts

@@ -1,12 +1,11 @@
-import type { DataToObject, RetryConfig, S2RequestOptions } from "./common.js";
+import type { 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> {
-}
-export interface IssueAccessTokenArgs extends DataToObject<IssueAccessTokenData> {
-}
-export interface RevokeAccessTokenArgs extends DataToObject<RevokeAccessTokenData> {
-}
+import type * as Types from "./types.js";
+/**
+ * Account-scoped helper for listing, issuing, and revoking access tokens.
+ *
+ * Acquire via {@link S2.accessTokens}. Use {@link S2AccessTokens.listAll} for async iteration.
+ */
 export declare class S2AccessTokens {
     readonly client: Client;
     private readonly retryConfig?;
@@ -15,24 +14,38 @@ export declare class S2AccessTokens {
      * List access tokens.
      *
      * @param args.prefix Filter to IDs beginning with this prefix
-     * @param args.start_after Filter to IDs lexicographically after this value
+     * @param args.startAfter Filter to IDs lexicographically after this value
      * @param args.limit Max results (up to 1000)
      */
-    list(args?: ListAccessTokensArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").ListAccessTokensResponse>;
+    list(args?: Types.ListAccessTokensInput, options?: S2RequestOptions): Promise<Types.ListAccessTokensResponse>;
+    /**
+     * List all access tokens with automatic pagination.
+     * Returns a lazy async iterable that fetches pages as needed.
+     *
+     * @param args - Optional filtering options: `prefix` to filter by ID prefix, `limit` for max results per page
+     *
+     * @example
+     * ```ts
+     * for await (const token of s2.accessTokens.listAll({ prefix: "service-" })) {
+     *   console.log(token.id);
+     * }
+     * ```
+     */
+    listAll(args?: Types.ListAllAccessTokensInput, options?: S2RequestOptions): AsyncIterable<Types.AccessTokenInfo>;
     /**
      * Issue a new access token.
      *
      * @param args.id Unique token ID (1-96 bytes)
      * @param args.scope Token scope (operations and resource sets)
-     * @param args.auto_prefix_streams Namespace stream names by configured prefix scope
-     * @param args.expires_at Expiration in ISO 8601; defaults to requestor's token expiry
+     * @param args.autoPrefixStreams Namespace stream names by configured prefix scope
+     * @param args.expiresAt Expiration time (Date or RFC 3339 string); defaults to requestor's token expiry
      */
-    issue(args: IssueAccessTokenArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").IssueAccessTokenResponse>;
+    issue(args: Types.IssueAccessTokenInput, options?: S2RequestOptions): Promise<Types.IssueAccessTokenResponse>;
     /**
      * Revoke an access token by ID.
      *
      * @param args.id Token ID to revoke
      */
-    revoke(args: RevokeAccessTokenArgs, options?: S2RequestOptions): Promise<unknown>;
+    revoke(args: Types.RevokeAccessTokenInput, options?: S2RequestOptions): Promise<void>;
 }
 //# sourceMappingURL=accessTokens.d.ts.map

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,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"}
+{"version":3,"file":"accessTokens.d.ts","sourceRoot":"","sources":["../../src/accessTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAS9D,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AA4BzC;;;;GAIG;AACH,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,CAChB,IAAI,CAAC,EAAE,KAAK,CAAC,qBAAqB,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAiB1C;;;;;;;;;;;;OAYG;IACI,OAAO,CACb,IAAI,CAAC,EAAE,KAAK,CAAC,wBAAwB,EACrC,OAAO,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC;IAYvC;;;;;;;OAOG;IACU,KAAK,CACjB,IAAI,EAAE,KAAK,CAAC,qBAAqB,EACjC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAkB1C;;;;OAIG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,sBAAsB,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;CAWhB"}

package/dist/cjs/accessTokens.js

@@ -3,7 +3,41 @@ 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 case_transform_js_1 = require("./internal/case-transform.js");
+const paginate_js_1 = require("./lib/paginate.js");
 const retry_js_1 = require("./lib/retry.js");
+/** Convert expiresAt input (Date, milliseconds, or string) to RFC 3339 string for API. */
+function toISOString(value) {
+    if (value === null)
+        return null;
+    if (value === undefined)
+        return undefined;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "number")
+        return new Date(value).toISOString();
+    return value;
+}
+/** Convert expiresAt from API (ISO string) to Date. */
+function toDate(value) {
+    if (value === null)
+        return null;
+    if (value === undefined)
+        return undefined;
+    return new Date(value);
+}
+/** Transform AccessTokenInfo response: convert expiresAt to Date. */
+function transformTokenInfo(token) {
+    return {
+        ...token,
+        expiresAt: toDate(token.expiresAt),
+    };
+}
+/**
+ * Account-scoped helper for listing, issuing, and revoking access tokens.
+ *
+ * Acquire via {@link S2.accessTokens}. Use {@link S2AccessTokens.listAll} for async iteration.
+ */
 class S2AccessTokens {
     client;
     retryConfig;
@@ -15,34 +49,64 @@ class S2AccessTokens {
      * List access tokens.
      *
      * @param args.prefix Filter to IDs beginning with this prefix
-     * @param args.start_after Filter to IDs lexicographically after this value
+     * @param args.startAfter Filter to IDs lexicographically after this value
      * @param args.limit Max results (up to 1000)
      */
     async list(args, options) {
-        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+        const response = 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,
+                query: (0, case_transform_js_1.toSnakeCase)(args),
                 ...options,
             }));
         });
+        const camelCased = (0, case_transform_js_1.toCamelCase)(response);
+        return {
+            ...camelCased,
+            accessTokens: camelCased.accessTokens.map(transformTokenInfo),
+        };
+    }
+    /**
+     * List all access tokens with automatic pagination.
+     * Returns a lazy async iterable that fetches pages as needed.
+     *
+     * @param args - Optional filtering options: `prefix` to filter by ID prefix, `limit` for max results per page
+     *
+     * @example
+     * ```ts
+     * for await (const token of s2.accessTokens.listAll({ prefix: "service-" })) {
+     *   console.log(token.id);
+     * }
+     * ```
+     */
+    listAll(args, options) {
+        return (0, paginate_js_1.paginate)((a) => this.list(a, options).then((r) => ({
+            items: r.accessTokens,
+            hasMore: r.hasMore,
+        })), args ?? {}, (token) => token.id);
     }
     /**
      * Issue a new access token.
      *
      * @param args.id Unique token ID (1-96 bytes)
      * @param args.scope Token scope (operations and resource sets)
-     * @param args.auto_prefix_streams Namespace stream names by configured prefix scope
-     * @param args.expires_at Expiration in ISO 8601; defaults to requestor's token expiry
+     * @param args.autoPrefixStreams Namespace stream names by configured prefix scope
+     * @param args.expiresAt Expiration time (Date or RFC 3339 string); defaults to requestor's token expiry
      */
     async issue(args, options) {
-        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+        // Convert Date to ISO string for API
+        const apiArgs = {
+            ...args,
+            expiresAt: toISOString(args.expiresAt),
+        };
+        const response = 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,
+                body: (0, case_transform_js_1.toSnakeCase)(apiArgs),
                 ...options,
             }));
         });
+        return (0, case_transform_js_1.toCamelCase)(response);
     }
     /**
      * Revoke an access token by ID.
@@ -50,7 +114,7 @@ class S2AccessTokens {
      * @param args.id Token ID to revoke
      */
     async revoke(args, options) {
-        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+        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,

package/dist/cjs/accessTokens.js.map

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

package/dist/cjs/basins.d.ts

@@ -1,16 +1,11 @@
-import type { DataToObject, RetryConfig, S2RequestOptions } from "./common.js";
+import type { RetryConfig, S2RequestOptions } from "./common.js";
 import type { Client } from "./generated/client/types.gen.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> {
-}
-export interface GetBasinConfigArgs extends DataToObject<GetBasinConfigData> {
-}
-export interface DeleteBasinArgs extends DataToObject<DeleteBasinData> {
-}
-export interface ReconfigureBasinArgs extends DataToObject<ReconfigureBasinData> {
-}
+import type * as Types from "./types.js";
+/**
+ * Account-scoped helper for listing, creating, deleting, and reconfiguring basins.
+ *
+ * Retrieve this via {@link S2.basins}. Each method retries according to the client-level retry config.
+ */
 export declare class S2Basins {
     private readonly client;
     private readonly retryConfig;
@@ -19,35 +14,50 @@ export declare class S2Basins {
      * List basins.
      *
      * @param args.prefix Return basins whose names start with the given prefix
-     * @param args.start_after Name to start after (for pagination)
+     * @param args.startAfter Name to start after (for pagination)
      * @param args.limit Max results (up to 1000)
      */
-    list(args?: ListBasinsArgs, options?: S2RequestOptions): Promise<ListBasinsResponse>;
+    list(args?: Types.ListBasinsInput, options?: S2RequestOptions): Promise<Types.ListBasinsResponse>;
+    /**
+     * List all basins with automatic pagination.
+     * Returns a lazy async iterable that fetches pages as needed.
+     *
+     * @param includeDeleted - Include basins that are being deleted (default: false)
+     * @param args - Optional filtering options: `prefix` to filter by name prefix, `limit` for max results per page
+     *
+     * @example
+     * ```ts
+     * for await (const basin of s2.basins.listAll(false, { prefix: "my-" })) {
+     *   console.log(basin.name);
+     * }
+     * ```
+     */
+    listAll(includeDeleted?: boolean, args?: Types.ListAllBasinsInput, options?: S2RequestOptions): AsyncIterable<Types.BasinInfo>;
     /**
      * Create a basin.
      *
      * @param args.basin Globally unique basin name (8-48 chars, lowercase letters, numbers, hyphens; cannot begin or end with a hyphen)
-     * @param args.config Optional basin configuration (e.g. default stream config)
+     * @param args.config Optional basin configuration (e.g. defaultStreamConfig)
      * @param args.scope Basin scope
      */
-    create(args: CreateBasinArgs, options?: S2RequestOptions): Promise<CreateBasinResponse>;
+    create(args: Types.CreateBasinInput, options?: S2RequestOptions): Promise<Types.CreateBasinResponse>;
     /**
      * Get basin configuration.
      *
      * @param args.basin Basin name
      */
-    getConfig(args: GetBasinConfigArgs, options?: S2RequestOptions): Promise<BasinConfig>;
+    getConfig(args: Types.GetBasinConfigInput, options?: S2RequestOptions): Promise<Types.BasinConfig>;
     /**
      * Delete a basin.
      *
      * @param args.basin Basin name
      */
-    delete(args: DeleteBasinArgs, options?: S2RequestOptions): Promise<void>;
+    delete(args: Types.DeleteBasinInput, options?: S2RequestOptions): Promise<void>;
     /**
      * Reconfigure a basin.
      *
      * @param args Configuration for the basin to reconfigure (including basin name and fields to change)
      */
-    reconfigure(args: ReconfigureBasinArgs, options?: S2RequestOptions): Promise<ReconfigureBasinResponse>;
+    reconfigure(args: Types.ReconfigureBasinInput, options?: S2RequestOptions): Promise<Types.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,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"}
+{"version":3,"file":"basins.d.ts","sourceRoot":"","sources":["../../src/basins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAa9D,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAsEzC;;;;GAIG;AACH,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,KAAK,CAAC,eAAe,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAapC;;;;;;;;;;;;;OAaG;IACI,OAAO,CACb,cAAc,UAAQ,EACtB,IAAI,CAAC,EAAE,KAAK,CAAC,kBAAkB,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;IAcjC;;;;;;OAMG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,gBAAgB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAoBrC;;;;OAIG;IACU,SAAS,CACrB,IAAI,EAAE,KAAK,CAAC,mBAAmB,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;IAc7B;;;;OAIG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,gBAAgB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACU,WAAW,CACvB,IAAI,EAAE,KAAK,CAAC,qBAAqB,EACjC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC;CAmB1C"}