@sovereignbase/station-client 0.0.0

package/dist/index.js

@@ -0,0 +1,346 @@
+/*
+ * Copyright 2026 Sovereignbase
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+
+// src/StationClient/class.ts
+import { encode, decode } from "@msgpack/msgpack";
+var StationClient = class {
+  eventTarget = new EventTarget();
+  lockName;
+  channelName;
+  webSocketUrl;
+  instanceId = self.crypto.randomUUID();
+  onlineHandler = () => {
+    void this.opportunisticConnect();
+  };
+  broadcastChannel = null;
+  webSocket = null;
+  isLeader = false;
+  isClosed = false;
+  isConnecting = false;
+  outboundQueue = [];
+  pendingTransacts = /* @__PURE__ */ new Map();
+  pendingTransactTargets = /* @__PURE__ */ new Map();
+  /**
+   * Initializes a new {@link StationClient} instance.
+   *
+   * @param webSocketUrl The base station WebSocket URL. When omitted, the instance operates in local-only mode.
+   */
+  constructor(webSocketUrl = "") {
+    this.webSocketUrl = webSocketUrl;
+    this.channelName = `origin-channel-lock::${this.webSocketUrl}`;
+    this.lockName = `origin-channel-lock::${this.webSocketUrl}`;
+    this.broadcastChannel = new BroadcastChannel(this.channelName);
+    this.broadcastChannel.onmessage = (event) => {
+      const envelope = event.data;
+      if (!envelope) return;
+      if (envelope.kind === "relay") {
+        this.eventTarget.dispatchEvent(
+          new CustomEvent("message", { detail: envelope.message })
+        );
+        if (!this.isLeader) return;
+        this.sendToStation(envelope.message);
+        return;
+      }
+      if (envelope.kind === "transact-response") {
+        if (envelope.target !== this.instanceId) return;
+        const pending = this.pendingTransacts.get(envelope.id);
+        if (!pending) return;
+        this.pendingTransacts.delete(envelope.id);
+        pending.cleanup();
+        pending.resolve(envelope.message);
+        return;
+      }
+      if (envelope.kind === "transact-abort") {
+        if (!this.isLeader) return;
+        const pendingTarget2 = this.pendingTransactTargets.get(envelope.id);
+        if (pendingTarget2) clearTimeout(pendingTarget2.timeoutId);
+        this.pendingTransactTargets.delete(envelope.id);
+        return;
+      }
+      if (!this.isLeader) return;
+      if (!this.webSocketUrl || self.navigator.onLine !== true || !this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) {
+        this.broadcastChannel?.postMessage({
+          kind: "transact-response",
+          id: envelope.id,
+          target: envelope.source,
+          message: false
+        });
+        return;
+      }
+      const pendingTarget = this.pendingTransactTargets.get(envelope.id);
+      if (pendingTarget) clearTimeout(pendingTarget.timeoutId);
+      this.pendingTransactTargets.set(envelope.id, {
+        target: envelope.source,
+        timeoutId: setTimeout(() => {
+          this.pendingTransactTargets.delete(envelope.id);
+        }, envelope.ttlMs ?? 3e4)
+      });
+      this.sendToStation([
+        "station-client-request",
+        envelope.id,
+        envelope.message
+      ]);
+    };
+    if (this.webSocketUrl && navigator.onLine) void this.opportunisticConnect();
+    if (this.webSocketUrl) {
+      self.addEventListener("online", this.onlineHandler);
+    }
+  }
+  /**main methods*/
+  /**
+   * Broadcasts a message to other same-origin contexts and opportunistically forwards it to the base station.
+   *
+   * @param message The message to broadcast.
+   */
+  relay(message) {
+    if (this.isClosed) return;
+    this.broadcastChannel?.postMessage({ kind: "relay", message });
+    this.sendToStation(message);
+  }
+  /**
+   * Sends a request to the base station and resolves with the corresponding response message.
+   *
+   * @param message The message to send.
+   * @param options Options that control cancellation and stale follower cleanup.
+   * @returns A promise that resolves with the response message, or `false` when the request cannot be issued.
+   */
+  transact(message, options = {}) {
+    if (this.isClosed) return Promise.resolve(false);
+    const id = self.crypto.randomUUID();
+    const { signal, ttlMs } = options;
+    return new Promise((resolve, reject) => {
+      const abortReason = () => signal?.reason ?? new DOMException("The operation was aborted.", "AbortError");
+      if (signal?.aborted) {
+        reject(abortReason());
+        return;
+      }
+      if (!this.webSocketUrl || self.navigator.onLine !== true) {
+        resolve(false);
+        return;
+      }
+      if (this.isLeader && (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN)) {
+        resolve(false);
+        return;
+      }
+      const handleAbort = () => {
+        this.pendingTransacts.delete(id);
+        const pendingTarget = this.pendingTransactTargets.get(id);
+        if (pendingTarget) clearTimeout(pendingTarget.timeoutId);
+        this.pendingTransactTargets.delete(id);
+        signal?.removeEventListener("abort", handleAbort);
+        if (!this.isLeader) {
+          this.broadcastChannel?.postMessage({ kind: "transact-abort", id });
+        }
+        reject(abortReason());
+      };
+      this.pendingTransacts.set(id, {
+        resolve,
+        reject,
+        cleanup: () => {
+          signal?.removeEventListener("abort", handleAbort);
+        }
+      });
+      signal?.addEventListener("abort", handleAbort, { once: true });
+      if (this.isLeader) {
+        this.sendToStation(["station-client-request", id, message]);
+        return;
+      }
+      this.broadcastChannel?.postMessage({
+        kind: "transact",
+        id,
+        source: this.instanceId,
+        ttlMs,
+        message
+      });
+    });
+  }
+  /**
+   * Closes the client and releases its local and remote resources.
+   */
+  close() {
+    const wasLeader = this.isLeader;
+    const broadcastChannel = this.broadcastChannel;
+    this.isClosed = true;
+    self.removeEventListener("online", this.onlineHandler);
+    if (!wasLeader) {
+      for (const id of this.pendingTransacts.keys()) {
+        try {
+          broadcastChannel?.postMessage({ kind: "transact-abort", id });
+        } catch {
+        }
+      }
+    }
+    try {
+      broadcastChannel?.close();
+    } catch {
+    }
+    try {
+      this.webSocket?.close(1e3, "closed");
+    } catch {
+    }
+    this.broadcastChannel = null;
+    this.webSocket = null;
+    this.isLeader = false;
+    this.outboundQueue.length = 0;
+    for (const pending of this.pendingTransacts.values()) {
+      pending.cleanup();
+      pending.reject(new Error("Station client closed"));
+    }
+    this.pendingTransacts.clear();
+    for (const pendingTarget of this.pendingTransactTargets.values()) {
+      clearTimeout(pendingTarget.timeoutId);
+    }
+    this.pendingTransactTargets.clear();
+  }
+  /**listeners*/
+  /**
+   * Appends an event listener for events whose type attribute value is `type`.
+   *
+   * @param type The event type to listen for.
+   * @param listener The callback that receives the event.
+   * @param options An options object that specifies characteristics about the event listener.
+   */
+  addEventListener(type, listener, options) {
+    this.eventTarget.addEventListener(
+      type,
+      listener,
+      options
+    );
+  }
+  /**
+   * Removes an event listener previously registered with {@link addEventListener}.
+   *
+   * @param type The event type to remove.
+   * @param listener The callback to remove.
+   * @param options An options object that specifies characteristics about the event listener.
+   */
+  removeEventListener(type, listener, options) {
+    this.eventTarget.removeEventListener(
+      type,
+      listener,
+      options
+    );
+  }
+  /**helpers*/
+  sendToStation(message) {
+    if (!this.isLeader || !this.webSocketUrl) return;
+    if (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) {
+      if (self.navigator.onLine) {
+        if (this.outboundQueue.length >= 64) this.outboundQueue.shift();
+        this.outboundQueue.push(message);
+      }
+      return;
+    }
+    try {
+      this.webSocket.send(encode(message));
+    } catch {
+    }
+  }
+  flushOutboundQueue() {
+    if (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) return;
+    while (this.outboundQueue.length > 0) {
+      const message = this.outboundQueue.shift();
+      if (!message) continue;
+      try {
+        this.webSocket.send(encode(message));
+      } catch {
+        this.outboundQueue.unshift(message);
+        return;
+      }
+    }
+  }
+  async opportunisticConnect() {
+    if (this.isClosed || this.isConnecting || !this.webSocketUrl) return;
+    if (!self.navigator.locks) return;
+    this.isConnecting = true;
+    try {
+      while (!this.isClosed) {
+        if (self.navigator.onLine !== true) return;
+        await self.navigator.locks.request(
+          this.lockName,
+          { ifAvailable: true },
+          async (lockHandle) => {
+            if (!lockHandle || this.isClosed) return;
+            this.isLeader = true;
+            let socket;
+            try {
+              socket = new WebSocket(this.webSocketUrl);
+            } catch {
+              this.isLeader = false;
+              this.webSocket = null;
+              return;
+            }
+            socket.binaryType = "arraybuffer";
+            this.webSocket = socket;
+            socket.onopen = () => {
+              this.flushOutboundQueue();
+            };
+            socket.onmessage = (event) => {
+              const message = decode(event.data);
+              if (!message) return;
+              if (Array.isArray(message) && message[0] === "station-client-response" && typeof message[1] === "string") {
+                const id = message[1];
+                const pendingTarget = this.pendingTransactTargets.get(id);
+                if (pendingTarget) {
+                  clearTimeout(pendingTarget.timeoutId);
+                  this.pendingTransactTargets.delete(id);
+                  this.broadcastChannel?.postMessage({
+                    kind: "transact-response",
+                    id,
+                    target: pendingTarget.target,
+                    message: message[2]
+                  });
+                  return;
+                }
+                const pending = this.pendingTransacts.get(id);
+                if (!pending) return;
+                this.pendingTransacts.delete(id);
+                pending.cleanup();
+                pending.resolve(message[2]);
+                return;
+              }
+              this.eventTarget.dispatchEvent(
+                new CustomEvent("message", { detail: message })
+              );
+              this.broadcastChannel?.postMessage({
+                kind: "relay",
+                message
+              });
+            };
+            socket.onclose = () => {
+              if (this.webSocket === socket) this.webSocket = null;
+              this.isLeader = false;
+            };
+            await new Promise((resolve) => {
+              socket.addEventListener("close", () => resolve(), { once: true });
+            });
+            this.isLeader = false;
+            if (this.webSocket === socket) this.webSocket = null;
+          }
+        );
+        if (this.isClosed || self.navigator.onLine !== true) return;
+        await new Promise((resolve) => setTimeout(resolve, 1e4));
+      }
+    } finally {
+      this.isConnecting = false;
+    }
+  }
+};
+export {
+  StationClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/StationClient/class.ts"],"sourcesContent":["import { encode, decode } from '@msgpack/msgpack'\nimport type {\n  StationClientEventMap,\n  StationClientEventListenerFor,\n  StationClientLocalMessageShape,\n  StationClientPendingTransact,\n  StationClientPendingTransactTarget,\n  StationClientRemoteMessageShape,\n  StationClientTransactOptions,\n} from '../.types/index.js'\n\n/**\n * Represents a base station client that coordinates local tab messaging and an opportunistic base station transport.\n *\n * @template T The application message shape.\n */\nexport class StationClient<T extends Record<string, unknown>> {\n  private readonly eventTarget = new EventTarget()\n  private readonly lockName: string\n  private readonly channelName: string\n  private readonly webSocketUrl: string\n  private readonly instanceId = self.crypto.randomUUID()\n  private readonly onlineHandler = () => {\n    void this.opportunisticConnect()\n  }\n  private broadcastChannel: BroadcastChannel | null = null\n  private webSocket: WebSocket | null = null\n  private isLeader: boolean = false\n  private isClosed: boolean = false\n  private isConnecting: boolean = false\n  private readonly outboundQueue: StationClientRemoteMessageShape<T>[] = []\n  private readonly pendingTransacts = new Map<\n    string,\n    StationClientPendingTransact<T>\n  >()\n  private readonly pendingTransactTargets = new Map<\n    string,\n    StationClientPendingTransactTarget\n  >()\n\n  /**\n   * Initializes a new {@link StationClient} instance.\n   *\n   * @param webSocketUrl The base station WebSocket URL. When omitted, the instance operates in local-only mode.\n   */\n  constructor(webSocketUrl: string = '') {\n    this.webSocketUrl = webSocketUrl\n    this.channelName = `origin-channel-lock::${this.webSocketUrl}`\n    this.lockName = `origin-channel-lock::${this.webSocketUrl}`\n\n    this.broadcastChannel = new BroadcastChannel(this.channelName)\n    this.broadcastChannel.onmessage = (\n      event: MessageEvent<StationClientLocalMessageShape<T>>\n    ) => {\n      const envelope = event.data\n      if (!envelope) return\n\n      if (envelope.kind === 'relay') {\n        this.eventTarget.dispatchEvent(\n          new CustomEvent('message', { detail: envelope.message })\n        )\n        if (!this.isLeader) return\n\n        this.sendToStation(envelope.message)\n        return\n      }\n\n      if (envelope.kind === 'transact-response') {\n        if (envelope.target !== this.instanceId) return\n\n        const pending = this.pendingTransacts.get(envelope.id)\n        if (!pending) return\n\n        this.pendingTransacts.delete(envelope.id)\n        pending.cleanup()\n        pending.resolve(envelope.message)\n        return\n      }\n\n      if (envelope.kind === 'transact-abort') {\n        if (!this.isLeader) return\n\n        const pendingTarget = this.pendingTransactTargets.get(envelope.id)\n        if (pendingTarget) clearTimeout(pendingTarget.timeoutId)\n        this.pendingTransactTargets.delete(envelope.id)\n        return\n      }\n\n      if (!this.isLeader) return\n\n      if (\n        !this.webSocketUrl ||\n        self.navigator.onLine !== true ||\n        !this.webSocket ||\n        this.webSocket.readyState !== WebSocket.OPEN\n      ) {\n        this.broadcastChannel?.postMessage({\n          kind: 'transact-response',\n          id: envelope.id,\n          target: envelope.source,\n          message: false,\n        })\n        return\n      }\n\n      const pendingTarget = this.pendingTransactTargets.get(envelope.id)\n      if (pendingTarget) clearTimeout(pendingTarget.timeoutId)\n\n      this.pendingTransactTargets.set(envelope.id, {\n        target: envelope.source,\n        timeoutId: setTimeout(() => {\n          this.pendingTransactTargets.delete(envelope.id)\n        }, envelope.ttlMs ?? 30_000),\n      })\n      this.sendToStation([\n        'station-client-request',\n        envelope.id,\n        envelope.message,\n      ])\n    }\n\n    if (this.webSocketUrl && navigator.onLine) void this.opportunisticConnect()\n    if (this.webSocketUrl) {\n      self.addEventListener('online', this.onlineHandler)\n    }\n  }\n  /**main methods*/\n\n  /**\n   * Broadcasts a message to other same-origin contexts and opportunistically forwards it to the base station.\n   *\n   * @param message The message to broadcast.\n   */\n  relay(message: T) {\n    if (this.isClosed) return\n\n    this.broadcastChannel?.postMessage({ kind: 'relay', message })\n    this.sendToStation(message)\n  }\n\n  /**\n   * Sends a request to the base station and resolves with the corresponding response message.\n   *\n   * @param message The message to send.\n   * @param options Options that control cancellation and stale follower cleanup.\n   * @returns A promise that resolves with the response message, or `false` when the request cannot be issued.\n   */\n  transact(\n    message: T,\n    options: StationClientTransactOptions = {}\n  ): Promise<T | false> {\n    if (this.isClosed) return Promise.resolve(false)\n\n    const id = self.crypto.randomUUID()\n    const { signal, ttlMs } = options\n\n    return new Promise<T | false>((resolve, reject) => {\n      const abortReason = () =>\n        signal?.reason ??\n        new DOMException('The operation was aborted.', 'AbortError')\n\n      if (signal?.aborted) {\n        reject(abortReason())\n        return\n      }\n\n      if (!this.webSocketUrl || self.navigator.onLine !== true) {\n        resolve(false)\n        return\n      }\n\n      if (\n        this.isLeader &&\n        (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN)\n      ) {\n        resolve(false)\n        return\n      }\n\n      const handleAbort = () => {\n        this.pendingTransacts.delete(id)\n        const pendingTarget = this.pendingTransactTargets.get(id)\n        if (pendingTarget) clearTimeout(pendingTarget.timeoutId)\n        this.pendingTransactTargets.delete(id)\n        signal?.removeEventListener('abort', handleAbort)\n\n        if (!this.isLeader) {\n          this.broadcastChannel?.postMessage({ kind: 'transact-abort', id })\n        }\n\n        reject(abortReason())\n      }\n\n      this.pendingTransacts.set(id, {\n        resolve,\n        reject,\n        cleanup: () => {\n          signal?.removeEventListener('abort', handleAbort)\n        },\n      })\n      signal?.addEventListener('abort', handleAbort, { once: true })\n\n      if (this.isLeader) {\n        this.sendToStation(['station-client-request', id, message])\n        return\n      }\n\n      this.broadcastChannel?.postMessage({\n        kind: 'transact',\n        id,\n        source: this.instanceId,\n        ttlMs,\n        message,\n      })\n    })\n  }\n\n  /**\n   * Closes the client and releases its local and remote resources.\n   */\n  close(): void {\n    const wasLeader = this.isLeader\n    const broadcastChannel = this.broadcastChannel\n    this.isClosed = true\n    self.removeEventListener('online', this.onlineHandler)\n\n    if (!wasLeader) {\n      for (const id of this.pendingTransacts.keys()) {\n        try {\n          broadcastChannel?.postMessage({ kind: 'transact-abort', id })\n        } catch {}\n      }\n    }\n\n    try {\n      broadcastChannel?.close()\n    } catch {}\n    try {\n      this.webSocket?.close(1000, 'closed')\n    } catch {}\n\n    this.broadcastChannel = null\n    this.webSocket = null\n    this.isLeader = false\n    this.outboundQueue.length = 0\n    for (const pending of this.pendingTransacts.values()) {\n      pending.cleanup()\n      pending.reject(new Error('Station client closed'))\n    }\n    this.pendingTransacts.clear()\n    for (const pendingTarget of this.pendingTransactTargets.values()) {\n      clearTimeout(pendingTarget.timeoutId)\n    }\n    this.pendingTransactTargets.clear()\n  }\n\n  /**listeners*/\n\n  /**\n   * Appends an event listener for events whose type attribute value is `type`.\n   *\n   * @param type The event type to listen for.\n   * @param listener The callback that receives the event.\n   * @param options An options object that specifies characteristics about the event listener.\n   */\n  addEventListener<K extends keyof StationClientEventMap<T>>(\n    type: K,\n    listener: StationClientEventListenerFor<T, K> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void {\n    this.eventTarget.addEventListener(\n      type,\n      listener as EventListenerOrEventListenerObject | null,\n      options\n    )\n  }\n\n  /**\n   * Removes an event listener previously registered with {@link addEventListener}.\n   *\n   * @param type The event type to remove.\n   * @param listener The callback to remove.\n   * @param options An options object that specifies characteristics about the event listener.\n   */\n  removeEventListener<K extends keyof StationClientEventMap<T>>(\n    type: K,\n    listener: StationClientEventListenerFor<T, K> | null,\n    options?: boolean | EventListenerOptions\n  ): void {\n    this.eventTarget.removeEventListener(\n      type,\n      listener as EventListenerOrEventListenerObject | null,\n      options\n    )\n  }\n\n  /**helpers*/\n\n  private sendToStation(message: StationClientRemoteMessageShape<T>) {\n    if (!this.isLeader || !this.webSocketUrl) return\n\n    if (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) {\n      if (self.navigator.onLine) {\n        if (this.outboundQueue.length >= 64) this.outboundQueue.shift()\n        this.outboundQueue.push(message)\n      }\n      return\n    }\n\n    try {\n      this.webSocket.send(encode(message))\n    } catch {}\n  }\n\n  private flushOutboundQueue() {\n    if (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) return\n\n    while (this.outboundQueue.length > 0) {\n      const message = this.outboundQueue.shift()\n      if (!message) continue\n\n      try {\n        this.webSocket.send(encode(message))\n      } catch {\n        this.outboundQueue.unshift(message)\n        return\n      }\n    }\n  }\n\n  private async opportunisticConnect() {\n    if (this.isClosed || this.isConnecting || !this.webSocketUrl) return\n    if (!self.navigator.locks) return\n\n    this.isConnecting = true\n\n    try {\n      while (!this.isClosed) {\n        if (self.navigator.onLine !== true) return\n\n        await self.navigator.locks.request(\n          this.lockName,\n          { ifAvailable: true },\n          async (lockHandle) => {\n            if (!lockHandle || this.isClosed) return\n            this.isLeader = true\n\n            let socket: WebSocket\n\n            try {\n              socket = new WebSocket(this.webSocketUrl)\n            } catch {\n              this.isLeader = false\n              this.webSocket = null\n              return\n            }\n\n            socket.binaryType = 'arraybuffer'\n            this.webSocket = socket\n\n            socket.onopen = () => {\n              this.flushOutboundQueue()\n            }\n\n            socket.onmessage = (event: MessageEvent<ArrayBuffer>) => {\n              const message = decode(event.data)\n              if (!message) return\n\n              if (\n                Array.isArray(message) &&\n                message[0] === 'station-client-response' &&\n                typeof message[1] === 'string'\n              ) {\n                const id = message[1]\n                const pendingTarget = this.pendingTransactTargets.get(id)\n                if (pendingTarget) {\n                  clearTimeout(pendingTarget.timeoutId)\n                  this.pendingTransactTargets.delete(id)\n\n                  this.broadcastChannel?.postMessage({\n                    kind: 'transact-response',\n                    id,\n                    target: pendingTarget.target,\n                    message: message[2] as T,\n                  })\n                  return\n                }\n\n                const pending = this.pendingTransacts.get(id)\n                if (!pending) return\n\n                this.pendingTransacts.delete(id)\n                pending.cleanup()\n                pending.resolve(message[2] as T)\n                return\n              }\n\n              this.eventTarget.dispatchEvent(\n                new CustomEvent('message', { detail: message })\n              )\n\n              this.broadcastChannel?.postMessage({\n                kind: 'relay',\n                message: message as T,\n              })\n            }\n\n            socket.onclose = () => {\n              if (this.webSocket === socket) this.webSocket = null\n              this.isLeader = false\n            }\n\n            await new Promise<void>((resolve) => {\n              socket.addEventListener('close', () => resolve(), { once: true })\n            })\n\n            this.isLeader = false\n            if (this.webSocket === socket) this.webSocket = null\n          }\n        )\n\n        if (this.isClosed || self.navigator.onLine !== true) return\n        await new Promise<void>((resolve) => setTimeout(resolve, 10_000))\n      }\n    } finally {\n      this.isConnecting = false\n    }\n  }\n}\n"],"mappings":"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","names":["pendingTarget"]}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "type": "module",
+  "license": "Apache-2.0",
+  "name": "@sovereignbase/station-client",
+  "version": "0.0.0",
+  "description": "Local-first station client for tabs and workers sharing an opportunistic Sovereignbase base station transport.",
+  "keywords": [
+    "typescript",
+    "sovereignbase",
+    "station-client",
+    "base-station",
+    "local-first",
+    "broadcastchannel",
+    "websocket",
+    "tab-sync",
+    "worker"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "format": "prettier . --write",
+    "build": "tsup && node in-browser-testing-build.js",
+    "test": "npm run build && node test/run-coverage.mjs && node test/e2e/run.mjs",
+    "prepare": "husky",
+    "prepublishOnly": "npm run test"
+  },
+  "c8": {
+    "all": true,
+    "include": [
+      "dist/**/*.js"
+    ],
+    "exclude": [
+      "dist/**/*.d.ts",
+      "test/**",
+      "benchmark/**",
+      "playwright.config.ts"
+    ]
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@playwright/test": "^1.59.1",
+    "@sovereignbase/convergent-replicated-struct": "^1.0.1",
+    "@types/node": "^25.5.2",
+    "c8": "^11.0.0",
+    "edge-runtime": "^4.0.1",
+    "fast-glob": "^3.3.3",
+    "husky": "^9.1.7",
+    "playwright": "^1.59.1",
+    "prettier": "^3.8.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "wrangler": "^4.80.0"
+  },
+  "dependencies": {
+    "@msgpack/msgpack": "^3.1.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sovereignbase/station-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sovereignbase/station-client/issues"
+  },
+  "homepage": "https://sovereignbase.dev/station-client"
+}