@s2-dev/streamstore 0.2.11 → 0.3.1

package/README.md

@@ -23,6 +23,7 @@ S2 API: Serverless API for streaming data backed by object storage.
 * [streamstore](#streamstore)
   * [SDK Installation](#sdk-installation)
   * [Requirements](#requirements)
+  * [SDK Recommended Usage](#sdk-recommended-usage)
   * [SDK Example Usage](#sdk-example-usage)
   * [Authentication](#authentication)
   * [Available Resources and Operations](#available-resources-and-operations)
@@ -79,6 +80,24 @@ yarn add @s2-dev/streamstore zod
 For supported JavaScript runtimes, please consult [RUNTIMES.md](RUNTIMES.md).
 <!-- End Requirements [requirements] -->
 
+## SDK Recommended Usage
+
+The `S2Client` class provides a lot of convenience over the generated methods and is the recommended way to interact with the SDK. If you need finer control over the internal functions, you may use [Generated functions](#available-resources-and-operations)
+ or [Standalone functions](#standalone-functions).
+
+```typescript
+import { ReadRequest, S2Client } from "@s2-dev/streamstore";
+
+const s2 = new S2Client("<AUTH_TOKEN>");
+
+async function run() {
+  await s2.account.createBasin("my-favorite-basin");  
+  await s2.account.basin("my-favorite-basin").stream("test").append({ appendInput: { records: [{ body: "hello" }] } });  
+}
+
+run();
+```
+
 <!-- Start SDK Example Usage [usage] -->
 ## SDK Example Usage
 

package/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./lib/config.js";
 export * as files from "./lib/files.js";
 export * from "./sdk/sdk.js";
+export * from "./index.extras.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,cAAc,cAAc,CAAC;AAE7B,cAAc,mBAAmB,CAAC"}

package/index.extras.d.ts

@@ -0,0 +1,58 @@
+import { AppendOutput, BasinConfig, BasinInfo, CheckTailResponse, CreateBasinRequest, CreateStreamRequest, Output, ReadResponse, StreamConfig, StreamInfo } from "./models/components";
+import { ListBasinsRequest, ListBasinsResponse, ListStreamsRequest, ListStreamsResponse, ReadRequest as ReadRequestInner, AppendRequest as AppendRequestInner } from "./models/operations";
+import { PageIterator } from "./types";
+import { EventStream } from "./lib/event-streams";
+export type ReadRequest = Omit<ReadRequestInner, 'stream'>;
+export type AppendRequest = Omit<AppendRequestInner, 'stream'>;
+export type { GetBasinConfigRequest, ListBasinsRequest, ListBasinsResponse, ListStreamsRequest, ListStreamsResponse, ReconfigureBasinRequest, } from "./models/operations";
+export type { BasinConfig, BasinInfo, CheckTailResponse, CreateBasinRequest, CreateStreamRequest, Output, ReadResponse, StreamConfig, StreamInfo } from "./models/components";
+export declare function genS2RequestToken(): string;
+export declare class S2Client {
+    private authToken;
+    private _account?;
+    get account(): S2Account;
+    private _basin?;
+    basin(basinName: string): S2Basin;
+    constructor(authToken: string);
+}
+declare class S2Account {
+    private _account;
+    private requestOptions;
+    private authToken;
+    constructor(authToken: string);
+    basin(basinName: string): S2Basin;
+    listBasins(request?: ListBasinsRequest): Promise<PageIterator<ListBasinsResponse, {
+        cursor: string;
+    }>>;
+    getBasinConfig(basin: string): Promise<BasinConfig | undefined>;
+    createBasin(basin: string, request?: CreateBasinRequest): Promise<BasinInfo | undefined>;
+    deleteBasin(basin: string, if_exists?: boolean): Promise<void | undefined>;
+    reconfigureBasin(basin: string, config: BasinConfig): Promise<BasinConfig | undefined>;
+}
+declare class S2Basin {
+    private _basin;
+    private _stream;
+    private readonly basinURLSuffx;
+    private requestOptions;
+    private basinName;
+    constructor(authToken: string, basinName: string);
+    stream(streamName: string): Stream;
+    listStreams(request: ListStreamsRequest): Promise<PageIterator<ListStreamsResponse, {
+        cursor: string;
+    }>>;
+    getStreamConfig(stream: string): Promise<StreamConfig | undefined>;
+    createStream(stream: string, request?: CreateStreamRequest): Promise<StreamInfo | undefined>;
+    deleteStream(stream: string, if_exists?: boolean): Promise<void | undefined>;
+    reconfigureStream(stream: string, config: StreamConfig): Promise<StreamConfig | undefined>;
+}
+declare class Stream {
+    private _stream;
+    private basinName;
+    private streamName;
+    private readonly basinURLSuffx;
+    constructor(basinName: string, streamName: string);
+    checkTail(): Promise<CheckTailResponse | undefined>;
+    read(request: ReadRequest, stream?: boolean): Promise<EventStream<ReadResponse> | Output | undefined>;
+    append(request: AppendRequest): Promise<AppendOutput | undefined>;
+}
+//# sourceMappingURL=index.extras.d.ts.map

package/index.extras.d.ts.map

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

package/index.extras.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Client = void 0;
+exports.genS2RequestToken = genS2RequestToken;
+const accountDeleteBasin_1 = require("./funcs/accountDeleteBasin");
+const errors_1 = require("./models/errors");
+const stream_1 = require("./sdk/stream");
+const basin_1 = require("./sdk/basin");
+const account_1 = require("./sdk/account");
+const uuid_1 = require("uuid");
+const basinDeleteStream_1 = require("./funcs/basinDeleteStream");
+function genS2RequestToken() {
+    return (0, uuid_1.v4)().replace(/-/g, '');
+}
+class S2Client {
+    get account() {
+        return (this._account ?? (this._account = new S2Account(this.authToken)));
+    }
+    basin(basinName) {
+        return (this._basin ?? (this._basin = new S2Basin(this.authToken, basinName)));
+    }
+    constructor(authToken) {
+        this.authToken = authToken;
+    }
+}
+exports.S2Client = S2Client;
+class S2Account {
+    constructor(authToken) {
+        this._account = new account_1.Account({ bearerAuth: authToken });
+        this.authToken = authToken;
+        this.requestOptions = {
+            timeoutMs: 3000,
+            retries: {
+                strategy: 'backoff',
+                backoff: {
+                    initialInterval: 100,
+                    maxInterval: 3000,
+                    exponent: 2,
+                    maxElapsedTime: 6000,
+                },
+                retryConnectionErrors: true,
+            },
+            retryCodes: ['500', '503', '504'],
+        };
+    }
+    basin(basinName) {
+        return new S2Basin(this.authToken, basinName);
+    }
+    async listBasins(request) {
+        return this._account.listBasins(request ?? {}, this.requestOptions);
+    }
+    async getBasinConfig(basin) {
+        const _request = {
+            basin,
+        };
+        return (await this._account.getBasinConfig(_request, this.requestOptions)).basinConfig;
+    }
+    async createBasin(basin, request) {
+        const _request = {
+            basin,
+            s2RequestToken: genS2RequestToken(),
+            createBasinRequest: request ?? {},
+        };
+        return (await this._account.createBasin(_request, this.requestOptions)).basinInfo;
+    }
+    async deleteBasin(basin, if_exists) {
+        const response = await (0, accountDeleteBasin_1.accountDeleteBasin)(this._account, { basin }, this.requestOptions);
+        if (if_exists && response.error instanceof errors_1.NotFoundError)
+            return;
+        if (response.error)
+            throw new Error(response.error.message);
+        return;
+    }
+    async reconfigureBasin(basin, config) {
+        const _request = {
+            basin,
+            basinConfig: config,
+        };
+        return (await this._account.reconfigureBasin(_request, this.requestOptions)).basinConfig;
+    }
+}
+class S2Basin {
+    constructor(authToken, basinName) {
+        this.basinURLSuffx = 'b.aws.s2.dev/v1alpha';
+        this._basin = new basin_1.Basin({ bearerAuth: authToken });
+        this.basinName = basinName;
+        this.requestOptions = {
+            timeoutMs: 3000,
+            retries: {
+                strategy: 'backoff',
+                backoff: {
+                    initialInterval: 100,
+                    maxInterval: 3000,
+                    exponent: 2,
+                    maxElapsedTime: 6000,
+                },
+                retryConnectionErrors: true,
+            },
+            retryCodes: ['500', '503', '504'],
+        };
+    }
+    stream(streamName) {
+        return (this._stream ?? (this._stream = new Stream(this.basinName, streamName)));
+    }
+    async listStreams(request) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return this._basin.listStreams(request, { serverURL: basinURL, ...this.requestOptions });
+    }
+    async getStreamConfig(stream) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._basin.getStreamConfig({ stream }, { serverURL: basinURL, ...this.requestOptions })).streamConfig;
+    }
+    async createStream(stream, request) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        const _request = {
+            stream,
+            s2RequestToken: genS2RequestToken(),
+            createStreamRequest: request ?? {},
+        };
+        return (await this._basin.createStream(_request, { serverURL: basinURL, ...this.requestOptions })).streamInfo;
+    }
+    async deleteStream(stream, if_exists) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        const response = await (0, basinDeleteStream_1.basinDeleteStream)(this._basin, { stream }, { serverURL: basinURL, ...this.requestOptions });
+        if (if_exists && response instanceof errors_1.NotFoundError)
+            return;
+        if (response.error)
+            throw new Error(response.error.message);
+        return;
+    }
+    async reconfigureStream(stream, config) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._basin.reconfigureStream({ stream, streamConfig: config }, { serverURL: basinURL, ...this.requestOptions })).streamConfig;
+    }
+}
+class Stream {
+    constructor(basinName, streamName) {
+        this.basinURLSuffx = 'b.aws.s2.dev/v1alpha';
+        this.basinName = basinName;
+        this.streamName = streamName;
+        this._stream = new stream_1.Stream();
+    }
+    async checkTail() {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._stream.checkTail({ stream: this.streamName }, { serverURL: basinURL }))
+            .checkTailResponse;
+    }
+    async read(request, stream) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._stream.read({ ...request, stream: this.streamName }, stream
+            ? { serverURL: basinURL, acceptHeaderOverride: stream_1.ReadAcceptEnum.textEventStream }
+            : { serverURL: basinURL }))
+            .readResponse;
+    }
+    async append(request) {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._stream.append({ ...request, stream: this.streamName }, { serverURL: basinURL })).appendOutput;
+    }
+}
+//# sourceMappingURL=index.extras.js.map

