rwsdk 1.0.0-beta.27-test.20251112194755 → 1.0.0-beta.27-test.20251116215153

package/dist/use-synced-state/useSyncState.js

@@ -0,0 +1,58 @@
+import { React } from "../runtime/client/client";
+import { getSyncStateClient } from "./client";
+import { DEFAULT_SYNC_STATE_PATH } from "./constants.mjs";
+const defaultDeps = {
+    useState: React.useState,
+    useEffect: React.useEffect,
+    useRef: React.useRef,
+    useCallback: React.useCallback,
+};
+/**
+ * Builds a `useSyncedState` hook configured with optional endpoint and hook overrides.
+ * @param options Optional overrides for endpoint and React primitives.
+ * @returns Hook that syncs state through the sync state service.
+ */
+export const createSyncStateHook = (options = {}) => {
+    const resolvedUrl = options.url ?? DEFAULT_SYNC_STATE_PATH;
+    const deps = options.hooks ?? defaultDeps;
+    const { useState, useEffect, useRef, useCallback } = deps;
+    return function useSyncedState(initialValue, key) {
+        if (typeof window === "undefined" && !options.hooks) {
+            return [initialValue, () => { }];
+        }
+        const client = getSyncStateClient(resolvedUrl);
+        const [value, setValue] = useState(initialValue);
+        const valueRef = useRef(value);
+        valueRef.current = value;
+        const setSyncValue = useCallback((nextValue) => {
+            const resolved = typeof nextValue === "function"
+                ? nextValue(valueRef.current)
+                : nextValue;
+            setValue(resolved);
+            valueRef.current = resolved;
+            void client.setState(resolved, key);
+        }, [client, key, setValue, valueRef]);
+        useEffect(() => {
+            let isActive = true;
+            const handleUpdate = (next) => {
+                if (isActive) {
+                    setValue(next);
+                    valueRef.current = next;
+                }
+            };
+            void client.getState(key).then((existing) => {
+                if (existing !== undefined && isActive) {
+                    setValue(existing);
+                    valueRef.current = existing;
+                }
+            });
+            void client.subscribe(key, handleUpdate);
+            return () => {
+                isActive = false;
+                void client.unsubscribe(key, handleUpdate);
+            };
+        }, [client, key, setValue, valueRef]);
+        return [value, setSyncValue];
+    };
+};
+export const useSyncedState = createSyncStateHook();

package/dist/use-synced-state/useSyncedState.d.ts

@@ -0,0 +1,20 @@
+import { React } from "../runtime/client/client";
+type HookDeps = {
+    useState: typeof React.useState;
+    useEffect: typeof React.useEffect;
+    useRef: typeof React.useRef;
+    useCallback: typeof React.useCallback;
+};
+type Setter<T> = (value: T | ((previous: T) => T)) => void;
+export type CreateSyncStateHookOptions = {
+    url?: string;
+    hooks?: HookDeps;
+};
+/**
+ * Builds a `useSyncedState` hook configured with optional endpoint and hook overrides.
+ * @param options Optional overrides for endpoint and React primitives.
+ * @returns Hook that syncs state through the sync state service.
+ */
+export declare const createSyncStateHook: (options?: CreateSyncStateHookOptions) => <T>(initialValue: T, key: string) => [T, Setter<T>];
+export declare const useSyncedState: <T>(initialValue: T, key: string) => [T, Setter<T>];
+export {};

package/dist/use-synced-state/useSyncedState.js

