@zshannon/streamstore 0.22.3

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/batch-transform.d.ts

@@ -0,0 +1,60 @@
+import { AppendInput, type AppendRecord } from "./types.js";
+export interface BatchTransformOptions {
+    /** Duration in milliseconds to wait before flushing a batch (default: 5ms) */
+    lingerDurationMillis?: number;
+    /** Maximum number of records in a batch (default: 1000, max: 1000) */
+    maxBatchRecords?: number;
+    /** Maximum batch size in metered bytes (default: 1 MiB, max: 1 MiB) */
+    maxBatchBytes?: number;
+    /** Optional fencing token to enforce (remains static across batches) */
+    fencingToken?: string;
+    /** Optional sequence number to match for first batch (auto-increments for subsequent batches) */
+    matchSeqNum?: number;
+}
+/** Batch output type with optional fencing token and matchSeqNum */
+export type BatchOutput = AppendInput;
+/**
+ * A TransformStream that batches AppendRecords based on time, record count, and byte size.
+ *
+ * Input: AppendRecord (individual records)
+ * Output: { records: AppendRecord[], fencingToken?: string, matchSeqNum?: number }
+ *
+ * @example
+ * ```typescript
+ * const batcher = new BatchTransform<"string">({
+ *   lingerDurationMillis: 20,
+ *   maxBatchRecords: 100,
+ *   maxBatchBytes: 256 * 1024,
+ *   matchSeqNum: 0  // Optional: auto-increments per batch
+ * });
+ *
+ * // Pipe through the batcher and session to get acks
+ * readable.pipeThrough(batcher).pipeThrough(session).pipeTo(writable);
+ *
+ * // Or use manually
+ * const writer = batcher.writable.getWriter();
+ * writer.write(AppendRecord.string({ body: "foo" }));
+ * await writer.close();
+ *
+ * for await (const batch of batcher.readable) {
+ *   console.log(`Got batch of ${batch.records.length} records`);
+ * }
+ * ```
+ */
+export declare class BatchTransform extends TransformStream<AppendRecord, BatchOutput> {
+    private currentBatch;
+    private currentBatchSize;
+    private lingerTimer;
+    private controller;
+    private readonly maxBatchRecords;
+    private readonly maxBatchBytes;
+    private readonly lingerDuration;
+    private readonly fencingToken?;
+    private nextMatchSeqNum?;
+    constructor(args?: BatchTransformOptions);
+    private handleRecord;
+    private flush;
+    private startLingerTimer;
+    private cancelLingerTimer;
+}
+//# sourceMappingURL=batch-transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch-transform.d.ts","sourceRoot":"","sources":["../../src/batch-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,WAAW,qBAAqB;IACrC,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,cAAe,SAAQ,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC;IAC7E,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,UAAU,CACZ;IACN,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,eAAe,CAAC,CAAS;gBAErB,IAAI,CAAC,EAAE,qBAAqB;IAyDxC,OAAO,CAAC,YAAY;IA4CpB,OAAO,CAAC,KAAK;IA2Bb,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;CAMzB"}

