@syncular/server-cloudflare 0.0.1-100

package/dist/durable-object.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @syncular/server-cloudflare - Durable Object handler (WebSocket + polling)
+ *
+ * Provides a base DurableObject class with Hono routing and WebSocket support.
+ * The DO's stateful nature allows it to hold persistent WebSocket connections,
+ * bridging Cloudflare's hibernation API to Hono's `upgradeWebSocket` interface.
+ *
+ * @example
+ * ```typescript
+ * import { SyncDurableObject, createSyncWorkerWithDO } from '@syncular/server-cloudflare/durable-object';
+ * import { createD1Db } from '@syncular/dialect-d1';
+ * import { createSqliteServerDialect } from '@syncular/server-dialect-sqlite';
+ * import { ensureSyncSchema } from '@syncular/server';
+ * import { createSyncServer } from '@syncular/server-hono';
+ *
+ * type Env = { DB: D1Database; SYNC_DO: DurableObjectNamespace };
+ *
+ * export class SyncDO extends SyncDurableObject<Env> {
+ *   setup(app, env, upgradeWebSocket) {
+ *     const db = createD1Db(env.DB);
+ *     const dialect = createSqliteServerDialect();
+ *     const { syncRoutes, consoleRoutes } = createSyncServer({
+ *       db, dialect,
+ *       handlers: [tasksHandler],
+ *       authenticate: async (c) => ({ actorId: c.req.header('x-user-id')! }),
+ *       upgradeWebSocket,
+ *     });
+ *     app.route('/sync', syncRoutes);
+ *     if (consoleRoutes) app.route('/console', consoleRoutes);
+ *   }
+ * }
+ *
+ * // Worker entry — routes all requests to the DO
+ * export default createSyncWorkerWithDO<Env>('SYNC_DO');
+ * ```
+ */
+import { Hono } from 'hono';
+import type { UpgradeWebSocket } from 'hono/ws';
+/**
+ * Base class for a Syncular Durable Object with Hono routing and WebSocket.
+ *
+ * Subclass and implement `setup()` to configure routes.
+ */
+export declare abstract class SyncDurableObject<E extends object = Record<string, unknown>> {
+    protected ctx: DurableObjectState;
+    protected env: E;
+    private app;
+    private initPromise;
+    private doUpgradeWebSocket;
+    constructor(ctx: DurableObjectState, env: E);
+    /**
+     * Configure the Hono app with sync routes.
+     *
+     * Called once when the DO first receives a request.
+     * Use `upgradeWebSocket` when creating the sync server to enable realtime.
+     */
+    abstract setup(app: Hono<{
+        Bindings: E;
+    }>, env: E, upgradeWebSocket: UpgradeWebSocket<WebSocket>): void | Promise<void>;
+    private getApp;
+    private closeUntrackedSockets;
+    /** Handle incoming HTTP requests (and WebSocket upgrades). */
+    fetch(request: Request): Promise<Response>;
+    /** Dispatch incoming WebSocket messages to Hono event handlers. */
+    webSocketMessage(ws: WebSocket, message: string | ArrayBuffer): Promise<void>;
+    /** Dispatch WebSocket close events to Hono event handlers. */
+    webSocketClose(ws: WebSocket, code: number, reason: string, _wasClean: boolean): Promise<void>;
+    /** Dispatch WebSocket error events to Hono event handlers. */
+    webSocketError(ws: WebSocket, _error: unknown): Promise<void>;
+}
+/**
+ * Create a Worker export that routes all requests to a Durable Object.
+ *
+ * Uses a single DO instance (derived from a stable ID) to hold all
+ * connections. For multi-tenant setups, override `getStubId`.
+ *
+ * @example
+ * ```typescript
+ * export default createSyncWorkerWithDO<Env>('SYNC_DO');
+ * ```
+ */
+export declare function createSyncWorkerWithDO<E extends object>(bindingName: string & keyof E, options?: {
+    /**
+     * Derive a DurableObject ID from the request.
+     * Defaults to a single global instance via `idFromName('sync')`.
+     */
+    getStubId?: (ns: DurableObjectNamespace, request: Request, env: E) => DurableObjectId;
+}): ExportedHandler<E>;
+//# sourceMappingURL=durable-object.d.ts.map

