@syncular/server-cloudflare 0.0.1-100

package/dist/r2.js

@@ -0,0 +1,219 @@
+/**
+ * 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).
+ */
+/**
+ * Create a simple HMAC-based token signer.
+ */
+export function createHmacTokenSigner(secret) {
+    const encoder = new TextEncoder();
+    async function hmacSign(data) {
+        const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+        const signature = await crypto.subtle.sign('HMAC', key, encoder.encode(data));
+        return bufferToHex(new Uint8Array(signature));
+    }
+    return {
+        async sign(payload, _expiresIn) {
+            const data = JSON.stringify(payload);
+            const dataB64 = btoa(data);
+            const sig = await hmacSign(dataB64);
+            return `${dataB64}.${sig}`;
+        },
+        async verify(token) {
+            const [dataB64, sig] = token.split('.');
+            if (!dataB64 || !sig)
+                return null;
+            const expectedSig = await hmacSign(dataB64);
+            if (sig !== expectedSig)
+                return null;
+            try {
+                const data = JSON.parse(atob(dataB64));
+                if (Date.now() > data.expiresAt)
+                    return null;
+                return data;
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+function bufferToHex(buffer) {
+    return Array.from(buffer)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+/**
+ * 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 function createR2BlobStorageAdapter(options) {
+    const { bucket, keyPrefix = '', baseUrl, tokenSigner } = options;
+    // Normalize base URL (remove trailing slash)
+    const normalizedBaseUrl = baseUrl.replace(/\/$/, '');
+    function getKey(hash) {
+        // Remove "sha256:" prefix and use hex as key
+        const hex = hash.startsWith('sha256:') ? hash.slice(7) : hash;
+        return `${keyPrefix}${hex}`;
+    }
+    function resolveMimeType(metadata) {
+        return typeof metadata?.mimeType === 'string'
+            ? metadata.mimeType
+            : 'application/octet-stream';
+    }
+    function resolveChecksum(hash) {
+        return hash.startsWith('sha256:') ? hash.slice(7) : undefined;
+    }
+    function resolveContentLength(metadata) {
+        const candidates = [
+            metadata?.contentLength,
+            metadata?.byteLength,
+            metadata?.size,
+        ];
+        for (const candidate of candidates) {
+            if (typeof candidate !== 'number')
+                continue;
+            if (!Number.isFinite(candidate) || candidate < 0)
+                continue;
+            return candidate;
+        }
+        return undefined;
+    }
+    async function putStreamInternal(hash, stream, metadata) {
+        const key = getKey(hash);
+        const mimeType = resolveMimeType(metadata);
+        const checksum = resolveChecksum(hash);
+        const contentLength = resolveContentLength(metadata);
+        if (typeof contentLength === 'number' && contentLength >= 0) {
+            const fixedLength = new FixedLengthStream(contentLength);
+            await Promise.all([
+                stream.pipeTo(fixedLength.writable),
+                bucket.put(key, fixedLength.readable, {
+                    httpMetadata: { contentType: mimeType },
+                    sha256: checksum,
+                }),
+            ]);
+            return;
+        }
+        await bucket.put(key, stream, {
+            httpMetadata: {
+                contentType: mimeType,
+            },
+            sha256: checksum,
+        });
+    }
+    async function getStreamInternal(hash) {
+        const key = getKey(hash);
+        const object = await bucket.get(key);
+        if (!object)
+            return null;
+        return object.body;
+    }
+    return {
+        name: 'r2',
+        async signUpload(opts) {
+            const expiresAt = Date.now() + opts.expiresIn * 1000;
+            const token = await tokenSigner.sign({ hash: opts.hash, action: 'upload', expiresAt }, opts.expiresIn);
+            // URL points to server's blob upload endpoint
+            const url = `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/upload?token=${encodeURIComponent(token)}`;
+            return {
+                url,
+                method: 'PUT',
+                headers: {
+                    'Content-Type': opts.mimeType,
+                    'Content-Length': String(opts.size),
+                },
+            };
+        },
+        async signDownload(opts) {
+            const expiresAt = Date.now() + opts.expiresIn * 1000;
+            const token = await tokenSigner.sign({ hash: opts.hash, action: 'download', expiresAt }, opts.expiresIn);
+            return `${normalizedBaseUrl}/blobs/${encodeURIComponent(opts.hash)}/download?token=${encodeURIComponent(token)}`;
+        },
+        async exists(hash) {
+            const key = getKey(hash);
+            const head = await bucket.head(key);
+            return head !== null;
+        },
+        async delete(hash) {
+            const key = getKey(hash);
+            await bucket.delete(key);
+        },
+        async getMetadata(hash) {
+            const key = getKey(hash);
+            const head = await bucket.head(key);
+            if (!head)
+                return null;
+            return {
+                size: head.size,
+                mimeType: head.httpMetadata?.contentType,
+            };
+        },
+        async put(hash, data, metadata) {
+            const key = getKey(hash);
+            const mimeType = resolveMimeType(metadata);
+            const checksum = resolveChecksum(hash);
+            await bucket.put(key, data, {
+                httpMetadata: {
+                    contentType: mimeType,
+                },
+                sha256: checksum,
+            });
+        },
+        async putStream(hash, stream, metadata) {
+            await putStreamInternal(hash, stream, metadata);
+        },
+        async get(hash) {
+            const stream = await getStreamInternal(hash);
+            if (!stream)
+                return null;
+            const reader = stream.getReader();
+            try {
+                const chunks = [];
+                let total = 0;
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    if (!value)
+                        continue;
+                    chunks.push(value);
+                    total += value.length;
+                }
+                const out = new Uint8Array(total);
+                let offset = 0;
+                for (const chunk of chunks) {
+                    out.set(chunk, offset);
+                    offset += chunk.length;
+                }
+                return out;
+            }
+            finally {
+                reader.releaseLock();
+            }
+        },
+        async getStream(hash) {
+            return getStreamInternal(hash);
+        },
+    };
+}
+//# sourceMappingURL=r2.js.map

package/dist/r2.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @syncular/server-cloudflare - Worker handler (polling only)
+ *
+ * Creates a stateless Cloudflare Worker that serves sync routes via Hono.
+ * No WebSocket support — use the Durable Object adapter for realtime.
+ *
+ * @example
+ * ```typescript
+ * import { createSyncWorker } from '@syncular/server-cloudflare/worker';
+ * 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 };
+ *
+ * export default createSyncWorker<Env>((app, env) => {
+ *   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')! }),
+ *   });
+ *   app.route('/sync', syncRoutes);
+ *   if (consoleRoutes) app.route('/console', consoleRoutes);
+ * });
+ * ```
+ */
+import { Hono } from 'hono';
+type SyncWorkerSetup<B extends object> = (app: Hono<{
+    Bindings: B;
+}>, env: B) => void | Promise<void>;
+/**
+ * Create a Cloudflare Worker export that lazily initializes a Hono app.
+ *
+ * The `setup` callback is called once per isolate on the first request.
+ * It receives a fresh Hono app and the Worker env bindings.
+ */
+export declare function createSyncWorker<Bindings extends object = Record<string, unknown>>(setup: SyncWorkerSetup<Bindings>): ExportedHandler<Bindings>;
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,IAAI,CACvC,GAAG,EAAE,IAAI,CAAC;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,CAAC,EAC1B,GAAG,EAAE,CAAC,KACH,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjD,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,CA2B7D"}

package/dist/worker.js

@@ -0,0 +1,59 @@
+/**
+ * @syncular/server-cloudflare - Worker handler (polling only)
+ *
+ * Creates a stateless Cloudflare Worker that serves sync routes via Hono.
+ * No WebSocket support — use the Durable Object adapter for realtime.
+ *
+ * @example
+ * ```typescript
+ * import { createSyncWorker } from '@syncular/server-cloudflare/worker';
+ * 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 };
+ *
+ * export default createSyncWorker<Env>((app, env) => {
+ *   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')! }),
+ *   });
+ *   app.route('/sync', syncRoutes);
+ *   if (consoleRoutes) app.route('/console', consoleRoutes);
+ * });
+ * ```
+ */
+import { Hono } from 'hono';
+/**
+ * Create a Cloudflare Worker export that lazily initializes a Hono app.
+ *
+ * The `setup` callback is called once per isolate on the first request.
+ * It receives a fresh Hono app and the Worker env bindings.
+ */
+export function createSyncWorker(setup) {
+    let app = null;
+    let initPromise = null;
+    async function getApp(env) {
+        if (app)
+            return app;
+        if (!initPromise) {
+            const honoApp = new Hono();
+            initPromise = Promise.resolve(setup(honoApp, env)).then(() => {
+                app = honoApp;
+            });
+        }
+        await initPromise;
+        return app;
+    }
+    return {
+        async fetch(request, env, ctx) {
+            const honoApp = await getApp(env);
+            return honoApp.fetch(request, env, ctx);
+        },
+    };
+}
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAO5B;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAE9B,KAAgC,EAA6B;IAE7D,IAAI,GAAG,GAAmB,IAAI,CAAC;IAC/B,IAAI,WAAW,GAAyB,IAAI,CAAC;IAE7C,KAAK,UAAU,MAAM,CAAC,GAAa,EAAoB;QACrD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,IAAI,EAAK,CAAC;YAC9B,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5D,GAAG,GAAG,OAAO,CAAC;YAAA,CACf,CAAC,CAAC;QACL,CAAC;QACD,MAAM,WAAW,CAAC;QAClB,OAAO,GAAI,CAAC;IAAA,CACb;IAED,OAAO;QACL,KAAK,CAAC,KAAK,CACT,OAAgB,EAChB,GAAa,EACb,GAAqB,EACF;YACnB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAAA,CACzC;KACF,CAAC;AAAA,CACH"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@syncular/server-cloudflare",
+  "version": "0.0.1-100",
+  "description": "Cloudflare Workers adapter for the Syncular server",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular.git",
+    "directory": "packages/server-cloudflare"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular/issues"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "realtime",
+    "database",
+    "typescript",
+    "cloudflare",
+    "workers",
+    "edge"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./worker": {
+      "bun": "./src/worker.ts",
+      "import": {
+        "types": "./dist/worker.d.ts",
+        "default": "./dist/worker.js"
+      }
+    },
+    "./durable-object": {
+      "bun": "./src/durable-object.ts",
+      "import": {
+        "types": "./dist/durable-object.d.ts",
+        "default": "./dist/durable-object.js"
+      }
+    },
+    "./r2": {
+      "bun": "./src/r2.ts",
+      "import": {
+        "types": "./dist/r2.d.ts",
+        "default": "./dist/r2.js"
+      }
+    }
+  },
+  "scripts": {
+    "tsgo": "tsgo --noEmit",
+    "build": "tsgo",
+    "release": "bunx syncular-publish"
+  },
+  "peerDependencies": {
+    "hono": "^4.0.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "*",
+    "@syncular/config": "0.0.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/durable-object.test.ts

@@ -0,0 +1,65 @@
+import { describe, expect, test } from 'bun:test';
+import type { Hono } from 'hono';
+import type { UpgradeWebSocket } from 'hono/ws';
+import { SyncDurableObject } from './durable-object';
+
+const staleSocketCloseCode = 1012;
+const staleSocketCloseReason = 'WebSocket session expired; reconnect required';
+
+class TestSyncDurableObject extends SyncDurableObject<Record<string, never>> {
+  async setup(
+    _app: Hono<{ Bindings: Record<string, never> }>,
+    _env: Record<string, never>,
+    _upgradeWebSocket: UpgradeWebSocket<WebSocket>
+  ): Promise<void> {}
+}
+
+function createSocketTracker(): {
+  socket: WebSocket;
+  closes: Array<{ code: number | undefined; reason: string | undefined }>;
+} {
+  const closes: Array<{
+    code: number | undefined;
+    reason: string | undefined;
+  }> = [];
+  const socket = {
+    close(code?: number, reason?: string) {
+      closes.push({ code, reason });
+    },
+  } as WebSocket;
+  return { socket, closes };
+}
+
+function createState(sockets: WebSocket[]): DurableObjectState {
+  return {
+    acceptWebSocket() {},
+    getWebSockets() {
+      return sockets;
+    },
+  } as DurableObjectState;
+}
+
+describe('SyncDurableObject stale websocket handling', () => {
+  test('closes untracked sockets on construction (hibernation wake-up path)', () => {
+    const tracked = createSocketTracker();
+    const state = createState([tracked.socket]);
+
+    new TestSyncDurableObject(state, {});
+
+    expect(tracked.closes).toEqual([
+      { code: staleSocketCloseCode, reason: staleSocketCloseReason },
+    ]);
+  });
+
+  test('closes unknown sockets when receiving websocket messages', async () => {
+    const state = createState([]);
+    const durableObject = new TestSyncDurableObject(state, {});
+    const tracked = createSocketTracker();
+
+    await durableObject.webSocketMessage(tracked.socket, 'hello');
+
+    expect(tracked.closes).toEqual([
+      { code: staleSocketCloseCode, reason: staleSocketCloseReason },
+    ]);
+  });
+});