package/dist/cjs/batch-transform.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchTransform = void 0;
+const error_js_1 = require("./error.js");
+const types_js_1 = require("./types.js");
+const utils_js_1 = require("./utils.js");
+/**
+ * A TransformStream that batches AppendRecords based on time, record count, and byte size.
+ *
+ * Input: AppendRecord (individual records)
+ * Output: { records: AppendRecord[], fencingToken?: string, matchSeqNum?: number }
+ *
+ * @example
+ * ```typescript
+ * const batcher = new BatchTransform<"string">({
+ *   lingerDurationMillis: 20,
+ *   maxBatchRecords: 100,
+ *   maxBatchBytes: 256 * 1024,
+ *   matchSeqNum: 0  // Optional: auto-increments per batch
+ * });
+ *
+ * // Pipe through the batcher and session to get acks
+ * readable.pipeThrough(batcher).pipeThrough(session).pipeTo(writable);
+ *
+ * // Or use manually
+ * const writer = batcher.writable.getWriter();
+ * writer.write(AppendRecord.string({ body: "foo" }));
+ * await writer.close();
+ *
+ * for await (const batch of batcher.readable) {
+ *   console.log(`Got batch of ${batch.records.length} records`);
+ * }
+ * ```
+ */
+class BatchTransform extends TransformStream {
+    currentBatch = [];
+    currentBatchSize = 0;
+    lingerTimer = null;
+    controller = null;
+    maxBatchRecords;
+    maxBatchBytes;
+    lingerDuration;
+    fencingToken;
+    nextMatchSeqNum;
+    constructor(args) {
+        let controller;
+        super({
+            start: (c) => {
+                controller = c;
+            },
+            transform: (chunk, c) => {
+                // Store controller reference on first transform
+                if (!this.controller) {
+                    this.controller = c;
+                }
+                this.handleRecord(chunk);
+            },
+            flush: () => {
+                this.flush();
+            },
+        });
+        // Validate configuration
+        if (args?.maxBatchRecords !== undefined) {
+            if (args.maxBatchRecords < 1 || args.maxBatchRecords > 1000) {
+                throw new error_js_1.S2Error({
+                    message: `maxBatchRecords must be between 1 and 1000 (inclusive); got ${args.maxBatchRecords}`,
+                    status: 400,
+                    origin: "sdk",
+                });
+            }
+        }
+        if (args?.maxBatchBytes !== undefined) {
+            const max = 1024 * 1024;
+            if (args.maxBatchBytes < 1 || args.maxBatchBytes > max) {
+                throw new error_js_1.S2Error({
+                    message: `maxBatchBytes must be between 1 and ${max} (1 MiB) bytes (inclusive); got ${args.maxBatchBytes}`,
+                    status: 400,
+                    origin: "sdk",
+                });
+            }
+        }
+        if (args?.lingerDurationMillis !== undefined) {
+            if (args.lingerDurationMillis < 0) {
+                throw new error_js_1.S2Error({
+                    message: `lingerDurationMillis must be >= 0; got ${args.lingerDurationMillis}`,
+                    status: 400,
+                    origin: "sdk",
+                });
+            }
+        }
+        // Apply defaults
+        this.maxBatchRecords = args?.maxBatchRecords ?? 1000;
+        this.maxBatchBytes = args?.maxBatchBytes ?? 1024 * 1024;
+        this.lingerDuration = args?.lingerDurationMillis ?? 5;
+        this.fencingToken = args?.fencingToken;
+        this.nextMatchSeqNum = args?.matchSeqNum;
+    }
+    handleRecord(record) {
+        const recordSize = (0, utils_js_1.meteredBytes)(record);
+        // Reject individual records that exceed the max batch size
+        if (recordSize > this.maxBatchBytes) {
+            throw new error_js_1.S2Error({
+                message: `Record size ${recordSize} bytes exceeds maximum batch size of ${this.maxBatchBytes} bytes`,
+                status: 400,
+                origin: "sdk",
+            });
+        }
+        // Start linger timer on first record added to an empty batch
+        if (this.currentBatch.length === 0 && this.lingerDuration > 0) {
+            this.startLingerTimer();
+        }
+        // Check if adding this record would exceed limits
+        const wouldExceedRecords = this.currentBatch.length + 1 > this.maxBatchRecords;
+        const wouldExceedBytes = this.currentBatchSize + recordSize > this.maxBatchBytes;
+        if (wouldExceedRecords || wouldExceedBytes) {
+            this.flush();
+            // Restart linger timer for new batch
+            if (this.lingerDuration > 0) {
+                this.startLingerTimer();
+            }
+        }
+        // Add record to current batch
+        this.currentBatch.push(record);
+        this.currentBatchSize += recordSize;
+        // Check if we've now reached the limits
+        const nowExceedsRecords = this.currentBatch.length >= this.maxBatchRecords;
+        const nowExceedsBytes = this.currentBatchSize >= this.maxBatchBytes;
+        if (nowExceedsRecords || nowExceedsBytes) {
+            this.flush();
+        }
+    }
+    flush() {
+        this.cancelLingerTimer();
+        if (this.currentBatch.length === 0) {
+            return;
+        }
+        // Auto-increment matchSeqNum for next batch
+        const matchSeqNum = this.nextMatchSeqNum;
+        if (this.nextMatchSeqNum !== undefined) {
+            this.nextMatchSeqNum += this.currentBatch.length;
+        }
+        // Emit the batch downstream with optional fencing token and matchSeqNum
+        if (this.controller) {
+            const batch = types_js_1.AppendInput.create([...this.currentBatch], {
+                fencingToken: this.fencingToken,
+                matchSeqNum,
+            });
+            this.controller.enqueue(batch);
+        }
+        // Reset batch
+        this.currentBatch = [];
+        this.currentBatchSize = 0;
+    }
+    startLingerTimer() {
+        this.cancelLingerTimer();
+        this.lingerTimer = setTimeout(() => {
+            this.lingerTimer = null;
+            if (this.currentBatch.length > 0) {
+                this.flush();
+            }
+        }, this.lingerDuration);
+    }
+    cancelLingerTimer() {
+        if (this.lingerTimer) {
+            clearTimeout(this.lingerTimer);
+            this.lingerTimer = null;
+        }
+    }
+}
+exports.BatchTransform = BatchTransform;
+//# sourceMappingURL=batch-transform.js.map