package/dist/durable-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-object.d.ts","sourceRoot":"","sources":["../src/durable-object.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,SAAS,CAAC;AA4E1D;;;;GAIG;AACH,8BAAsB,iBAAiB,CACrC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1C,SAAS,CAAC,GAAG,EAAE,kBAAkB,CAAC;IAClC,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;IAEjB,OAAO,CAAC,GAAG,CAAsC;IACjD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,kBAAkB,CAA8B;IAExD,YAAY,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC,EAK1C;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CACZ,GAAG,EAAE,IAAI,CAAC;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,CAAC,EAC1B,GAAG,EAAE,CAAC,EACN,gBAAgB,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAC5C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAEV,MAAM;IAcpB,OAAO,CAAC,qBAAqB;IAQ7B,8DAA8D;IACxD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG/C;IAED,mEAAmE;IAC7D,gBAAgB,CACpB,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,MAAM,GAAG,WAAW,GAC5B,OAAO,CAAC,IAAI,CAAC,CAUf;IAED,8DAA8D;IACxD,cAAc,CAClB,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC,CAWf;IAED,8DAA8D;IACxD,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;CACF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,EAC7B,OAAO,CAAC,EAAE;IACR;;;OAGG;IACH,SAAS,CAAC,EAAE,CACV,EAAE,EAAE,sBAAsB,EAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,CAAC,KACH,eAAe,CAAC;CACtB,GACA,eAAe,CAAC,CAAC,CAAC,CAiBpB"}

package/dist/durable-object.js

