@zshannon/streamstore 0.22.3

package/dist/cjs/stream.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Stream = void 0;
+const error_js_1 = require("./error.js");
+const index_js_1 = require("./generated/index.js");
+const mappers_js_1 = require("./internal/mappers.js");
+const retry_js_1 = require("./lib/retry.js");
+const factory_js_1 = require("./lib/stream/factory.js");
+const shared_js_1 = require("./lib/stream/transport/fetch/shared.js");
+/**
+ * Basin-scoped stream helper for append/read operations.
+ *
+ * Created via {@link S2Basin.stream}. Provides direct methods plus factories for read/append sessions.
+ */
+class S2Stream {
+    client;
+    transportConfig;
+    retryConfig;
+    _transport;
+    closed = false;
+    closePromise;
+    name;
+    constructor(name, client, transportConfig, retryConfig) {
+        this.name = name;
+        this.client = client;
+        this.transportConfig = transportConfig;
+        this.retryConfig = retryConfig;
+    }
+    /**
+     * Get or create the transport instance
+     */
+    async getTransport() {
+        this.ensureOpen();
+        if (!this._transport) {
+            this._transport = await (0, factory_js_1.createSessionTransport)(this.transportConfig);
+        }
+        return this._transport;
+    }
+    ensureOpen() {
+        if (this.closed) {
+            throw new error_js_1.S2Error({ message: "S2Stream is closed" });
+        }
+    }
+    /**
+     * Check the tail of the stream.
+     *
+     * Returns the next sequence number and timestamp to be assigned (`tail`).
+     */
+    async checkTail(options) {
+        this.ensureOpen();
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            const response = await (0, error_js_1.withS2Data)(() => (0, index_js_1.checkTail)({
+                client: this.client,
+                path: {
+                    stream: this.name,
+                },
+                ...options,
+            }));
+            return (0, mappers_js_1.fromAPITailResponse)(response);
+        });
+    }
+    /**
+     * Read records from the stream.
+     *
+     * - When `as: "bytes"` is provided, bodies and headers are decoded from base64 to `Uint8Array`.
+     * - Supports starting position by `seq_num`, `timestamp`, or `tail_offset` and can clamp to the tail.
+     * - Non-streaming reads are bounded by `count` and `bytes` (defaults 1000 and 1 MiB).
+     * - Use `readSession` for streaming reads
+     */
+    async read(input, options) {
+        this.ensureOpen();
+        const { as, ...requestOptions } = options ?? {};
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            // Convert ReadInput to ReadArgs using mapper
+            const readArgs = {
+                ...(0, mappers_js_1.toAPIReadQuery)(input),
+                as,
+            };
+            const genBatch = await (0, shared_js_1.streamRead)(this.name, this.client, readArgs, requestOptions);
+            // Convert from API to SDK ReadBatch
+            return (as === "bytes"
+                ? (0, mappers_js_1.fromAPIReadBatchBytes)(genBatch)
+                : (0, mappers_js_1.fromAPIReadBatchString)(genBatch));
+        });
+    }
+    /**
+     * Append a batch of records to the stream.
+     *
+     * - Automatically base64-encodes when format is "bytes".
+     * - Supports conditional appends via `fencingToken` and `matchSeqNum` in the input.
+     * - Returns the acknowledged range and the stream tail after the append.
+     * - All records in a batch must use the same format (either all string or all bytes).
+     *
+     * Use {@link AppendInput.create} to construct a validated AppendInput.
+     * For high-throughput sequential appends, use `appendSession()` instead.
+     *
+     * @param input The append input containing records and optional conditions
+     * @param options Optional request options
+     */
+    async append(input, options) {
+        this.ensureOpen();
+        return await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, shared_js_1.streamAppend)(this.name, this.client, input, options);
+        }, (config, error) => {
+            if ((config.appendRetryPolicy ?? "all") === "noSideEffects") {
+                // Allow retry only when the append is naturally idempotent by containing
+                // a match_seq_num condition.
+                return input.matchSeqNum !== undefined;
+            }
+            else {
+                return true;
+            }
+        });
+    }
+    /**
+     * Open a streaming read session
+     *
+     * Use the returned session as an async iterable or as a readable stream.
+     * When `as: "bytes"` is provided, bodies and headers are decoded to `Uint8Array`.
+     */
+    async readSession(input, options) {
+        this.ensureOpen();
+        const { as, ...requestOptions } = options ?? {};
+        const transport = await this.getTransport();
+        // Convert ReadInput to ReadArgs using mapper
+        const readArgs = {
+            ...(0, mappers_js_1.toAPIReadQuery)(input),
+            as,
+        };
+        return await transport.makeReadSession(this.name, readArgs, requestOptions);
+    }
+    /**
+     * Create an append session that guarantees ordering of submissions.
+     *
+     * Use this to coordinate high-throughput, sequential appends with backpressure.
+     * Records can be either string or bytes format - the format is specified in each record.
+     *
+     * @param sessionOptions Options that control append session behavior
+     * @param requestOptions Optional request options
+     */
+    async appendSession(sessionOptions, requestOptions) {
+        this.ensureOpen();
+        const transport = await this.getTransport();
+        return await transport.makeAppendSession(this.name, sessionOptions, requestOptions);
+    }
+    async close() {
+        if (this.closePromise) {
+            return this.closePromise;
+        }
+        this.closePromise = (async () => {
+            if (this.closed) {
+                return;
+            }
+            this.closed = true;
+            if (this._transport) {
+                try {
+                    await this._transport.close();
+                }
+                finally {
+                    this._transport = undefined;
+                }
+            }
+        })();
+        try {
+            await this.closePromise;
+        }
+        finally {
+            this.closePromise = undefined;
+        }
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+}
+exports.S2Stream = S2Stream;
+//# sourceMappingURL=stream.js.map