package/dist/cjs/batch-transform.js.map

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

package/dist/cjs/common.d.ts

@@ -0,0 +1,156 @@
+import type { PkiAuthContext } from "./auth/pki-auth.js";
+import { S2Endpoints, type S2EndpointsInit } from "./endpoints.js";
+import type { Client } from "./generated/client/types.gen.js";
+/**
+ * Policy for retrying append operations.
+ *
+ * - `all`: Retry all append operations, including those that may have side effects (default)
+ * - `noSideEffects`: Only retry append operations that are guaranteed to have no side effects
+ */
+export type AppendRetryPolicy = "all" | "noSideEffects";
+/**
+ * Auth provider that abstracts token-based and PKI-based authentication.
+ */
+export type AuthProvider = {
+    type: "token";
+    token: string;
+} | {
+    type: "pki";
+    context: PkiAuthContext;
+};
+/**
+ * Retry configuration for handling transient failures.
+ */
+export type RetryConfig = {
+    /**
+     * Total number of attempts, including the initial try.
+     * Must be >= 1. A value of 1 means no retries.
+     * @default 3
+     */
+    maxAttempts?: number;
+    /**
+     * Minimum delay in milliseconds for exponential backoff.
+     * The first retry will have a delay in the range [minBaseDelayMillis, 2*minBaseDelayMillis).
+     * @default 100
+     */
+    minBaseDelayMillis?: number;
+    /**
+     * Maximum base delay in milliseconds for exponential backoff.
+     * Once the exponential backoff reaches this value, it stays capped here.
+     * Note: actual delay with jitter can be up to 2*maxBaseDelayMillis.
+     * @default 1000
+     */
+    maxBaseDelayMillis?: number;
+    /**
+     * Policy for retrying append operations.
+     * @default "all"
+     */
+    appendRetryPolicy?: AppendRetryPolicy;
+    /**
+     * Maximum time in milliseconds to wait for an append ack before considering
+     * the attempt timed out and applying retry logic.
+     *
+     * Used by retrying append sessions. When unset, defaults to 5000ms.
+     *
+     * @deprecated Use `requestTimeoutMillis` on {@link S2ClientOptions} instead.
+     */
+    requestTimeoutMillis?: number;
+    /**
+     * Maximum time in milliseconds to wait for connection establishment.
+     * This is a "fail fast" timeout that aborts slow connections early.
+     * Connection time counts toward requestTimeoutMillis.
+     *
+     * Only applies to S2S (HTTP/2) transport when establishing new connections.
+     * Reused pooled connections are not subject to this timeout.
+     *
+     * @default 3000
+     * @deprecated Use `connectionTimeoutMillis` on {@link S2ClientOptions} instead.
+     */
+    connectionTimeoutMillis?: number;
+};
+export type S2EnvironmentConfig = Partial<S2ClientOptions>;
+export declare class S2Environment {
+    static parse(): S2EnvironmentConfig;
+}
+/**
+ * Configuration for constructing the top-level `S2` client.
+ *
+ * Provide one of:
+ * - `accessToken` for Bearer token auth (legacy)
+ * - `rootKey` for PKI bootstrap mode (limited to admin operations)
+ * - `authContext` for PKI proper auth (full access)
+ */
+export type S2ClientOptions = {
+    /**
+     * Access token used for HTTP Bearer authentication.
+     * Typically obtained via your S2 account or created using `s2.accessTokens.issue`.
+     *
+     * Mutually exclusive with `rootKey` and `authContext`.
+     */
+    accessToken?: string;
+    /**
+     * P256 private key as base58-encoded 32 bytes for PKI bootstrap mode.
+     * When provided, the SDK generates short-lived Biscuit tokens on-the-fly
+     * and signs all requests with RFC 9421 HTTP message signatures.
+     *
+     * Bootstrap mode is limited to admin operations (list basins, issue tokens).
+     * For full access including stream operations, use `authContext` instead.
+     *
+     * Mutually exclusive with `accessToken` and `authContext`.
+     */
+    rootKey?: string;
+    /**
+     * Pre-created PKI auth context for proper auth mode.
+     * Create with `createPkiAuth({ token, signingKey })`.
+     *
+     * This is the recommended mode for full access to all operations including streams.
+     *
+     * Mutually exclusive with `accessToken` and `rootKey`.
+     */
+    authContext?: PkiAuthContext;
+    /**
+     * Endpoint configuration for the S2 environment.
+     *
+     * Defaults to AWS (`aws.s2.dev` and `{basin}.b.aws.s2.dev`) with the API base path inferred as `/v1`.
+     */
+    endpoints?: S2Endpoints | S2EndpointsInit;
+    /**
+     * Maximum time in milliseconds to wait for an append ack before considering
+     * the attempt timed out and applying retry logic.
+     *
+     * Used by retrying append sessions. When unset, defaults to 5000ms.
+     */
+    requestTimeoutMillis?: number;
+    /**
+     * Maximum time in milliseconds to wait for connection establishment.
+     * This is a "fail fast" timeout that aborts slow connections early.
+     * Connection time counts toward requestTimeoutMillis.
+     *
+     * Only applies to S2S (HTTP/2) transport when establishing new connections.
+     * Reused pooled connections are not subject to this timeout.
+     *
+     * @default 3000
+     */
+    connectionTimeoutMillis?: number;
+    /**
+     * Retry configuration for handling transient failures.
+     * Applies to management operations (basins, streams, tokens) and stream operations (read, append).
+     * @default { maxAttempts: 3, minBaseDelayMillis: 100, maxBaseDelayMillis: 1000, appendRetryPolicy: "all" }
+     */
+    retry?: RetryConfig;
+};
+/**
+ * Per-request options that apply to all SDK operations.
+ */
+export type S2RequestOptions = {
+    /**
+     * Optional abort signal to cancel the underlying HTTP request.
+     */
+    signal?: AbortSignal;
+};
+/**
+ * Creates a client configured with the given auth provider.
+ * Adds request interceptor for PKI signing when using PKI auth.
+ */
+export declare function createAuthenticatedClient(baseUrl: string, authProvider: AuthProvider, headers: Record<string, string>): Client;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,eAAe,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAE3D,qBAAa,aAAa;WACX,KAAK,IAAI,mBAAmB;CAyB1C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IAC1C;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;OASG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAsBR"}

