@zshannon/streamstore 0.22.3

package/dist/cjs/internal/sdk-types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * SDK Types - CamelCase wrappers around generated API types.
+ *
+ * This module re-exports generated types with all keys transformed from
+ * snake_case to camelCase for a more idiomatic JavaScript/TypeScript API.
+ */
+import type * as API from "../generated/types.gen.js";
+import type { CamelCaseKeys } from "./case-transform.js";
+/**
+ * Access token information.
+ *
+ * Generated: `auto_prefix_streams`, `expires_at`
+ * SDK: `autoPrefixStreams`, `expiresAt`
+ */
+export type AccessTokenInfo = CamelCaseKeys<API.AccessTokenInfo>;
+/**
+ * Access token scope.
+ *
+ * Generated: `access_tokens`, `op_groups`
+ * SDK: `accessTokens`, `opGroups`
+ */
+export type AccessTokenScope = CamelCaseKeys<API.AccessTokenScope>;
+/**
+ * Basin configuration.
+ *
+ * Generated: `create_stream_on_append`, `create_stream_on_read`, `default_stream_config`
+ * SDK: `createStreamOnAppend`, `createStreamOnRead`, `defaultStreamConfig`
+ */
+export type BasinConfig = CamelCaseKeys<API.BasinConfig>;
+/**
+ * Basin information.
+ */
+export type BasinInfo = CamelCaseKeys<API.BasinInfo>;
+/**
+ * Basin reconfiguration options.
+ *
+ * Generated: `create_stream_on_append`, `create_stream_on_read`, `default_stream_config`
+ * SDK: `createStreamOnAppend`, `createStreamOnRead`, `defaultStreamConfig`
+ */
+export type BasinReconfiguration = CamelCaseKeys<API.BasinReconfiguration>;
+/**
+ * Stream configuration.
+ *
+ * Generated: `delete_on_empty`, `retention_policy`, `storage_class`
+ * SDK: `deleteOnEmpty`, `retentionPolicy`, `storageClass`
+ */
+export type StreamConfig = CamelCaseKeys<API.StreamConfig>;
+/**
+ * Stream information.
+ *
+ * Generated: `created_at`, `deleted_at`
+ * SDK: `createdAt`, `deletedAt`
+ */
+export type StreamInfo = CamelCaseKeys<API.StreamInfo>;
+/**
+ * Stream reconfiguration options.
+ *
+ * Generated: `delete_on_empty`, `retention_policy`, `storage_class`
+ * SDK: `deleteOnEmpty`, `retentionPolicy`, `storageClass`
+ */
+export type StreamReconfiguration = CamelCaseKeys<API.StreamReconfiguration>;
+/**
+ * Delete-on-empty configuration.
+ *
+ * Generated: `min_age_secs`
+ * SDK: `minAgeSecs`
+ */
+export type DeleteOnEmptyConfig = CamelCaseKeys<API.DeleteOnEmptyConfig>;
+/**
+ * Delete-on-empty reconfiguration.
+ *
+ * Generated: `min_age_secs`
+ * SDK: `minAgeSecs`
+ */
+export type DeleteOnEmptyReconfiguration = CamelCaseKeys<API.DeleteOnEmptyReconfiguration>;
+/**
+ * List access tokens response.
+ *
+ * Generated: `access_tokens`, `has_more`
+ * SDK: `accessTokens`, `hasMore`
+ */
+export type ListAccessTokensResponse = CamelCaseKeys<API.ListAccessTokensResponse>;
+/**
+ * List basins response.
+ *
+ * Generated: `has_more`
+ * SDK: `hasMore`
+ */
+export type ListBasinsResponse = CamelCaseKeys<API.ListBasinsResponse>;
+/**
+ * List streams response.
+ *
+ * Generated: `has_more`
+ * SDK: `hasMore`
+ */
+export type ListStreamsResponse = CamelCaseKeys<API.ListStreamsResponse>;
+/**
+ * Accumulation metric with interval.
+ *
+ * Generated: `interval`
+ * SDK: `interval`
+ */
+export type AccumulationMetric = CamelCaseKeys<API.AccumulationMetric>;
+/**
+ * Sequenced record (read from stream).
+ *
+ * Generated: `seq_num`
+ * SDK: `seqNum`
+ */
+export type SequencedRecord = CamelCaseKeys<API.SequencedRecord>;
+/**
+ * Timestamping configuration.
+ */
+export type TimestampingConfig = CamelCaseKeys<API.TimestampingConfig>;
+/**
+ * Timestamping reconfiguration.
+ */
+export type TimestampingReconfiguration = CamelCaseKeys<API.TimestampingReconfiguration>;
+/**
+ * Issue access token response.
+ *
+ * Generated: `access_token`
+ * SDK: `accessToken`
+ */
+export type IssueAccessTokenResponse = CamelCaseKeys<API.IssueAccessTokenResponse>;
+export type { AccessTokenIdStr, AccountMetricSet, BasinMetricSet, BasinScope, BasinState, CreateStreamRequest, FencingToken, GaugeMetric, Header, InfiniteRetention, LabelMetric, Metric, MetricSetResponse, MetricUnit, Operation, PermittedOperationGroups, ReadWritePermissions, ResourceSet, RetentionPolicy, ScalarMetric, StorageClass, StreamMetricSet, TimeseriesInterval, TimestampingMode, } from "../generated/types.gen.js";
+//# sourceMappingURL=sdk-types.d.ts.map

