@verdant-web/cloudflare 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Grant Forrest
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# Verdant Cloudflare Bindings
+
+This library provides bindings for running a Verdant sync backend on Cloudflare using Workers, Durable Objects and (optionally) R2 Object Storage.
+
+See: [Cloudflare Adapter docs](https://verdant.dev/docs/sync/cloudflare)

package/dist/esm/api.d.ts

@@ -0,0 +1,27 @@
+export interface VerdantWorkerConfig {
+    durableObjectBindingName: string;
+    tokenSecretBindingName: string;
+}
+/**
+ * Creates a Hono app configured to serve Verdant library traffic.
+ * This app 'router' should be mounted onto another Verdant app
+ * used by your main Cloudflare worker, either as a Hono router
+ * or by just calling app.fetch with the request.
+ * The Durable Object binding specified by `durableObjectBindingName`
+ * must be configured to point to the DurableObjectNamespace for
+ * the Verdant library Durable Object class as configured in your
+ * wrangler config.
+ */
+export declare function createVerdantWorkerApp(config: VerdantWorkerConfig): import("hono/hono-base").HonoBase<{
+    Bindings: any;
+    Variables: any;
+}, {
+    "/": {
+        $all: {
+            input: {};
+            output: {};
+            outputFormat: import("hono/types").ResponseFormat;
+            status: import("hono/utils/http-status").StatusCode;
+        };
+    };
+}, "/">;

package/dist/esm/api.js

@@ -0,0 +1,43 @@
+import { errorHandler, tokenMiddleware, TokenVerifier, } from '@verdant-web/server/internals';
+import { Hono } from 'hono';
+import { basePath } from 'hono/route';
+/**
+ * Creates a Hono app configured to serve Verdant library traffic.
+ * This app 'router' should be mounted onto another Verdant app
+ * used by your main Cloudflare worker, either as a Hono router
+ * or by just calling app.fetch with the request.
+ * The Durable Object binding specified by `durableObjectBindingName`
+ * must be configured to point to the DurableObjectNamespace for
+ * the Verdant library Durable Object class as configured in your
+ * wrangler config.
+ */
+export function createVerdantWorkerApp(config) {
+    // this really just determines which library DO to route to
+    // and the DO handles the rest
+    const app = new Hono()
+        .onError(errorHandler)
+        .use((ctx, next) => {
+        const tokenVerifier = new TokenVerifier({
+            secret: ctx.env[config.tokenSecretBindingName],
+        });
+        return tokenMiddleware(tokenVerifier)(ctx, next);
+    })
+        .all((ctx) => {
+        if (ctx.req.method === 'OPTIONS') {
+            // preflight request, np
+            return ctx.newResponse(null, { status: 204 });
+        }
+        const info = ctx.get('tokenInfo');
+        const id = ctx.env[config.durableObjectBindingName].idFromName(info.libraryId);
+        const obj = ctx.env[config.durableObjectBindingName].get(id);
+        // remove the base path so the DO sees the correct routing
+        const path = basePath(ctx);
+        const thisUrl = new URL(ctx.req.url);
+        thisUrl.pathname = thisUrl.pathname.replace(path, '') || '/';
+        const modifiedReq = new Request(thisUrl.toString(), ctx.req.raw);
+        console.log(`[verdant worker] routing to DO ${info.libraryId}:`, ctx.req.method, ctx.req.url, path, modifiedReq.url);
+        return obj.fetch(modifiedReq);
+    });
+    return app;
+}
+//# sourceMappingURL=api.js.map

package/dist/esm/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,eAAe,EACf,aAAa,GACb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA2B;IACjE,2DAA2D;IAC3D,8BAA8B;IAC9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAqC;SACvD,OAAO,CAAC,YAAY,CAAC;SACrB,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;YACvC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,sBAAsB,CAAC;SAC9C,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,aAAa,CAAC,CAAC,GAAU,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,wBAAwB;YACxB,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,UAAU,CAC7D,IAAI,CAAC,SAAS,CACd,CAAC;QACF,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,0DAA0D;QAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;QAC7D,MAAM,WAAW,GAAY,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CACV,kCAAkC,IAAI,CAAC,SAAS,GAAG,EACnD,GAAG,CAAC,GAAG,CAAC,MAAM,EACd,GAAG,CAAC,GAAG,CAAC,GAAG,EACX,IAAI,EACJ,WAAW,CAAC,GAAG,CACf,CAAC;QACF,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEJ,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/esm/doLibrary.d.ts

@@ -0,0 +1,40 @@
+import { ClientMessage, EventSubscriber } from '@verdant-web/common';
+import { FileStorage, TokenInfo, UserProfiles } from '@verdant-web/server';
+import { ClientConnectionManager, Library, LibraryEvents } from '@verdant-web/server/internals';
+export interface DurableObjectLibraryConfig {
+    tokenSecret: string;
+    disableRebasing?: boolean;
+    fileStorage: FileStorage;
+    log?: (level: string, ...args: any[]) => void;
+    profiles: UserProfiles<any>;
+    storageOptions?: {
+        fileDeleteExpirationDays?: number;
+        replicaTruancyTimeout?: number;
+    };
+}
+export declare class DurableObjectLibrary {
+    #private;
+    private ctx;
+    protected clientConnections: ClientConnectionManager;
+    protected library: Library;
+    protected events: EventSubscriber<LibraryEvents>;
+    constructor(ctx: DurableObjectState, verdant: DurableObjectLibraryConfig);
+    get log(): (level: string, ...args: any[]) => void;
+    initialize: (libraryId: string) => Promise<void>;
+    fetch: (request: Request) => Promise<Response>;
+    webSocketMessage: (ws: WebSocket, message: string | ArrayBuffer) => void | Promise<void>;
+    webSocketClose: (ws: WebSocket, code: number, reason: string, wasClean: boolean) => void | Promise<void>;
+    webSocketError: (ws: WebSocket, error: unknown) => void | Promise<void>;
+    handleMessage: (key: string, info: TokenInfo, message: ClientMessage) => Promise<void>;
+    getDocumentSnapshot: (collection: string, id: string) => Promise<{} | null>;
+    getFileInfo: (fileId: string) => Promise<{
+        libraryId: string;
+        id: string;
+        name: string;
+        type: string;
+        url: string | null;
+    } | null>;
+    evict: () => Promise<void>;
+    forceTruant: (replicaId: string) => Promise<void>;
+    getInfo: () => Promise<import("@verdant-web/server").LibraryInfo | null>;
+}

package/dist/esm/doLibrary.js

@@ -0,0 +1,233 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _DurableObjectLibrary_app, _DurableObjectLibrary_socketInfoCache, _DurableObjectLibrary_initialized, _DurableObjectLibrary_config, _DurableObjectLibrary_noop, _DurableObjectLibrary_restore, _DurableObjectLibrary_getSocketInfo;
+import { createOid, EventSubscriber, VerdantError, } from '@verdant-web/common';
+import { ClientConnectionManager, errorHandler, FileStorageLibraryDelegate, Library, SqlShardStorage, tokenMiddleware, TokenVerifier, UserProfileLoader, } from '@verdant-web/server/internals';
+import { Hono } from 'hono';
+import { createDurableObjectSqliteExecutor } from './sql.js';
+export class DurableObjectLibrary {
+    constructor(ctx, verdant) {
+        this.ctx = ctx;
+        _DurableObjectLibrary_app.set(this, void 0);
+        _DurableObjectLibrary_socketInfoCache.set(this, new WeakMap());
+        _DurableObjectLibrary_initialized.set(this, false);
+        _DurableObjectLibrary_config.set(this, void 0);
+        this.events = new EventSubscriber();
+        _DurableObjectLibrary_noop.set(this, () => { });
+        this.initialize = async (libraryId) => {
+            var _a, _b, _c, _d;
+            if (__classPrivateFieldGet(this, _DurableObjectLibrary_initialized, "f")) {
+                return;
+            }
+            const storedLibraryId = await this.ctx.storage.get('libraryId');
+            if (storedLibraryId && storedLibraryId !== libraryId) {
+                throw new VerdantError(VerdantError.Code.InvalidRequest, undefined, 'Library ID does not match existing storage');
+            }
+            await this.ctx.storage.put('libraryId', libraryId);
+            __classPrivateFieldSet(this, _DurableObjectLibrary_initialized, true, "f");
+            const db = createDurableObjectSqliteExecutor(this.ctx.storage, {
+                log: this.log,
+            });
+            await db.migrate();
+            const storage = new SqlShardStorage(db, {
+                libraryId,
+                fileDeleteExpirationDays: (_b = (_a = __classPrivateFieldGet(this, _DurableObjectLibrary_config, "f").storageOptions) === null || _a === void 0 ? void 0 : _a.fileDeleteExpirationDays) !== null && _b !== void 0 ? _b : 14,
+                replicaTruancyMinutes: (_d = (_c = __classPrivateFieldGet(this, _DurableObjectLibrary_config, "f").storageOptions) === null || _c === void 0 ? void 0 : _c.replicaTruancyTimeout) !== null && _d !== void 0 ? _d : 14 * 24 * 60,
+            });
+            this.library = new Library({
+                id: libraryId,
+                storage,
+                sender: this.clientConnections,
+                events: this.events,
+                disableRebasing: __classPrivateFieldGet(this, _DurableObjectLibrary_config, "f").disableRebasing,
+                fileStorage: new FileStorageLibraryDelegate(libraryId, __classPrivateFieldGet(this, _DurableObjectLibrary_config, "f").fileStorage),
+                log: this.log,
+                presence: this.clientConnections.presence,
+            });
+        };
+        _DurableObjectLibrary_restore.set(this, async () => {
+            if (__classPrivateFieldGet(this, _DurableObjectLibrary_initialized, "f")) {
+                return;
+            }
+            const storedLibraryId = await this.ctx.storage.get('libraryId');
+            if (storedLibraryId) {
+                await this.initialize(storedLibraryId);
+            }
+        });
+        this.fetch = async (request) => {
+            return __classPrivateFieldGet(this, _DurableObjectLibrary_app, "f").fetch(request);
+        };
+        _DurableObjectLibrary_getSocketInfo.set(this, (ws) => {
+            if (!__classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").has(ws)) {
+                // check for serialized form
+                const info = ws.deserializeAttachment();
+                if (info) {
+                    __classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").set(ws, info);
+                    return info;
+                }
+                throw new Error('No user token info associated with socket');
+            }
+            return __classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").get(ws);
+        });
+        this.webSocketMessage = (ws, message) => {
+            const { tokenInfo, key } = __classPrivateFieldGet(this, _DurableObjectLibrary_getSocketInfo, "f").call(this, ws);
+            const msg = JSON.parse(message.toString());
+            if (!msg) {
+                throw new VerdantError(VerdantError.Code.InvalidRequest, undefined, 'Invalid message format');
+            }
+            this.library.handleMessage(msg, key, tokenInfo);
+        };
+        this.webSocketClose = (ws, code, reason, wasClean) => {
+            const { key } = __classPrivateFieldGet(this, _DurableObjectLibrary_getSocketInfo, "f").call(this, ws);
+            this.log('info', 'WebSocket closed', { key, code, reason, wasClean });
+            this.clientConnections.remove(key);
+            __classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").delete(ws);
+        };
+        this.webSocketError = (ws, error) => {
+            this.log('error', 'WebSocket error', error);
+            const { key } = __classPrivateFieldGet(this, _DurableObjectLibrary_getSocketInfo, "f").call(this, ws);
+            this.clientConnections.remove(key);
+            __classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").delete(ws);
+        };
+        this.handleMessage = async (key, info, message) => {
+            await __classPrivateFieldGet(this, _DurableObjectLibrary_restore, "f").call(this);
+            return this.library.handleMessage(message, key, info);
+        };
+        // public library API
+        this.getDocumentSnapshot = async (collection, id) => {
+            await __classPrivateFieldGet(this, _DurableObjectLibrary_restore, "f").call(this);
+            return this.library.getDocumentSnapshot(createOid(collection, id));
+        };
+        this.getFileInfo = async (fileId) => {
+            await __classPrivateFieldGet(this, _DurableObjectLibrary_restore, "f").call(this);
+            return this.library.getFileInfo(fileId);
+        };
+        this.evict = async () => {
+            var _a;
+            await __classPrivateFieldGet(this, _DurableObjectLibrary_restore, "f").call(this);
+            await this.clientConnections.disconnectAll();
+            await ((_a = this.library) === null || _a === void 0 ? void 0 : _a.destroy());
+            await this.ctx.storage.deleteAll();
+            __classPrivateFieldSet(this, _DurableObjectLibrary_initialized, false, "f");
+        };
+        this.forceTruant = async (replicaId) => {
+            await __classPrivateFieldGet(this, _DurableObjectLibrary_restore, "f").call(this);
+            return this.library.forceTruant(replicaId);
+        };
+        this.getInfo = async () => {
+            await __classPrivateFieldGet(this, _DurableObjectLibrary_restore, "f").call(this);
+            return this.library.getInfo();
+        };
+        __classPrivateFieldSet(this, _DurableObjectLibrary_config, verdant, "f");
+        this.clientConnections = new ClientConnectionManager({
+            profiles: new UserProfileLoader(__classPrivateFieldGet(this, _DurableObjectLibrary_config, "f").profiles),
+        });
+        ctx.getWebSockets().forEach((ws) => {
+            // restore socket info after hibernation
+            const info = ws.deserializeAttachment();
+            if (info) {
+                __classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").set(ws, info);
+            }
+        });
+        __classPrivateFieldSet(this, _DurableObjectLibrary_app, new Hono()
+            .onError(errorHandler)
+            .use(async (ctx, next) => {
+            console.log(`[verdant object]`, ctx.req.url);
+            await next();
+        })
+            .use(tokenMiddleware(new TokenVerifier({ secret: verdant.tokenSecret })))
+            .use(async (ctx, next) => {
+            // only after authorization, migrate the database
+            await this.initialize(ctx.get('tokenInfo').libraryId);
+            return next();
+        })
+            .post('/', async (ctx) => {
+            const info = ctx.get('tokenInfo');
+            const body = (await ctx.req.json());
+            if (!body) {
+                throw new VerdantError(VerdantError.Code.BodyRequired, undefined, 'Invalid request body');
+            }
+            const finish = this.clientConnections.addFetch(ctx.get('key'), ctx.req.raw, info);
+            for (const message of body.messages) {
+                await this.library.handleMessage(message, ctx.get('key'), info);
+            }
+            const res = finish();
+            return res;
+        })
+            .post('/files/:fileId', async (ctx) => {
+            const info = ctx.get('tokenInfo');
+            const id = ctx.req.param('fileId');
+            if (!id) {
+                throw new VerdantError(VerdantError.Code.NotFound, undefined, 'Supply a file ID as a path parameters');
+            }
+            const form = await ctx.req.parseBody();
+            const file = form.file;
+            if (!file || !(file instanceof File)) {
+                throw new VerdantError(VerdantError.Code.InvalidRequest, undefined, 'File must be provided as form data');
+            }
+            const fileInfo = {
+                id,
+                libraryId: info.libraryId,
+                fileName: file.name,
+                type: file.type,
+            };
+            await verdant.fileStorage.put(file.stream(), fileInfo);
+            await this.library.putFileInfo(fileInfo);
+            return ctx.json({ success: true });
+        })
+            .get('/files/:fileId', async (ctx) => {
+            const id = ctx.req.param('fileId');
+            if (!id) {
+                throw new VerdantError(VerdantError.Code.NotFound, undefined, 'Supply a file ID as a path parameters');
+            }
+            const fileInfo = await this.library.getFileInfo(id);
+            if (!fileInfo) {
+                throw new VerdantError(VerdantError.Code.NotFound, undefined, 'File not found');
+            }
+            return ctx.json(fileInfo);
+        })
+            // add socket handler
+            .all('*', async (ctx) => {
+            this.log('debug', '[verdant object] socket upgrade request');
+            // WebSocket endpoint
+            const upgradeHeader = ctx.req.header('Upgrade');
+            if (upgradeHeader !== 'websocket') {
+                return ctx.json({ error: 'Upgrade to WebSocket required' }, 400);
+            }
+            const info = ctx.get('tokenInfo');
+            const websocketPair = new WebSocketPair();
+            const [client, server] = Object.values(websocketPair);
+            this.ctx.acceptWebSocket(server);
+            this.log('debug', 'WebSocket connection established');
+            const meta = {
+                tokenInfo: info,
+                key: ctx.get('key'),
+            };
+            server.serializeAttachment(meta);
+            __classPrivateFieldGet(this, _DurableObjectLibrary_socketInfoCache, "f").set(client, meta);
+            this.clientConnections.addSocket(meta.key, server, info);
+            return new Response(null, {
+                status: 101,
+                webSocket: client,
+            });
+        }), "f");
+        // set auto-response for pings
+        this.ctx.setWebSocketAutoResponse(new WebSocketRequestResponsePair(JSON.stringify({ type: 'heartbeat' }), JSON.stringify({
+            type: 'heartbeat-response',
+        })));
+    }
+    get log() {
+        return __classPrivateFieldGet(this, _DurableObjectLibrary_config, "f").log || __classPrivateFieldGet(this, _DurableObjectLibrary_noop, "f");
+    }
+}
+_DurableObjectLibrary_app = new WeakMap(), _DurableObjectLibrary_socketInfoCache = new WeakMap(), _DurableObjectLibrary_initialized = new WeakMap(), _DurableObjectLibrary_config = new WeakMap(), _DurableObjectLibrary_noop = new WeakMap(), _DurableObjectLibrary_restore = new WeakMap(), _DurableObjectLibrary_getSocketInfo = new WeakMap();
+//# sourceMappingURL=doLibrary.js.map

package/dist/esm/doLibrary.js.map

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

package/dist/esm/files.d.ts

@@ -0,0 +1,15 @@
+import { FileInfo, FileStorage } from '@verdant-web/server';
+import { Readable } from 'stream';
+export declare class R2FileStorage implements FileStorage {
+    private bucket;
+    private host;
+    constructor({ host, bucket }: {
+        host: string;
+        bucket: R2Bucket;
+    });
+    private getDirectory;
+    private getPath;
+    put: (fileStream: Readable | ReadableStream, data: FileInfo) => Promise<void>;
+    getUrl: (data: FileInfo) => Promise<string>;
+    delete: (data: FileInfo) => Promise<void>;
+}

package/dist/esm/files.js

@@ -0,0 +1,35 @@
+import { Readable } from 'stream';
+export class R2FileStorage {
+    constructor({ host, bucket }) {
+        this.getDirectory = (data) => {
+            return `${data.libraryId}/${data.id}`;
+        };
+        this.getPath = (data) => {
+            return `${this.getDirectory(data)}/${data.fileName}`;
+        };
+        this.put = async (fileStream, data) => {
+            const webStream = fileStream instanceof ReadableStream
+                ? fileStream
+                : Readable.toWeb(fileStream);
+            await this.bucket.put(this.getPath(data), webStream, {
+                httpMetadata: {
+                    contentType: data.type,
+                },
+                customMetadata: {
+                    libraryId: data.libraryId,
+                    fileId: data.id,
+                    fileName: data.fileName,
+                },
+            });
+        };
+        this.getUrl = async (data) => {
+            return this.host + '/' + this.getPath(data);
+        };
+        this.delete = async (data) => {
+            await this.bucket.delete(this.getPath(data));
+        };
+        this.bucket = bucket;
+        this.host = host;
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/esm/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/files.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,MAAM,OAAO,aAAa;IAIzB,YAAY,EAAE,IAAI,EAAE,MAAM,EAAsC;QAIxD,iBAAY,GAAG,CAAC,IAAc,EAAE,EAAE;YACzC,OAAO,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACvC,CAAC,CAAC;QACM,YAAO,GAAG,CAAC,IAAc,EAAE,EAAE;YACpC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtD,CAAC,CAAC;QACF,QAAG,GAAG,KAAK,EACV,UAAqC,EACrC,IAAc,EACE,EAAE;YAClB,MAAM,SAAS,GACd,UAAU,YAAY,cAAc;gBACnC,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAgB,EAAE;gBAC3D,YAAY,EAAE;oBACb,WAAW,EAAE,IAAI,CAAC,IAAI;iBACtB;gBACD,cAAc,EAAE;oBACf,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACvB;aACD,CAAC,CAAC;QACJ,CAAC,CAAC;QACF,WAAM,GAAG,KAAK,EAAE,IAAc,EAAmB,EAAE;YAClD,OAAO,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC;QACF,WAAM,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;YAChD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC;QAjCD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CAgCD"}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+export { createVerdantWorkerApp } from './api.js';
+export { DurableObjectLibrary } from './doLibrary.js';
+export { R2FileStorage } from './files.js';

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export { createVerdantWorkerApp } from './api.js';
+export { DurableObjectLibrary } from './doLibrary.js';
+export { R2FileStorage } from './files.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/sql.d.ts

@@ -0,0 +1,4 @@
+import { SqliteExecutor } from '@verdant-web/server/internals';
+export declare function createDurableObjectSqliteExecutor(storage: DurableObjectStorage, { log }?: {
+    log?: (level: string, ...args: any[]) => void;
+}): SqliteExecutor;

package/dist/esm/sql.js

@@ -0,0 +1,23 @@
+import { SqliteExecutor } from '@verdant-web/server/internals';
+export function createDurableObjectSqliteExecutor(storage, { log } = {}) {
+    return new SqliteExecutor({
+        close: () => { },
+        query: (sql, params = []) => {
+            const cursor = storage.sql.exec(sql, ...params);
+            const results = [];
+            let result = cursor.next();
+            while (!result.done) {
+                results.push(result.value);
+                result = cursor.next();
+            }
+            return results;
+        },
+        createTransaction: (exec) => (cb) => storage.transactionSync(() => {
+            return cb(exec);
+        }),
+        exec: (sql, params = []) => {
+            storage.sql.exec(sql, ...params);
+        },
+    }, { log });
+}
+//# sourceMappingURL=sql.js.map

package/dist/esm/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,UAAU,iCAAiC,CAChD,OAA6B,EAC7B,EAAE,GAAG,KAAwD,EAAE;IAE/D,OAAO,IAAI,cAAc,CACxB;QACC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,KAAK,EAAE,CACN,GAAW,EACX,SAA6B,EAAE,EAC9B,EAAE;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAI,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;YACnD,MAAM,OAAO,GAAQ,EAAE,CAAC;YACxB,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC3B,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YACxB,CAAC;YACD,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CACnC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE;YAC5B,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC;QACH,IAAI,EAAE,CAAC,GAAW,EAAE,SAA6B,EAAE,EAAE,EAAE;YACtD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;QAClC,CAAC;KACD,EACD,EAAE,GAAG,EAAE,CACP,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@verdant-web/cloudflare",
+  "version": "0.1.0",
+  "access": "public",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "types": "./dist/esm/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "bin/"
+  ],
+  "peerDependencies": {
+    "hono": "^4.7.2",
+    "@hono/node-server": "^1.13.8"
+  },
+  "dependencies": {
+    "@verdant-web/server": "4.0.0",
+    "@verdant-web/common": "3.0.0"
+  },
+  "devDependencies": {
+    "cross-env": "7.0.3",
+    "typescript": "5.9.3",
+    "hono": "^4.9.9",
+    "@hono/node-server": "^1.19.5",
+    "@cloudflare/workers-types": "^4.20250224.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublish": "pnpm run build"
+  }
+}

package/src/api.ts

@@ -0,0 +1,62 @@
+import {
+	errorHandler,
+	tokenMiddleware,
+	TokenVerifier,
+} from '@verdant-web/server/internals';
+import { Hono } from 'hono';
+import { basePath } from 'hono/route';
+
+export interface VerdantWorkerConfig {
+	durableObjectBindingName: string;
+	tokenSecretBindingName: string;
+}
+
+/**
+ * Creates a Hono app configured to serve Verdant library traffic.
+ * This app 'router' should be mounted onto another Verdant app
+ * used by your main Cloudflare worker, either as a Hono router
+ * or by just calling app.fetch with the request.
+ * The Durable Object binding specified by `durableObjectBindingName`
+ * must be configured to point to the DurableObjectNamespace for
+ * the Verdant library Durable Object class as configured in your
+ * wrangler config.
+ */
+export function createVerdantWorkerApp(config: VerdantWorkerConfig) {
+	// this really just determines which library DO to route to
+	// and the DO handles the rest
+	const app = new Hono<{ Bindings: any; Variables: any }>()
+		.onError(errorHandler)
+		.use((ctx, next) => {
+			const tokenVerifier = new TokenVerifier({
+				secret: ctx.env[config.tokenSecretBindingName],
+			});
+			return tokenMiddleware(tokenVerifier)(ctx as any, next);
+		})
+		.all((ctx) => {
+			if (ctx.req.method === 'OPTIONS') {
+				// preflight request, np
+				return ctx.newResponse(null, { status: 204 });
+			}
+
+			const info = ctx.get('tokenInfo');
+			const id = ctx.env[config.durableObjectBindingName].idFromName(
+				info.libraryId,
+			);
+			const obj = ctx.env[config.durableObjectBindingName].get(id);
+			// remove the base path so the DO sees the correct routing
+			const path = basePath(ctx);
+			const thisUrl = new URL(ctx.req.url);
+			thisUrl.pathname = thisUrl.pathname.replace(path, '') || '/';
+			const modifiedReq: Request = new Request(thisUrl.toString(), ctx.req.raw);
+			console.log(
+				`[verdant worker] routing to DO ${info.libraryId}:`,
+				ctx.req.method,
+				ctx.req.url,
+				path,
+				modifiedReq.url,
+			);
+			return obj.fetch(modifiedReq);
+		});
+
+	return app;
+}

package/src/doLibrary.ts

@@ -0,0 +1,346 @@
+import {
+	ClientMessage,
+	createOid,
+	EventSubscriber,
+	VerdantError,
+} from '@verdant-web/common';
+import {
+	FileInfo,
+	FileStorage,
+	TokenInfo,
+	UserProfiles,
+} from '@verdant-web/server';
+import {
+	ClientConnectionManager,
+	errorHandler,
+	FileStorageLibraryDelegate,
+	Library,
+	LibraryEvents,
+	SqlShardStorage,
+	tokenMiddleware,
+	TokenVerifier,
+	UserProfileLoader,
+} from '@verdant-web/server/internals';
+import { Hono } from 'hono';
+import { createDurableObjectSqliteExecutor } from './sql.js';
+
+interface SocketMeta {
+	tokenInfo: TokenInfo;
+	key: string;
+}
+
+export interface DurableObjectLibraryConfig {
+	tokenSecret: string;
+	disableRebasing?: boolean;
+	fileStorage: FileStorage;
+	log?: (level: string, ...args: any[]) => void;
+	profiles: UserProfiles<any>;
+	storageOptions?: {
+		fileDeleteExpirationDays?: number;
+		replicaTruancyTimeout?: number;
+	};
+}
+
+export class DurableObjectLibrary {
+	#app: Hono<any>;
+	#socketInfoCache: WeakMap<WebSocket, SocketMeta> = new WeakMap();
+	#initialized = false;
+	#config: DurableObjectLibraryConfig;
+
+	protected clientConnections: ClientConnectionManager;
+	protected library!: Library;
+	protected events: EventSubscriber<LibraryEvents> = new EventSubscriber();
+
+	constructor(
+		private ctx: DurableObjectState,
+		verdant: DurableObjectLibraryConfig,
+	) {
+		this.#config = verdant;
+
+		this.clientConnections = new ClientConnectionManager({
+			profiles: new UserProfileLoader(this.#config.profiles),
+		});
+
+		ctx.getWebSockets().forEach((ws) => {
+			// restore socket info after hibernation
+			const info = ws.deserializeAttachment() as SocketMeta | undefined;
+			if (info) {
+				this.#socketInfoCache.set(ws, info);
+			}
+		});
+
+		this.#app = new Hono()
+			.onError(errorHandler)
+			.use(async (ctx, next) => {
+				console.log(`[verdant object]`, ctx.req.url);
+				await next();
+			})
+			.use(tokenMiddleware(new TokenVerifier({ secret: verdant.tokenSecret })))
+			.use(async (ctx, next) => {
+				// only after authorization, migrate the database
+				await this.initialize(ctx.get('tokenInfo').libraryId);
+				return next();
+			})
+			.post('/', async (ctx) => {
+				const info = ctx.get('tokenInfo');
+				const body = (await ctx.req.json()) as
+					| { messages: ClientMessage[] }
+					| null
+					| undefined;
+				if (!body) {
+					throw new VerdantError(
+						VerdantError.Code.BodyRequired,
+						undefined,
+						'Invalid request body',
+					);
+				}
+				const finish = this.clientConnections.addFetch(
+					ctx.get('key'),
+					ctx.req.raw,
+					info,
+				);
+				for (const message of body.messages) {
+					await this.library.handleMessage(message, ctx.get('key'), info);
+				}
+				const res = finish();
+				return res;
+			})
+			.post('/files/:fileId', async (ctx) => {
+				const info = ctx.get('tokenInfo');
+
+				const id = ctx.req.param('fileId');
+				if (!id) {
+					throw new VerdantError(
+						VerdantError.Code.NotFound,
+						undefined,
+						'Supply a file ID as a path parameters',
+					);
+				}
+
+				const form = await ctx.req.parseBody();
+				const file = form.file;
+				if (!file || !(file instanceof File)) {
+					throw new VerdantError(
+						VerdantError.Code.InvalidRequest,
+						undefined,
+						'File must be provided as form data',
+					);
+				}
+
+				const fileInfo: FileInfo = {
+					id,
+					libraryId: info.libraryId,
+					fileName: file.name,
+					type: file.type,
+				};
+				await verdant.fileStorage.put(file.stream(), fileInfo);
+				await this.library.putFileInfo(fileInfo);
+
+				return ctx.json({ success: true });
+			})
+			.get('/files/:fileId', async (ctx) => {
+				const id = ctx.req.param('fileId');
+				if (!id) {
+					throw new VerdantError(
+						VerdantError.Code.NotFound,
+						undefined,
+						'Supply a file ID as a path parameters',
+					);
+				}
+
+				const fileInfo = await this.library.getFileInfo(id);
+				if (!fileInfo) {
+					throw new VerdantError(
+						VerdantError.Code.NotFound,
+						undefined,
+						'File not found',
+					);
+				}
+
+				return ctx.json(fileInfo);
+			})
+			// add socket handler
+			.all('*', async (ctx) => {
+				this.log('debug', '[verdant object] socket upgrade request');
+				// WebSocket endpoint
+				const upgradeHeader = ctx.req.header('Upgrade');
+				if (upgradeHeader !== 'websocket') {
+					return ctx.json({ error: 'Upgrade to WebSocket required' }, 400);
+				}
+
+				const info = ctx.get('tokenInfo');
+
+				const websocketPair = new WebSocketPair();
+				const [client, server] = Object.values(websocketPair);
+
+				this.ctx.acceptWebSocket(server);
+				this.log('debug', 'WebSocket connection established');
+
+				const meta: SocketMeta = {
+					tokenInfo: info,
+					key: ctx.get('key'),
+				};
+				server.serializeAttachment(meta);
+				this.#socketInfoCache.set(client, meta);
+
+				this.clientConnections.addSocket(meta.key, server, info);
+
+				return new Response(null, {
+					status: 101,
+					webSocket: client,
+				});
+			});
+
+		// set auto-response for pings
+		this.ctx.setWebSocketAutoResponse(
+			new WebSocketRequestResponsePair(
+				JSON.stringify({ type: 'heartbeat' }),
+				JSON.stringify({
+					type: 'heartbeat-response',
+				}),
+			),
+		);
+	}
+
+	#noop = () => {};
+	get log() {
+		return this.#config.log || this.#noop;
+	}
+
+	initialize = async (libraryId: string) => {
+		if (this.#initialized) {
+			return;
+		}
+		const storedLibraryId = await this.ctx.storage.get<string>('libraryId');
+		if (storedLibraryId && storedLibraryId !== libraryId) {
+			throw new VerdantError(
+				VerdantError.Code.InvalidRequest,
+				undefined,
+				'Library ID does not match existing storage',
+			);
+		}
+		await this.ctx.storage.put('libraryId', libraryId);
+		this.#initialized = true;
+		const db = createDurableObjectSqliteExecutor(this.ctx.storage, {
+			log: this.log,
+		});
+		await db.migrate();
+		const storage = new SqlShardStorage(db, {
+			libraryId,
+			fileDeleteExpirationDays:
+				this.#config.storageOptions?.fileDeleteExpirationDays ?? 14,
+			replicaTruancyMinutes:
+				this.#config.storageOptions?.replicaTruancyTimeout ?? 14 * 24 * 60,
+		});
+		this.library = new Library({
+			id: libraryId,
+			storage,
+			sender: this.clientConnections,
+			events: this.events,
+			disableRebasing: this.#config.disableRebasing,
+			fileStorage: new FileStorageLibraryDelegate(
+				libraryId,
+				this.#config.fileStorage,
+			),
+			log: this.log,
+			presence: this.clientConnections.presence,
+		});
+	};
+	#restore = async () => {
+		if (this.#initialized) {
+			return;
+		}
+		const storedLibraryId = await this.ctx.storage.get<string>('libraryId');
+		if (storedLibraryId) {
+			await this.initialize(storedLibraryId);
+		}
+	};
+
+	fetch = async (request: Request) => {
+		return this.#app.fetch(request);
+	};
+
+	#getSocketInfo = (ws: WebSocket) => {
+		if (!this.#socketInfoCache.has(ws)) {
+			// check for serialized form
+			const info = ws.deserializeAttachment() as SocketMeta | undefined;
+			if (info) {
+				this.#socketInfoCache.set(ws, info);
+				return info;
+			}
+			throw new Error('No user token info associated with socket');
+		}
+		return this.#socketInfoCache.get(ws)!;
+	};
+
+	webSocketMessage = (
+		ws: WebSocket,
+		message: string | ArrayBuffer,
+	): void | Promise<void> => {
+		const { tokenInfo, key } = this.#getSocketInfo(ws);
+		const msg = JSON.parse(message.toString()) as ClientMessage | null;
+		if (!msg) {
+			throw new VerdantError(
+				VerdantError.Code.InvalidRequest,
+				undefined,
+				'Invalid message format',
+			);
+		}
+		this.library.handleMessage(msg, key, tokenInfo);
+	};
+
+	webSocketClose = (
+		ws: WebSocket,
+		code: number,
+		reason: string,
+		wasClean: boolean,
+	): void | Promise<void> => {
+		const { key } = this.#getSocketInfo(ws);
+		this.log('info', 'WebSocket closed', { key, code, reason, wasClean });
+		this.clientConnections.remove(key);
+		this.#socketInfoCache.delete(ws);
+	};
+
+	webSocketError = (ws: WebSocket, error: unknown): void | Promise<void> => {
+		this.log('error', 'WebSocket error', error);
+		const { key } = this.#getSocketInfo(ws);
+		this.clientConnections.remove(key);
+		this.#socketInfoCache.delete(ws);
+	};
+
+	handleMessage = async (
+		key: string,
+		info: TokenInfo,
+		message: ClientMessage,
+	) => {
+		await this.#restore();
+		return this.library.handleMessage(message, key, info);
+	};
+
+	// public library API
+	getDocumentSnapshot = async (collection: string, id: string) => {
+		await this.#restore();
+		return this.library.getDocumentSnapshot(
+			createOid(collection, id),
+		) as Promise<{} | null>;
+	};
+	getFileInfo = async (fileId: string) => {
+		await this.#restore();
+		return this.library.getFileInfo(fileId);
+	};
+	evict = async () => {
+		await this.#restore();
+		await this.clientConnections.disconnectAll();
+		await this.library?.destroy();
+		await this.ctx.storage.deleteAll();
+		this.#initialized = false;
+	};
+	forceTruant = async (replicaId: string) => {
+		await this.#restore();
+		return this.library.forceTruant(replicaId);
+	};
+	getInfo = async () => {
+		await this.#restore();
+		return this.library.getInfo();
+	};
+}

