@s2-dev/streamstore 0.16.3 → 0.16.6

package/README.md

@@ -115,7 +115,9 @@ for await (const record of readSession) {
 
 ## SDK Docs and Reference
 
-For detailed documentation and API reference, please visit the [S2 Documentation](https://s2.dev/docs).
+For detailed documentation for the SDK, please check the generated type docs [here](https://s2-streamstore.github.io/s2-sdk-typescript/).
+
+For API reference, please visit the [S2 Documentation](https://s2.dev/docs).
 
 ## Feedback
 

package/dist/{accessTokens.d.ts → cjs/accessTokens.d.ts}

@@ -1,6 +1,6 @@
-import type { DataToObject, S2RequestOptions } from "./common";
-import { type IssueAccessTokenData, type ListAccessTokensData, type RevokeAccessTokenData } from "./generated";
-import type { Client } from "./generated/client/types.gen";
+import type { DataToObject, 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> {
@@ -17,7 +17,7 @@ export declare class S2AccessTokens {
      * @param args.start_after Filter to IDs lexicographically after this value
      * @param args.limit Max results (up to 1000)
      */
-    list(args?: ListAccessTokensArgs, options?: S2RequestOptions): Promise<import("./generated").ListAccessTokensResponse>;
+    list(args?: ListAccessTokensArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").ListAccessTokensResponse>;
     /**
      * Issue a new access token.
      *
@@ -26,7 +26,7 @@ export declare class S2AccessTokens {
      * @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
      */
-    issue(args: IssueAccessTokenArgs, options?: S2RequestOptions): Promise<import("./generated").IssueAccessTokenResponse>;
+    issue(args: IssueAccessTokenArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").IssueAccessTokenResponse>;
     /**
      * Revoke an access token by ID.
      *

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

@@ -0,0 +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"}

package/dist/cjs/accessTokens.js

@@ -0,0 +1,78 @@
+"use strict";
+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");
+class S2AccessTokens {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 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.limit Max results (up to 1000)
+     */
+    async list(args, options) {
+        const response = await (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.
+     *
+     * @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
+     */
+    async issue(args, options) {
+        const response = await (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.
+     *
+     * @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,
+        });
+        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;
+//# sourceMappingURL=accessTokens.js.map

package/dist/cjs/accessTokens.js.map

@@ -0,0 +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"}

package/dist/{basin.d.ts → cjs/basin.d.ts}

@@ -1,6 +1,6 @@
-import * as Redacted from "./lib/redacted";
-import { S2Stream } from "./stream";
-import { S2Streams } from "./streams";
+import * as Redacted from "./lib/redacted.js";
+import { S2Stream } from "./stream.js";
+import { S2Streams } from "./streams.js";
 export declare class S2Basin {
     private readonly client;
     private readonly accessToken;

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

@@ -0,0 +1 @@
+{"version":3,"file":"basin.d.ts","sourceRoot":"","sources":["../../src/basin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,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,WAAW,CAAoB;IAEhD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,SAAS,CAAC;IAEnC;;;;;;OAMG;gBAEF,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAa7D;;;OAGG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM;CAG1B"}

package/dist/cjs/basin.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Basin = void 0;
+const index_js_1 = require("./generated/client/index.js");
+const Redacted = require("./lib/redacted.js");
+const stream_js_1 = require("./stream.js");
+const streams_js_1 = require("./streams.js");
+class S2Basin {
+    client;
+    accessToken;
+    name;
+    streams;
+    /**
+     * Create a basin-scoped client that talks to `https://{basin}.b.aws.s2.dev/v1`.
+     *
+     * Use this to work with streams inside a single basin.
+     * @param name Basin name
+     * @param accessToken Redacted access token from the parent `S2` client
+     */
+    constructor(name, options) {
+        this.name = name;
+        this.accessToken = options.accessToken;
+        this.client = (0, index_js_1.createClient)((0, index_js_1.createConfig)({
+            baseUrl: options.baseUrl,
+            auth: () => Redacted.value(this.accessToken),
+        }));
+        this.streams = new streams_js_1.S2Streams(this.client);
+    }
+    /**
+     * Create a stream-scoped helper bound to `this` basin.
+     * @param name Stream name
+     */
+    stream(name) {
+        return new stream_js_1.S2Stream(name, this.client);
+    }
+}
+exports.S2Basin = S2Basin;
+//# sourceMappingURL=basin.js.map

package/dist/cjs/basin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basin.js","sourceRoot":"","sources":["../../src/basin.ts"],"names":[],"mappings":";;;AAAA,0DAAyE;AAEzE,8CAA8C;AAC9C,2CAAuC;AACvC,6CAAyC;AAEzC,MAAa,OAAO;IACF,MAAM,CAAS;IACf,WAAW,CAAoB;IAEhC,IAAI,CAAS;IACb,OAAO,CAAY;IAEnC;;;;;;OAMG;IACH,YACC,IAAY,EACZ,OAA4D;QAE5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,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,WAAW,CAAC;SAC5C,CAAC,CACF,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,IAAY;QACzB,OAAO,IAAI,oBAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;CACD;AApCD,0BAoCC"}

package/dist/{basins.d.ts → cjs/basins.d.ts}

@@ -1,6 +1,6 @@
-import type { DataToObject, S2RequestOptions } from "./common";
-import { type CreateBasinData, type DeleteBasinData, type GetBasinConfigData, type ListBasinsData, type ReconfigureBasinData } from "./generated";
-import type { Client } from "./generated/client/types.gen";
+import type { DataToObject, 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";
 export interface ListBasinsArgs extends DataToObject<ListBasinsData> {
 }
 export interface CreateBasinArgs extends DataToObject<CreateBasinData> {
@@ -21,7 +21,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").ListBasinsResponse>;
+    list(args?: ListBasinsArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").ListBasinsResponse>;
     /**
      * Create a basin.
      *
@@ -29,13 +29,13 @@ 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").BasinInfo>;
+    create(args: CreateBasinArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").BasinInfo>;
     /**
      * Get basin configuration.
      *
      * @param args.basin Basin name
      */
-    getConfig(args: GetBasinConfigArgs, options?: S2RequestOptions): Promise<import("./generated").BasinConfig>;
+    getConfig(args: GetBasinConfigArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").BasinConfig>;
     /**
      * Delete a basin.
      *
@@ -48,6 +48,6 @@ export declare class S2Basins {
      * @param args.basin Basin name
      * @param args.body Configuration fields to change (e.g. default stream config)
      */
-    reconfigure(args: ReconfigureBasinArgs, options?: S2RequestOptions): Promise<import("./generated").BasinConfig>;
+    reconfigure(args: ReconfigureBasinArgs, options?: S2RequestOptions): Promise<import("./generated/types.gen.js").BasinConfig>;
 }
 //# sourceMappingURL=basins.d.ts.map

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

@@ -0,0 +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"}

package/dist/cjs/basins.js

@@ -0,0 +1,119 @@
+"use strict";
+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");
+class S2Basins {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 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.limit Max results (up to 1000)
+     */
+    async list(args, options) {
+        const response = await (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.
+     *
+     * @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.scope Basin scope
+     */
+    async create(args, options) {
+        const response = await (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.
+     *
+     * @param args.basin Basin name
+     */
+    async getConfig(args, options) {
+        const response = await (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.
+     *
+     * @param args.basin Basin name
+     */
+    async delete(args, options) {
+        const response = await (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)
+     */
+    async reconfigure(args, options) {
+        const response = await (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;
+//# sourceMappingURL=basins.js.map

package/dist/cjs/basins.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GACxD,CAAC,SAAS,SAAS,GAAG,KAAK,GAC1B,EAAE,GACF,CAAC,GACF,EAAE,CAAC,GACL,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAC5E,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/cjs/common.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

package/dist/cjs/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":""}

package/dist/cjs/error.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Rich error type used by the SDK to surface HTTP and protocol errors.
+ *
+ * - `code` is the service error code when available.
+ * - `status` is the HTTP status code.
+ * - `data` may include structured error details (e.g. for conditional failures).
+ */
+export declare class S2Error extends Error {
+    readonly code?: string;
+    readonly status?: number;
+    constructor({ message, code, status, }: {
+        message: string;
+        code?: string;
+        status?: number;
+    });
+}
+/**
+ * Thrown when an append operation fails due to a sequence number mismatch.
+ *
+ * This occurs when you specify a `matchSeqNum` condition in your append request,
+ * but the current tail sequence number of the stream doesn't match.
+ *
+ * The `expectedSeqNum` property contains the actual next sequence number
+ * that should be used for a successful append.
+ */
+export declare class SeqNumMismatchError extends S2Error {
+    /** The expected next sequence number for the stream. */
+    readonly expectedSeqNum: number;
+    constructor({ message, code, status, expectedSeqNum, }: {
+        message: string;
+        code?: string;
+        status?: number;
+        expectedSeqNum: number;
+    });
+}
+/**
+ * Thrown when an append operation fails due to a fencing token mismatch.
+ *
+ * This occurs when you specify a `fencingToken` condition in your append request,
+ * but the current fencing token of the stream doesn't match.
+ *
+ * The `expectedFencingToken` property contains the actual fencing token
+ * that should be used for a successful append.
+ */
+export declare class FencingTokenMismatchError extends S2Error {
+    /** The expected fencing token for the stream. */
+    readonly expectedFencingToken: string;
+    constructor({ message, code, status, expectedFencingToken, }: {
+        message: string;
+        code?: string;
+        status?: number;
+        expectedFencingToken: string;
+    });
+}
+/**
+ * Thrown when a read operation fails because the requested position is beyond the stream tail.
+ *
+ * This occurs when you specify a `startSeqNum` that is greater than the current tail
+ * of the stream (HTTP 416 Range Not Satisfiable).
+ *
+ * To handle this gracefully, you can set `clamp: true` in your read options to
+ * automatically start from the tail instead of throwing an error.
+ */
+export declare class RangeNotSatisfiableError extends S2Error {
+    constructor({ message, code, status, }?: {
+        message?: string;
+        code?: string;
+        status?: number;
+    });
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACjC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEpB,EACX,OAAO,EACP,IAAI,EACJ,MAAM,GACN,EAAE;QACF,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB;CAMD;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;IAC/C,wDAAwD;IACxD,SAAgB,cAAc,EAAE,MAAM,CAAC;gBAE3B,EACX,OAAO,EACP,IAAI,EACJ,MAAM,EACN,cAAc,GACd,EAAE;QACF,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;KACvB;CASD;AAED;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,SAAQ,OAAO;IACrD,iDAAiD;IACjD,SAAgB,oBAAoB,EAAE,MAAM,CAAC;gBAEjC,EACX,OAAO,EACP,IAAI,EACJ,MAAM,EACN,oBAAoB,GACpB,EAAE;QACF,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,oBAAoB,EAAE,MAAM,CAAC;KAC7B;CASD;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,OAAO;gBACxC,EACX,OAAkI,EAClI,IAAI,EACJ,MAAY,GACZ,GAAE;QACF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACX;CAQN"}

package/dist/cjs/error.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RangeNotSatisfiableError = exports.FencingTokenMismatchError = exports.SeqNumMismatchError = exports.S2Error = void 0;
+/**
+ * Rich error type used by the SDK to surface HTTP and protocol errors.
+ *
+ * - `code` is the service error code when available.
+ * - `status` is the HTTP status code.
+ * - `data` may include structured error details (e.g. for conditional failures).
+ */
+class S2Error extends Error {
+    code;
+    status;
+    constructor({ message, code, status, }) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = "S2Error";
+    }
+}
+exports.S2Error = S2Error;
+/**
+ * Thrown when an append operation fails due to a sequence number mismatch.
+ *
+ * This occurs when you specify a `matchSeqNum` condition in your append request,
+ * but the current tail sequence number of the stream doesn't match.
+ *
+ * The `expectedSeqNum` property contains the actual next sequence number
+ * that should be used for a successful append.
+ */
+class SeqNumMismatchError extends S2Error {
+    /** The expected next sequence number for the stream. */
+    expectedSeqNum;
+    constructor({ message, code, status, expectedSeqNum, }) {
+        super({
+            message: `${message}\nExpected sequence number: ${expectedSeqNum}`,
+            code,
+            status,
+        });
+        this.name = "SeqNumMismatchError";
+        this.expectedSeqNum = expectedSeqNum;
+    }
+}
+exports.SeqNumMismatchError = SeqNumMismatchError;
+/**
+ * Thrown when an append operation fails due to a fencing token mismatch.
+ *
+ * This occurs when you specify a `fencingToken` condition in your append request,
+ * but the current fencing token of the stream doesn't match.
+ *
+ * The `expectedFencingToken` property contains the actual fencing token
+ * that should be used for a successful append.
+ */
+class FencingTokenMismatchError extends S2Error {
+    /** The expected fencing token for the stream. */
+    expectedFencingToken;
+    constructor({ message, code, status, expectedFencingToken, }) {
+        super({
+            message: `${message}\nExpected fencing token: ${expectedFencingToken}`,
+            code,
+            status,
+        });
+        this.name = "FencingTokenMismatchError";
+        this.expectedFencingToken = expectedFencingToken;
+    }
+}
+exports.FencingTokenMismatchError = FencingTokenMismatchError;
+/**
+ * Thrown when a read operation fails because the requested position is beyond the stream tail.
+ *
+ * This occurs when you specify a `startSeqNum` that is greater than the current tail
+ * of the stream (HTTP 416 Range Not Satisfiable).
+ *
+ * To handle this gracefully, you can set `clamp: true` in your read options to
+ * automatically start from the tail instead of throwing an error.
+ */
+class RangeNotSatisfiableError extends S2Error {
+    constructor({ message = "Range not satisfiable: requested position is beyond the stream tail. Use 'clamp: true' to start from the tail instead.", code, status = 416, } = {}) {
+        super({
+            message,
+            code,
+            status,
+        });
+        this.name = "RangeNotSatisfiableError";
+    }
+}
+exports.RangeNotSatisfiableError = RangeNotSatisfiableError;
+//# sourceMappingURL=error.js.map

package/dist/cjs/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAa,OAAQ,SAAQ,KAAK;IACjB,IAAI,CAAU;IACd,MAAM,CAAU;IAEhC,YAAY,EACX,OAAO,EACP,IAAI,EACJ,MAAM,GAKN;QACA,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;CACD;AAlBD,0BAkBC;AAED;;;;;;;;GAQG;AACH,MAAa,mBAAoB,SAAQ,OAAO;IAC/C,wDAAwD;IACxC,cAAc,CAAS;IAEvC,YAAY,EACX,OAAO,EACP,IAAI,EACJ,MAAM,EACN,cAAc,GAMd;QACA,KAAK,CAAC;YACL,OAAO,EAAE,GAAG,OAAO,+BAA+B,cAAc,EAAE;YAClE,IAAI;YACJ,MAAM;SACN,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACtC,CAAC;CACD;AAvBD,kDAuBC;AAED;;;;;;;;GAQG;AACH,MAAa,yBAA0B,SAAQ,OAAO;IACrD,iDAAiD;IACjC,oBAAoB,CAAS;IAE7C,YAAY,EACX,OAAO,EACP,IAAI,EACJ,MAAM,EACN,oBAAoB,GAMpB;QACA,KAAK,CAAC;YACL,OAAO,EAAE,GAAG,OAAO,6BAA6B,oBAAoB,EAAE;YACtE,IAAI;YACJ,MAAM;SACN,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;IAClD,CAAC;CACD;AAvBD,8DAuBC;AAED;;;;;;;;GAQG;AACH,MAAa,wBAAyB,SAAQ,OAAO;IACpD,YAAY,EACX,OAAO,GAAG,wHAAwH,EAClI,IAAI,EACJ,MAAM,GAAG,GAAG,MAKT,EAAE;QACL,KAAK,CAAC;YACL,OAAO;YACP,IAAI;YACJ,MAAM;SACN,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAjBD,4DAiBC"}

package/dist/cjs/generated/client/client.gen.d.ts

@@ -0,0 +1,3 @@
+import type { Client, Config } from './types.gen.js';
+export declare const createClient: (config?: Config) => Client;
+//# sourceMappingURL=client.gen.d.ts.map

package/dist/cjs/generated/client/client.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.gen.d.ts","sourceRoot":"","sources":["../../../../src/generated/client/client.gen.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,MAAM,EACN,MAAM,EAGP,MAAM,gBAAgB,CAAC;AAgBxB,eAAO,MAAM,YAAY,YAAY,MAAM,KAAQ,MAiPlD,CAAC"}