@sveltebase/sync 1.4.1 → 1.4.3

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,113 @@ 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 is explicit and targets the one-worker Durable Object binding. During Vite dev, `syncDevPlugin()` provides an in-process broker fallback.
 
 ```ts
 import { createPublisher } from "@sveltebase/sync/server";
 
-type AppSchema = {
-  todos: { id: string; title: string; updatedAt: string };
-};
-
-const publish = createPublisher<AppSchema>({
+const publish = createPublisher({
   platform: ctx.platform,
-  binding: "SYNC_WORKER",
-  fallbackUrl: env.SYNC_WORKER_URL,
 });
 
 await publish("todos", "update", todo.id, todo);
 ```
 
-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`.
+## Vite Dev
 
-## Cloudflare Configuration
+```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(),
+  ],
+});
+```
 
-App Worker:
+## 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",
+      },
+    }),
+  },
+};
+```
+
+## Wrangler Configuration
+
+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 +195,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/cloudflare/handler.d.ts

@@ -0,0 +1,14 @@
+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[];
+    durableObjectBinding?: string;
+    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,EAEL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2CpE,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,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,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,qBA2ClC"}

package/dist/cloudflare/handler.js

@@ -0,0 +1,108 @@
+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";
+}
+export function configureSyncEngine(handlers) {
+    activeHandlers = handlers;
+}
+export function getSyncEngineHandlers() {
+    return activeHandlers;
+}
+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 async function handleSyncRequest(request, env, ctx, options) {
+    configureSyncEngine(options.handlers);
+    const url = new URL(request.url);
+    const durableObjectBinding = options.durableObjectBinding ?? "SYNC_ENGINE";
+    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,
+            durableObjectBinding,
+            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, durableObjectBinding);
+    }
+    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;AACrD,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,CAwBjB;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,24 @@
 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 { 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) {
             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/server/broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/server/broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAGzE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,GAAG,CAAC;IACf,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,WAAW,CAAmC;gBAE1C,QAAQ,EAAE,WAAW,EAAE;IAK5B,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE;IAanC,kBAAkB,CAAC,IAAI,EAAE,eAAe;IAIxC,gBAAgB,CAAC,IAAI,EAAE,eAAe;IAI7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCN,aAAa,CACxB,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO;YA2IJ,eAAe;IAmDhB,oBAAoB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG;IAqBE,yBAAyB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CAkBvF"}
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["broker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAGzE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,GAAG,CAAC;IACf,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,WAAW,CAAmC;gBAE1C,QAAQ,EAAE,WAAW,EAAE;IAK5B,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE;IAanC,kBAAkB,CAAC,IAAI,EAAE,eAAe;IAIxC,gBAAgB,CAAC,IAAI,EAAE,eAAe;IAI7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAqCN,aAAa,CACxB,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO;YA2IJ,eAAe;IAmDhB,oBAAoB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG;IAqBE,yBAAyB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;CAkBvF"}

package/dist/server/dev-engine.d.ts

@@ -0,0 +1,22 @@
+import type { IncomingMessage } from "node:http";
+import type { SyncHandler, SyncPlatform } from "./index.js";
+export type SyncDevAuthOptions<TAuth = unknown> = {
+    auth?: (request: Request, platform: SyncPlatform) => Promise<TAuth | null | undefined> | TAuth | null | undefined;
+    identity?: (auth: TAuth) => string | number | bigint | null | undefined;
+    allowUnauthenticated?: boolean;
+    platform?: SyncPlatform | (() => Promise<SyncPlatform> | SyncPlatform);
+    wranglerConfigPath?: string;
+};
+export declare function setHandlers(handlers: SyncHandler[]): void;
+export declare function addClient(ws: {
+    send: (data: string) => void;
+    close: (code?: number, reason?: string) => void;
+    on: (event: string, listener: (...args: any[]) => void) => void;
+}, req: IncomingMessage, options?: SyncDevAuthOptions): Promise<boolean>;
+export declare function broadcastExternalChange(channel: string, action: "create" | "update" | "delete", key: string | undefined, data: any): Promise<void>;
+export declare function broadcastExternalBatchChange(channel: string, changes: Array<{
+    action: "create" | "update" | "delete";
+    key?: string;
+    data?: any;
+}>): Promise<void>;
+//# sourceMappingURL=dev-engine.d.ts.map

package/dist/server/dev-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-engine.d.ts","sourceRoot":"","sources":["dev-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAW5D,MAAM,MAAM,kBAAkB,CAAC,KAAK,GAAG,OAAO,IAAI;IAChD,IAAI,CAAC,EAAE,CACL,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,YAAY,KACnB,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,YAAY,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAkBF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QAWlD;AA4ED,wBAAsB,SAAS,CAC7B,EAAE,EAAE;IACF,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CACjE,EACD,GAAG,EAAE,eAAe,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CA2ElB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,IAAI,EAAE,GAAG,iBAIV;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,CAAC,iBAIH"}

package/dist/server/dev-engine.js

@@ -0,0 +1,165 @@
+import { SyncBroker } from "./broker.js";
+const GLOBAL_BROKER_KEY = "__sveltebase_sync_dev_broker__";
+const GLOBAL_PLATFORM_KEY = "__sveltebase_sync_dev_platform__";
+let devBroker = null;
+function setGlobalBroker(state) {
+    const globalObject = globalThis;
+    globalObject[GLOBAL_BROKER_KEY] = state;
+}
+function getGlobalBroker() {
+    const globalObject = globalThis;
+    return globalObject[GLOBAL_BROKER_KEY];
+}
+export function setHandlers(handlers) {
+    const existing = getGlobalBroker();
+    if (!existing) {
+        const state = { broker: new SyncBroker(handlers) };
+        setGlobalBroker(state);
+        devBroker = state.broker;
+        return;
+    }
+    existing.broker.setHandlers(handlers);
+    devBroker = existing.broker;
+}
+function getDevBroker() {
+    if (devBroker)
+        return devBroker;
+    const existing = getGlobalBroker();
+    if (existing) {
+        devBroker = existing.broker;
+        return existing.broker;
+    }
+    throw new Error("Sync dev broker not initialized. Call setHandlers first.");
+}
+function getHeaderValue(value) {
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+function headersFromIncomingMessage(req) {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                headers.append(key, item);
+            continue;
+        }
+        headers.set(key, value);
+    }
+    return headers;
+}
+function requestFromIncomingMessage(req) {
+    const host = getHeaderValue(req.headers.host) ?? "localhost";
+    const url = new URL(req.url ?? "", `http://${host}`);
+    return new Request(url.toString(), {
+        headers: headersFromIncomingMessage(req),
+    });
+}
+async function resolvePlatform(options) {
+    if (options?.platform) {
+        return typeof options.platform === "function"
+            ? await options.platform()
+            : options.platform;
+    }
+    const globalObject = globalThis;
+    const existing = globalObject[GLOBAL_PLATFORM_KEY];
+    if (existing)
+        return existing.platform;
+    try {
+        const { getPlatformProxy } = await import("wrangler");
+        const proxy = await getPlatformProxy(options?.wranglerConfigPath
+            ? { configPath: options.wranglerConfigPath }
+            : undefined);
+        const platform = proxy;
+        globalObject[GLOBAL_PLATFORM_KEY] = { platform };
+        return platform;
+    }
+    catch {
+        const platform = { env: {} };
+        globalObject[GLOBAL_PLATFORM_KEY] = { platform };
+        return platform;
+    }
+}
+function defaultIdentity(auth) {
+    const value = auth?.identity ?? auth?.user?.id ?? auth?.userId;
+    return value == null ? null : String(value);
+}
+export async function addClient(ws, req, options) {
+    const broker = getDevBroker();
+    const request = requestFromIncomingMessage(req);
+    const platform = await resolvePlatform(options);
+    const subscribedChannels = new Set();
+    let auth = null;
+    let identity = null;
+    try {
+        if (options?.auth) {
+            auth = (await options.auth(request, platform)) ?? null;
+            if (!auth && options.allowUnauthenticated === false) {
+                ws.close(1008, "Unauthorized");
+                return false;
+            }
+            if (auth) {
+                const identityValue = options.identity
+                    ? options.identity(auth)
+                    : defaultIdentity(auth);
+                identity = identityValue == null ? null : String(identityValue);
+            }
+        }
+    }
+    catch {
+        ws.close(1011, "Internal server error");
+        return false;
+    }
+    const conn = {
+        send(data) {
+            ws.send(data);
+        },
+        close(code, reason) {
+            ws.close(code, reason);
+        },
+        getAuth() {
+            return auth;
+        },
+        setAuth(newAuth) {
+            auth = newAuth;
+        },
+        getIdentity() {
+            return identity;
+        },
+        setIdentity(newIdentity) {
+            identity = newIdentity;
+        },
+        getSubscribedChannels() {
+            return subscribedChannels;
+        },
+        headers: request.headers,
+        url: request.url,
+    };
+    broker.registerConnection(conn);
+    ws.on("message", async (data) => {
+        const message = typeof data === "string" ? data : String(data);
+        try {
+            await broker.handleMessage(conn, message, platform, request);
+        }
+        catch (err) {
+            console.error("sync dev engine: error handling message", err);
+        }
+    });
+    ws.on("close", () => {
+        broker.removeConnection(conn);
+    });
+    ws.on("error", () => {
+        broker.removeConnection(conn);
+    });
+    return true;
+}
+export async function broadcastExternalChange(channel, action, key, data) {
+    const broker = getDevBroker();
+    await broker.handleExternalChange(channel, action, key, data);
+}
+export async function broadcastExternalBatchChange(channel, changes) {
+    const broker = getDevBroker();
+    await broker.handleExternalBatchChange(channel, changes);
+}

