@s2-dev/streamstore 0.16.0 → 0.16.1

package/dist/streams.js

@@ -0,0 +1,114 @@
+import { S2Error } from "./error";
+import { createStream, deleteStream, getStreamConfig, listStreams, reconfigureStream, } from "./generated";
+export class S2Streams {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List streams in the basin.
+     *
+     * @param args.prefix Return streams whose names start with the given prefix
+     * @param args.start_after Name to start after (for pagination)
+     * @param args.limit Max results (up to 1000)
+     */
+    async list(args, options) {
+        const response = await listStreams({
+            client: this.client,
+            query: args,
+            ...options,
+        });
+        if (response.error) {
+            throw new S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        return response.data;
+    }
+    /**
+     * Create a stream.
+     *
+     * @param args.stream Stream name (1-512 bytes, unique within the basin)
+     * @param args.config Stream configuration (retention, storage class, timestamping, delete-on-empty)
+     */
+    async create(args, options) {
+        const response = await createStream({
+            client: this.client,
+            body: args,
+            ...options,
+        });
+        if (response.error) {
+            throw new S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        return response.data;
+    }
+    /**
+     * Get stream configuration.
+     *
+     * @param args.stream Stream name
+     */
+    async getConfig(args, options) {
+        const response = await getStreamConfig({
+            client: this.client,
+            path: args,
+            ...options,
+        });
+        if (response.error) {
+            throw new S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        return response.data;
+    }
+    /**
+     * Delete a stream.
+     *
+     * @param args.stream Stream name
+     */
+    async delete(args, options) {
+        const response = await deleteStream({
+            client: this.client,
+            path: args,
+            ...options,
+        });
+        if (response.error) {
+            throw new S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        return response.data;
+    }
+    /**
+     * Reconfigure a stream.
+     *
+     * @param args.stream Stream name
+     * @param args.body Configuration fields to change
+     */
+    async reconfigure(args, options) {
+        const response = await reconfigureStream({
+            client: this.client,
+            path: args,
+            body: args,
+            ...options,
+        });
+        if (response.error) {
+            throw new S2Error({
+                message: response.error.message,
+                code: response.error.code ?? undefined,
+                status: response.response.status,
+            });
+        }
+        return response.data;
+    }
+}
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,20 @@
+import type { AppendRecord as AppendRecordType } from "./stream";
+type Headers = Record<string, string> | Array<[string | Uint8Array, string | Uint8Array]>;
+export type AppendRecord = AppendRecordType;
+/**
+ * Helpers to construct appendable records.
+ *
+ * These helpers mirror the OpenAPI record schema and add convenience builders for S2 command records:
+ * - `make` creates a normal record
+ * - `command` creates a command record with an empty-name header set to the command name
+ * - `fence` is a command record enforcing a fencing token
+ * - `trim` is a command record that encodes a sequence number for trimming
+ */
+export declare const AppendRecord: {
+    readonly make: (body?: string | Uint8Array, headers?: Headers, timestamp?: AppendRecordType["timestamp"]) => AppendRecordType;
+    readonly command: (command: string, body?: string | Uint8Array, additionalHeaders?: Headers, timestamp?: AppendRecordType["timestamp"]) => AppendRecordType;
+    readonly fence: (fencing_token: string, additionalHeaders?: Headers, timestamp?: AppendRecordType["timestamp"]) => AppendRecordType;
+    readonly trim: (seqNum: number | bigint, additionalHeaders?: Headers, timestamp?: AppendRecordType["timestamp"]) => AppendRecordType;
+};
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjE,KAAK,OAAO,GACT,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,KAAK,CAAC,CAAC,MAAM,GAAG,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;2BAEhB,MAAM,GAAG,UAAU,YAChB,OAAO,cACL,gBAAgB,CAAC,WAAW,CAAC,KACvC,gBAAgB;gCAST,MAAM,SACR,MAAM,GAAG,UAAU,sBACN,OAAO,cACf,gBAAgB,CAAC,WAAW,CAAC,KACvC,gBAAgB;oCAsBH,MAAM,sBACD,OAAO,cACf,gBAAgB,CAAC,WAAW,CAAC;4BAUjC,MAAM,GAAG,MAAM,sBACH,OAAO,cACf,gBAAgB,CAAC,WAAW,CAAC,KACvC,gBAAgB;CAOV,CAAC"}

package/dist/utils.js

@@ -0,0 +1,52 @@
+/**
+ * Helpers to construct appendable records.
+ *
+ * These helpers mirror the OpenAPI record schema and add convenience builders for S2 command records:
+ * - `make` creates a normal record
+ * - `command` creates a command record with an empty-name header set to the command name
+ * - `fence` is a command record enforcing a fencing token
+ * - `trim` is a command record that encodes a sequence number for trimming
+ */
+export const AppendRecord = {
+    make: (body, headers, timestamp) => {
+        return {
+            body,
+            headers,
+            timestamp,
+        };
+    },
+    command: (
+    /** Command name (e.g. "fence" or "trim"). */
+    command, body, additionalHeaders, timestamp) => {
+        const headers = (() => {
+            if (!additionalHeaders) {
+                return [["", command]];
+            }
+            else if (Array.isArray(additionalHeaders)) {
+                return [["", command], ...additionalHeaders];
+            }
+            else {
+                return [
+                    ["", command],
+                    ...Object.entries(additionalHeaders).map(([key, value]) => [key, value]),
+                ];
+            }
+        })();
+        return {
+            body,
+            headers,
+            timestamp,
+        };
+    },
+    fence: (fencing_token, additionalHeaders, timestamp) => {
+        return AppendRecord.command("fence", fencing_token, additionalHeaders, timestamp);
+    },
+    trim: (seqNum, additionalHeaders, timestamp) => {
+        // Encode sequence number as 8 big-endian bytes
+        const buffer = new Uint8Array(8);
+        const view = new DataView(buffer.buffer);
+        view.setBigUint64(0, BigInt(seqNum), false); // false = big-endian
+        return AppendRecord.command("trim", buffer, additionalHeaders, timestamp);
+    },
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,IAAI,EAAE,CACL,IAA0B,EAC1B,OAAiB,EACjB,SAAyC,EACtB,EAAE;QACrB,OAAO;YACN,IAAI;YACJ,OAAO;YACP,SAAS;SACT,CAAC;IACH,CAAC;IACD,OAAO,EAAE;IACR,6CAA6C;IAC7C,OAAe,EACf,IAA0B,EAC1B,iBAA2B,EAC3B,SAAyC,EACtB,EAAE;QACrB,MAAM,OAAO,GAAgC,CAAC,GAAG,EAAE;YAClD,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,CAAC,EAAE,EAAE,OAAO,CAAqB,EAAE,GAAG,iBAAiB,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACP,OAAO;oBACN,CAAC,EAAE,EAAE,OAAO,CAAqB;oBACjC,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,CACvC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAqB,CAClD;iBACD,CAAC;YACH,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;QACL,OAAO;YACN,IAAI;YACJ,OAAO;YACP,SAAS;SACT,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CACN,aAAqB,EACrB,iBAA2B,EAC3B,SAAyC,EACxC,EAAE;QACH,OAAO,YAAY,CAAC,OAAO,CAC1B,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,SAAS,CACT,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CACL,MAAuB,EACvB,iBAA2B,EAC3B,SAAyC,EACtB,EAAE;QACrB,+CAA+C;QAC/C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB;QAClE,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;CACQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s2-dev/streamstore",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "type": "module",
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
@@ -21,6 +21,10 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "devDependencies": {
     "@biomejs/biome": "2.2.5",
     "@changesets/cli": "^2.29.7",

package/.changeset/README.md

@@ -1,8 +0,0 @@
-# Changesets
-
-Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
-with multi-package repos, or single-package repos to help you version and publish your code. You can
-find the full documentation for it [in our repository](https://github.com/changesets/changesets)
-
-We have a quick list of common questions to get you started engaging with this project in
-[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/config.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
-  "changelog": "@changesets/cli/changelog",
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "restricted",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Read(//Users/infiniteregrets/Documents/s2-sdk-rust/**)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

package/.github/workflows/ci.yml

@@ -1,59 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: ["**"]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Build
-        run: bun run build
-
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Run check
-        run: bun run check
-
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Run test
-        run: bun run test

package/.github/workflows/publish.yml

@@ -1,35 +0,0 @@
-name: Publish
-
-on:
-  push:
-    branches:
-      - main
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    steps:
-      - name: Checkout Repo
-        uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
-
-      - name: Install Dependencies
-        run: bun install
-
-      - name: Build
-        run: bun run build
-
-      - name: Create Release Pull Request or Publish to npm
-        id: changesets
-        uses: changesets/action@v1.5.3
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -1,7 +0,0 @@
-# @s2-dev/streamstore
-
-## 0.16.0
-
-### Minor Changes
-
-- New sdk for S2

package/biome.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.2.5/schema.json",
-  "files": {
-    "includes": [
-      "src/**/*.ts",
-      "*.json",
-      "!src/generated/**/*.ts",
-      "examples/**/*.ts"
-    ]
-  },
-  "formatter": {
-    "enabled": true,
-    "formatWithErrors": true
-  },
-  "linter": {
-    "enabled": false
-  },
-  "json": {
-    "formatter": {
-      "indentWidth": 2,
-      "indentStyle": "space"
-    },
-    "parser": {
-      "allowTrailingCommas": true
-    }
-  },
-  "assist": {
-    "enabled": true
-  }
-}