package/dist/cjs/common.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Environment = void 0;
+exports.createAuthenticatedClient = createAuthenticatedClient;
+const endpoints_js_1 = require("./endpoints.js");
+const index_js_1 = require("./generated/client/index.js");
+class S2Environment {
+    static parse() {
+        const config = {};
+        const token = process.env.S2_ACCESS_TOKEN;
+        if (token) {
+            config.accessToken = token;
+        }
+        const rootKey = process.env.S2_ROOT_KEY;
+        if (rootKey) {
+            config.rootKey = rootKey;
+        }
+        const accountEndpoint = process.env.S2_ACCOUNT_ENDPOINT;
+        const basinEndpoint = process.env.S2_BASIN_ENDPOINT;
+        if (accountEndpoint || basinEndpoint) {
+            const endpointsInit = {
+                account: accountEndpoint || undefined,
+                basin: basinEndpoint || undefined,
+            };
+            config.endpoints = new endpoints_js_1.S2Endpoints(endpointsInit);
+        }
+        return config;
+    }
+}
+exports.S2Environment = S2Environment;
+/**
+ * Creates a client configured with the given auth provider.
+ * Adds request interceptor for PKI signing when using PKI auth.
+ */
+function createAuthenticatedClient(baseUrl, authProvider, headers) {
+    const client = (0, index_js_1.createClient)((0, index_js_1.createConfig)({
+        baseUrl,
+        auth: async () => {
+            if (authProvider.type === "pki") {
+                return authProvider.context.getToken();
+            }
+            return authProvider.token;
+        },
+        headers,
+    }));
+    if (authProvider.type === "pki") {
+        const pkiContext = authProvider.context;
+        client.interceptors.request.use(async (request) => {
+            return pkiContext.signRequest(request);
+        });
+    }
+    return client;
+}
+//# 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":";;;AA4LA,8DA0BC;AArND,iDAAmE;AACnE,0DAAyE;AA4EzE,MAAa,aAAa;IAClB,MAAM,CAAC,KAAK;QAClB,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAC1B,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACxD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACpD,IAAI,eAAe,IAAI,aAAa,EAAE,CAAC;YACtC,MAAM,aAAa,GAAoB;gBACtC,OAAO,EAAE,eAAe,IAAI,SAAS;gBACrC,KAAK,EAAE,aAAa,IAAI,SAAS;aACjC,CAAC;YACF,MAAM,CAAC,SAAS,GAAG,IAAI,0BAAW,CAAC,aAAa,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;CACD;AA1BD,sCA0BC;AAgFD;;;GAGG;AACH,SAAgB,yBAAyB,CACxC,OAAe,EACf,YAA0B,EAC1B,OAA+B;IAE/B,MAAM,MAAM,GAAG,IAAA,uBAAY,EAC1B,IAAA,uBAAY,EAAC;QACZ,OAAO;QACP,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,YAAY,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACjC,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACxC,CAAC;YACD,OAAO,YAAY,CAAC,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO;KACP,CAAC,CACF,CAAC;IAEF,IAAI,YAAY,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC;QACxC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACjD,OAAO,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/cjs/endpoints.d.ts