package/src/files.ts

@@ -0,0 +1,43 @@
+import { FileInfo, FileStorage } from '@verdant-web/server';
+import { Readable } from 'stream';
+
+export class R2FileStorage implements FileStorage {
+	private bucket: R2Bucket;
+	private host: string;
+
+	constructor({ host, bucket }: { host: string; bucket: R2Bucket }) {
+		this.bucket = bucket;
+		this.host = host;
+	}
+	private getDirectory = (data: FileInfo) => {
+		return `${data.libraryId}/${data.id}`;
+	};
+	private getPath = (data: FileInfo) => {
+		return `${this.getDirectory(data)}/${data.fileName}`;
+	};
+	put = async (
+		fileStream: Readable | ReadableStream,
+		data: FileInfo,
+	): Promise<void> => {
+		const webStream =
+			fileStream instanceof ReadableStream
+				? fileStream
+				: Readable.toWeb(fileStream);
+		await this.bucket.put(this.getPath(data), webStream as any, {
+			httpMetadata: {
+				contentType: data.type,
+			},
+			customMetadata: {
+				libraryId: data.libraryId,
+				fileId: data.id,
+				fileName: data.fileName,
+			},
+		});
+	};
+	getUrl = async (data: FileInfo): Promise<string> => {
+		return this.host + '/' + this.getPath(data);
+	};
+	delete = async (data: FileInfo): Promise<void> => {
+		await this.bucket.delete(this.getPath(data));
+	};
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { createVerdantWorkerApp } from './api.js';
+export { DurableObjectLibrary } from './doLibrary.js';
+export { R2FileStorage } from './files.js';

package/src/sql.ts

@@ -0,0 +1,33 @@
+import { SqliteExecutor } from '@verdant-web/server/internals';
+
+export function createDurableObjectSqliteExecutor(
+	storage: DurableObjectStorage,
+	{ log }: { log?: (level: string, ...args: any[]) => void } = {},
+): SqliteExecutor {
+	return new SqliteExecutor(
+		{
+			close: () => {},
+			query: <O extends Record<string, any>>(
+				sql: string,
+				params: readonly unknown[] = [],
+			) => {
+				const cursor = storage.sql.exec<O>(sql, ...params);
+				const results: O[] = [];
+				let result = cursor.next();
+				while (!result.done) {
+					results.push(result.value);
+					result = cursor.next();
+				}
+				return results;
+			},
+			createTransaction: (exec) => (cb) =>
+				storage.transactionSync(() => {
+					return cb(exec);
+				}),
+			exec: (sql: string, params: readonly unknown[] = []) => {
+				storage.sql.exec(sql, ...params);
+			},
+		},
+		{ log },
+	);
+}