@@ -0,0 +1,195 @@
+/**
+ * @syncular/server-cloudflare - Durable Object handler (WebSocket + polling)
+ *
+ * Provides a base DurableObject class with Hono routing and WebSocket support.
+ * The DO's stateful nature allows it to hold persistent WebSocket connections,
+ * bridging Cloudflare's hibernation API to Hono's `upgradeWebSocket` interface.
+ *
+ * @example
+ * ```typescript
+ * import { SyncDurableObject, createSyncWorkerWithDO } from '@syncular/server-cloudflare/durable-object';
+ * import { createD1Db } from '@syncular/dialect-d1';
+ * import { createSqliteServerDialect } from '@syncular/server-dialect-sqlite';
+ * import { ensureSyncSchema } from '@syncular/server';
+ * import { createSyncServer } from '@syncular/server-hono';
+ *
+ * type Env = { DB: D1Database; SYNC_DO: DurableObjectNamespace };
+ *
+ * export class SyncDO extends SyncDurableObject<Env> {
+ *   setup(app, env, upgradeWebSocket) {
+ *     const db = createD1Db(env.DB);
+ *     const dialect = createSqliteServerDialect();
+ *     const { syncRoutes, consoleRoutes } = createSyncServer({
+ *       db, dialect,
+ *       handlers: [tasksHandler],
+ *       authenticate: async (c) => ({ actorId: c.req.header('x-user-id')! }),
+ *       upgradeWebSocket,
+ *     });
+ *     app.route('/sync', syncRoutes);
+ *     if (consoleRoutes) app.route('/console', consoleRoutes);
+ *   }
+ * }
+ *
+ * // Worker entry — routes all requests to the DO
+ * export default createSyncWorkerWithDO<Env>('SYNC_DO');
+ * ```
+ */
+import { Hono } from 'hono';
+import { defineWebSocketHelper, WSContext } from 'hono/ws';
+const STALE_SOCKET_CLOSE_CODE = 1012;
+const STALE_SOCKET_CLOSE_REASON = 'WebSocket session expired; reconnect required';
+/**
+ * WeakMap from server-side WebSocket → tag with event handlers.
+ * Populated on upgrade, read in webSocketMessage/webSocketClose.
+ */
+const socketTags = new WeakMap();
+function closeStaleSocket(ws) {
+    try {
+        ws.close(STALE_SOCKET_CLOSE_CODE, STALE_SOCKET_CLOSE_REASON);
+    }
+    catch {
+        // ignore
+    }
+}
+function createWSContext(ws) {
+    return new WSContext({
+        send(data) {
+            ws.send(data);
+        },
+        close(code, reason) {
+            ws.close(code, reason);
+        },
+        raw: ws,
+        get readyState() {
+            return ws.readyState;
+        },
+    });
+}
+/**
+ * Create an `upgradeWebSocket` function backed by the Durable Object
+ * hibernation API (`state.acceptWebSocket`).
+ *
+ * Each accepted socket is tagged with its Hono `WSEvents` handlers so the
+ * DO's `webSocketMessage` / `webSocketClose` callbacks can dispatch to them.
+ */
+function createDOUpgradeWebSocket(doState) {
+    return defineWebSocketHelper((_c, events) => {
+        const pair = new WebSocketPair();
+        const [client, server] = Object.values(pair);
+        // Accept via hibernation API so the DO can wake on messages
+        doState.acceptWebSocket(server);
+        // Tag the server socket so webSocketMessage/webSocketClose can find handlers
+        socketTags.set(server, { events: events });
+        // Fire onOpen synchronously (socket is already accepted)
+        const wsCtx = createWSContext(server);
+        events.onOpen?.(new Event('open'), wsCtx);
+        return new Response(null, { status: 101, webSocket: client });
+    });
+}
+// ---------------------------------------------------------------------------
+// SyncDurableObject base class
+// ---------------------------------------------------------------------------
+/**
+ * Base class for a Syncular Durable Object with Hono routing and WebSocket.
+ *
+ * Subclass and implement `setup()` to configure routes.
+ */
+export class SyncDurableObject {
+    ctx;
+    env;
+    app = null;
+    initPromise = null;
+    doUpgradeWebSocket;
+    constructor(ctx, env) {
+        this.ctx = ctx;
+        this.env = env;
+        this.doUpgradeWebSocket = createDOUpgradeWebSocket(ctx);
+        this.closeUntrackedSockets();
+    }
+    async getApp() {
+        if (this.app)
+            return this.app;
+        if (!this.initPromise) {
+            const honoApp = new Hono();
+            this.initPromise = Promise.resolve(this.setup(honoApp, this.env, this.doUpgradeWebSocket)).then(() => {
+                this.app = honoApp;
+            });
+        }
+        await this.initPromise;
+        return this.app;
+    }
+    closeUntrackedSockets() {
+        const sockets = this.ctx.getWebSockets();
+        for (const ws of sockets) {
+            if (socketTags.has(ws))
+                continue;
+            closeStaleSocket(ws);
+        }
+    }
+    /** Handle incoming HTTP requests (and WebSocket upgrades). */
+    async fetch(request) {
+        const app = await this.getApp();
+        return app.fetch(request, this.env);
+    }
+    /** Dispatch incoming WebSocket messages to Hono event handlers. */
+    async webSocketMessage(ws, message) {
+        const tag = socketTags.get(ws);
+        if (!tag?.events.onMessage) {
+            closeStaleSocket(ws);
+            return;
+        }
+        const wsCtx = createWSContext(ws);
+        const evt = new MessageEvent('message', { data: message });
+        tag.events.onMessage(evt, wsCtx);
+    }
+    /** Dispatch WebSocket close events to Hono event handlers. */
+    async webSocketClose(ws, code, reason, _wasClean) {
+        const tag = socketTags.get(ws);
+        if (!tag?.events.onClose) {
+            socketTags.delete(ws);
+            return;
+        }
+        const wsCtx = createWSContext(ws);
+        const evt = new CloseEvent('close', { code, reason });
+        tag.events.onClose(evt, wsCtx);
+        socketTags.delete(ws);
+    }
+    /** Dispatch WebSocket error events to Hono event handlers. */
+    async webSocketError(ws, _error) {
+        const tag = socketTags.get(ws);
+        if (!tag?.events.onError) {
+            closeStaleSocket(ws);
+            return;
+        }
+        const wsCtx = createWSContext(ws);
+        const evt = new Event('error');
+        tag.events.onError(evt, wsCtx);
+    }
+}
+// ---------------------------------------------------------------------------
+// Worker → DO router
+// ---------------------------------------------------------------------------
+/**
+ * Create a Worker export that routes all requests to a Durable Object.
+ *
+ * Uses a single DO instance (derived from a stable ID) to hold all
+ * connections. For multi-tenant setups, override `getStubId`.
+ *
+ * @example
+ * ```typescript
+ * export default createSyncWorkerWithDO<Env>('SYNC_DO');
+ * ```
+ */
+export function createSyncWorkerWithDO(bindingName, options) {
+    return {
+        async fetch(request, env, _ctx) {
+            const ns = env[bindingName];
+            const id = options?.getStubId
+                ? options.getStubId(ns, request, env)
+                : ns.idFromName('sync');
+            const stub = ns.get(id);
+            return stub.fetch(request);
+        },
+    };
+}
+//# sourceMappingURL=durable-object.js.map