package/dist/cjs/stream.js.map

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

package/dist/cjs/streams.d.ts

@@ -0,0 +1,61 @@
+import type { RetryConfig, S2RequestOptions } from "./common.js";
+import type { Client } from "./generated/client/types.gen.js";
+import type * as Types from "./types.js";
+/**
+ * Basin-scoped helper for listing and configuring streams.
+ *
+ * Access via {@link S2Basin.streams}. Methods inherit the basin's retry configuration.
+ */
+export declare class S2Streams {
+    private readonly client;
+    private readonly retryConfig?;
+    constructor(client: Client, retryConfig?: RetryConfig);
+    /**
+     * List streams in the basin.
+     *
+     * @param args.prefix Return streams whose names start with the given prefix
+     * @param args.startAfter Name to start after (for pagination)
+     * @param args.limit Max results (up to 1000)
+     */
+    list(args?: Types.ListStreamsInput, options?: S2RequestOptions): Promise<Types.ListStreamsResponse>;
+    /**
+     * List all streams in the basin with automatic pagination.
+     * Returns a lazy async iterable that fetches pages as needed.
+     *
+     * @param args - Optional options: `prefix` to filter by name prefix, `limit` for max results per page, `includeDeleted` to include streams pending deletion
+     *
+     * @example
+     * ```ts
+     * for await (const stream of basin.streams.listAll({ prefix: "events-" })) {
+     *   console.log(stream.name);
+     * }
+     * ```
+     */
+    listAll(args?: Types.ListAllStreamsInput, options?: S2RequestOptions): AsyncIterable<Types.StreamInfo>;
+    /**
+     * Create a stream.
+     *
+     * @param args.stream Stream name (1-512 bytes, unique within the basin)
+     * @param args.config Stream configuration (retentionPolicy, storageClass, timestamping, deleteOnEmpty)
+     */
+    create(args: Types.CreateStreamInput, options?: S2RequestOptions): Promise<Types.CreateStreamResponse>;
+    /**
+     * Get stream configuration.
+     *
+     * @param args.stream Stream name
+     */
+    getConfig(args: Types.GetStreamConfigInput, options?: S2RequestOptions): Promise<Types.StreamConfig>;
+    /**
+     * Delete a stream.
+     *
+     * @param args.stream Stream name
+     */
+    delete(args: Types.DeleteStreamInput, options?: S2RequestOptions): Promise<void>;
+    /**
+     * Reconfigure a stream.
+     *
+     * @param args Configuration for the stream to reconfigure (including stream name and fields to change)
+     */
+    reconfigure(args: Types.ReconfigureStreamInput, options?: S2RequestOptions): Promise<Types.ReconfigureStreamResponse>;
+}
+//# sourceMappingURL=streams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAa9D,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAC;AAkEzC;;;;GAIG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW;IAKrD;;;;;;OAMG;IACU,IAAI,CAChB,IAAI,CAAC,EAAE,KAAK,CAAC,gBAAgB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;IAiBrC;;;;;;;;;;;;OAYG;IACI,OAAO,CACb,IAAI,CAAC,EAAE,KAAK,CAAC,mBAAmB,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACxB,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;IAalC;;;;;OAKG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAoBtC;;;;OAIG;IACU,SAAS,CACrB,IAAI,EAAE,KAAK,CAAC,oBAAoB,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;IAc9B;;;;OAIG;IACU,MAAM,CAClB,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;OAIG;IACU,WAAW,CACvB,IAAI,EAAE,KAAK,CAAC,sBAAsB,EAClC,OAAO,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC;CAoB3C"}

