@s2-dev/streamstore 0.3.2 → 0.3.8

package/endpoints.d.ts

@@ -0,0 +1,67 @@
+type Authority = string;
+type BasinName = string;
+/**
+ * S2 cloud environment to connect with.
+ */
+export declare enum S2Cloud {
+    /** S2 running on AWS */
+    Aws = "aws"
+}
+/**
+ * Endpoint for connecting to an S2 basin.
+ */
+export declare enum BasinEndpointKind {
+    ParentZone = "ParentZone",
+    Direct = "Direct"
+}
+export type BasinEndpoint = {
+    kind: BasinEndpointKind.ParentZone;
+    authority: Authority;
+} | {
+    kind: BasinEndpointKind.Direct;
+    authority: Authority;
+};
+/**
+ * Endpoints for the S2 environment.
+ *
+ * You can find the S2 endpoints in our [documentation](https://s2.dev/docs/interface/endpoints)
+ */
+export declare class S2Endpoints {
+    /** Used by `AccountService` requests */
+    account: Authority;
+    /** Used by `BasinService` and `StreamService` requests */
+    basin: BasinEndpoint;
+    constructor(account: Authority, basin: BasinEndpoint);
+    /**
+     * Get S2 endpoints for the specified cloud.
+     */
+    static forCloud(cloud: S2Cloud): S2Endpoints;
+    /**
+     * Get S2 endpoints for the specified cell.
+     */
+    static forCell(cloud: S2Cloud, cellId: string): S2Endpoints;
+    /**
+     * Get S2 endpoints from environment variables.
+     *
+     * The following environment variables are used:
+     * - `S2_CLOUD`: Valid S2 cloud name. Defaults to AWS.
+     * - `S2_ACCOUNT_ENDPOINT`: Overrides the account endpoint.
+     * - `S2_BASIN_ENDPOINT`: Overrides the basin endpoint. The prefix `"{basin}."` indicates the
+     *   basin endpoint is `ParentZone` else `Direct`.
+     */
+    static fromEnv(): S2Endpoints;
+}
+/**
+ * Client kind for different S2 services
+ */
+export type ClientKind = {
+    kind: 'Account';
+} | {
+    kind: 'Basin';
+    basin: BasinName;
+};
+export declare const ClientKind: {
+    toAuthority(kind: ClientKind, endpoints: S2Endpoints): Authority;
+};
+export {};
+//# sourceMappingURL=endpoints.d.ts.map

package/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["src/endpoints.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,MAAM,CAAC;AAGxB,KAAK,SAAS,GAAG,MAAM,CAAC;AAExB;;GAEG;AACH,oBAAY,OAAO;IACf,wBAAwB;IACxB,GAAG,QAAQ;CACd;AAED;;GAEG;AACH,oBAAY,iBAAiB;IACzB,UAAU,eAAe;IACzB,MAAM,WAAW;CACpB;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,iBAAiB,CAAC,UAAU,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;CACxB,GAAG;IACA,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,SAAS,CAAC;CACxB,CAAC;AASF;;;;GAIG;AACH,qBAAa,WAAW;IACpB,wCAAwC;IACjC,OAAO,EAAE,SAAS,CAAC;IAC1B,0DAA0D;IACnD,KAAK,EAAE,aAAa,CAAC;gBAEhB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa;IAKpD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW;IAW5C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW;IAW3D;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,IAAI,WAAW;CA8ChC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,UAAU;sBACD,UAAU,aAAa,WAAW,GAAG,SAAS;CAanE,CAAC"}

