@sveltebase/sync 1.3.0 → 1.4.1

package/dist/server/index.js

@@ -8,3 +8,4 @@ export function defineSync(config) {
         },
     };
 }
+export { createBulkPublisher, createPublisher, INTERNAL_AUTH_HEADER, } from "./handler.js";

package/dist/sveltekit/index.d.ts

@@ -0,0 +1,10 @@
+import type { RequestHandler } from "@sveltejs/kit";
+export type SyncProxyOptions = {
+    binding?: string;
+    fallbackUrl?: string;
+};
+export declare function syncProxy(options?: SyncProxyOptions): {
+    GET: RequestHandler;
+    POST: RequestHandler;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/sveltekit/index.js

@@ -0,0 +1,29 @@
+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,
+    });
+}
+export function syncProxy(options) {
+    const bindingName = options?.binding ?? "SYNC_WORKER";
+    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));
+        }
+        return new Response(`Missing sync Worker binding ${bindingName}. Configure a service binding or pass fallbackUrl to syncProxy().`, { status: 500 });
+    };
+    return {
+        GET: handler,
+        POST: handler,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sveltebase/sync",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -22,16 +22,16 @@
       "default": "./dist/client/index.js"
     },
     "./server": {
-      "types": "./dist/server/engine.d.ts",
-      "default": "./dist/server/engine.js"
+      "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"
     },
-    "./vite": {
-      "types": "./dist/vite.d.ts",
-      "default": "./dist/vite.js"
+    "./cloudflare": {
+      "types": "./dist/cloudflare/index.d.ts",
+      "default": "./dist/cloudflare/index.js"
     }
   },
   "dependencies": {

package/dist/global.d.ts

@@ -1,25 +0,0 @@
-namespace App {
-  interface Platform {
-    env: {
-      SYNC_ENGINE: any;
-      [key: string]: any;
-    };
-    context: any;
-    caches: any;
-  }
-}
-
-interface Env {
-  SYNC_ENGINE: any;
-  [key: string]: any;
-}
-
-declare module "$app/environment" {
-  export const dev: boolean;
-  export const browser: boolean;
-  export const building: boolean;
-}
-
-declare module "$app/server" {
-  export function getRequestEvent(): any;
-}

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

@@ -1,16 +0,0 @@
-import type { SyncHandler } from "./index.js";
-import type { SyncUpgradeOptions } from "./handler.js";
-import type { IncomingMessage } from "node:http";
-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?: SyncUpgradeOptions): 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