package/index.extras.js.map

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

package/index.js

@@ -43,4 +43,5 @@ exports.files = void 0;
 __exportStar(require("./lib/config.js"), exports);
 exports.files = __importStar(require("./lib/files.js"));
 __exportStar(require("./sdk/sdk.js"), exports);
+__exportStar(require("./index.extras.js"), exports);
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,wDAAwC;AACxC,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,wDAAwC;AACxC,+CAA6B;AAE7B,oDAAkC"}

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@s2-dev/streamstore",
-  "version": "0.2.11",
+  "version": "0.3.1",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/lib/config.d.ts

@@ -27,8 +27,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "0.2.11";
-    readonly genVersion: "2.503.2";
-    readonly userAgent: "speakeasy-sdk/typescript 0.2.11 2.503.2 1.0.0 @s2-dev/streamstore";
+    readonly sdkVersion: "0.3.1";
+    readonly genVersion: "2.505.0";
+    readonly userAgent: "speakeasy-sdk/typescript 0.3.1 2.505.0 1.0.0 @s2-dev/streamstore";
 };
 //# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,eAAO,MAAM,UAAU,yCAEb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,GAAG,IAAI,CAepE;AAED,eAAO,MAAM,YAAY;;;;;;CAOf,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,eAAO,MAAM,UAAU,yCAEb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,GAAG,GAAG,IAAI,CAepE;AAED,eAAO,MAAM,YAAY;;;;;;CAMf,CAAC"}