package/endpoints.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientKind = exports.S2Endpoints = exports.BasinEndpointKind = exports.S2Cloud = void 0;
+/**
+ * S2 cloud environment to connect with.
+ */
+var S2Cloud;
+(function (S2Cloud) {
+    /** S2 running on AWS */
+    S2Cloud["Aws"] = "aws";
+})(S2Cloud || (exports.S2Cloud = S2Cloud = {}));
+/**
+ * Endpoint for connecting to an S2 basin.
+ */
+var BasinEndpointKind;
+(function (BasinEndpointKind) {
+    BasinEndpointKind["ParentZone"] = "ParentZone";
+    BasinEndpointKind["Direct"] = "Direct";
+})(BasinEndpointKind || (exports.BasinEndpointKind = BasinEndpointKind = {}));
+class S2EndpointError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'S2EndpointError';
+    }
+}
+/**
+ * Endpoints for the S2 environment.
+ *
+ * You can find the S2 endpoints in our [documentation](https://s2.dev/docs/interface/endpoints)
+ */
+class S2Endpoints {
+    constructor(account, basin) {
+        this.account = account;
+        this.basin = basin;
+    }
+    /**
+     * Get S2 endpoints for the specified cloud.
+     */
+    static forCloud(cloud) {
+        const authority = `${cloud}.s2.dev`;
+        return new S2Endpoints(authority, {
+            kind: BasinEndpointKind.ParentZone,
+            authority: `b.${cloud}.s2.dev`
+        });
+    }
+    /**
+     * Get S2 endpoints for the specified cell.
+     */
+    static forCell(cloud, cellId) {
+        const cellEndpoint = `${cellId}.o.${cloud}.s2.dev`;
+        return new S2Endpoints(cellEndpoint, {
+            kind: BasinEndpointKind.Direct,
+            authority: cellEndpoint
+        });
+    }
+    /**
+     * Get S2 endpoints from environment variables.
+     *
+     * The following environment variables are used:
+     * - `S2_CLOUD`: Valid S2 cloud name. Defaults to AWS.
+     * - `S2_ACCOUNT_ENDPOINT`: Overrides the account endpoint.
+     * - `S2_BASIN_ENDPOINT`: Overrides the basin endpoint. The prefix `"{basin}."` indicates the
+     *   basin endpoint is `ParentZone` else `Direct`.
+     */
+    static fromEnv() {
+        let cloud;
+        try {
+            const cloudEnv = process.env['S2_CLOUD'] || S2Cloud.Aws;
+            if (Object.values(S2Cloud).includes(cloudEnv)) {
+                cloud = cloudEnv;
+            }
+            else {
+                throw new S2EndpointError(`Invalid S2_CLOUD: ${cloudEnv}`);
+            }
+        }
+        catch (err) {
+            const error = err;
+            throw new S2EndpointError(`Invalid S2_CLOUD: ${error.message}`);
+        }
+        const endpoints = S2Endpoints.forCloud(cloud);
+        const accountEndpoint = process.env['S2_ACCOUNT_ENDPOINT'];
+        if (accountEndpoint !== undefined) {
+            if (typeof accountEndpoint !== 'string') {
+                throw new S2EndpointError('Invalid S2_ACCOUNT_ENDPOINT: not string');
+            }
+            endpoints.account = accountEndpoint;
+        }
+        const basinEndpoint = process.env['S2_BASIN_ENDPOINT'];
+        if (basinEndpoint !== undefined) {
+            if (typeof basinEndpoint !== 'string') {
+                throw new S2EndpointError('Invalid S2_BASIN_ENDPOINT: not string');
+            }
+            if (basinEndpoint.startsWith('{basin}.')) {
+                const parentZone = basinEndpoint.substring(7);
+                endpoints.basin = {
+                    kind: BasinEndpointKind.ParentZone,
+                    authority: parentZone
+                };
+            }
+            else {
+                endpoints.basin = {
+                    kind: BasinEndpointKind.Direct,
+                    authority: basinEndpoint
+                };
+            }
+        }
+        return endpoints;
+    }
+}
+exports.S2Endpoints = S2Endpoints;
+exports.ClientKind = {
+    toAuthority(kind, endpoints) {
+        switch (kind.kind) {
+            case 'Account':
+                return endpoints.account;
+            case 'Basin':
+                switch (endpoints.basin.kind) {
+                    case BasinEndpointKind.ParentZone:
+                        return `${kind.basin}.${endpoints.basin.authority}`;
+                    case BasinEndpointKind.Direct:
+                        return endpoints.basin.authority;
+                }
+        }
+    }
+};
+//# sourceMappingURL=endpoints.js.map

package/endpoints.js.map

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

package/index.extras.d.ts

@@ -1,25 +1,31 @@
 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";
+import { S2Endpoints } from "./endpoints";
 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 * from "./endpoints";