package/dist/cjs/internal/sdk-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-types.d.ts","sourceRoot":"","sources":["../../../src/internal/sdk-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAMnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAM3E;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GACvC,aAAa,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAMjD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GACnC,aAAa,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAMzE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAMvE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACtC,aAAa,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GACnC,aAAa,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAM7C,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,wBAAwB,EACxB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GAChB,MAAM,2BAA2B,CAAC"}

package/dist/cjs/internal/sdk-types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * SDK Types - CamelCase wrappers around generated API types.
+ *
+ * This module re-exports generated types with all keys transformed from
+ * snake_case to camelCase for a more idiomatic JavaScript/TypeScript API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sdk-types.js.map

package/dist/cjs/internal/sdk-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-types.js","sourceRoot":"","sources":["../../../src/internal/sdk-types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/cjs/lib/base64.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a random token of the specified byte length, base64 encoded.
+ * Uses crypto.getRandomValues() which is available in browsers and Node.js 19+.
+ *
+ * @param byteLength Number of random bytes to generate (default: 16)
+ * @returns Base64-encoded random string
+ */
+export declare const randomToken: (byteLength?: number) => string;
+export declare const encodeToBase64: (bytes: Uint8Array) => string;
+export declare const decodeFromBase64: (str: string) => Uint8Array;
+export declare const stripCrlf: (str: string) => string;
+//# sourceMappingURL=base64.d.ts.map

package/dist/cjs/lib/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../../src/lib/base64.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,mBAAe,KAAG,MAI7C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,UAAU,WA6B/C,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,UA+C9C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,WAA+B,CAAC"}