@@ -0,0 +1,63 @@
+type Scheme = "http" | "https";
+export type EndpointTemplateInit = {
+    /**
+     * Endpoint string. May be:
+     * - `host`
+     * - `host:port`
+     * - `https://host[:port][/path]`
+     * - `http://host[:port][/path]`
+     *
+     * For basin endpoints, may include `{basin}` placeholder in hostname and/or path.
+     */
+    endpoint: string;
+};
+export declare class EndpointTemplate {
+    readonly raw: string;
+    readonly scheme: Scheme;
+    readonly hostTemplate: string;
+    readonly port: string;
+    readonly pathTemplate: string;
+    readonly hasBasinPlaceholder: boolean;
+    readonly explicitPathProvided: boolean;
+    constructor({ endpoint }: EndpointTemplateInit);
+    /**
+     * Resolve the template into a base URL string.
+     *
+     * - If `{basin}` appears in the hostname, it is substituted verbatim (basin names are validated by S2.basin()).
+     * - If `{basin}` appears in the path/query/hash, it is substituted via `encodeURIComponent`.
+     */
+    baseUrl(basin?: string): string;
+}
+export type S2EndpointsInit = {
+    /**
+     * Account endpoint (authority with optional scheme/port, optional path).
+     * If no path is present, `/v1` is used.
+     */
+    account?: string;
+    /**
+     * Basin endpoint (authority with optional scheme/port, optional path).
+     * Supports `{basin}` placeholder anywhere. If no path is present, `/v1` is used.
+     */
+    basin?: string;
+};
+/**
+ * Endpoint configuration for the S2 environment.
+ *
+ * This mirrors the Rust SDK's endpoint model, with an additional capability:
+ * the basin endpoint may include `{basin}` anywhere (hostname and/or path).
+ */
+export declare class S2Endpoints {
+    readonly account: EndpointTemplate;
+    readonly basin: EndpointTemplate;
+    /**
+     * When true, include `s2-basin: <name>` header on basin-scoped requests.
+     *
+     * Per project convention: enabled whenever a non-default basin endpoint is provided.
+     */
+    readonly includeBasinHeader: boolean;
+    constructor(init?: S2EndpointsInit);
+    accountBaseUrl(): string;
+    basinBaseUrl(basin: string): string;
+}
+export {};
+//# sourceMappingURL=endpoints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/endpoints.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAwC/B,MAAM,MAAM,oBAAoB,GAAG;IAClC;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,gBAAgB;IAC5B,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,mBAAmB,EAAE,OAAO,CAAC;IAC7C,SAAgB,oBAAoB,EAAE,OAAO,CAAC;gBAElC,EAAE,QAAQ,EAAE,EAAE,oBAAoB;IAwC9C;;;;;OAKG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;CAYtC;AAED,MAAM,MAAM,eAAe,GAAG;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAKF;;;;;GAKG;AACH,qBAAa,WAAW;IACvB,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAC1C,SAAgB,KAAK,EAAE,gBAAgB,CAAC;IACxC;;;;OAIG;IACH,SAAgB,kBAAkB,EAAE,OAAO,CAAC;gBAEhC,IAAI,CAAC,EAAE,eAAe;IAU3B,cAAc,IAAI,MAAM;IAIxB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAG1C"}