+export type S2ClientConfig = {
+    authToken?: string;
+    requestTimeout?: number;
+    endpoints?: S2Endpoints;
+};
 export declare class S2Client {
-    private authToken;
+    private config;
     private _account?;
     get account(): S2Account;
     private _basin?;
     basin(basinName: string): S2Basin;
-    constructor(authToken: string);
+    constructor(config?: S2ClientConfig);
 }
 declare class S2Account {
     private _account;
-    private requestOptions;
-    private authToken;
-    constructor(authToken: string);
+    private config;
+    private readonly accountURLSuffx;
+    constructor(config: S2ClientConfig);
+    get URL(): string | undefined;
     basin(basinName: string): S2Basin;
     listBasins(request?: ListBasinsRequest): Promise<PageIterator<ListBasinsResponse, {
         cursor: string;
@@ -32,12 +38,12 @@ declare class S2Account {
 declare class S2Basin {
     private _basin;
     private _stream;
-    private requestOptions;
     private basinName;
-    private authToken;
+    private config;
+    private clientKind;
     private readonly basinURLSuffx;
-    private get basinURL();
-    constructor(authToken: string, basinName: string);
+    private get URL();
+    constructor(basinName: string, config: S2ClientConfig);
     stream(streamName: string): Stream;
     listStreams(request: ListStreamsRequest): Promise<PageIterator<ListStreamsResponse, {
         cursor: string;
@@ -49,14 +55,16 @@ declare class S2Basin {
 }
 declare class Stream {
     private _stream;
-    private basinName;
     private streamName;
+    private config;
+    private clientKind;
     private readonly basinURLSuffx;
     private get basinURL();
-    constructor(basinName: string, streamName: string, authToken: string);
+    constructor(basinName: string, streamName: string, config: S2ClientConfig);
     checkTail(): Promise<CheckTailResponse | undefined>;
-    readStream(request: ReadRequest): Promise<EventStream<ReadResponse> | undefined>;
-    read(request: ReadRequest): Promise<Output | undefined>;
     append(request: AppendRequest): Promise<AppendOutput | undefined>;
+    read(request: ReadRequest): Promise<Output | undefined>;
+    readStream(request: ReadRequest): AsyncGenerator<ReadResponse, void, undefined>;
 }
+export declare function genS2RequestToken(): string;
 //# sourceMappingURL=index.extras.d.ts.map

package/index.extras.d.ts.map

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

package/index.extras.js

@@ -1,4 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.S2Client = void 0;
 exports.genS2RequestToken = genS2RequestToken;
@@ -9,49 +23,49 @@ 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, "");
-}
+const endpoints_1 = require("./endpoints");
+__exportStar(require("./endpoints"), exports);
+const defaultS2ClientConfig = {
+    requestTimeout: 3000,
+    endpoints: endpoints_1.S2Endpoints.forCloud(endpoints_1.S2Cloud.Aws),
+};
 class S2Client {
     get account() {
-        return (this._account ?? (this._account = new S2Account(this.authToken)));
+        return (this._account ?? (this._account = new S2Account(this.config)));
     }
     basin(basinName) {
-        return (this._basin ?? (this._basin = new S2Basin(this.authToken, basinName)));
+        return (this._basin ?? (this._basin = new S2Basin(basinName, this.config)));
     }
-    constructor(authToken) {
-        this.authToken = authToken;
+    constructor(config) {
+        this.config = { ...defaultS2ClientConfig, ...config };
     }
 }
 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"],
-        };
+    constructor(config) {
+        this.accountURLSuffx = "/v1alpha";
+        this._account = new account_1.Account({
+            ...(config.authToken !== undefined && { bearerAuth: config.authToken }),
+            ...(config.requestTimeout !== undefined && { timeoutMs: config.requestTimeout })
+        });
+        this.config = config;
+    }
+    get URL() {
+        if (!this.config.endpoints)
+            return undefined;
+        return `https://${endpoints_1.ClientKind.toAuthority({ kind: "Account" }, this.config.endpoints)}${this.accountURLSuffx}`;
     }
     basin(basinName) {
-        return new S2Basin(this.authToken, basinName);
+        return new S2Basin(basinName, this.config);
     }
     async listBasins(request) {
-        return this._account.listBasins(request ?? {}, this.requestOptions);
+        const url = this.URL;
+        return this._account.listBasins(request ?? {}, url ? { serverURL: url } : {});
     }
     async getBasinConfig(basin) {
         const _request = { basin };
-        return (await this._account.getBasinConfig(_request, this.requestOptions)).basinConfig;
+        const url = this.URL;
+        return (await this._account.getBasinConfig(_request, url ? { serverURL: url } : {})).basinConfig;
     }
     async createBasin(basin, request) {
         const _request = {
@@ -59,10 +73,12 @@ class S2Account {
             s2RequestToken: genS2RequestToken(),
             createBasinRequest: request ?? {},
         };
-        return (await this._account.createBasin(_request, this.requestOptions)).basinInfo;
+        const url = this.URL;
+        return (await this._account.createBasin(_request, url ? { serverURL: url } : {})).basinInfo;
     }
     async deleteBasin(basin, if_exists) {
-        const response = await (0, accountDeleteBasin_1.accountDeleteBasin)(this._account, { basin }, this.requestOptions);
+        const url = this.URL;
+        const response = await (0, accountDeleteBasin_1.accountDeleteBasin)(this._account, { basin }, url ? { serverURL: url } : {});
         if (if_exists && response.error instanceof errors_1.NotFoundError)
             return;
         if (response.error)
@@ -70,42 +86,33 @@ class S2Account {
         return;
     }
     async reconfigureBasin(basin, config) {
+        const url = this.URL;
         const _request = { basin, basinConfig: config };
-        return (await this._account.reconfigureBasin(_request, this.requestOptions)).basinConfig;
+        return (await this._account.reconfigureBasin(_request, url ? { serverURL: url } : {})).basinConfig;
     }
 }
 class S2Basin {
-    get basinURL() {
-        return `https://${this.basinName}.${this.basinURLSuffx}`;
-    }
-    constructor(authToken, basinName) {
-        this.basinURLSuffx = "b.aws.s2.dev/v1alpha";
-        this._basin = new basin_1.Basin({ bearerAuth: authToken });
-        this.authToken = authToken;
+    get URL() {
+        return `https://${endpoints_1.ClientKind.toAuthority(this.clientKind, this.config.endpoints ?? endpoints_1.S2Endpoints.forCloud(endpoints_1.S2Cloud.Aws))}${this.basinURLSuffx}`;
+    }
+    constructor(basinName, config) {
+        this.basinURLSuffx = "/v1alpha";
+        this._basin = new basin_1.Basin({
+            ...(config.authToken !== undefined && { bearerAuth: config.authToken }),
+            ...(config.requestTimeout !== undefined && { timeoutMs: config.requestTimeout })
+        });
+        this.config = config;
+        this.clientKind = { kind: "Basin", basin: basinName };
         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, this.authToken)));
+        return (this._stream ?? (this._stream = new Stream(this.basinName, streamName, this.config)));
     }
     async listStreams(request) {
-        return this._basin.listStreams(request, { serverURL: this.basinURL, ...this.requestOptions });
+        return this._basin.listStreams(request, { serverURL: this.URL });
     }
     async getStreamConfig(stream) {
-        return (await this._basin.getStreamConfig({ stream }, { serverURL: this.basinURL, ...this.requestOptions })).streamConfig;
+        return (await this._basin.getStreamConfig({ stream }, { serverURL: this.URL })).streamConfig;
     }
     async createStream(stream, request) {
         const _request = {
@@ -113,12 +120,11 @@ class S2Basin {
             s2RequestToken: genS2RequestToken(),
             createStreamRequest: request ?? {},
         };
-        return (await this._basin.createStream(_request, { serverURL: this.basinURL, ...this.requestOptions })).streamInfo;
+        return (await this._basin.createStream(_request, { serverURL: this.URL })).streamInfo;
     }
     async deleteStream(stream, if_exists) {
         const response = await (0, basinDeleteStream_1.basinDeleteStream)(this._basin, { stream }, {
-            serverURL: this.basinURL,
-            ...this.requestOptions,
+            serverURL: this.URL,
         });
         if (if_exists && response instanceof errors_1.NotFoundError)
             return;
@@ -127,30 +133,97 @@ class S2Basin {
         return;
     }
     async reconfigureStream(stream, config) {
-        return (await this._basin.reconfigureStream({ stream, streamConfig: config }, { serverURL: this.basinURL, ...this.requestOptions })).streamConfig;
+        return (await this._basin.reconfigureStream({ stream, streamConfig: config }, { serverURL: this.URL })).streamConfig;
     }
 }
 class Stream {
     get basinURL() {
-        return `https://${this.basinName}.${this.basinURLSuffx}`;
+        return `https://${endpoints_1.ClientKind.toAuthority(this.clientKind, this.config.endpoints ?? endpoints_1.S2Endpoints.forCloud(endpoints_1.S2Cloud.Aws))}${this.basinURLSuffx}`;
     }
-    constructor(basinName, streamName, authToken) {
-        this.basinURLSuffx = "b.aws.s2.dev/v1alpha";
-        this.basinName = basinName;
+    constructor(basinName, streamName, config) {
+        this.basinURLSuffx = "/v1alpha";
+        this.config = config;
+        this.clientKind = { kind: "Basin", basin: basinName };
         this.streamName = streamName;
-        this._stream = new stream_1.Stream({ bearerAuth: authToken });
+        this._stream = new stream_1.Stream({
+            ...(config.authToken !== undefined && { bearerAuth: config.authToken }),
+            ...(config.requestTimeout !== undefined && { timeoutMs: config.requestTimeout })
+        });
     }
     async checkTail() {
         return (await this._stream.checkTail({ stream: this.streamName }, { serverURL: this.basinURL })).checkTailResponse;
     }
-    async readStream(request) {
-        return (await this._stream.read({ ...request, stream: this.streamName }, { serverURL: this.basinURL, acceptHeaderOverride: stream_1.ReadAcceptEnum.textEventStream })).readResponse;
+    async append(request) {
+        return (await this._stream.append({ ...request, stream: this.streamName }, { serverURL: this.basinURL })).appendOutput;
     }
     async read(request) {
         return (await this._stream.read({ ...request, stream: this.streamName }, { serverURL: this.basinURL })).output;
     }
-    async append(request) {
-        return (await this._stream.append({ ...request, stream: this.streamName }, { serverURL: this.basinURL })).appendOutput;
+    async *readStream(request) {
+        let currentRequest = { ...request };
+        let backoffMs = 100;
+        const maxBackoffMs = 5000;
+        const maxRetries = 5;
+        let retryCount = 0;
+        while (true) {
+            let stream;
+            try {
+                const response = await this._stream.read({ ...currentRequest, stream: this.streamName }, {
+                    serverURL: this.basinURL,
+                    timeoutMs: -1, // disable only for streaming
+                    acceptHeaderOverride: stream_1.ReadAcceptEnum.textEventStream
+                });
+                stream = response.readResponse;
+                if (!stream)
+                    return;
+                for await (const event of stream) {
+                    yield event;
+                    if (event.event === 'message') {
+                        const output = event;
+                        if ('batch' in output.data) {
+                            const batch = output.data.batch;
+                            if (batch.records && batch.records.length > 0) {
+                                const lastRecord = batch.records[batch.records.length - 1];
+                                if (lastRecord) {
+                                    currentRequest = { ...currentRequest, startSeqNum: lastRecord.seqNum + 1 };
+                                }
+                            }
+                            if (currentRequest.limit) {
+                                if (currentRequest.limit.count != null) {
+                                    currentRequest.limit.count = Math.max(0, currentRequest.limit.count - batch.records.length);
+                                }
+                                if (currentRequest.limit.bytes != null) {
+                                    currentRequest.limit.bytes = Math.max(0, currentRequest.limit.bytes - meteredBatch(batch));
+                                }
+                            }
+                        }
+                    }
+                }
+                return;
+            }
+            catch (error) {
+                if (error instanceof errors_1.ErrorResponse || error instanceof errors_1.NotFoundError)
+                    return;
+                if (retryCount >= maxRetries) {
+                    throw error;
+                }
+                retryCount++;
+                await new Promise(resolve => setTimeout(resolve, backoffMs));
+                backoffMs = Math.min(backoffMs * 2, maxBackoffMs);
+            }
+        }
     }
 }
+function meteredRecord(batch) {
+    const fixed = 8 + (2 * batch.headers.length);
+    const headerSize = batch.headers.reduce((acc, header) => acc + header.name.length + header.value.length, 0);
+    const bodySize = batch.body.length;
+    return fixed + headerSize + bodySize;
+}
+function meteredBatch(batch) {
+    return batch.records.reduce((acc, record) => acc + meteredRecord(record), 0);
+}
+function genS2RequestToken() {
+    return (0, uuid_1.v4)().replace(/-/g, "");
+}
 //# sourceMappingURL=index.extras.js.map

package/index.extras.js.map

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

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@s2-dev/streamstore",
-  "version": "0.3.2",
+  "version": "0.3.8",
   "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.3.2";
-    readonly genVersion: "2.505.0";
-    readonly userAgent: "speakeasy-sdk/typescript 0.3.2 2.505.0 1.0.0 @s2-dev/streamstore";
+    readonly sdkVersion: "0.3.8";
+    readonly genVersion: "2.506.0";
+    readonly userAgent: "speakeasy-sdk/typescript 0.3.8 2.506.0 1.0.0 @s2-dev/streamstore";
 };
 //# sourceMappingURL=config.d.ts.map

package/lib/config.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2-dev/streamstore",
-  "version": "0.3.2",
+  "version": "0.3.8",
   "author": "Speakeasy",
   "main": "./index.js",
   "sideEffects": false,
@@ -19,6 +19,7 @@
   "devDependencies": {
     "@eslint/js": "^9.19.0",
     "@types/jsonpath": "^0.2.4",
+    "@types/node": "^22.13.1",
     "@types/uuid": "^9.0.8",
     "eslint": "^9.19.0",
     "globals": "^15.14.0",

package/src/endpoints.ts

@@ -0,0 +1,159 @@
+type Authority = string;
+
+// Basin Name
+type BasinName = string;
+
+/**
+ * S2 cloud environment to connect with.
+ */
+export enum S2Cloud {
+    /** S2 running on AWS */
+    Aws = "aws"
+}
+
+/**
+ * Endpoint for connecting to an S2 basin.
+ */
+export enum BasinEndpointKind {
+    ParentZone = "ParentZone",
+    Direct = "Direct"
+}
+
+export type BasinEndpoint = {
+    kind: BasinEndpointKind.ParentZone;
+    authority: Authority;
+} | {
+    kind: BasinEndpointKind.Direct;
+    authority: Authority;
+};
+
+class S2EndpointError extends Error {
+    constructor(message: string) {
+        super(message);
+        this.name = 'S2EndpointError';
+    }
+}
+
+/**
+ * Endpoints for the S2 environment.
+ * 
+ * You can find the S2 endpoints in our [documentation](https://s2.dev/docs/interface/endpoints)
+ */
+export class S2Endpoints {
+    /** Used by `AccountService` requests */
+    public account: Authority;
+    /** Used by `BasinService` and `StreamService` requests */
+    public basin: BasinEndpoint;
+
+    constructor(account: Authority, basin: BasinEndpoint) {
+        this.account = account;
+        this.basin = basin;
+    }
+
+    /**
+     * Get S2 endpoints for the specified cloud.
+     */
+    static forCloud(cloud: S2Cloud): S2Endpoints {
+        const authority = `${cloud}.s2.dev`;
+        return new S2Endpoints(
+            authority,
+            {
+                kind: BasinEndpointKind.ParentZone,
+                authority: `b.${cloud}.s2.dev`
+            }
+        );
+    }
+
+    /**
+     * Get S2 endpoints for the specified cell.
+     */
+    static forCell(cloud: S2Cloud, cellId: string): S2Endpoints {
+        const cellEndpoint = `${cellId}.o.${cloud}.s2.dev`;
+        return new S2Endpoints(
+            cellEndpoint,
+            {
+                kind: BasinEndpointKind.Direct,
+                authority: cellEndpoint
+            }
+        );
+    }
+
+    /**
+     * Get S2 endpoints from environment variables.
+     * 
+     * The following environment variables are used:
+     * - `S2_CLOUD`: Valid S2 cloud name. Defaults to AWS.
+     * - `S2_ACCOUNT_ENDPOINT`: Overrides the account endpoint.
+     * - `S2_BASIN_ENDPOINT`: Overrides the basin endpoint. The prefix `"{basin}."` indicates the
+     *   basin endpoint is `ParentZone` else `Direct`.
+     */
+    static fromEnv(): S2Endpoints {
+        let cloud: S2Cloud;
+        try {
+            const cloudEnv = process.env['S2_CLOUD'] || S2Cloud.Aws;
+            if (Object.values(S2Cloud).includes(cloudEnv as S2Cloud)) {
+                cloud = cloudEnv as S2Cloud;
+            } else {
+                throw new S2EndpointError(`Invalid S2_CLOUD: ${cloudEnv}`);
+            }
+        } catch (err) {
+            const error = err as Error;
+            throw new S2EndpointError(`Invalid S2_CLOUD: ${error.message}`);
+        }
+
+        const endpoints = S2Endpoints.forCloud(cloud);
+
+        const accountEndpoint = process.env['S2_ACCOUNT_ENDPOINT'];
+        if (accountEndpoint !== undefined) {
+            if (typeof accountEndpoint !== 'string') {
+                throw new S2EndpointError('Invalid S2_ACCOUNT_ENDPOINT: not string');
+            }
+            endpoints.account = accountEndpoint;
+        }
+
+        const basinEndpoint = process.env['S2_BASIN_ENDPOINT'];
+        if (basinEndpoint !== undefined) {
+            if (typeof basinEndpoint !== 'string') {
+                throw new S2EndpointError('Invalid S2_BASIN_ENDPOINT: not string');
+            }
+
+            if (basinEndpoint.startsWith('{basin}.')) {
+                const parentZone = basinEndpoint.substring(7);
+                endpoints.basin = {
+                    kind: BasinEndpointKind.ParentZone,
+                    authority: parentZone
+                };
+            } else {
+                endpoints.basin = {
+                    kind: BasinEndpointKind.Direct,
+                    authority: basinEndpoint
+                };
+            }
+        }
+
+        return endpoints;
+    }
+}
+
+/**
+ * Client kind for different S2 services
+ */
+export type ClientKind = 
+    | { kind: 'Account' }
+    | { kind: 'Basin'; basin: BasinName };
+
+export const ClientKind = {
+    toAuthority(kind: ClientKind, endpoints: S2Endpoints): Authority {
+        switch (kind.kind) {
+            case 'Account':
+                return endpoints.account;
+            case 'Basin':
+                switch (endpoints.basin.kind) {
+                    case BasinEndpointKind.ParentZone:
+                        return `${kind.basin}.${endpoints.basin.authority}`;
+                    case BasinEndpointKind.Direct:
+                        return endpoints.basin.authority;
+                }
+        }
+    }
+};

package/src/index.extras.ts

@@ -1,5 +1,4 @@
 import { accountDeleteBasin } from "./funcs/accountDeleteBasin";
-import { RequestOptions } from "./lib/sdks";
 import {
     AppendOutput,
     BasinConfig,
@@ -9,10 +8,13 @@ import {
     CreateStreamRequest,
     Output,
     ReadResponse,
+    ReadResponseOutput,
+    SequencedRecord,
+    SequencedRecordBatch,
     StreamConfig,
     StreamInfo,
 } from "./models/components";
-import { NotFoundError } from "./models/errors";
+import { ErrorResponse, NotFoundError } from "./models/errors";
 import {
     GetBasinConfigRequest,
     ListBasinsRequest,
@@ -34,6 +36,7 @@ import { Account as InnerAccount } from "./sdk/account";
 import { v4 } from "uuid";
 import { basinDeleteStream } from "./funcs/basinDeleteStream";
 import { EventStream } from "./lib/event-streams";
+import { ClientKind, S2Cloud, S2Endpoints } from "./endpoints";
 
 export type ReadRequest = Omit<ReadRequestInner, "stream">;
 export type AppendRequest = Omit<AppendRequestInner, "stream">;
@@ -57,64 +60,71 @@ export type {
     StreamInfo,
 } from "./models/components";
 
-export function genS2RequestToken(): string {
-    return v4().replace(/-/g, "");
-}
+export * from "./endpoints";
+
+export type S2ClientConfig = {
+    authToken?: string;
+    requestTimeout?: number;
+    endpoints?: S2Endpoints;
+};
+
+const defaultS2ClientConfig: S2ClientConfig = {
+    requestTimeout: 3000,
+    endpoints: S2Endpoints.forCloud(S2Cloud.Aws),
+};
 
 export class S2Client {
-    private authToken: string;
+    private config: S2ClientConfig;
     private _account?: S2Account;
     get account(): S2Account {
-        return (this._account ??= new S2Account(this.authToken));
+        return (this._account ??= new S2Account(this.config));
     }
 
     private _basin?: S2Basin;
     basin(basinName: string): S2Basin {
-        return (this._basin ??= new S2Basin(this.authToken, basinName));
+        return (this._basin ??= new S2Basin(basinName, this.config));
     }
 
-    constructor(authToken: string) {
-        this.authToken = authToken;
+    constructor(config?: S2ClientConfig) {
+        this.config = { ...defaultS2ClientConfig, ...config };
     }
 }
 
 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"],
-        };
+    private config: S2ClientConfig;
+    private readonly accountURLSuffx = "/v1alpha";
+
+    constructor(config: S2ClientConfig) {
+        this._account = new InnerAccount({
+            ...(config.authToken !== undefined && { bearerAuth: config.authToken }),
+            ...(config.requestTimeout !== undefined && { timeoutMs: config.requestTimeout })
+        });
+        this.config = config;
+    }
+
+    get URL(): string | undefined {
+        if (!this.config.endpoints) return undefined;
+        return `https://${ClientKind.toAuthority({ kind: "Account" }, this.config.endpoints)}${this.accountURLSuffx}`;
     }
 
     basin(basinName: string): S2Basin {
-        return new S2Basin(this.authToken, basinName);
+        return new S2Basin(basinName, this.config);
     }
 
     async listBasins(
         request?: ListBasinsRequest
     ): Promise<PageIterator<ListBasinsResponse, { cursor: string }>> {
-        return this._account.listBasins(request ?? {}, this.requestOptions);
+        const url = this.URL;
+        return this._account.listBasins(request ?? {}, url ? { serverURL: url } : {});
     }
 
     async getBasinConfig(basin: string): Promise<BasinConfig | undefined> {
         const _request: GetBasinConfigRequest = { basin };
-        return (await this._account.getBasinConfig(_request, this.requestOptions)).basinConfig;
+        const url = this.URL;
+        return (await this._account.getBasinConfig(_request
+            , url ? { serverURL: url } : {}
+        )).basinConfig;
     }
 
     async createBasin(basin: string, request?: CreateBasinRequest): Promise<BasinInfo | undefined> {
@@ -123,67 +133,64 @@ class S2Account {
             s2RequestToken: genS2RequestToken(),
             createBasinRequest: request ?? {},
         };
-        return (await this._account.createBasin(_request, this.requestOptions)).basinInfo;
+        const url = this.URL;
+        return (await this._account.createBasin(_request,
+            url ? { serverURL: url } : {}
+        )).basinInfo;
     }
 
     async deleteBasin(basin: string, if_exists?: boolean): Promise<void | undefined> {
-        const response = await accountDeleteBasin(this._account, { basin }, this.requestOptions);
+        const url = this.URL;
+        const response = await accountDeleteBasin(this._account, { basin }, url ? { serverURL: url } : {});
         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 url = this.URL;
         const _request: ReconfigureBasinRequest = { basin, basinConfig: config };
-        return (await this._account.reconfigureBasin(_request, this.requestOptions)).basinConfig;
+        return (await this._account.reconfigureBasin(_request
+            , url ? { serverURL: url } : {}
+        )).basinConfig;
     }
 }
 
 class S2Basin {
     private _basin: InnerBasin;
     private _stream!: Stream;
-    private requestOptions: RequestOptions;
     private basinName: string;
-    private authToken: string;
-    private readonly basinURLSuffx = "b.aws.s2.dev/v1alpha";
+    private config: S2ClientConfig;
+    private clientKind: ClientKind;
+    private readonly basinURLSuffx = "/v1alpha";
 
-    private get basinURL(): string {
-        return `https://${this.basinName}.${this.basinURLSuffx}`;
+    private get URL(): string {
+        return `https://${ClientKind.toAuthority(this.clientKind, this.config.endpoints ?? S2Endpoints.forCloud(S2Cloud.Aws))}${this.basinURLSuffx}`;
     }
 
-    constructor(authToken: string, basinName: string) {
-        this._basin = new InnerBasin({ bearerAuth: authToken });
-        this.authToken = authToken;
+    constructor(basinName: string, config: S2ClientConfig) {
+        this._basin = new InnerBasin({
+            ...(config.authToken !== undefined && { bearerAuth: config.authToken }),
+            ...(config.requestTimeout !== undefined && { timeoutMs: config.requestTimeout })
+        });
+        this.config = config;
+        this.clientKind = { kind: "Basin" as const, basin: basinName };
         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, this.authToken));
+        return (this._stream ??= new Stream(this.basinName, streamName, this.config));
     }
 
     async listStreams(
         request: ListStreamsRequest
     ): Promise<PageIterator<ListStreamsResponse, { cursor: string }>> {
-        return this._basin.listStreams(request, { serverURL: this.basinURL, ...this.requestOptions });
+        return this._basin.listStreams(request, { serverURL: this.URL });
     }
 
     async getStreamConfig(stream: string): Promise<StreamConfig | undefined> {
         return (
-            await this._basin.getStreamConfig({ stream }, { serverURL: this.basinURL, ...this.requestOptions })
+            await this._basin.getStreamConfig({ stream }, { serverURL: this.URL })
         ).streamConfig;
     }
 
@@ -194,14 +201,13 @@ class S2Basin {
             createStreamRequest: request ?? {},
         };
         return (
-            await this._basin.createStream(_request, { serverURL: this.basinURL, ...this.requestOptions })
+            await this._basin.createStream(_request, { serverURL: this.URL })
         ).streamInfo;
     }
 
     async deleteStream(stream: string, if_exists?: boolean): Promise<void | undefined> {
         const response = await basinDeleteStream(this._basin, { stream }, {
-            serverURL: this.basinURL,
-            ...this.requestOptions,
+            serverURL: this.URL,
         });
         if (if_exists && response instanceof NotFoundError) return;
         if (response.error) throw new Error(response.error.message);
@@ -212,7 +218,7 @@ class S2Basin {
         return (
             await this._basin.reconfigureStream(
                 { stream, streamConfig: config },
-                { serverURL: this.basinURL, ...this.requestOptions }
+                { serverURL: this.URL }
             )
         ).streamConfig;
     }
@@ -220,18 +226,23 @@ class S2Basin {
 
 class Stream {
     private _stream: InnerStream;
-    private basinName: string;
     private streamName: string;
-    private readonly basinURLSuffx = "b.aws.s2.dev/v1alpha";
+    private config: S2ClientConfig;
+    private clientKind: ClientKind;
+    private readonly basinURLSuffx = "/v1alpha";
 
     private get basinURL(): string {
-        return `https://${this.basinName}.${this.basinURLSuffx}`;
+        return `https://${ClientKind.toAuthority(this.clientKind, this.config.endpoints ?? S2Endpoints.forCloud(S2Cloud.Aws))}${this.basinURLSuffx}`;
     }
 
-    constructor(basinName: string, streamName: string, authToken: string) {
-        this.basinName = basinName;
+    constructor(basinName: string, streamName: string, config: S2ClientConfig) {
+        this.config = config;
+        this.clientKind = { kind: "Basin" as const, basin: basinName };
         this.streamName = streamName;
-        this._stream = new InnerStream({ bearerAuth: authToken });
+        this._stream = new InnerStream({
+            ...(config.authToken !== undefined && { bearerAuth: config.authToken }),
+            ...(config.requestTimeout !== undefined && { timeoutMs: config.requestTimeout })
+        });
     }
 
     async checkTail(): Promise<CheckTailResponse | undefined> {
@@ -240,13 +251,10 @@ class Stream {
         ).checkTailResponse;
     }
 
-    async readStream(request: ReadRequest): Promise<EventStream<ReadResponse> | undefined> {
+    async append(request: AppendRequest): Promise<AppendOutput | undefined> {
         return (
-            await this._stream.read(
-                { ...request, stream: this.streamName },
-                { serverURL: this.basinURL, acceptHeaderOverride: ReadAcceptEnum.textEventStream }
-            )
-        ).readResponse;
+            await this._stream.append({ ...request, stream: this.streamName }, { serverURL: this.basinURL })
+        ).appendOutput;
     }
 
     async read(request: ReadRequest): Promise<Output | undefined> {
@@ -255,9 +263,77 @@ class Stream {
         ).output;
     }
 
-    async append(request: AppendRequest): Promise<AppendOutput | undefined> {
-        return (
-            await this._stream.append({ ...request, stream: this.streamName }, { serverURL: this.basinURL })
-        ).appendOutput;
+    async *readStream(request: ReadRequest): AsyncGenerator<ReadResponse, void, undefined> {
+        let currentRequest: ReadRequest = { ...request };
+        let backoffMs = 100;
+        const maxBackoffMs = 5000;
+        const maxRetries = 5;
+        let retryCount = 0;
+
+        while (true) {
+            let stream: EventStream<ReadResponse> | undefined;
+            try {
+                const response = await this._stream.read(
+                    { ...currentRequest, stream: this.streamName },
+                    {
+                        serverURL: this.basinURL,
+                        timeoutMs: -1, // disable only for streaming
+                        acceptHeaderOverride: ReadAcceptEnum.textEventStream
+                    }
+                );
+                stream = response.readResponse;
+                if (!stream) return;
+
+                for await (const event of stream) {
+                    yield event;
+
+                    if (event.event === 'message') {
+                        const output = event as ReadResponseOutput;
+                        if ('batch' in output.data) {
+                            const batch = output.data.batch;
+                            if (batch.records && batch.records.length > 0) {
+                                const lastRecord = batch.records[batch.records.length - 1];
+                                if (lastRecord) {
+                                    currentRequest = { ...currentRequest, startSeqNum: lastRecord.seqNum + 1 };
+                                }
+                            }
+                            if (currentRequest.limit) {
+                                if (currentRequest.limit.count != null) {
+                                    currentRequest.limit.count = Math.max(0, currentRequest.limit.count - batch.records.length);
+                                }
+                                if (currentRequest.limit.bytes != null) {
+                                    currentRequest.limit.bytes = Math.max(0, currentRequest.limit.bytes - meteredBatch(batch));
+                                }
+                            }
+                        }
+                    }
+                }
+                return;
+            } catch (error) {
+                if (error instanceof ErrorResponse || error instanceof NotFoundError) return;
+                if (retryCount >= maxRetries) {
+                    throw error;
+                }
+                retryCount++;
+                await new Promise(resolve => setTimeout(resolve, backoffMs));
+                backoffMs = Math.min(backoffMs * 2, maxBackoffMs);
+            }
+        }
     }
 }
+
+function meteredRecord(batch: SequencedRecord): number {
+    const fixed = 8 + (2 * batch.headers.length);
+    const headerSize = batch.headers.reduce((acc, header) => acc + header.name.length + header.value.length, 0);
+    const bodySize = batch.body.length;
+
+    return fixed + headerSize + bodySize;
+}
+
+function meteredBatch(batch: SequencedRecordBatch): number {
+    return batch.records.reduce((acc, record) => acc + meteredRecord(record), 0);
+}
+
+export function genS2RequestToken(): string {
+    return v4().replace(/-/g, "");
+}

package/src/lib/config.ts

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