package/dist/cjs/streams.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2Streams = void 0;
+const error_js_1 = require("./error.js");
+const index_js_1 = require("./generated/index.js");
+const case_transform_js_1 = require("./internal/case-transform.js");
+const base64_js_1 = require("./lib/base64.js");
+const paginate_js_1 = require("./lib/paginate.js");
+const retry_js_1 = require("./lib/retry.js");
+function toDate(value) {
+    if (value === null)
+        return null;
+    if (value === undefined)
+        return undefined;
+    return new Date(value);
+}
+function transformStreamInfo(stream) {
+    return {
+        ...stream,
+        createdAt: toDate(stream.createdAt),
+        deletedAt: toDate(stream.deletedAt),
+    };
+}
+/** Convert SDK RetentionPolicy (ageSecs) to API RetentionPolicy (age). */
+function toAPIRetentionPolicy(policy) {
+    if (policy === null)
+        return null;
+    if (policy === undefined)
+        return undefined;
+    if ("ageSecs" in policy) {
+        return { age: Math.floor(policy.ageSecs) };
+    }
+    return policy; // { infinite: ... } passes through
+}
+/** Convert API RetentionPolicy (age) to SDK RetentionPolicy (ageSecs). */
+function toSDKRetentionPolicy(policy) {
+    if (policy === null)
+        return null;
+    if (policy === undefined)
+        return undefined;
+    if ("age" in policy) {
+        return { ageSecs: policy.age };
+    }
+    return policy; // { infinite: ... } passes through
+}
+/** Convert SDK StreamConfig to API format (handles retentionPolicy.ageSecs → age). */
+function toAPIStreamConfig(config) {
+    if (config === null || config === undefined)
+        return config;
+    return {
+        ...config,
+        deleteOnEmpty: config.deleteOnEmpty
+            ? {
+                ...config.deleteOnEmpty,
+                minAgeSecs: config.deleteOnEmpty.minAgeSecs === undefined
+                    ? undefined
+                    : Math.max(0, Math.floor(config.deleteOnEmpty.minAgeSecs)),
+            }
+            : config.deleteOnEmpty,
+        retentionPolicy: toAPIRetentionPolicy(config.retentionPolicy),
+    };
+}
+/** Convert API StreamConfig to SDK format (handles retentionPolicy.age → ageSecs). */
+function toSDKStreamConfig(config) {
+    return {
+        ...config,
+        retentionPolicy: toSDKRetentionPolicy(config?.retentionPolicy),
+    };
+}
+/**
+ * Basin-scoped helper for listing and configuring streams.
+ *
+ * Access via {@link S2Basin.streams}. Methods inherit the basin's retry configuration.
+ */
+class S2Streams {
+    client;
+    retryConfig;
+    constructor(client, retryConfig) {
+        this.client = client;
+        this.retryConfig = retryConfig;
+    }
+    /**
+     * List streams in the basin.
+     *
+     * @param args.prefix Return streams whose names start with the given prefix
+     * @param args.startAfter Name to start after (for pagination)
+     * @param args.limit Max results (up to 1000)
+     */
+    async list(args, options) {
+        const response = await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.listStreams)({
+                client: this.client,
+                query: (0, case_transform_js_1.toSnakeCase)(args),
+                ...options,
+            }));
+        });
+        const camelCased = (0, case_transform_js_1.toCamelCase)(response);
+        return {
+            ...camelCased,
+            streams: camelCased.streams.map(transformStreamInfo),
+        };
+    }
+    /**
+     * List all streams in the basin with automatic pagination.
+     * Returns a lazy async iterable that fetches pages as needed.
+     *
+     * @param args - Optional options: `prefix` to filter by name prefix, `limit` for max results per page, `includeDeleted` to include streams pending deletion
+     *
+     * @example
+     * ```ts
+     * for await (const stream of basin.streams.listAll({ prefix: "events-" })) {
+     *   console.log(stream.name);
+     * }
+     * ```
+     */
+    listAll(args, options) {
+        const { includeDeleted, ...listArgs } = args ?? {};
+        return (0, paginate_js_1.paginate)((a) => this.list(a, options).then((r) => ({
+            items: r.streams.filter((s) => includeDeleted || !s.deletedAt),
+            hasMore: r.hasMore,
+        })), listArgs, (stream) => stream.name);
+    }
+    /**
+     * Create a stream.
+     *
+     * @param args.stream Stream name (1-512 bytes, unique within the basin)
+     * @param args.config Stream configuration (retentionPolicy, storageClass, timestamping, deleteOnEmpty)
+     */
+    async create(args, options) {
+        const requestToken = (0, base64_js_1.randomToken)();
+        // Convert SDK config to API format (ageSecs → age)
+        const apiArgs = {
+            ...args,
+            config: toAPIStreamConfig(args.config),
+        };
+        const response = await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.createStream)({
+                client: this.client,
+                body: (0, case_transform_js_1.toSnakeCase)(apiArgs),
+                headers: { "s2-request-token": requestToken },
+                ...options,
+            }));
+        });
+        return (0, case_transform_js_1.toCamelCase)(response);
+    }
+    /**
+     * Get stream configuration.
+     *
+     * @param args.stream Stream name
+     */
+    async getConfig(args, options) {
+        const response = await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.getStreamConfig)({
+                client: this.client,
+                path: args,
+                ...options,
+            }));
+        });
+        // Convert API format to SDK (age → ageSecs)
+        return toSDKStreamConfig((0, case_transform_js_1.toCamelCase)(response));
+    }
+    /**
+     * Delete a stream.
+     *
+     * @param args.stream Stream name
+     */
+    async delete(args, options) {
+        await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.deleteStream)({
+                client: this.client,
+                path: args,
+                ...options,
+            }));
+        });
+    }
+    /**
+     * Reconfigure a stream.
+     *
+     * @param args Configuration for the stream to reconfigure (including stream name and fields to change)
+     */
+    async reconfigure(args, options) {
+        // Convert SDK config to API format (ageSecs → age)
+        const apiArgs = {
+            ...args,
+            retentionPolicy: toAPIRetentionPolicy(args.retentionPolicy),
+        };
+        const response = await (0, retry_js_1.withRetries)(this.retryConfig, async () => {
+            return await (0, error_js_1.withS2Data)(() => (0, index_js_1.reconfigureStream)({
+                client: this.client,
+                path: args,
+                body: (0, case_transform_js_1.toSnakeCase)(apiArgs),
+                ...options,
+            }));
+        });
+        // Convert API format to SDK (age → ageSecs)
+        const camelCased = (0, case_transform_js_1.toCamelCase)(response);
+        return toSDKStreamConfig(camelCased);
+    }
+}
+exports.S2Streams = S2Streams;
+//# sourceMappingURL=streams.js.map

package/dist/cjs/streams.js.map

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