package/dist/cjs/lib/base64.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripCrlf = exports.decodeFromBase64 = exports.encodeToBase64 = exports.randomToken = void 0;
+/**
+ * Generate a random token of the specified byte length, base64 encoded.
+ * Uses crypto.getRandomValues() which is available in browsers and Node.js 19+.
+ *
+ * @param byteLength Number of random bytes to generate (default: 16)
+ * @returns Base64-encoded random string
+ */
+const randomToken = (byteLength = 16) => {
+    const bytes = new Uint8Array(byteLength);
+    crypto.getRandomValues(bytes);
+    return (0, exports.encodeToBase64)(bytes);
+};
+exports.randomToken = randomToken;
+const encodeToBase64 = (bytes) => {
+    const length = bytes.length;
+    let result = "";
+    let i;
+    for (i = 2; i < length; i += 3) {
+        result += base64abc[bytes[i - 2] >> 2];
+        result += base64abc[((bytes[i - 2] & 0x03) << 4) | (bytes[i - 1] >> 4)];
+        result += base64abc[((bytes[i - 1] & 0x0f) << 2) | (bytes[i] >> 6)];
+        result += base64abc[bytes[i] & 0x3f];
+    }
+    if (i === length + 1) {
+        // 1 octet yet to write
+        result += base64abc[bytes[i - 2] >> 2];
+        result += base64abc[(bytes[i - 2] & 0x03) << 4];
+        result += "==";
+    }
+    if (i === length) {
+        // 2 octets yet to write
+        result += base64abc[bytes[i - 2] >> 2];
+        result += base64abc[((bytes[i - 2] & 0x03) << 4) | (bytes[i - 1] >> 4)];
+        result += base64abc[(bytes[i - 1] & 0x0f) << 2];
+        result += "=";
+    }
+    return result;
+};
+exports.encodeToBase64 = encodeToBase64;
+const decodeFromBase64 = (str) => {
+    // Normalize to standard base64:
+    // - remove CRLF
+    // - allow base64url ("-" and "_")
+    // - add missing padding
+    const normalized = (0, exports.stripCrlf)(str)
+        .trim()
+        .replace(/-/g, "+")
+        .replace(/_/g, "/");
+    const padded = normalized + "=".repeat((4 - (normalized.length % 4)) % 4);
+    const length = padded.length;
+    if (length % 4 !== 0) {
+        throw new Error(`Length must be a multiple of 4, but is ${length}`);
+    }
+    const index = padded.indexOf("=");
+    if (index !== -1 &&
+        (index < length - 2 || (index === length - 2 && padded[length - 1] !== "="))) {
+        throw new Error("Found a '=' character, but it is not at the end");
+    }
+    try {
+        const missingOctets = padded.endsWith("==")
+            ? 2
+            : padded.endsWith("=")
+                ? 1
+                : 0;
+        const result = new Uint8Array(3 * (length / 4) - missingOctets);
+        for (let i = 0, j = 0; i < length; i += 4, j += 3) {
+            const buffer = (getBase64Code(padded.charCodeAt(i)) << 18) |
+                (getBase64Code(padded.charCodeAt(i + 1)) << 12) |
+                (getBase64Code(padded.charCodeAt(i + 2)) << 6) |
+                getBase64Code(padded.charCodeAt(i + 3));
+            result[j] = buffer >> 16;
+            result[j + 1] = (buffer >> 8) & 0xff;
+            result[j + 2] = buffer & 0xff;
+        }
+        return result;
+    }
+    catch (e) {
+        throw new Error(e instanceof Error ? e.message : "Invalid input");
+    }
+};
+exports.decodeFromBase64 = decodeFromBase64;
+const stripCrlf = (str) => str.replace(/[\n\r]/g, "");
+exports.stripCrlf = stripCrlf;
+function getBase64Code(charCode) {
+    if (charCode >= base64codes.length) {
+        throw new TypeError(`Invalid character ${String.fromCharCode(charCode)}`);
+    }
+    const code = base64codes[charCode];
+    if (code === 255) {
+        throw new TypeError(`Invalid character ${String.fromCharCode(charCode)}`);
+    }
+    return code;
+}
+const base64abc = [
+    "A",
+    "B",
+    "C",
+    "D",
+    "E",
+    "F",
+    "G",
+    "H",
+    "I",
+    "J",
+    "K",
+    "L",
+    "M",
+    "N",
+    "O",
+    "P",
+    "Q",
+    "R",
+    "S",
+    "T",
+    "U",
+    "V",
+    "W",
+    "X",
+    "Y",
+    "Z",
+    "a",
+    "b",
+    "c",
+    "d",
+    "e",
+    "f",
+    "g",
+    "h",
+    "i",
+    "j",
+    "k",
+    "l",
+    "m",
+    "n",
+    "o",
+    "p",
+    "q",
+    "r",
+    "s",
+    "t",
+    "u",
+    "v",
+    "w",
+    "x",
+    "y",
+    "z",
+    "0",
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7",
+    "8",
+    "9",
+    "+",
+    "/",
+];
+const base64codes = [
+    255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
+    255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255,
+    255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 62, 255, 255,
+    255, 63, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 255, 255, 255, 0, 255, 255,
+    255, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
+    21, 22, 23, 24, 25, 255, 255, 255, 255, 255, 255, 26, 27, 28, 29, 30, 31, 32,
+    33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51,
+];
+//# sourceMappingURL=base64.js.map