package/lib/config.js

@@ -28,8 +28,8 @@ function serverURLFromOptions(options) {
 exports.SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.2.11",
-    genVersion: "2.503.2",
-    userAgent: "speakeasy-sdk/typescript 0.2.11 2.503.2 1.0.0 @s2-dev/streamstore",
+    sdkVersion: "0.3.1",
+    genVersion: "2.505.0",
+    userAgent: "speakeasy-sdk/typescript 0.3.1 2.505.0 1.0.0 @s2-dev/streamstore",
 };
 //# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAkCH,oDAeC;AA5CD,qCAA8C;AAE9C;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,4BAA4B;CACpB,CAAC;AAsBX,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAElC,MAAM,MAAM,GAAW,EAAE,CAAC;IAE1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACzC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,kBAAU,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,SAAS,GAAG,kBAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,GAAG,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAEY,QAAA,YAAY,GAAG;IAC1B,QAAQ,EAAE,YAAY;IACtB,iBAAiB,EAAE,OAAO;IAC1B,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE,SAAS;IACrB,SAAS,EACP,mEAAmE;CAC7D,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/lib/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAkCH,oDAeC;AA5CD,qCAA8C;AAE9C;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,4BAA4B;CACpB,CAAC;AAsBX,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAElC,MAAM,MAAM,GAAW,EAAE,CAAC;IAE1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACzC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,kBAAU,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,SAAS,GAAG,kBAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,GAAG,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAEY,QAAA,YAAY,GAAG;IAC1B,QAAQ,EAAE,YAAY;IACtB,iBAAiB,EAAE,OAAO;IAC1B,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,kEAAkE;CACrE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2-dev/streamstore",