package/dist/server/handler.d.ts

@@ -8,8 +8,6 @@ export type InferSchemaFromHandlers<T extends SyncHandler[]> = {
     [K in T[number] as K["config"]["channel"] extends string ? K["config"]["channel"] : K["config"]["channel"] extends (...args: any[]) => infer R ? R extends string ? R : string : string]: K extends SyncHandler<infer TRow> ? TRow : never;
 };
 export type SyncPublisherOptions = {
-    binding?: string;
-    fallbackUrl?: string;
     durableObjectBinding?: string;
     platform?: SyncPlatform;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["handler.ts"],"names":[],"mappings":"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"}

package/dist/server/handler.js

@@ -2,8 +2,9 @@ export const INTERNAL_AUTH_HEADER = "x-sveltebase-sync-auth";
 function getEnv(options) {
     return options.platform?.env;
 }
-function normalizeEndpoint(baseUrl, pathname) {
-    return new URL(pathname, baseUrl).toString();
+function hasDevBroker() {
+    const globalObject = globalThis;
+    return Boolean(globalObject.__sveltebase_sync_dev_broker__);
 }
 async function publishToDurableObject(platform, durableObjectBinding, pathname, body) {
     const namespace = platform.env[durableObjectBinding];
@@ -21,44 +22,26 @@ async function publishToDurableObject(platform, durableObjectBinding, pathname,
         throw new Error(await response.text());
     }
 }
-async function publishToServiceBinding(binding, pathname, body) {
-    const response = await binding.fetch(`https://sync.internal${pathname}`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-    });
-    if (!response.ok) {
-        throw new Error(await response.text());
-    }
-}
-async function publishToFallbackUrl(fallbackUrl, pathname, body) {
-    const response = await fetch(normalizeEndpoint(fallbackUrl, pathname), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(body),
-    });
-    if (!response.ok) {
-        throw new Error(await response.text());
+async function publishToDevBroker(pathname, body) {
+    const devEngine = await import("./dev-engine.js");
+    if (pathname === "/broadcast-batch") {
+        await devEngine.broadcastExternalBatchChange(String(body.channel), Array.isArray(body.changes) ? body.changes : []);
+        return;
     }
+    await devEngine.broadcastExternalChange(String(body.channel), body.action, body.key, body.data);
 }
 async function publish(options, pathname, body) {
     const env = getEnv(options);
     const durableObjectBinding = options.durableObjectBinding ?? "SYNC_ENGINE";
-    const bindingName = options.binding ?? "SYNC_WORKER";
     if (options.platform && env?.[durableObjectBinding]) {
         await publishToDurableObject(options.platform, durableObjectBinding, pathname, body);
         return;
     }
-    const serviceBinding = env?.[bindingName];
-    if (serviceBinding?.fetch) {
-        await publishToServiceBinding(serviceBinding, pathname, body);
-        return;
-    }
-    if (options.fallbackUrl) {
-        await publishToFallbackUrl(options.fallbackUrl, pathname, body);
+    if (hasDevBroker()) {
+        await publishToDevBroker(pathname, body);
         return;
     }
-    throw new Error(`Missing sync publisher target: provide platform.env.${durableObjectBinding}, platform.env.${bindingName}, or fallbackUrl`);
+    throw new Error(`Missing sync publisher target: provide platform.env.${durableObjectBinding} or run vite dev with syncDevPlugin()`);
 }
 export function createPublisher(options, handlers) {
     void handlers;

package/dist/sveltekit/index.d.ts

@@ -1,10 +1,7 @@
 import type { RequestHandler } from "@sveltejs/kit";
-export type SyncProxyOptions = {
-    binding?: string;
-    fallbackUrl?: string;
-};
-export declare function syncProxy(options?: SyncProxyOptions): {
+import { type SyncWorkerOptions } from "../cloudflare/handler.js";
+export type SyncEngineRouteOptions<TAuth = unknown> = SyncWorkerOptions<TAuth>;
+export declare function syncEngineRoute<TAuth = unknown>(options: SyncEngineRouteOptions<TAuth>): {
     GET: RequestHandler;
-    POST: RequestHandler;
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sveltekit/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAeF,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG;IACrD,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;CACtB,CA6BA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sveltekit/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,OAAO,IAChD,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAkB3B,wBAAgB,eAAe,CAAC,KAAK,GAAG,OAAO,EAC7C,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,GACrC;IACD,GAAG,EAAE,cAAc,CAAC;CACrB,CAuBA"}

package/dist/sveltekit/index.js

@@ -1,29 +1,23 @@
-function buildFallbackRequest(request, fallbackUrl) {
-    const sourceUrl = new URL(request.url);
-    const targetUrl = new URL(fallbackUrl);
-    targetUrl.search = sourceUrl.search;
-    return new Request(targetUrl, {
-        method: request.method,
-        headers: request.headers,
-        body: request.body,
-        redirect: request.redirect,
-    });
+import { handleSyncRequest, } from "../cloudflare/handler.js";
+function getExecutionContext(platform) {
+    const context = platform?.context ?? platform?.ctx;
+    if (context)
+        return context;
+    return {
+        waitUntil() { },
+        passThroughOnException() { },
+    };
 }
-export function syncProxy(options) {
-    const bindingName = options?.binding ?? "SYNC_WORKER";
+export function syncEngineRoute(options) {
     const handler = async (event) => {
         const platform = event.platform;
-        const serviceBinding = platform?.env?.[bindingName];
-        if (serviceBinding?.fetch) {
-            return serviceBinding.fetch(event.request);
-        }
-        if (options?.fallbackUrl) {
-            return fetch(buildFallbackRequest(event.request, options.fallbackUrl));
+        const env = platform?.env;
+        if (!env) {
+            return new Response("Missing Cloudflare platform env. Configure adapter-cloudflare platformProxy for Vite dev or run under wrangler.", { status: 500 });
         }
-        return new Response(`Missing sync Worker binding ${bindingName}. Configure a service binding or pass fallbackUrl to syncProxy().`, { status: 500 });
+        return handleSyncRequest(event.request, env, getExecutionContext(platform), options);
     };
     return {
         GET: handler,
-        POST: handler,
     };
 }

package/dist/vite.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "vite";
+import type { SyncDevAuthOptions } from "./server/dev-engine.js";
+export type SyncDevPluginOptions<TAuth = unknown> = SyncDevAuthOptions<TAuth> & {
+    handlersPath?: string;
+    path?: string;
+};
+export declare function syncDevPlugin<TAuth = unknown>(options?: SyncDevPluginOptions<TAuth>): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAajE,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,GAAG,OAAO,EAC3C,OAAO,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC,GACpC,MAAM,CA6ER"}

package/dist/vite.js

@@ -0,0 +1,56 @@
+const DEFAULT_SYNC_PATH = "/api/sync";
+export function syncDevPlugin(options) {
+    const handlersPath = options?.handlersPath ?? "/src/lib/server/sync-handlers.ts";
+    const syncPath = options?.path ?? DEFAULT_SYNC_PATH;
+    return {
+        name: "sveltebase-sync-dev-websocket",
+        apply: "serve",
+        async configureServer(server) {
+            const { WebSocketServer } = (await import("ws"));
+            const wss = new WebSocketServer({ noServer: true });
+            server.httpServer?.on("upgrade", (request, socket, head) => {
+                const url = new URL(request.url ?? "", `http://${request.headers.host ?? "localhost"}`);
+                if (url.pathname !== syncPath) {
+                    return;
+                }
+                wss.handleUpgrade(request, socket, head, (client) => {
+                    const messageQueue = [];
+                    const onMessage = (data) => {
+                        messageQueue.push(data);
+                    };
+                    client.on("message", onMessage);
+                    void (async () => {
+                        try {
+                            const handlersModule = await server.ssrLoadModule(handlersPath);
+                            const devEngine = await server.ssrLoadModule("@sveltebase/sync/server/dev-engine");
+                            devEngine.setHandlers(handlersModule.handlers);
+                            client.off("message", onMessage);
+                            const connected = await devEngine.addClient(client, request, {
+                                auth: options?.auth,
+                                identity: options?.identity,
+                                allowUnauthenticated: options?.allowUnauthenticated,
+                                platform: options?.platform,
+                                wranglerConfigPath: options?.wranglerConfigPath,
+                            });
+                            if (!connected)
+                                return;
+                            for (const message of messageQueue) {
+                                client.emit("message", message);
+                            }
+                        }
+                        catch (err) {
+                            console.error("sync dev plugin: websocket upgrade failed", err);
+                            try {
+                                client.off("message", onMessage);
+                                client.close(1011, "Internal server error");
+                            }
+                            catch {
+                                // Ignore close errors.
+                            }
+                        }
+                    })();
+                });
+            });
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sveltebase/sync",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -25,6 +25,10 @@
       "types": "./dist/server/index.d.ts",
       "default": "./dist/server/index.js"
     },
+    "./server/dev-engine": {
+      "types": "./dist/server/dev-engine.d.ts",
+      "default": "./dist/server/dev-engine.js"
+    },
     "./sveltekit": {
       "types": "./dist/sveltekit/index.d.ts",
       "default": "./dist/sveltekit/index.js"
@@ -32,10 +36,15 @@
     "./cloudflare": {
       "types": "./dist/cloudflare/index.d.ts",
       "default": "./dist/cloudflare/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
     }
   },
   "dependencies": {
-    "dexie": "^4.0.8"
+    "dexie": "^4.0.8",
+    "ws": "^8.18.3"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",