package/dist/cjs/lib/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../../src/lib/base64.ts"],"names":[],"mappings":"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GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACzE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG;IAC7E,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG;IAC3E,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC7E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAC5E,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;CAC1E,CAAC"}

package/dist/cjs/lib/event-stream.d.ts

@@ -0,0 +1,26 @@
+export type SseMessage<T> = {
+    data?: T | undefined;
+    event?: string | undefined;
+    id?: string | undefined;
+    retry?: number | undefined;
+};
+type ParseResult<T> = {
+    done: true;
+    value?: undefined;
+    batch?: undefined;
+} | {
+    done: false;
+    batch?: false;
+    value?: T;
+} | {
+    done: false;
+    batch: true;
+    value: T[];
+};
+export declare class EventStream<T> extends ReadableStream<T> implements AsyncDisposable {
+    constructor(responseBody: ReadableStream<Uint8Array>, parse: (x: SseMessage<string>) => ParseResult<T>);
+    [Symbol.asyncDispose](): Promise<void>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+export {};
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/cjs/lib/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../../src/lib/event-stream.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC3B,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,KAAK,WAAW,CAAC,CAAC,IACf;IACA,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;CACjB,GACD;IACA,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,CAAC,CAAC;CACT,GACD;IACA,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,CAAC,EAAE,CAAC;CACV,CAAC;AAEL,qBAAa,WAAW,CAAC,CAAC,CACzB,SAAQ,cAAc,CAAC,CAAC,CACxB,YAAW,eAAe;gBAGzB,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,EACxC,KAAK,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC;IA0C3C,CAAC,MAAM,CAAC,YAAY,CAAC;IAK3B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;CAqClD"}

package/dist/cjs/lib/event-stream.js

@@ -0,0 +1,154 @@
+"use strict";
+/*
+ * Code from Speakeasy (https://speakeasy.com).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStream = void 0;
+const debug_1 = require("debug");
+const debug = (0, debug_1.default)("s2:event-stream");
+class EventStream extends ReadableStream {
+    constructor(responseBody, parse) {
+        const upstream = responseBody.getReader();
+        let buffer = new Uint8Array();
+        const eventStreamId = Math.random().toString(36).slice(2);
+        super({
+            async pull(downstream) {
+                try {
+                    while (true) {
+                        debug("pull loop, eventstream=%s", eventStreamId);
+                        const match = findBoundary(buffer);
+                        if (!match) {
+                            const chunk = await upstream.read();
+                            if (chunk.done)
+                                return downstream.close();
+                            buffer = concatBuffer(buffer, chunk.value);
+                            continue;
+                        }
+                        const message = buffer.slice(0, match.index);
+                        buffer = buffer.slice(match.index + match.length);
+                        const item = parseMessage(message, parse);
+                        if (item) {
+                            if (item.batch) {
+                                for (const chunk of item.value) {
+                                    downstream.enqueue(chunk);
+                                }
+                            }
+                            else if (item.value) {
+                                downstream.enqueue(item.value);
+                            }
+                            else if (item.done) {
+                                await upstream.cancel("done");
+                                downstream.close();
+                            }
+                        }
+                    }
+                }
+                catch (e) {
+                    downstream.error(e);
+                    await upstream.cancel(e);
+                }
+            },
+            cancel: (reason) => upstream.cancel(reason),
+        });
+    }
+    async [Symbol.asyncDispose]() {
+        await this.cancel("disposed");
+    }
+    // Polyfill for older browsers
+    [Symbol.asyncIterator]() {
+        const proto = ReadableStream.prototype;
+        const fn = proto[Symbol.asyncIterator];
+        if (typeof fn === "function") {
+            try {
+                return fn.call(this);
+            }
+            catch {
+                // Native method may throw "Illegal invocation" when called on subclass
+                // Fall through to manual implementation
+            }
+        }
+        const reader = this.getReader();
+        return {
+            next: async () => {
+                const r = await reader.read();
+                if (r.done) {
+                    reader.releaseLock();
+                    return { done: true, value: undefined };
+                }
+                return { done: false, value: r.value };
+            },
+            throw: async (e) => {
+                await reader.cancel(e);
+                reader.releaseLock();
+                return { done: true, value: undefined };
+            },
+            return: async () => {
+                await reader.cancel("done");
+                reader.releaseLock();
+                return { done: true, value: undefined };
+            },
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+        };
+    }
+}
+exports.EventStream = EventStream;
+function concatBuffer(a, b) {
+    const c = new Uint8Array(a.length + b.length);
+    c.set(a, 0);
+    c.set(b, a.length);
+    return c;
+}
+/** Finds the first (CR,LF,CR,LF) or (CR,CR) or (LF,LF) */
+function findBoundary(buf) {
+    const len = buf.length;
+    for (let i = 0; i < len; i++) {
+        if (i <= len - 4 &&
+            buf[i] === 13 &&
+            buf[i + 1] === 10 &&
+            buf[i + 2] === 13 &&
+            buf[i + 3] === 10) {
+            return { index: i, length: 4 };
+        }
+        if (i <= len - 2 && buf[i] === 13 && buf[i + 1] === 13) {
+            return { index: i, length: 2 };
+        }
+        if (i <= len - 2 && buf[i] === 10 && buf[i + 1] === 10) {
+            return { index: i, length: 2 };
+        }
+    }
+    return null;
+}
+function parseMessage(chunk, parse) {
+    const text = new TextDecoder().decode(chunk);
+    const lines = text.split(/\r\n|\r|\n/);
+    const dataLines = [];
+    const ret = {};
+    let ignore = true;
+    for (const line of lines) {
+        if (!line || line.startsWith(":"))
+            continue;
+        ignore = false;
+        const i = line.indexOf(":");
+        const field = line.slice(0, i);
+        const value = line[i + 1] === " " ? line.slice(i + 2) : line.slice(i + 1);
+        if (field === "data")
+            dataLines.push(value);
+        else if (field === "event")
+            ret.event = value;
+        else if (field === "id")
+            ret.id = value;
+        else if (field === "retry") {
+            const n = Number(value);
+            if (!isNaN(n))
+                ret.retry = n;
+        }
+    }
+    if (ignore)
+        return;
+    if (dataLines.length)
+        ret.data = dataLines.join("\n");
+    return parse(ret);
+}
+//# sourceMappingURL=event-stream.js.map

package/dist/cjs/lib/event-stream.js.map

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

package/dist/cjs/lib/paginate.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Paginated response containing a page of results.
+ *
+ * @template T The type of items in the page
+ */
+export interface Page<T> {
+    /**
+     * Items in this page.
+     */
+    readonly values: readonly T[];
+    /**
+     * Whether there are more pages available.
+     * If true, use the last item in `values` as the cursor for the next page.
+     */
+    readonly hasMore: boolean;
+}
+/**
+ * A function that fetches a single page of results.
+ * @template TItem The type of items in the page
+ * @template TArgs The query arguments type (excluding startAfter)
+ */
+export type PageFetcher<TItem, TArgs> = (args: TArgs & {
+    startAfter?: string;
+}) => Promise<{
+    items: TItem[];
+    hasMore: boolean;
+}>;
+/**
+ * Arguments for listAll pagination methods.
+ * Omits startAfter since pagination is handled automatically.
+ * Adds includeDeleted option to include resources pending deletion.
+ */
+export type ListAllArgs<TArgs> = Omit<TArgs, "startAfter"> & {
+    /** Include resources that are pending deletion (default: false). */
+    includeDeleted?: boolean;
+};
+/**
+ * Creates a lazy async iterable that automatically paginates through all results.
+ *
+ * @template TItem The type of items being paginated
+ * @template TArgs The query arguments type
+ * @param fetcher Function that fetches a single page of results
+ * @param args Query arguments (startAfter is managed internally)
+ * @param getCursor Function to extract the cursor value from an item for the next page
+ * @returns An async iterable that yields items one at a time, fetching pages as needed
+ *
+ * @example
+ * ```ts
+ * const allBasins = paginate(
+ *   (args) => this.list(args).then(r => ({ items: r.basins, hasMore: r.hasMore })),
+ *   { prefix: "my-" },
+ *   (basin) => basin.name
+ * );
+ *
+ * for await (const basin of allBasins) {
+ *   console.log(basin.name);
+ * }
+ * ```
+ */
+export declare function paginate<TItem, TArgs>(fetcher: PageFetcher<TItem, TArgs>, args: TArgs, getCursor: (item: TItem) => string): AsyncIterable<TItem>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/cjs/lib/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../../src/lib/paginate.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,IAAI,CACvC,IAAI,EAAE,KAAK,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,KACjC,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG;IAC5D,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EACpC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,EAClC,IAAI,EAAE,KAAK,EACX,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAChC,aAAa,CAAC,KAAK,CAAC,CAyBtB"}

package/dist/cjs/lib/paginate.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginate = paginate;
+const debug_1 = require("debug");
+const debug = (0, debug_1.default)("s2:paginate");
+/**
+ * Creates a lazy async iterable that automatically paginates through all results.
+ *
+ * @template TItem The type of items being paginated
+ * @template TArgs The query arguments type
+ * @param fetcher Function that fetches a single page of results
+ * @param args Query arguments (startAfter is managed internally)
+ * @param getCursor Function to extract the cursor value from an item for the next page
+ * @returns An async iterable that yields items one at a time, fetching pages as needed
+ *
+ * @example
+ * ```ts
+ * const allBasins = paginate(
+ *   (args) => this.list(args).then(r => ({ items: r.basins, hasMore: r.hasMore })),
+ *   { prefix: "my-" },
+ *   (basin) => basin.name
+ * );
+ *
+ * for await (const basin of allBasins) {
+ *   console.log(basin.name);
+ * }
+ * ```
+ */
+function paginate(fetcher, args, getCursor) {
+    return {
+        [Symbol.asyncIterator]: async function* () {
+            let cursor;
+            while (true) {
+                debug({ args, cursor });
+                const { items, hasMore } = await fetcher({
+                    ...args,
+                    startAfter: cursor,
+                });
+                for (const item of items) {
+                    yield item;
+                }
+                if (!hasMore || items.length === 0) {
+                    break;
+                }
+                // Safe: we just checked items.length > 0
+                cursor = getCursor(items[items.length - 1]);
+            }
+        },
+    };
+}
+//# sourceMappingURL=paginate.js.map

package/dist/cjs/lib/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../../src/lib/paginate.ts"],"names":[],"mappings":";;AA+DA,4BA6BC;AA5FD,iCAAgC;AAEhC,MAAM,KAAK,GAAG,IAAA,eAAW,EAAC,aAAa,CAAC,CAAC;AAsCzC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,QAAQ,CACvB,OAAkC,EAClC,IAAW,EACX,SAAkC;IAElC,OAAO;QACN,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,SAAS,CAAC;YACtC,IAAI,MAA0B,CAAC;YAE/B,OAAO,IAAI,EAAE,CAAC;gBACb,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBACxB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;oBACxC,GAAG,IAAI;oBACP,UAAU,EAAE,MAAM;iBAClB,CAAC,CAAC;gBAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBAC1B,MAAM,IAAI,CAAC;gBACZ,CAAC;gBAED,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpC,MAAM;gBACP,CAAC;gBAED,yCAAyC;gBACzC,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC;YAC9C,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}