-  "version": "0.2.11",
+  "version": "0.3.1",
   "author": "Speakeasy",
   "main": "./index.js",
   "sideEffects": false,
@@ -19,6 +19,7 @@
   "devDependencies": {
     "@eslint/js": "^9.19.0",
     "@types/jsonpath": "^0.2.4",
+    "@types/uuid": "^9.0.8",
     "eslint": "^9.19.0",
     "globals": "^15.14.0",
     "typescript": "^5.4.5",
@@ -26,6 +27,7 @@
     "zod": "^3.23.4"
   },
   "dependencies": {
-    "jsonpath": "^1.1.1"
+    "jsonpath": "^1.1.1",
+    "uuid": "^9.0.1"
   }
 }

package/src/index.extras.ts

@@ -0,0 +1,247 @@
+import { accountDeleteBasin } from "./funcs/accountDeleteBasin";
+import { RequestOptions } from "./lib/sdks";
+import { AppendOutput, BasinConfig, BasinInfo, CheckTailResponse, CreateBasinRequest, CreateStreamRequest, Output, ReadResponse, StreamConfig, StreamInfo } from "./models/components";
+import { NotFoundError } from "./models/errors";
+import {
+    GetBasinConfigRequest,
+    ListBasinsRequest,
+    ListBasinsResponse,
+    ListStreamsRequest,
+    ListStreamsResponse,
+    ReconfigureBasinRequest,
+    CreateBasinRequest as CreateBasinRequestInner,
+    CreateStreamRequest as CreateStreamRequestInner,
+    ReadRequest as ReadRequestInner,
+    AppendRequest as AppendRequestInner,
+} from "./models/operations";
+import { PageIterator } from "./types";
+
+import { Stream as InnerStream, ReadAcceptEnum } from "./sdk/stream";
+import { Basin as InnerBasin } from "./sdk/basin";
+import { Account as InnerAccount } from "./sdk/account";
+
+import { v4 } from 'uuid';
+import { basinDeleteStream } from "./funcs/basinDeleteStream";
+import { EventStream } from "./lib/event-streams";
+
+export type ReadRequest = Omit<ReadRequestInner, 'stream'>;
+export type AppendRequest = Omit<AppendRequestInner, 'stream'>;
+export type {
+    GetBasinConfigRequest,
+    ListBasinsRequest,
+    ListBasinsResponse,
+    ListStreamsRequest,
+    ListStreamsResponse,
+    ReconfigureBasinRequest,
+} from "./models/operations";
+export type { BasinConfig, BasinInfo, CheckTailResponse, CreateBasinRequest, CreateStreamRequest, Output, ReadResponse, StreamConfig, StreamInfo } from "./models/components";
+
+export function genS2RequestToken(): string {
+    return v4().replace(/-/g, '');
+}
+
+export class S2Client {
+    private authToken: string;
+    private _account?: S2Account;
+    get account(): S2Account {
+        return (this._account ??= new S2Account(this.authToken));
+    }
+
+    private _basin?: S2Basin;
+    basin(basinName: string): S2Basin {
+        return (this._basin ??= new S2Basin(this.authToken, basinName));
+    }
+
+    constructor(authToken: string) {
+        this.authToken = authToken;
+    }
+}
+
+class S2Account {
+    private _account: InnerAccount;
+    private requestOptions: RequestOptions;
+    private authToken: string;
+
+    constructor(authToken: string) {
+        this._account = new InnerAccount({ bearerAuth: authToken });
+        this.authToken = authToken;
+        this.requestOptions = {
+            timeoutMs: 3000,
+            retries: {
+                strategy: 'backoff',
+                backoff: {
+                    initialInterval: 100,
+                    maxInterval: 3000,
+                    exponent: 2,
+                    maxElapsedTime: 6000,
+                },
+                retryConnectionErrors: true,
+            },
+            retryCodes: ['500', '503', '504'],
+        };
+    }
+
+    basin(basinName: string): S2Basin {
+        return new S2Basin(this.authToken, basinName);
+    }
+
+    async listBasins(
+        request?: ListBasinsRequest,
+    ): Promise<PageIterator<ListBasinsResponse, { cursor: string }>> {
+        return this._account.listBasins(request ?? {}, this.requestOptions);
+    }
+
+    async getBasinConfig(basin: string): Promise<BasinConfig | undefined> {
+        const _request: GetBasinConfigRequest = {
+            basin,
+        };
+        return (await this._account.getBasinConfig(_request, this.requestOptions)).basinConfig;
+    }
+
+    async createBasin(basin: string, request?: CreateBasinRequest): Promise<BasinInfo | undefined> {
+        const _request: CreateBasinRequestInner = {
+            basin,
+            s2RequestToken: genS2RequestToken(),
+            createBasinRequest: request ?? {},
+        };
+        return (await this._account.createBasin(_request, this.requestOptions)).basinInfo;
+    }
+
+    async deleteBasin(basin: string, if_exists?: boolean): Promise<void | undefined> {
+        const response = await accountDeleteBasin(this._account, { basin }, this.requestOptions);
+        if (if_exists && response.error instanceof NotFoundError) return;
+        if (response.error) throw new Error(response.error.message);
+        return;
+    }
+
+    async reconfigureBasin(basin: string, config: BasinConfig): Promise<BasinConfig | undefined> {
+        const _request: ReconfigureBasinRequest = {
+            basin,
+            basinConfig: config,
+        };
+        return (await this._account.reconfigureBasin(_request, this.requestOptions)).basinConfig;
+    }
+}
+
+class S2Basin {
+    private _basin: InnerBasin;
+    private _stream!: Stream;
+    private readonly basinURLSuffx = 'b.aws.s2.dev/v1alpha';
+    private requestOptions: RequestOptions;
+    private basinName: string;
+
+    constructor(authToken: string, basinName: string) {
+        this._basin = new InnerBasin({ bearerAuth: authToken });
+        this.basinName = basinName;
+        this.requestOptions = {
+            timeoutMs: 3000,
+            retries: {
+                strategy: 'backoff',
+                backoff: {
+                    initialInterval: 100,
+                    maxInterval: 3000,
+                    exponent: 2,
+                    maxElapsedTime: 6000,
+                },
+                retryConnectionErrors: true,
+            },
+            retryCodes: ['500', '503', '504'],
+        };
+    }
+
+    stream(streamName: string): Stream {
+        return (this._stream ??= new Stream(this.basinName, streamName));
+    }
+
+    async listStreams(
+        request: ListStreamsRequest,
+    ): Promise<PageIterator<ListStreamsResponse, { cursor: string }>> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return this._basin.listStreams(request, { serverURL: basinURL, ...this.requestOptions });
+    }
+
+    async getStreamConfig(stream: string): Promise<StreamConfig | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (
+            await this._basin.getStreamConfig({ stream }, { serverURL: basinURL, ...this.requestOptions })
+        ).streamConfig;
+    }
+
+    async createStream(
+        stream: string,
+        request?: CreateStreamRequest,
+    ): Promise<StreamInfo | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        const _request: CreateStreamRequestInner = {
+            stream,
+            s2RequestToken: genS2RequestToken(),
+            createStreamRequest: request ?? {},
+        };
+
+        return (
+            await this._basin.createStream(_request, { serverURL: basinURL, ...this.requestOptions })
+        ).streamInfo;
+    }
+
+    async deleteStream(stream: string, if_exists?: boolean): Promise<void | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        const response = await basinDeleteStream(this._basin, { stream }, { serverURL: basinURL, ...this.requestOptions });
+        if (if_exists && response instanceof NotFoundError) return;
+        if (response.error) throw new Error(response.error.message);
+        return;
+    }
+
+    async reconfigureStream(stream: string, config: StreamConfig): Promise<StreamConfig | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (
+            await this._basin.reconfigureStream(
+                { stream, streamConfig: config },
+                { serverURL: basinURL, ...this.requestOptions },
+            )
+        ).streamConfig;
+    }
+}
+
+
+class Stream {
+    private _stream: InnerStream;
+    private basinName: string;
+    private streamName: string;
+    private readonly basinURLSuffx = 'b.aws.s2.dev/v1alpha';
+
+    constructor(basinName: string, streamName: string) {
+        this.basinName = basinName;
+        this.streamName = streamName;
+        this._stream = new InnerStream();
+    }
+
+    async checkTail(): Promise<CheckTailResponse | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._stream.checkTail({ stream: this.streamName }, { serverURL: basinURL }))
+            .checkTailResponse;
+    }
+
+    async read(
+        request: ReadRequest,
+        stream?: boolean
+    ): Promise<EventStream<ReadResponse> | Output | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._stream.read(
+            { ...request, stream: this.streamName },
+            stream
+                ? { serverURL: basinURL, acceptHeaderOverride: ReadAcceptEnum.textEventStream }
+                : { serverURL: basinURL }
+        ))
+            .readResponse;
+    }
+
+    async append(
+        request: AppendRequest,        
+    ): Promise<AppendOutput | undefined> {
+        const basinURL = `${this.basinName}.${this.basinURLSuffx}`;
+        return (await this._stream.append(
+            { ...request, stream: this.streamName },
+            { serverURL: basinURL }
+        )).appendOutput;
+    }
+}

package/src/index.ts

@@ -5,3 +5,5 @@
 export * from "./lib/config.js";
 export * as files from "./lib/files.js";
 export * from "./sdk/sdk.js";
+
+export * from "./index.extras.js";

package/src/lib/config.ts

@@ -54,8 +54,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.2.11",
-  genVersion: "2.503.2",
-  userAgent:
-    "speakeasy-sdk/typescript 0.2.11 2.503.2 1.0.0 @s2-dev/streamstore",
+  sdkVersion: "0.3.1",
+  genVersion: "2.505.0",
+  userAgent: "speakeasy-sdk/typescript 0.3.1 2.505.0 1.0.0 @s2-dev/streamstore",
 } as const;