@sveltebase/sync 1.4.1 → 1.4.4

package/README.md

@@ -1,32 +1,28 @@
 # @sveltebase/sync
 
-Reactive, local-first database synchronization for Svelte 5 using a separate Cloudflare Worker for realtime sync.
+Reactive, local-first database synchronization for Svelte 5 on Cloudflare Workers.
 
 ## Architecture
 
-`@sveltebase/sync` now uses two Workers:
+`@sveltebase/sync` uses one Cloudflare Worker:
 
 ```txt
 browser
   -> SvelteKit app Worker
-      /api/sync -> env.SYNC_WORKER.fetch(request)
-  -> sync Worker
-      owns SyncEngine Durable Object
-      owns websocket upgrades
-      owns broadcasts
-      owns sync database/runtime bindings
-      owns sync auth verification
+      /api/sync -> SyncEngine Durable Object
+      server writes -> platform.env.SYNC_ENGINE
 ```
 
-The SvelteKit app Worker does not export sync Durable Objects. This lets apps use the official `@sveltejs/adapter-cloudflare`.
+The production Worker wraps the official `@sveltejs/adapter-cloudflare` output and exports the `SyncEngine` Durable Object. Vite dev uses `syncDevPlugin()` for the WebSocket broker and `adapter-cloudflare` platform proxy for local Cloudflare bindings.
 
 ## Imports
 
 ```ts
 import { SyncClient, createLiveQuery } from "@sveltebase/sync/client";
 import { defineSync, createPublisher } from "@sveltebase/sync/server";
-import { syncProxy } from "@sveltebase/sync/sveltekit";
-import { defineSyncWorker, SyncEngine } from "@sveltebase/sync/cloudflare";
+import { syncEngineRoute } from "@sveltebase/sync/sveltekit";
+import { createSyncAppWorker, SyncEngine } from "@sveltebase/sync/cloudflare";
+import { syncDevPlugin } from "@sveltebase/sync/vite";
 ```
 
 ## Client
@@ -35,16 +31,7 @@ import { defineSyncWorker, SyncEngine } from "@sveltebase/sync/cloudflare";
 // src/lib/sync-client.ts
 import { SyncClient } from "@sveltebase/sync/client";
 