@@ -0,0 +1,58 @@
+import { React } from "../runtime/client/client";
+import { getSyncStateClient } from "./client";
+import { DEFAULT_SYNC_STATE_PATH } from "./constants.mjs";
+const defaultDeps = {
+    useState: React.useState,
+    useEffect: React.useEffect,
+    useRef: React.useRef,
+    useCallback: React.useCallback,
+};
+/**
+ * Builds a `useSyncedState` hook configured with optional endpoint and hook overrides.
+ * @param options Optional overrides for endpoint and React primitives.
+ * @returns Hook that syncs state through the sync state service.
+ */
+export const createSyncStateHook = (options = {}) => {
+    const resolvedUrl = options.url ?? DEFAULT_SYNC_STATE_PATH;
+    const deps = options.hooks ?? defaultDeps;
+    const { useState, useEffect, useRef, useCallback } = deps;
+    return function useSyncedState(initialValue, key) {
+        if (typeof window === "undefined" && !options.hooks) {
+            return [initialValue, () => { }];
+        }
+        const client = getSyncStateClient(resolvedUrl);
+        const [value, setValue] = useState(initialValue);
+        const valueRef = useRef(value);
+        valueRef.current = value;
+        const setSyncValue = useCallback((nextValue) => {
+            const resolved = typeof nextValue === "function"
+                ? nextValue(valueRef.current)
+                : nextValue;
+            setValue(resolved);
+            valueRef.current = resolved;
+            void client.setState(resolved, key);
+        }, [client, key, setValue, valueRef]);
+        useEffect(() => {
+            let isActive = true;
+            const handleUpdate = (next) => {
+                if (isActive) {
+                    setValue(next);
+                    valueRef.current = next;
+                }
+            };
+            void client.getState(key).then((existing) => {
+                if (existing !== undefined && isActive) {
+                    setValue(existing);
+                    valueRef.current = existing;
+                }
+            });
+            void client.subscribe(key, handleUpdate);
+            return () => {
+                isActive = false;
+                void client.unsubscribe(key, handleUpdate);
+            };
+        }, [client, key, setValue, valueRef]);
+        return [value, setSyncValue];
+    };
+};
+export const useSyncedState = createSyncStateHook();

package/dist/use-synced-state/worker.d.mts

@@ -0,0 +1,14 @@
+import { SyncStateServer } from "./SyncStateServer.mjs";
+export { SyncStateServer } from "./SyncStateServer.mjs";
+export type SyncStateRouteOptions = {
+    basePath?: string;
+    resetPath?: string;
+    durableObjectName?: string;
+};
+/**
+ * Registers routes that forward sync state requests to the configured Durable Object namespace.
+ * @param getNamespace Function that returns the Durable Object namespace from the Worker env.
+ * @param options Optional overrides for base path, reset path, and object name.
+ * @returns Router entries for the sync state API and reset endpoint.
+ */
+export declare const syncStateRoutes: (getNamespace: (env: Cloudflare.Env) => DurableObjectNamespace<SyncStateServer>, options?: SyncStateRouteOptions) => import("../runtime/lib/router.js").RouteDefinition<import("../runtime/worker.js").RequestInfo<any, import("../runtime/worker.js").DefaultAppContext>>[];

package/dist/use-synced-state/worker.mjs