package/dist/durable-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-object.js","sourceRoot":"","sources":["../src/durable-object.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAU3D,MAAM,uBAAuB,GAAG,IAAI,CAAC;AACrC,MAAM,yBAAyB,GAC7B,+CAA+C,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,GAAG,IAAI,OAAO,EAA2B,CAAC;AAE1D,SAAS,gBAAgB,CAAC,EAAa,EAAQ;IAC7C,IAAI,CAAC;QACH,EAAE,CAAC,KAAK,CAAC,uBAAuB,EAAE,yBAAyB,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AAAA,CACF;AAED,SAAS,eAAe,CAAC,EAAa,EAAwB;IAC5D,OAAO,IAAI,SAAS,CAAY;QAC9B,IAAI,CAAC,IAAI,EAAE;YACT,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAA,CACf;QACD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE;YAClB,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAA,CACxB;QACD,GAAG,EAAE,EAAE;QACP,IAAI,UAAU,GAAG;YACf,OAAO,EAAE,CAAC,UAA2B,CAAC;QAAA,CACvC;KACF,CAAC,CAAC;AAAA,CACJ;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB,CAC/B,OAA2B,EACE;IAC7B,OAAO,qBAAqB,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAC;QAEvE,4DAA4D;QAC5D,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAEhC,6EAA6E;QAC7E,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAA6B,EAAE,CAAC,CAAC;QAElE,yDAAyD;QACzD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QAE1C,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAAA,CAC/D,CAAC,CAAC;AAAA,CACJ;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,OAAgB,iBAAiB;IAG3B,GAAG,CAAqB;IACxB,GAAG,CAAI;IAET,GAAG,GAAiC,IAAI,CAAC;IACzC,WAAW,GAAyB,IAAI,CAAC;IACzC,kBAAkB,CAA8B;IAExD,YAAY,GAAuB,EAAE,GAAM,EAAE;QAC3C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,kBAAkB,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAAA,CAC9B;IAcO,KAAK,CAAC,MAAM,GAAmC;QACrD,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,IAAI,EAAmB,CAAC;YAC5C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAChC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,CAAC,CACvD,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACX,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC;YAAA,CACpB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC;QACvB,OAAO,IAAI,CAAC,GAAI,CAAC;IAAA,CAClB;IAEO,qBAAqB,GAAS;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QACzC,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YACjC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IAAA,CACF;IAED,8DAA8D;IAC9D,KAAK,CAAC,KAAK,CAAC,OAAgB,EAAqB;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAAA,CACrC;IAED,mEAAmE;IACnE,KAAK,CAAC,gBAAgB,CACpB,EAAa,EACb,OAA6B,EACd;QACf,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3B,gBAAgB,CAAC,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAAA,CAClC;IAED,8DAA8D;IAC9D,KAAK,CAAC,cAAc,CAClB,EAAa,EACb,IAAY,EACZ,MAAc,EACd,SAAkB,EACH;QACf,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAAA,CACvB;IAED,8DAA8D;IAC9D,KAAK,CAAC,cAAc,CAAC,EAAa,EAAE,MAAe,EAAiB;QAClE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,gBAAgB,CAAC,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAAA,CAChC;CACF;AAED,8EAA8E;AAC9E,uBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA6B,EAC7B,OAUC,EACmB;IACpB,OAAO;QACL,KAAK,CAAC,KAAK,CACT,OAAgB,EAChB,GAAM,EACN,IAAsB,EACH;YACnB,MAAM,EAAE,GAAG,GAAG,CACZ,WAAsB,CACc,CAAC;YACvC,MAAM,EAAE,GAAG,OAAO,EAAE,SAAS;gBAC3B,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC;gBACrC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAAA,CAC5B;KACF,CAAC;AAAA,CACH"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @syncular/server-cloudflare - Cloudflare adapters for Syncular
+ *
+ * Two deployment modes:
+ * - Worker (polling only): `@syncular/server-cloudflare/worker`
+ * - Durable Object (WebSocket + polling): `@syncular/server-cloudflare/durable-object`
+ *
+ * Blob storage:
+ * - R2 native: `@syncular/server-cloudflare/r2`
+ *
+ * Dialect is user-provided:
+ * - D1 + SQLite: `@syncular/dialect-d1` + `@syncular/server-dialect-sqlite`
+ * - Neon + Postgres: `@syncular/dialect-neon` + `@syncular/server-dialect-postgres`
+ */
+export * from './durable-object';
+export * from './r2';
+export * from './worker';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @syncular/server-cloudflare - Cloudflare adapters for Syncular
+ *
+ * Two deployment modes:
+ * - Worker (polling only): `@syncular/server-cloudflare/worker`
+ * - Durable Object (WebSocket + polling): `@syncular/server-cloudflare/durable-object`
+ *
+ * Blob storage:
+ * - R2 native: `@syncular/server-cloudflare/r2`
+ *
+ * Dialect is user-provided:
+ * - D1 + SQLite: `@syncular/dialect-d1` + `@syncular/server-dialect-sqlite`
+ * - Neon + Postgres: `@syncular/dialect-neon` + `@syncular/server-dialect-postgres`
+ */
+export * from './durable-object.js';
+export * from './r2.js';
+export * from './worker.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}