package/dist/cjs/endpoints.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Endpoints = exports.EndpointTemplate = void 0;
+const DEFAULT_SCHEME = "https";
+const DEFAULT_API_PATH = "/v1";
+const BASIN_PLACEHOLDER_SENTINEL = "__basin__";
+function hasScheme(input) {
+    return /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(input);
+}
+function firstDelimiterIndex(value, fromIndex) {
+    const slash = value.indexOf("/", fromIndex);
+    const query = value.indexOf("?", fromIndex);
+    const hash = value.indexOf("#", fromIndex);
+    const candidates = [slash, query, hash].filter((idx) => idx !== -1);
+    return candidates.length ? Math.min(...candidates) : -1;
+}
+function hasExplicitPath(input) {
+    const trimmed = input.trim();
+    const schemeMatch = trimmed.match(/^([a-zA-Z][a-zA-Z0-9+.-]*):\/\//);
+    const authorityStart = schemeMatch ? schemeMatch[0].length : 0;
+    const delim = firstDelimiterIndex(trimmed, authorityStart);
+    return delim !== -1 && trimmed[delim] === "/";
+}
+function normalizeForUrlParsing(input) {
+    const trimmed = input.trim();
+    const withScheme = hasScheme(trimmed)
+        ? trimmed
+        : `${DEFAULT_SCHEME}://${trimmed}`;
+    return withScheme.replaceAll("{basin}", BASIN_PLACEHOLDER_SENTINEL);
+}
+function asScheme(protocol) {
+    const normalized = protocol.replace(":", "").toLowerCase();
+    if (normalized === "http" || normalized === "https")
+        return normalized;
+    throw new Error(`Unsupported scheme: ${protocol}`);
+}
+class EndpointTemplate {
+    raw;
+    scheme;
+    hostTemplate;
+    port;
+    pathTemplate;
+    hasBasinPlaceholder;
+    explicitPathProvided;
+    constructor({ endpoint }) {
+        const raw = endpoint.trim();
+        if (!raw) {
+            throw new Error("Endpoint cannot be empty");
+        }
+        const explicitPathProvided = hasExplicitPath(raw);
+        const parsed = new URL(normalizeForUrlParsing(raw));
+        this.raw = raw;
+        this.scheme = asScheme(parsed.protocol);
+        this.hostTemplate = parsed.hostname.replaceAll(BASIN_PLACEHOLDER_SENTINEL, "{basin}");
+        this.port = parsed.port;
+        const parsedPath = parsed.pathname.replaceAll(BASIN_PLACEHOLDER_SENTINEL, "{basin}");
+        const parsedQuery = parsed.search.replaceAll(BASIN_PLACEHOLDER_SENTINEL, "{basin}");
+        const parsedHash = parsed.hash.replaceAll(BASIN_PLACEHOLDER_SENTINEL, "{basin}");
+        this.pathTemplate = explicitPathProvided
+            ? `${parsedPath}${parsedQuery}${parsedHash}`
+            : DEFAULT_API_PATH;
+        this.explicitPathProvided = explicitPathProvided;
+        this.hasBasinPlaceholder =
+            this.raw.includes("{basin}") ||
+                this.hostTemplate.includes("{basin}") ||
+                this.pathTemplate.includes("{basin}");
+    }
+    /**
+     * Resolve the template into a base URL string.
+     *
+     * - If `{basin}` appears in the hostname, it is substituted verbatim (basin names are validated by S2.basin()).
+     * - If `{basin}` appears in the path/query/hash, it is substituted via `encodeURIComponent`.
+     */
+    baseUrl(basin) {
+        const host = basin
+            ? this.hostTemplate.replaceAll("{basin}", basin)
+            : this.hostTemplate;
+        const path = basin
+            ? this.pathTemplate.replaceAll("{basin}", encodeURIComponent(basin))
+            : this.pathTemplate;
+        const authority = this.port ? `${host}:${this.port}` : host;
+        return `${this.scheme}://${authority}${path}`;
+    }
+}
+exports.EndpointTemplate = EndpointTemplate;
+const DEFAULT_ACCOUNT_ENDPOINT = "aws.s2.dev";
+const DEFAULT_BASIN_ENDPOINT = "{basin}.b.aws.s2.dev";
+/**
+ * Endpoint configuration for the S2 environment.
+ *
+ * This mirrors the Rust SDK's endpoint model, with an additional capability:
+ * the basin endpoint may include `{basin}` anywhere (hostname and/or path).
+ */
+class S2Endpoints {
+    account;
+    basin;
+    /**
+     * When true, include `s2-basin: <name>` header on basin-scoped requests.
+     *
+     * Per project convention: enabled whenever a non-default basin endpoint is provided.
+     */
+    includeBasinHeader;
+    constructor(init) {
+        this.account = new EndpointTemplate({
+            endpoint: init?.account ?? DEFAULT_ACCOUNT_ENDPOINT,
+        });
+        this.basin = new EndpointTemplate({
+            endpoint: init?.basin ?? DEFAULT_BASIN_ENDPOINT,
+        });
+        this.includeBasinHeader = init?.basin !== undefined;
+    }
+    accountBaseUrl() {
+        return this.account.baseUrl();
+    }
+    basinBaseUrl(basin) {
+        return this.basin.baseUrl(basin);
+    }
+}
+exports.S2Endpoints = S2Endpoints;
+//# sourceMappingURL=endpoints.js.map