@@ -0,0 +1,73 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _SyncStateProxy_stub, _SyncStateProxy_keyHandler;
+import { RpcTarget, newWorkersRpcResponse } from "capnweb";
+import { env } from "cloudflare:workers";
+import { route } from "../runtime/entries/router";
+import { SyncStateServer } from "./SyncStateServer.mjs";
+import { DEFAULT_SYNC_STATE_PATH } from "./constants.mjs";
+export { SyncStateServer } from "./SyncStateServer.mjs";
+const DEFAULT_SYNC_STATE_NAME = "syncedState";
+class SyncStateProxy extends RpcTarget {
+    constructor(stub, keyHandler) {
+        super();
+        _SyncStateProxy_stub.set(this, void 0);
+        _SyncStateProxy_keyHandler.set(this, void 0);
+        __classPrivateFieldSet(this, _SyncStateProxy_stub, stub, "f");
+        __classPrivateFieldSet(this, _SyncStateProxy_keyHandler, keyHandler, "f");
+    }
+    async getState(key) {
+        const transformedKey = __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f") ? await __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f").call(this, key) : key;
+        return __classPrivateFieldGet(this, _SyncStateProxy_stub, "f").getState(transformedKey);
+    }
+    async setState(value, key) {
+        const transformedKey = __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f") ? await __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f").call(this, key) : key;
+        return __classPrivateFieldGet(this, _SyncStateProxy_stub, "f").setState(value, transformedKey);
+    }
+    async subscribe(key, client) {
+        const transformedKey = __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f") ? await __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f").call(this, key) : key;
+        return __classPrivateFieldGet(this, _SyncStateProxy_stub, "f").subscribe(transformedKey, client);
+    }
+    async unsubscribe(key, client) {
+        const transformedKey = __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f") ? await __classPrivateFieldGet(this, _SyncStateProxy_keyHandler, "f").call(this, key) : key;
+        return __classPrivateFieldGet(this, _SyncStateProxy_stub, "f").unsubscribe(transformedKey, client);
+    }
+}
+_SyncStateProxy_stub = new WeakMap(), _SyncStateProxy_keyHandler = new WeakMap();
+/**
+ * Registers routes that forward sync state requests to the configured Durable Object namespace.
+ * @param getNamespace Function that returns the Durable Object namespace from the Worker env.
+ * @param options Optional overrides for base path, reset path, and object name.
+ * @returns Router entries for the sync state API and reset endpoint.
+ */
+export const syncStateRoutes = (getNamespace, options = {}) => {
+    const basePath = options.basePath ?? DEFAULT_SYNC_STATE_PATH;
+    const resetPath = options.resetPath ?? `${basePath}/reset`;
+    const durableObjectName = options.durableObjectName ?? DEFAULT_SYNC_STATE_NAME;
+    const forwardRequest = async (request) => {
+        const keyHandler = SyncStateServer.getKeyHandler();
+        if (!keyHandler) {
+            const namespace = getNamespace(env);
+            const id = namespace.idFromName(durableObjectName);
+            return namespace.get(id).fetch(request);
+        }
+        const namespace = getNamespace(env);
+        const id = namespace.idFromName(durableObjectName);
+        const coordinator = namespace.get(id);
+        const proxy = new SyncStateProxy(coordinator, keyHandler);
+        return newWorkersRpcResponse(request, proxy);
+    };
+    return [
+        route(basePath, ({ request }) => forwardRequest(request)),
+        route(resetPath, ({ request }) => forwardRequest(request)),
+    ];
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rwsdk",
-  "version": "1.0.0-beta.27-test.20251112194755",
+  "version": "1.0.0-beta.27-test.20251116215153",
   "description": "Build fast, server-driven webapps on Cloudflare with SSR, RSC, and realtime",
   "type": "module",
   "bin": {
@@ -104,6 +104,14 @@
     "./realtime/durableObject": {
       "types": "./dist/runtime/lib/realtime/durableObject.d.ts",
       "default": "./dist/runtime/lib/realtime/durableObject.js"
+    },
+    "./use-synced-state/client": {
+      "types": "./dist/use-synced-state/client.d.ts",
+      "default": "./dist/use-synced-state/client.js"
+    },
+    "./use-synced-state/worker": {
+      "types": "./dist/use-synced-state/worker.d.ts",
+      "default": "./dist/use-synced-state/worker.js"
     }
   },
   "keywords": [
@@ -144,10 +152,12 @@
     "@puppeteer/browsers": "~2.10.0",
     "@types/decompress": "~4.2.7",
     "@types/fs-extra": "~11.0.4",
+    "@types/glob": "^8.1.0",
     "@types/react": "~19.1.2",
     "@types/react-dom": "~19.1.2",
     "@types/react-is": "~19.0.0",
     "@vitejs/plugin-react": "~5.0.0",
+    "capnweb": "~0.2.0",
     "chokidar": "~4.0.0",
     "debug": "~4.4.0",
     "decompress": "~4.2.1",
@@ -173,8 +183,7 @@
     "ts-morph": "~27.0.0",
     "unique-names-generator": "~4.7.1",
     "vibe-rules": "~0.3.0",
-    "vite-tsconfig-paths": "~5.1.4",
-    "@types/glob": "^8.1.0"
+    "vite-tsconfig-paths": "~5.1.4"
   },
   "peerDependencies": {
     "@cloudflare/vite-plugin": "^1.13.10",