package/dist/r2.d.ts

@@ -0,0 +1,148 @@
+/**
+ * R2 blob storage adapter using native R2Bucket binding.
+ *
+ * This adapter stores blobs in Cloudflare R2 using the native binding,
+ * without requiring the AWS SDK. Since R2 bindings don't support presigned URLs,
+ * this adapter generates signed tokens that allow uploads/downloads through
+ * the Worker's blob routes (similar to the database adapter).
+ */
+/**
+ * Options for signing an upload URL.
+ */
+export interface BlobSignUploadOptions {
+    /** SHA-256 hash (for naming and checksum validation) */
+    hash: string;
+    /** Content size in bytes */
+    size: number;
+    /** MIME type */
+    mimeType: string;
+    /** URL expiration in seconds */
+    expiresIn: number;
+}
+/**
+ * Result of signing an upload URL.
+ */
+export interface BlobSignedUpload {
+    /** The URL to upload to */
+    url: string;
+    /** HTTP method */
+    method: 'PUT' | 'POST';
+    /** Required headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Options for signing a download URL.
+ */
+export interface BlobSignDownloadOptions {
+    /** SHA-256 hash */
+    hash: string;
+    /** URL expiration in seconds */
+    expiresIn: number;
+}
+/**
+ * Adapter for blob storage backends.
+ * Implements the same interface as @syncular/core BlobStorageAdapter.
+ */
+export interface BlobStorageAdapter {
+    /** Adapter name for logging/debugging */
+    readonly name: string;
+    /**
+     * Generate a presigned URL for uploading a blob.
+     */
+    signUpload(options: BlobSignUploadOptions): Promise<BlobSignedUpload>;
+    /**
+     * Generate a presigned URL for downloading a blob.
+     */
+    signDownload(options: BlobSignDownloadOptions): Promise<string>;
+    /**
+     * Check if a blob exists in storage.
+     */
+    exists(hash: string): Promise<boolean>;
+    /**
+     * Delete a blob (for garbage collection).
+     */
+    delete(hash: string): Promise<void>;
+    /**
+     * Get blob metadata from storage (optional).
+     */
+    getMetadata?(hash: string): Promise<{
+        size: number;
+        mimeType?: string;
+    } | null>;
+    /**
+     * Store blob data directly (for adapters that support direct storage).
+     */
+    put?(hash: string, data: Uint8Array, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Store blob data directly from a stream.
+     */
+    putStream?(hash: string, stream: ReadableStream<Uint8Array>, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Get blob data directly (for adapters that support direct retrieval).
+     */
+    get?(hash: string): Promise<Uint8Array | null>;
+    /**
+     * Get blob data directly as a stream.
+     */
+    getStream?(hash: string): Promise<ReadableStream<Uint8Array> | null>;
+}
+/**
+ * Token signer interface for creating/verifying upload/download tokens.
+ */
+export interface BlobTokenSigner {
+    /**
+     * Sign a token for blob upload/download authorization.
+     * @param payload The data to sign
+     * @param expiresIn Expiration time in seconds
+     * @returns A signed token string
+     */
+    sign(payload: {
+        hash: string;
+        action: 'upload' | 'download';
+        expiresAt: number;
+    }, expiresIn: number): Promise<string>;
+    /**
+     * Verify and decode a signed token.
+     * @returns The payload if valid, null if invalid/expired
+     */
+    verify(token: string): Promise<{
+        hash: string;
+        action: 'upload' | 'download';
+        expiresAt: number;
+    } | null>;
+}
+/**
+ * Create a simple HMAC-based token signer.
+ */
+export declare function createHmacTokenSigner(secret: string): BlobTokenSigner;
+export interface R2BlobStorageAdapterOptions {
+    /** R2 bucket binding */
+    bucket: R2Bucket;
+    /** Optional key prefix for all blobs */
+    keyPrefix?: string;
+    /** Base URL for the blob routes (e.g., "https://api.example.com/api/sync") */
+    baseUrl: string;
+    /** Token signer for authorization */
+    tokenSigner: BlobTokenSigner;
+}
+/**
+ * Create an R2 blob storage adapter using native R2Bucket binding.
+ *
+ * Since R2 bindings don't support presigned URLs, this adapter generates
+ * signed tokens and uses Worker-proxied uploads/downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createR2BlobStorageAdapter, createHmacTokenSigner } from '@syncular/server-cloudflare/r2';
+ *
+ * type Env = { BLOBS: R2Bucket };
+ *
+ * const adapter = createR2BlobStorageAdapter({
+ *   bucket: env.BLOBS,
+ *   baseUrl: 'https://api.example.com/sync',
+ *   tokenSigner: createHmacTokenSigner(env.BLOB_SECRET),
+ * });
+ * ```
+ */
+export declare function createR2BlobStorageAdapter(options: R2BlobStorageAdapterOptions): BlobStorageAdapter;
+//# sourceMappingURL=r2.d.ts.map

package/dist/r2.d.ts.map

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