@coderbuzz/kvs-client 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Indra Gunawan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# KVS Client — `@coderbuzz/kvs-client`
+
+TypeScript client SDK for `@coderbuzz/kvs-server`. REST-first, transparently upgrades to WebSocket RPC for lower latency.
+
+```ts
+import { KvsClient } from "@coderbuzz/kvs-client";
+
+const kv = new KvsClient({ url: "http://localhost:3000", token: "my-token" });
+await kv.set(["greeting"], "hello world");
+const entry = await kv.get(["greeting"]);
+```
+
+## Documentation
+
+Full API reference:
+**[DOCS.md](https://github.com/coderbuzz/kvs-client)**
+
+## License
+
+MIT © 2026 Indra Gunawan

package/index.d.ts

@@ -0,0 +1,88 @@
+import { KvKey, KvEntry, KvCommitResult, KvListSelector, KvListOptions, KvListResult, KvCheck, KvMutation, QueueOptions, KvCommitError, QueueMessage } from '@coderbuzz/kvs';
+export { KvCheck, KvCommitError, KvCommitResult, KvEntry, KvKey, KvKeyPart, KvListOptions, KvListResult, KvListSelector, KvMutation, QueueMessage, QueueOptions } from '@coderbuzz/kvs';
+
+interface KvsClientOptions {
+    /** Base URL of the KVS server, e.g. "http://localhost:3000" */
+    url: string;
+    /** Bearer access token */
+    token: string;
+}
+/**
+ * Singleflight: deduplicates concurrent calls for the same key.
+ * Only one fn() runs at a time per key; all concurrent callers share the result.
+ */
+declare class Singleflight<T = unknown> {
+    private flights;
+    get size(): number;
+    do(key: string, fn: () => T | Promise<T>): Promise<T>;
+    clear(): void;
+}
+declare class KvsClient {
+    private readonly url;
+    private readonly token;
+    private readonly headers;
+    readonly sf: Singleflight<unknown>;
+    private ws;
+    private rpcId;
+    private rpcCallbacks;
+    private watchCallback;
+    private queueCallbacks;
+    private _transport;
+    constructor(options: KvsClientOptions);
+    /** Establish WebSocket connection for RPC, watch, and listen */
+    open(): Promise<void>;
+    /** Close the WebSocket connection */
+    close(): void;
+    private _post;
+    private _rpc;
+    get(key: KvKey): Promise<KvEntry | null>;
+    getAsync<T = unknown>(key: KvKey, fn: () => T | Promise<T>, ttl?: number): Promise<T>;
+    set(key: KvKey, value: unknown, options?: {
+        ttl?: number;
+    }): Promise<KvCommitResult>;
+    delete(key: KvKey): Promise<{
+        ok: true;
+    }>;
+    list(selector: KvListSelector, options?: KvListOptions): Promise<KvListResult>;
+    atomic(): AtomicBuilder;
+    _commitAtomic(checks: KvCheck[], mutations: KvMutation[], enqueues: {
+        payload: unknown;
+        options?: QueueOptions;
+    }[]): Promise<KvCommitResult | KvCommitError>;
+    enqueue(payload: unknown, options?: QueueOptions): Promise<{
+        ok: true;
+        id: number;
+    }>;
+    dequeue(topic?: string, limit?: number): Promise<QueueMessage[]>;
+    acknowledge(id: number): Promise<boolean>;
+    reset(): Promise<{
+        ok: true;
+    }>;
+    health(): Promise<{
+        ok: boolean;
+        uptime: number;
+    }>;
+    watch(keys: KvKey[], callback: (entries: (KvEntry | null)[]) => void): {
+        cancel: () => void;
+    };
+    listen(topic: string, callback: (msg: QueueMessage) => void): {
+        cancel: () => void;
+    };
+}
+/** Fluent builder for atomic operations */
+declare class AtomicBuilder {
+    private client;
+    private checks;
+    private mutations;
+    private enqueues;
+    constructor(client: KvsClient);
+    check(...checks: KvCheck[]): this;
+    set(key: KvKey, value: unknown, options?: {
+        ttl?: number;
+    }): this;
+    delete(key: KvKey): this;
+    enqueue(payload: unknown, options?: QueueOptions): this;
+    commit(): Promise<KvCommitResult | KvCommitError>;
+}
+
+export { AtomicBuilder, KvsClient, type KvsClientOptions, Singleflight };

package/index.js

@@ -0,0 +1,273 @@
+// src/client.ts
+var Singleflight = class {
+  flights = /* @__PURE__ */ new Map();
+  get size() {
+    return this.flights.size;
+  }
+  async do(key, fn) {
+    const existing = this.flights.get(key);
+    if (existing) return existing;
+    const promise = (async () => {
+      try {
+        return await fn();
+      } finally {
+        this.flights.delete(key);
+      }
+    })();
+    this.flights.set(key, promise);
+    return promise;
+  }
+  clear() {
+    this.flights.clear();
+  }
+};
+var KvsClient = class {
+  url;
+  token;
+  headers;
+  sf = new Singleflight();
+  // WebSocket state
+  ws = null;
+  rpcId = 0;
+  rpcCallbacks = /* @__PURE__ */ new Map();
+  watchCallback = null;
+  queueCallbacks = /* @__PURE__ */ new Map();
+  // Active transport
+  _transport;
+  constructor(options) {
+    this.url = options.url.replace(/\/+$/, "");
+    this.token = options.token;
+    this.headers = {
+      "content-type": "application/json",
+      authorization: `Bearer ${options.token}`
+    };
+    this._transport = this._post.bind(this);
+  }
+  // ==================== Transport ====================
+  /** Establish WebSocket connection for RPC, watch, and listen */
+  async open() {
+    if (this.ws?.readyState === WebSocket.OPEN) return;
+    const wsUrl = this.url.replace(/^http/, "ws");
+    const ws = new WebSocket(`${wsUrl}/ws`);
+    ws.onmessage = (event) => {
+      try {
+        const data = JSON.parse(String(event.data));
+        if ("id" in data) {
+          const cb = this.rpcCallbacks.get(data.id);
+          if (cb) {
+            this.rpcCallbacks.delete(data.id);
+            if ("error" in data) cb.reject(new Error(data.error));
+            else cb.resolve(data.result);
+          }
+        } else if (data.type === "watch") {
+          this.watchCallback?.(data.entries);
+        } else if (data.type === "queue") {
+          this.queueCallbacks.get(data.topic)?.(data.message);
+        }
+      } catch {
+      }
+    };
+    ws.onclose = () => {
+      this.ws = null;
+      this._transport = this._post.bind(this);
+      this.watchCallback = null;
+      this.queueCallbacks.clear();
+      for (const cb of this.rpcCallbacks.values()) {
+        cb.reject(new Error("WebSocket closed"));
+      }
+      this.rpcCallbacks.clear();
+    };
+    await new Promise((resolve, reject) => {
+      ws.onopen = () => resolve();
+      ws.onerror = () => reject(new Error("WebSocket connection failed"));
+    });
+    this.ws = ws;
+    const authResult = await this._rpc("auth", { token: this.token });
+    if (!authResult.ok) {
+      this.ws = null;
+      this._transport = this._post.bind(this);
+      ws.close();
+      throw new Error("WebSocket authentication failed");
+    }
+    this._transport = this._rpc.bind(this);
+  }
+  /** Close the WebSocket connection */
+  close() {
+    if (this.ws) {
+      const ws = this.ws;
+      this.ws = null;
+      this._transport = this._post.bind(this);
+      ws.onclose = null;
+      ws.onmessage = null;
+      ws.close();
+      this.watchCallback = null;
+      this.queueCallbacks.clear();
+      for (const cb of this.rpcCallbacks.values()) {
+        cb.reject(new Error("WebSocket closed"));
+      }
+      this.rpcCallbacks.clear();
+    }
+  }
+  async _post(path, params) {
+    const res = await fetch(`${this.url}${path}`, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(params)
+    });
+    if (!res.ok) {
+      throw new Error(`KVS ${path}: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+  }
+  _rpc(path, params) {
+    const id = ++this.rpcId;
+    return new Promise((resolve, reject) => {
+      this.rpcCallbacks.set(id, { resolve, reject });
+      this.ws.send(JSON.stringify({ id, method: path, params }));
+    });
+  }
+  // ==================== KV ====================
+  async get(key) {
+    const data = await this._transport("/kv/get", { key });
+    return data.entry;
+  }
+  async getAsync(key, fn, ttl) {
+    const cacheKey = JSON.stringify(key);
+    return this.sf.do(cacheKey, async () => {
+      const entry = await this.get(key);
+      if (entry) return entry.value;
+      const value = await fn();
+      const result = await this.atomic().check({ key, version: null }).set(key, value, { ttl }).commit();
+      if (result.ok) return value;
+      const winner = await this.get(key);
+      return winner?.value ?? value;
+    });
+  }
+  set(key, value, options) {
+    return this._transport("/kv/set", {
+      key,
+      value,
+      ttl: options?.ttl
+    });
+  }
+  delete(key) {
+    return this._transport("/kv/delete", { key });
+  }
+  list(selector, options) {
+    return this._transport("/kv/list", {
+      prefix: selector.prefix,
+      start: selector.start,
+      end: selector.end,
+      limit: options?.limit,
+      cursor: options?.cursor,
+      reverse: options?.reverse
+    });
+  }
+  atomic() {
+    return new AtomicBuilder(this);
+  }
+  _commitAtomic(checks, mutations, enqueues) {
+    return this._transport("/kv/atomic", {
+      checks: checks.length > 0 ? checks : void 0,
+      mutations: mutations.length > 0 ? mutations : void 0,
+      enqueues: enqueues.length > 0 ? enqueues : void 0
+    });
+  }
+  // ==================== Queue ====================
+  enqueue(payload, options) {
+    return this._transport("/queue/enqueue", {
+      payload,
+      topic: options?.topic,
+      delay: options?.delay,
+      maxAttempts: options?.maxAttempts
+    });
+  }
+  async dequeue(topic = "default", limit = 1) {
+    const data = await this._transport("/queue/dequeue", { topic, limit });
+    return data.messages;
+  }
+  async acknowledge(id) {
+    const data = await this._transport("/queue/ack", { id });
+    return data.ok;
+  }
+  reset() {
+    return this._transport("/kv/reset", {});
+  }
+  async health() {
+    const res = await fetch(`${this.url}/health`);
+    if (!res.ok) {
+      throw new Error(`KVS /health: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+  }
+  // ==================== Watch (requires open()) ====================
+  watch(keys, callback) {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+      throw new Error("WebSocket not connected. Call open() first.");
+    }
+    this.watchCallback = callback;
+    this.ws.send(JSON.stringify({ method: "/kv/watch", params: { keys } }));
+    return {
+      cancel: () => {
+        this.watchCallback = null;
+        if (this.ws?.readyState === WebSocket.OPEN) {
+          this.ws.send(JSON.stringify({ method: "/kv/unwatch" }));
+        }
+      }
+    };
+  }
+  // ==================== Listen Queue (requires open()) ====================
+  listen(topic, callback) {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+      throw new Error("WebSocket not connected. Call open() first.");
+    }
+    this.queueCallbacks.set(topic, callback);
+    this.ws.send(JSON.stringify({ method: "/queue/listen", params: { topic } }));
+    return {
+      cancel: () => {
+        this.queueCallbacks.delete(topic);
+        if (this.ws?.readyState === WebSocket.OPEN) {
+          this.ws.send(JSON.stringify({ method: "/queue/unlisten", params: { topic } }));
+        }
+      }
+    };
+  }
+};
+var AtomicBuilder = class {
+  client;
+  checks = [];
+  mutations = [];
+  enqueues = [];
+  constructor(client) {
+    this.client = client;
+  }
+  check(...checks) {
+    this.checks.push(...checks);
+    return this;
+  }
+  set(key, value, options) {
+    this.mutations.push({ type: "set", key, value, ttl: options?.ttl });
+    return this;
+  }
+  delete(key) {
+    this.mutations.push({ type: "delete", key });
+    return this;
+  }
+  enqueue(payload, options) {
+    this.enqueues.push({ payload, options });
+    return this;
+  }
+  commit() {
+    return this.client._commitAtomic(
+      this.checks,
+      this.mutations,
+      this.enqueues
+    );
+  }
+};
+export {
+  AtomicBuilder,
+  KvsClient,
+  Singleflight
+};
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  KvKey,\n  KvEntry,\n  KvCommitResult,\n  KvCommitError,\n  KvCheck,\n  KvMutation,\n  KvListSelector,\n  KvListOptions,\n  KvListResult,\n  QueueMessage,\n  QueueOptions,\n} from \"@coderbuzz/kvs\";\n\nexport interface KvsClientOptions {\n  /** Base URL of the KVS server, e.g. \"http://localhost:3000\" */\n  url: string;\n  /** Bearer access token */\n  token: string;\n}\n\n/**\n * Singleflight: deduplicates concurrent calls for the same key.\n * Only one fn() runs at a time per key; all concurrent callers share the result.\n */\nexport class Singleflight<T = unknown> {\n  private flights = new Map<string, Promise<T>>();\n\n  get size(): number {\n    return this.flights.size;\n  }\n\n  async do(key: string, fn: () => T | Promise<T>): Promise<T> {\n    const existing = this.flights.get(key);\n    if (existing) return existing;\n\n    const promise = (async () => {\n      try {\n        return await fn();\n      } finally {\n        this.flights.delete(key);\n      }\n    })();\n\n    this.flights.set(key, promise);\n    return promise;\n  }\n\n  clear(): void {\n    this.flights.clear();\n  }\n}\n\nexport class KvsClient {\n  private readonly url: string;\n  private readonly token: string;\n  private readonly headers: Record<string, string>;\n  readonly sf = new Singleflight();\n\n  // WebSocket state\n  private ws: WebSocket | null = null;\n  private rpcId = 0;\n  private rpcCallbacks = new Map<number, { resolve: (v: any) => void; reject: (e: Error) => void; }>();\n  private watchCallback: ((entries: (KvEntry | null)[]) => void) | null = null;\n  private queueCallbacks = new Map<string, (msg: QueueMessage) => void>();\n\n  // Active transport\n  private _transport: (path: string, params: unknown) => Promise<any>;\n\n  constructor(options: KvsClientOptions) {\n    this.url = options.url.replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.headers = {\n      \"content-type\": \"application/json\",\n      authorization: `Bearer ${options.token}`,\n    };\n    this._transport = this._post.bind(this);\n  }\n\n  // ==================== Transport ====================\n\n  /** Establish WebSocket connection for RPC, watch, and listen */\n  async open(): Promise<void> {\n    if (this.ws?.readyState === WebSocket.OPEN) return;\n\n    const wsUrl = this.url.replace(/^http/, \"ws\");\n    const ws = new WebSocket(`${wsUrl}/ws`);\n\n    ws.onmessage = (event) => {\n      try {\n        const data = JSON.parse(String(event.data));\n        if (\"id\" in data) {\n          const cb = this.rpcCallbacks.get(data.id);\n          if (cb) {\n            this.rpcCallbacks.delete(data.id);\n            if (\"error\" in data) cb.reject(new Error(data.error));\n            else cb.resolve(data.result);\n          }\n        } else if (data.type === \"watch\") {\n          this.watchCallback?.(data.entries);\n        } else if (data.type === \"queue\") {\n          this.queueCallbacks.get(data.topic)?.(data.message);\n        }\n      } catch {\n        // Ignore malformed messages\n      }\n    };\n\n    ws.onclose = () => {\n      this.ws = null;\n      this._transport = this._post.bind(this);\n      this.watchCallback = null;\n      this.queueCallbacks.clear();\n      for (const cb of this.rpcCallbacks.values()) {\n        cb.reject(new Error(\"WebSocket closed\"));\n      }\n      this.rpcCallbacks.clear();\n    };\n\n    await new Promise<void>((resolve, reject) => {\n      ws.onopen = () => resolve();\n      ws.onerror = () => reject(new Error(\"WebSocket connection failed\"));\n    });\n\n    this.ws = ws;\n\n    const authResult = await this._rpc(\"auth\", { token: this.token });\n    if (!authResult.ok) {\n      this.ws = null;\n      this._transport = this._post.bind(this);\n      ws.close();\n      throw new Error(\"WebSocket authentication failed\");\n    }\n\n    this._transport = this._rpc.bind(this);\n  }\n\n  /** Close the WebSocket connection */\n  close(): void {\n    if (this.ws) {\n      const ws = this.ws;\n      this.ws = null;\n      this._transport = this._post.bind(this);\n      ws.onclose = null;\n      ws.onmessage = null;\n      ws.close();\n      this.watchCallback = null;\n      this.queueCallbacks.clear();\n      for (const cb of this.rpcCallbacks.values()) {\n        cb.reject(new Error(\"WebSocket closed\"));\n      }\n      this.rpcCallbacks.clear();\n    }\n  }\n\n  private async _post(path: string, params: unknown): Promise<any> {\n    const res = await fetch(`${this.url}${path}`, {\n      method: \"POST\",\n      headers: this.headers,\n      body: JSON.stringify(params),\n    });\n    if (!res.ok) {\n      throw new Error(`KVS ${path}: ${res.status} ${res.statusText}`);\n    }\n    return res.json();\n  }\n\n  private _rpc(path: string, params: unknown): Promise<any> {\n    const id = ++this.rpcId;\n    return new Promise((resolve, reject) => {\n      this.rpcCallbacks.set(id, { resolve, reject });\n      this.ws!.send(JSON.stringify({ id, method: path, params }));\n    });\n  }\n\n  // ==================== KV ====================\n\n  async get(key: KvKey): Promise<KvEntry | null> {\n    const data = await this._transport(\"/kv/get\", { key });\n    return data.entry;\n  }\n\n  async getAsync<T = unknown>(\n    key: KvKey,\n    fn: () => T | Promise<T>,\n    ttl?: number\n  ): Promise<T> {\n    const cacheKey = JSON.stringify(key);\n    return this.sf.do(cacheKey, async () => {\n      const entry = await this.get(key);\n      if (entry) return entry.value as T;\n\n      const value = await fn();\n\n      const result = await this.atomic()\n        .check({ key, version: null })\n        .set(key, value, { ttl })\n        .commit();\n\n      if (result.ok) return value;\n\n      const winner = await this.get(key);\n      return (winner?.value as T) ?? value;\n    }) as Promise<T>;\n  }\n\n  set(\n    key: KvKey,\n    value: unknown,\n    options?: { ttl?: number; }\n  ): Promise<KvCommitResult> {\n    return this._transport(\"/kv/set\", {\n      key,\n      value,\n      ttl: options?.ttl,\n    });\n  }\n\n  delete(key: KvKey): Promise<{ ok: true; }> {\n    return this._transport(\"/kv/delete\", { key });\n  }\n\n  list(\n    selector: KvListSelector,\n    options?: KvListOptions\n  ): Promise<KvListResult> {\n    return this._transport(\"/kv/list\", {\n      prefix: selector.prefix,\n      start: selector.start,\n      end: selector.end,\n      limit: options?.limit,\n      cursor: options?.cursor,\n      reverse: options?.reverse,\n    });\n  }\n\n  atomic(): AtomicBuilder {\n    return new AtomicBuilder(this);\n  }\n\n  _commitAtomic(\n    checks: KvCheck[],\n    mutations: KvMutation[],\n    enqueues: { payload: unknown; options?: QueueOptions; }[]\n  ): Promise<KvCommitResult | KvCommitError> {\n    return this._transport(\"/kv/atomic\", {\n      checks: checks.length > 0 ? checks : undefined,\n      mutations: mutations.length > 0 ? mutations : undefined,\n      enqueues: enqueues.length > 0 ? enqueues : undefined,\n    });\n  }\n\n  // ==================== Queue ====================\n\n  enqueue(\n    payload: unknown,\n    options?: QueueOptions\n  ): Promise<{ ok: true; id: number; }> {\n    return this._transport(\"/queue/enqueue\", {\n      payload,\n      topic: options?.topic,\n      delay: options?.delay,\n      maxAttempts: options?.maxAttempts,\n    });\n  }\n\n  async dequeue(\n    topic: string = \"default\",\n    limit: number = 1\n  ): Promise<QueueMessage[]> {\n    const data = await this._transport(\"/queue/dequeue\", { topic, limit });\n    return data.messages;\n  }\n\n  async acknowledge(id: number): Promise<boolean> {\n    const data = await this._transport(\"/queue/ack\", { id });\n    return data.ok;\n  }\n\n  reset(): Promise<{ ok: true; }> {\n    return this._transport(\"/kv/reset\", {});\n  }\n\n  async health(): Promise<{ ok: boolean; uptime: number; }> {\n    const res = await fetch(`${this.url}/health`);\n    if (!res.ok) {\n      throw new Error(`KVS /health: ${res.status} ${res.statusText}`);\n    }\n    return res.json() as Promise<{ ok: boolean; uptime: number; }>;\n  }\n\n  // ==================== Watch (requires open()) ====================\n\n  watch(\n    keys: KvKey[],\n    callback: (entries: (KvEntry | null)[]) => void\n  ): { cancel: () => void; } {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      throw new Error(\"WebSocket not connected. Call open() first.\");\n    }\n    this.watchCallback = callback;\n    this.ws.send(JSON.stringify({ method: \"/kv/watch\", params: { keys } }));\n\n    return {\n      cancel: () => {\n        this.watchCallback = null;\n        if (this.ws?.readyState === WebSocket.OPEN) {\n          this.ws.send(JSON.stringify({ method: \"/kv/unwatch\" }));\n        }\n      },\n    };\n  }\n\n  // ==================== Listen Queue (requires open()) ====================\n\n  listen(\n    topic: string,\n    callback: (msg: QueueMessage) => void\n  ): { cancel: () => void; } {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      throw new Error(\"WebSocket not connected. Call open() first.\");\n    }\n    this.queueCallbacks.set(topic, callback);\n    this.ws.send(JSON.stringify({ method: \"/queue/listen\", params: { topic } }));\n\n    return {\n      cancel: () => {\n        this.queueCallbacks.delete(topic);\n        if (this.ws?.readyState === WebSocket.OPEN) {\n          this.ws.send(JSON.stringify({ method: \"/queue/unlisten\", params: { topic } }));\n        }\n      },\n    };\n  }\n}\n\n/** Fluent builder for atomic operations */\nexport class AtomicBuilder {\n  private client: KvsClient;\n  private checks: KvCheck[] = [];\n  private mutations: KvMutation[] = [];\n  private enqueues: { payload: unknown; options?: QueueOptions; }[] = [];\n\n  constructor(client: KvsClient) {\n    this.client = client;\n  }\n\n  check(...checks: KvCheck[]): this {\n    this.checks.push(...checks);\n    return this;\n  }\n\n  set(key: KvKey, value: unknown, options?: { ttl?: number; }): this {\n    this.mutations.push({ type: \"set\", key, value, ttl: options?.ttl });\n    return this;\n  }\n\n  delete(key: KvKey): this {\n    this.mutations.push({ type: \"delete\", key });\n    return this;\n  }\n\n  enqueue(payload: unknown, options?: QueueOptions): this {\n    this.enqueues.push({ payload, options });\n    return this;\n  }\n\n  commit(): Promise<KvCommitResult | KvCommitError> {\n    return this.client._commitAtomic(\n      this.checks,\n      this.mutations,\n      this.enqueues\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@coderbuzz/kvs-client",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "TypeScript client SDK for @coderbuzz/kvs-server — REST and WebSocket RPC transport, watch, and push-based queue listeners.",
+  "license": "MIT",
+  "keywords": [
+    "kv",
+    "key-value",
+    "client",
+    "sdk",
+    "rest",
+    "websocket",
+    "typescript",
+    "bun",
+    "node",
+    "deno"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coderbuzz/kvs-client.git"
+  },
+  "dependencies": {
+    "@coderbuzz/kvs": "^0.2.5"
+  }
+}