-type AppSchema = {
-  todos: {
-    id: string;
-    title: string;
-    completed: boolean;
-    updatedAt: string;
-  };
-};
-
-export const sync = new SyncClient<AppSchema>({
+export const sync = new SyncClient({
   name: "app-sync",
   url: "/api/sync",
   tables: {
@@ -58,7 +45,7 @@ export const sync = new SyncClient<AppSchema>({
 
 ## Sync Handlers
 
-Handlers run in the sync Worker. Use `ctx.platform.env` for Cloudflare bindings, `ctx.auth` for verified auth data, and `ctx.identity` for ownership/scoped fanout.
+Handlers run in the sync engine. Use `ctx.platform.env` for Cloudflare bindings, `ctx.auth` for verified auth data, and `ctx.identity` for ownership/scoped fanout.
 
 ```ts
 // src/lib/server/sync-handlers.ts
@@ -69,14 +56,11 @@ export const todoSync = defineSync({
 
   fetch: async (ctx, since) => {
     const db = ctx.platform.env.DB;
-    // Query any database here.
     return [];
   },
 
   authorize: async (ctx) => {
-    if (!ctx.auth) {
-      throw new Error("Unauthorized");
-    }
+    if (!ctx.auth) throw new Error("Unauthorized");
   },
 
   scope: (ctx) => {
@@ -87,97 +71,115 @@ export const todoSync = defineSync({
 export const handlers = [todoSync];
 ```
 
-## Sync Worker
-
-Create a standalone Worker entrypoint that owns the Durable Object:
+## SvelteKit Route For Vite Dev
 
 ```ts
-// src/worker/sync.ts
+// src/routes/api/sync/+server.ts
 import { jwtCookieAuth } from "@sveltebase/auth/sync";
-import { defineSyncWorker, SyncEngine } from "@sveltebase/sync/cloudflare";
+import { syncEngineRoute } from "@sveltebase/sync/sveltekit";
 import { handlers } from "$lib/server/sync-handlers";
 
-export default defineSyncWorker({
+export const { GET } = syncEngineRoute({
   handlers,
   auth: jwtCookieAuth(),
+  allowUnauthenticated: true,
 });
-
-export { SyncEngine };
 ```
 
-`defineSyncWorker()` handles:
-
-- `GET /api/sync`: public websocket upgrade endpoint
-- `POST /broadcast`: publish one external change
-- `POST /broadcast-batch`: publish a batch of external changes
-
-`GET /websocket` is internal to the sync Worker and Durable Object.
-
-## SvelteKit Proxy Route
-
-Keep browsers connecting to the app origin so existing cookies are sent:
+## Worker Wrapper For Wrangler And Production
 
 ```ts
-// src/routes/api/sync/+server.ts
-import { SYNC_WORKER_URL } from "$env/static/private";
-import { syncProxy } from "@sveltebase/sync/sveltekit";
+// src/worker/app.ts
+import app from "../../.svelte-kit/cloudflare/_worker.js";
+import { jwtCookieAuth } from "@sveltebase/auth/sync";
+import { createSyncAppWorker, SyncEngine } from "@sveltebase/sync/cloudflare";
+import { handlers } from "$lib/server/sync-handlers";
 
-export const { GET, POST } = syncProxy({
-  fallbackUrl: SYNC_WORKER_URL,
+export default createSyncAppWorker(app, {
+  handlers,
+  auth: jwtCookieAuth(),
+  allowUnauthenticated: true,
 });
+
+export { SyncEngine };
 ```
 
-In production, configure a Cloudflare service binding named `SYNC_WORKER`. In local development, use `fallbackUrl` such as `http://localhost:8788/api/sync`.
+`createSyncAppWorker()` handles `GET /api/sync` and internal broadcast routes, then delegates all other requests to the adapter output.
 
 ## Publishing Server Events
 
-Publishing is explicit. It never reads SvelteKit request context implicitly.
+Publishing targets the current one-worker sync runtime automatically. In production, `createSyncAppWorker()` registers `env.SYNC_ENGINE`; in Vite dev, `syncDevPlugin()` provides the in-process broker.
 
 ```ts
-import { createPublisher } from "@sveltebase/sync/server";
-
-type AppSchema = {
-  todos: { id: string; title: string; updatedAt: string };
-};
+import { createBulkPublisher, createPublisher } from "@sveltebase/sync/server";
 
-const publish = createPublisher<AppSchema>({
-  platform: ctx.platform,
-  binding: "SYNC_WORKER",
-  fallbackUrl: env.SYNC_WORKER_URL,
-});
+const publish = createPublisher();
+const publishBulk = createBulkPublisher();
 
 await publish("todos", "update", todo.id, todo);
+await publishBulk("todos", [
+  { action: "update", key: todo.id, data: todo },
+]);
+```
+
+## Vite Dev
+
+```ts
+// vite.config.ts
+import { sveltekit } from "@sveltejs/kit/vite";
+import { syncDevPlugin } from "@sveltebase/sync/vite";
+import { jwtCookieAuth } from "@sveltebase/auth/sync";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [
+    syncDevPlugin({
+      auth: jwtCookieAuth(),
+      allowUnauthenticated: true,
+      wranglerConfigPath: "wrangler.local.jsonc",
+    }),
+    sveltekit(),
+  ],
+});
 ```
 
-Inside the sync Worker, `createPublisher()` publishes directly to `platform.env.SYNC_ENGINE`. Inside the app Worker, it publishes through `platform.env.SYNC_WORKER.fetch()`. Without a binding, it uses `fallbackUrl`.
+## Svelte Config
+
+```js
+// svelte.config.js
+import adapter from "@sveltejs/adapter-cloudflare";
+import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
+
+export default {
+  preprocess: vitePreprocess(),
+  kit: {
+    adapter: adapter({
+      platformProxy: {
+        configPath: "wrangler.local.jsonc",
+      },
+    }),
+  },
+};
+```
 
-## Cloudflare Configuration
+## Wrangler Configuration
 
-App Worker:
+Main config for Wrangler dev with remote bindings and production deploy:
 
 ```jsonc
+// wrangler.jsonc
 {
   "name": "my-app",
-  "main": ".svelte-kit/cloudflare/_worker.js",
+  "main": "src/worker/app.ts",
   "compatibility_date": "2026-06-07",
   "compatibility_flags": ["nodejs_compat"],
-  "services": [
+  "d1_databases": [
     {
-      "binding": "SYNC_WORKER",
-      "service": "my-app-sync"
+      "binding": "DB",
+      "database_name": "my-app",
+      "database_id": "..."
     }
-  ]
-}
-```
-
-Sync Worker:
-
-```jsonc
-{
-  "name": "my-app-sync",
-  "main": "./src/worker/sync.ts",
-  "compatibility_date": "2026-06-07",
-  "compatibility_flags": ["nodejs_compat"],
+  ],
   "durable_objects": {
     "bindings": [
       {
@@ -195,9 +197,23 @@ Sync Worker:
 }
 ```
 
-Both Workers need the same session secret when using `@sveltebase/auth/sync`:
+Local config for adapter platform proxy in Vite dev:
 
-```bash
-wrangler secret put JWT_SECRET --config wrangler.jsonc
-wrangler secret put JWT_SECRET --config wrangler.sync.jsonc
+```jsonc
+// wrangler.local.jsonc
+{
+  "name": "my-app-local",
+  "main": ".svelte-kit/cloudflare/_worker.js",
+  "compatibility_date": "2026-06-07",
+  "compatibility_flags": ["nodejs_compat"],
+  "d1_databases": [
+    {
+      "binding": "DB",
+      "database_name": "my-app",
+      "database_id": "..."
+    }
+  ]
+}
 ```
+
+Use `wrangler secret put JWT_SECRET --config wrangler.jsonc` for remote/prod secrets. Use `.env` for Vite dev secrets loaded by the platform proxy.

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC,CAAC;AAaF,cAAM,eAAe,CACnB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACzD,SAAQ,KAAK;IACb,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,YAAY,CAA0B;IAG9C,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,OAAO,CAAC,aAAa,CAMb;gBAEI,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;KACrD;IAoBD,IAAW,MAAM,gDAEhB;IAED,OAAO,CAAC,cAAc;YAiJR,OAAO;IAuFd,SAAS;IAgBhB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;YAOP,kBAAkB;IAoBhC,OAAO,CAAC,kBAAkB;YAkBZ,UAAU;YAiBV,aAAa;YAqBb,mBAAmB;IAyFjC,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,eAAe;IAqChB,UAAU;CAelB;AAED,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG;KAC5G,CAAC,IAAI,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACxC,GAAG;IACF,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KACvB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,OAAO,EAAE;IACT,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;CACrD,KAAK,UAAU,CAAC,OAAO,CAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC,CAAC;AAaF,cAAM,eAAe,CACnB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CACzD,SAAQ,KAAK;IACb,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,YAAY,CAA0B;IAG9C,OAAO,CAAC,gBAAgB,CAAsC;IAE9D,OAAO,CAAC,aAAa,CAMb;gBAEI,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;KACrD;IAoBD,IAAW,MAAM,gDAEhB;IAED,OAAO,CAAC,cAAc;YAiJR,OAAO;IAuFd,SAAS;IAgBhB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,aAAa;YAOP,kBAAkB;IAoBhC,OAAO,CAAC,kBAAkB;YAkBZ,UAAU;YAiBV,aAAa;YAqBb,mBAAmB;IAyFjC,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,eAAe;IAqChB,UAAU;CAelB;AAED,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG;KAC5G,CAAC,IAAI,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACxC,GAAG;IACF,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KACvB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,OAAO,EAAE;IACT,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC;CACrD,KAAK,UAAU,CAAC,OAAO,CAA0B,CAAC"}

package/dist/client/live-query.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-query.svelte.d.ts","sourceRoot":"","sources":["live-query.svelte.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC7B,YAAY,CAAC,EAAE,MAAM,OAAO,EAAE,GAC7B,cAAc,CAAC,CAAC,CAAC,CA6BnB"}
+{"version":3,"file":"live-query.svelte.d.ts","sourceRoot":"","sources":["../../src/client/live-query.svelte.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC7B,YAAY,CAAC,EAAE,MAAM,OAAO,EAAE,GAC7B,cAAc,CAAC,CAAC,CAAC,CA6BnB"}

package/dist/client/status.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.svelte.d.ts","sourceRoot":"","sources":["status.svelte.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqE;IAEnF,IAAI,KAAK,IAIW,YAAY,GAAG,WAAW,GAAG,cAAc,CAF9D;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,EAE9D;CACF"}
+{"version":3,"file":"status.svelte.d.ts","sourceRoot":"","sources":["../../src/client/status.svelte.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAqE;IAEnF,IAAI,KAAK,IAIW,YAAY,GAAG,WAAW,GAAG,cAAc,CAF9D;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,cAAc,EAE9D;CACF"}

package/dist/cloudflare/handler.d.ts

@@ -0,0 +1,13 @@
+import { type SyncAuthResult } from "../server/handler.js";
+import type { SyncHandler, SyncPlatform } from "../server/index.js";
+export declare function configureSyncEngine(handlers: SyncHandler[]): void;
+export declare function getSyncEngineHandlers(): SyncHandler<any, any>[];
+export type SyncWorkerOptions<TAuth = unknown> = {
+    handlers: SyncHandler[];
+    websocketPath?: string;
+    auth?: (request: Request, platform: SyncPlatform) => Promise<SyncAuthResult<TAuth>> | SyncAuthResult<TAuth>;
+    identity?: (auth: TAuth) => string | number | bigint | null | undefined;
+    allowUnauthenticated?: boolean;
+};
+export declare function handleSyncRequest<TAuth = unknown>(request: Request, env: Record<string, unknown>, ctx: ExecutionContext, options: SyncWorkerOptions<TAuth>): Promise<Response>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/cloudflare/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/cloudflare/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA4BpE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,QAE1D;AAED,wBAAgB,qBAAqB,4BAEpC;AAED,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,OAAO,IAAI;IAC/C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,CACL,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,YAAY,KACnB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAkFF,wBAAsB,iBAAiB,CAAC,KAAK,GAAG,OAAO,EACrD,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,qBAsClC"}

package/dist/cloudflare/handler.js

@@ -0,0 +1,99 @@
+import { configurePublisherPlatform, INTERNAL_AUTH_HEADER, } from "../server/handler.js";
+import { resolveIdentity, serializeConnectionAuth } from "../server/auth.js";
+let activeHandlers = [];
+function createPlatform(request, env, ctx) {
+    return {
+        env,
+        ctx,
+        context: ctx,
+        caches,
+        cf: request.cf,
+    };
+}
+function withPath(request, pathname) {
+    const url = new URL(request.url);
+    url.pathname = pathname;
+    return url.toString();
+}
+function isWebSocketRequest(request) {
+    return request.headers.get("Upgrade")?.toLowerCase() === "websocket";
+}
+export function configureSyncEngine(handlers) {
+    activeHandlers = handlers;
+}
+export function getSyncEngineHandlers() {
+    return activeHandlers;
+}
+async function forwardToEngine(request, env) {
+    const namespace = env.SYNC_ENGINE;
+    if (!namespace) {
+        return new Response("Missing SYNC_ENGINE Durable Object binding", {
+            status: 500,
+        });
+    }
+    const id = namespace.idFromName("global");
+    return namespace.get(id).fetch(request);
+}
+async function handleWebSocket(request, env, ctx, options) {
+    if (!isWebSocketRequest(request)) {
+        return new Response("Expected Upgrade: websocket", { status: 426 });
+    }
+    const publicHeaders = new Headers(request.headers);
+    publicHeaders.delete(INTERNAL_AUTH_HEADER);
+    const publicRequest = new Request(request, {
+        headers: publicHeaders,
+    });
+    const platform = createPlatform(publicRequest, env, ctx);
+    let resolvedAuth = null;
+    let identity = null;
+    if (options.auth) {
+        resolvedAuth = (await options.auth(publicRequest, platform)) ?? null;
+        if (!resolvedAuth && options.allowUnauthenticated === false) {
+            return new Response("Unauthorized", { status: 401 });
+        }
+        if (resolvedAuth) {
+            identity = resolveIdentity(resolvedAuth, options.identity);
+        }
+    }
+    else if (options.allowUnauthenticated === false) {
+        return new Response("Unauthorized", { status: 401 });
+    }
+    const forwardedHeaders = new Headers(publicRequest.headers);
+    forwardedHeaders.delete(INTERNAL_AUTH_HEADER);
+    if (resolvedAuth) {
+        forwardedHeaders.set(INTERNAL_AUTH_HEADER, serializeConnectionAuth(resolvedAuth, identity));
+    }
+    const forwardedRequest = new Request(withPath(publicRequest, "/websocket"), publicRequest);
+    for (const [key, value] of forwardedHeaders) {
+        forwardedRequest.headers.set(key, value);
+    }
+    return forwardToEngine(forwardedRequest, env);
+}
+export async function handleSyncRequest(request, env, ctx, options) {
+    configureSyncEngine(options.handlers);
+    configurePublisherPlatform({ env });
+    const url = new URL(request.url);
+    const websocketPath = options.websocketPath ?? "/api/sync";
+    const authMetadata = options.auth;
+    const allowUnauthenticated = options.allowUnauthenticated ??
+        authMetadata?.allowUnauthenticated ??
+        true;
+    if (url.pathname === websocketPath && request.method === "GET") {
+        return handleWebSocket(request, env, ctx, {
+            ...options,
+            websocketPath,
+            allowUnauthenticated,
+        });
+    }
+    if (url.pathname === "/websocket") {
+        return new Response("Not found", { status: 404 });
+    }
+    if ((url.pathname === "/broadcast" ||
+        url.pathname === "/broadcast-batch") &&
+        request.method === "POST") {
+        const headers = new Headers(request.headers);
+        headers.delete(INTERNAL_AUTH_HEADER);
+        return forwardToEngine(new Request(request, { headers }), env);
+    }
+    return new Response("Not found", { status: 404 });
+}

package/dist/cloudflare/index.d.ts

@@ -1,16 +1,10 @@
 import { SyncEngineBase } from "../server/engine.js";
-import { type SyncAuthResult } from "../server/handler.js";
-import type { SyncHandler, SyncPlatform } from "../server/index.js";
-export type SyncWorkerOptions<TAuth = unknown> = {
-    handlers: SyncHandler[];
-    durableObjectBinding?: string;
-    websocketPath?: string;
-    auth?: (request: Request, platform: SyncPlatform) => Promise<SyncAuthResult<TAuth>> | SyncAuthResult<TAuth>;
-    identity?: (auth: TAuth) => string | number | bigint | null | undefined;
-    allowUnauthenticated?: boolean;
+import { type SyncWorkerOptions } from "./handler.js";
+export { configureSyncEngine, handleSyncRequest, type SyncWorkerOptions, } from "./handler.js";
+export type SyncAppWorker = {
+    fetch: NonNullable<ExportedHandler["fetch"]>;
 };
-export declare function createSyncWorker<TAuth = unknown>(options: SyncWorkerOptions<TAuth>): ExportedHandler;
-export declare function defineSyncWorker<TAuth = unknown>(options: SyncWorkerOptions<TAuth>): ExportedHandler;
+export declare function createSyncAppWorker<TAuth = unknown>(app: SyncAppWorker, options: SyncWorkerOptions<TAuth>): ExportedHandler;
 export declare class SyncEngine extends SyncEngineBase {
     constructor(ctx: DurableObjectState, env: Record<string, unknown>);
 }

package/dist/cloudflare/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2CpE,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,OAAO,IAAI;IAC/C,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,CACL,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,YAAY,KACnB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AA6FF,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAC9C,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAChC,eAAe,CAgDjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAC9C,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAChC,eAAe,CAEjB;AAED,qBAAa,UAAW,SAAQ,cAAc;gBAChC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;CAC9C,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,GAAG,OAAO,EACjD,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAChC,eAAe,CA0BjB;AAED,qBAAa,UAAW,SAAQ,cAAc;gBAChC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGlE"}

package/dist/cloudflare/index.js

@@ -1,116 +1,26 @@
 import { SyncEngineBase } from "../server/engine.js";
-import { INTERNAL_AUTH_HEADER, } from "../server/handler.js";
-let activeHandlers = [];
-function defaultIdentity(auth) {
-    const value = auth?.identity ?? auth?.user?.id ?? auth?.userId;
-    return value == null ? null : String(value);
-}
-function serializeConnectionAuth(auth, identity) {
-    const payload = { auth, identity };
-    return btoa(unescape(encodeURIComponent(JSON.stringify(payload))));
-}
-function createPlatform(request, env, ctx) {
-    return {
-        env,
-        ctx,
-        context: ctx,
-        caches,
-        cf: request.cf,
-    };
-}
-function withPath(request, pathname) {
-    const url = new URL(request.url);
-    url.pathname = pathname;
-    return url.toString();
-}
-function isWebSocketRequest(request) {
-    return request.headers.get("Upgrade")?.toLowerCase() === "websocket";
-}
-async function forwardToEngine(request, env, durableObjectBinding) {
-    const namespace = env[durableObjectBinding];
-    if (!namespace) {
-        return new Response(`Missing ${durableObjectBinding} Durable Object binding`, { status: 500 });
-    }
-    const id = namespace.idFromName("global");
-    return namespace.get(id).fetch(request);
-}
-async function handleWebSocket(request, env, ctx, options) {
-    if (!isWebSocketRequest(request)) {
-        return new Response("Expected Upgrade: websocket", { status: 426 });
-    }
-    const publicHeaders = new Headers(request.headers);
-    publicHeaders.delete(INTERNAL_AUTH_HEADER);
-    const publicRequest = new Request(request, {
-        headers: publicHeaders,
-    });
-    const platform = createPlatform(publicRequest, env, ctx);
-    let resolvedAuth = null;
-    let identity = null;
-    if (options.auth) {
-        resolvedAuth = (await options.auth(publicRequest, platform)) ?? null;
-        if (!resolvedAuth && options.allowUnauthenticated === false) {
-            return new Response("Unauthorized", { status: 401 });
-        }
-        if (resolvedAuth) {
-            const identityValue = options.identity
-                ? options.identity(resolvedAuth)
-                : defaultIdentity(resolvedAuth);
-            identity = identityValue == null ? null : String(identityValue);
-        }
-    }
-    else if (options.allowUnauthenticated === false) {
-        return new Response("Unauthorized", { status: 401 });
-    }
-    const forwardedHeaders = new Headers(publicRequest.headers);
-    forwardedHeaders.delete(INTERNAL_AUTH_HEADER);
-    if (resolvedAuth) {
-        forwardedHeaders.set(INTERNAL_AUTH_HEADER, serializeConnectionAuth(resolvedAuth, identity));
-    }
-    const forwardedRequest = new Request(withPath(publicRequest, "/websocket"), publicRequest);
-    for (const [key, value] of forwardedHeaders) {
-        forwardedRequest.headers.set(key, value);
-    }
-    return forwardToEngine(forwardedRequest, env, options.durableObjectBinding);
-}
-export function createSyncWorker(options) {
-    activeHandlers = options.handlers;
-    const durableObjectBinding = options.durableObjectBinding ?? "SYNC_ENGINE";
-    const websocketPath = options.websocketPath ?? "/api/sync";
-    const authMetadata = options.auth;
-    const allowUnauthenticated = options.allowUnauthenticated ??
-        authMetadata?.allowUnauthenticated ??
-        true;
+import { configurePublisherPlatform } from "../server/handler.js";
+import { configureSyncEngine, getSyncEngineHandlers, handleSyncRequest, } from "./handler.js";
+export { configureSyncEngine, handleSyncRequest, } from "./handler.js";
+export function createSyncAppWorker(app, options) {
+    configureSyncEngine(options.handlers);
     return {
         async fetch(request, env, ctx) {
+            configurePublisherPlatform({ env: env });
             const url = new URL(request.url);
-            const workerEnv = env;
-            if (url.pathname === websocketPath && request.method === "GET") {
-                return handleWebSocket(request, workerEnv, ctx, {
-                    ...options,
-                    durableObjectBinding,
-                    websocketPath,
-                    allowUnauthenticated,
-                });
-            }
-            if (url.pathname === "/websocket") {
-                return new Response("Not found", { status: 404 });
+            const websocketPath = options.websocketPath ?? "/api/sync";
+            if ((url.pathname === websocketPath && request.method === "GET") ||
+                ((url.pathname === "/broadcast" ||
+                    url.pathname === "/broadcast-batch") &&
+                    request.method === "POST")) {
+                return handleSyncRequest(request, env, ctx, options);
             }
-            if ((url.pathname === "/broadcast" ||
-                url.pathname === "/broadcast-batch") &&
-                request.method === "POST") {
-                const headers = new Headers(request.headers);
-                headers.delete(INTERNAL_AUTH_HEADER);
-                return forwardToEngine(new Request(request, { headers }), workerEnv, durableObjectBinding);
-            }
-            return new Response("Not found", { status: 404 });
+            return app.fetch(request, env, ctx);
         },
     };
 }
-export function defineSyncWorker(options) {
-    return createSyncWorker(options);
-}
 export class SyncEngine extends SyncEngineBase {
     constructor(ctx, env) {
-        super(ctx, env, activeHandlers);
+        super(ctx, env, getSyncEngineHandlers());
     }
 }

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { SyncClient, createLiveQuery } from "./client/index.js";
 export type { LiveQueryState } from "./client/index.js";
 export { defineSync } from "./server/index.js";
-export type { BulkPublishFn, InferSchemaFromHandlers, PublishEventData, PublishFn, SyncAuthResult, SyncConnectionAuth, SyncContext, SyncHandler, SyncPlatform, SyncPublisherOptions, } from "./server/index.js";
+export type { BulkPublishFn, PublishEventData, PublishFn, SyncAuthResult, SyncConnectionAuth, SyncContext, SyncHandler, SyncPlatform, } from "./server/index.js";
 export type { SyncMessage } from "./protocol.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACvC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,CAAC,CAAC;CACJ,CAAC;AAEN,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAcjE"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACvC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,CAAC,CAAC;CACJ,CAAC;AAEN,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAcjE"}

package/dist/server/auth.d.ts

@@ -0,0 +1,8 @@
+export type SerializedConnectionAuth = {
+    auth: any;
+    identity: string | null;
+};
+export declare function resolveIdentity(auth: any, identity?: (auth: any) => string | number | bigint | null | undefined): string | null;
+export declare function serializeConnectionAuth(auth: any, identity: string | null): string;
+export declare function deserializeConnectionAuth(value: string | null): SerializedConnectionAuth | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,GAAG,CAAC;IACV,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,EACT,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACpE,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,CAIR;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,wBAAwB,GAAG,IAAI,CAQjC"}

package/dist/server/auth.js

@@ -0,0 +1,19 @@
+export function resolveIdentity(auth, identity) {
+    const value = identity
+        ? identity(auth)
+        : (auth?.identity ?? auth?.user?.id ?? auth?.userId);
+    return value == null ? null : String(value);
+}
+export function serializeConnectionAuth(auth, identity) {
+    return btoa(unescape(encodeURIComponent(JSON.stringify({ auth, identity }))));
+}
+export function deserializeConnectionAuth(value) {
+    if (!value)
+        return null;
+    try {
+        return JSON.parse(decodeURIComponent(escape(atob(value))));
+    }
+    catch {
+        return null;
+    }
+}