@@ -1 +0,0 @@
-{"version":3,"file":"dev-engine.d.ts","sourceRoot":"","sources":["../../src/server/dev-engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAUjD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,QASlD;AAcD,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,CAwHlB;AAyBD,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

@@ -1,160 +0,0 @@
-import { SyncBroker } from "./broker.js";
-const GLOBAL_KEY = "__sync_dev_broker__";
-let devBroker = null;
-export function setHandlers(handlers) {
-    const g = globalThis;
-    if (!g[GLOBAL_KEY]) {
-        const broker = new SyncBroker(handlers);
-        g[GLOBAL_KEY] = { broker };
-    }
-    else {
-        g[GLOBAL_KEY].broker.setHandlers(handlers);
-    }
-    devBroker = g[GLOBAL_KEY].broker;
-}
-function getDevBroker() {
-    if (devBroker)
-        return devBroker;
-    const g = globalThis;
-    if (g[GLOBAL_KEY]) {
-        devBroker = g[GLOBAL_KEY].broker;
-        return devBroker;
-    }
-    throw new Error("Sync dev broker not initialized. Call setHandlers first.");
-}
-export async function addClient(ws, req, options) {
-    const broker = getDevBroker();
-    const subscribedChannels = new Set();
-    let auth = null;
-    let identity = null;
-    // Convert Node IncomingMessage headers to web-standard Headers
-    const headers = new Headers();
-    for (const [key, value] of Object.entries(req.headers)) {
-        if (value === undefined)
-            continue;
-        if (Array.isArray(value)) {
-            for (const v of value) {
-                headers.append(key, v);
-            }
-        }
-        else {
-            headers.set(key, value);
-        }
-    }
-    const urlObj = new URL(req.url ?? "", `http://${req.headers.host || "localhost"}`);
-    const initConnection = async () => {
-        const request = new Request(urlObj.toString(), { headers });
-        if (options?.auth) {
-            auth = (await options.auth(request, undefined)) ?? null;
-            if (!auth && options.allowUnauthenticated === false) {
-                ws.close(1008, "Unauthorized");
-                return false;
-            }
-            if (auth) {
-                const identityValue = options.identity
-                    ? options.identity(auth)
-                    : (auth?.user?.id ?? auth?.userId);
-                identity = identityValue == null ? null : String(identityValue);
-            }
-        }
-        // Legacy fallback for existing demos/apps that pass identity in URL/header.
-        const userId = urlObj.searchParams.get("userId") || headers.get("x-user-id");
-        if (userId && !auth) {
-            auth = { userId };
-            identity = userId;
-        }
-        return true;
-    };
-    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,
-        url: urlObj.toString(),
-    };
-    try {
-        const ok = await initConnection();
-        if (!ok)
-            return false;
-        broker.registerConnection(conn);
-        console.log("dev-engine: addClient registered connection");
-    }
-    catch (err) {
-        console.error("dev-engine: Error initializing connection:", err);
-        try {
-            ws.close(1011, "Internal server error");
-        }
-        catch { }
-        return false;
-    }
-    ws.on("message", async (data) => {
-        const messageString = String(data);
-        console.log("dev-engine: WebSocket message received:", messageString.slice(0, 100));
-        const request = new Request(conn.url, {
-            headers: conn.headers,
-        });
-        try {
-            console.log("dev-engine: getting platform proxy...");
-            const platform = await getPlatform();
-            console.log("dev-engine: platform proxy obtained, handling message...");
-            await broker.handleMessage(conn, messageString, platform, request);
-            console.log("dev-engine: message handled successfully");
-        }
-        catch (err) {
-            console.error("dev-engine: Error handling message:", err);
-        }
-    });
-    ws.on("close", () => {
-        console.log("dev-engine: WebSocket connection closed");
-        broker.removeConnection(conn);
-    });
-    ws.on("error", (err) => {
-        console.error("dev-engine: WebSocket connection error:", err);
-        broker.removeConnection(conn);
-    });
-    return true;
-}
-const GLOBAL_PLATFORM_KEY = "__sync_dev_platform__";
-async function getPlatform() {
-    const g = globalThis;
-    if (!g[GLOBAL_PLATFORM_KEY]) {
-        try {
-            console.log("dev-engine: calling getPlatformProxy()...");
-            const startTime = Date.now();
-            const { getPlatformProxy } = await import("wrangler");
-            const platform = await getPlatformProxy();
-            g[GLOBAL_PLATFORM_KEY] = { platform };
-            console.log(`dev-engine: getPlatformProxy() succeeded in ${Date.now() - startTime}ms`);
-        }
-        catch (err) {
-            console.error("dev-engine: Failed to load wrangler platform proxy:", err);
-        }
-    }
-    return g[GLOBAL_PLATFORM_KEY]?.platform;
-}
-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/vite.d.ts

@@ -1,10 +0,0 @@
-import type { Plugin } from "vite";
-import type { SyncUpgradeOptions } from "./server/handler.js";
-export type SyncDevPluginOptions = {
-    handlersPath?: string;
-    auth?: SyncUpgradeOptions["auth"];
-    identity?: SyncUpgradeOptions["identity"];
-    allowUnauthenticated?: SyncUpgradeOptions["allowUnauthenticated"];
-};
-export declare function syncDevPlugin(options?: SyncDevPluginOptions): Plugin;
-//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -1 +0,0 @@
-{"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,qBAAqB,CAAC;AAa9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,oBAAoB,CAAC,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;CACnE,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAwFpE"}

package/dist/vite.js

@@ -1,62 +0,0 @@
-const SYNC_PATH = "/api/sync";
-export function syncDevPlugin(options) {
-    const handlersPath = options?.handlersPath ?? "/src/lib/server/sync-handlers.ts";
-    return {
-        name: "sync-dev-websocket",
-        apply: "serve",
-        async configureServer(server) {
-            // Dynamic import — ws is a transitive dependency of Vite itself.
-            // @ts-expect-error -- ws has no bundled type declarations
-            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}`);
-                if (url.pathname !== SYNC_PATH) {
-                    return;
-                }
-                wss.handleUpgrade(request, socket, head, (client) => {
-                    console.log("sync-dev-plugin: WebSocket upgrade handler starting (buffering messages)...");
-                    // Buffer messages while async ssrLoadModule runs to avoid race conditions
-                    const messageQueue = [];
-                    const onMessage = (data) => {
-                        messageQueue.push(data);
-                    };
-                    client.on("message", onMessage);
-                    (async () => {
-                        try {
-                            // Load the handlers module dynamically from the user-configured path
-                            const handlersModule = await server.ssrLoadModule(handlersPath);
-                            const devEngine = await server.ssrLoadModule("@sveltebase/sync/server/dev-engine");
-                            // Register handlers dynamically before connecting client
-                            devEngine.setHandlers(handlersModule.handlers);
-                            // Remove temporary buffering listener
-                            client.off("message", onMessage);
-                            // Register client in the dev engine
-                            const connected = await devEngine.addClient(client, request, {
-                                auth: options?.auth,
-                                identity: options?.identity,
-                                allowUnauthenticated: options?.allowUnauthenticated,
-                            });
-                            if (!connected) {
-                                return;
-                            }
-                            console.log("sync-dev-plugin: WebSocket upgrade handler completed, replaying buffered messages:", messageQueue.length);
-                            // Replay any buffered messages
-                            for (const msg of messageQueue) {
-                                client.emit("message", msg);
-                            }
-                        }
-                        catch (err) {
-                            console.error("sync-dev-plugin: Error in WebSocket upgrade handler:", err);
-                            try {
-                                client.off("message", onMessage);
-                                client.close(1011, "Internal server error");
-                            }
-                            catch { }
-                        }
-                    })();
-                });
-            });
-        },
-    };
-}