@verdant-web/server 3.3.11 → 4.0.0

package/bin/server.mjs

@@ -1,15 +1,20 @@
 #!/usr/bin/env node
-import { createReadStream } from 'fs';
-import { createServer } from 'http';
+import { serve } from '@hono/node-server';
+import { serveStatic } from '@hono/node-server/serve-static';
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
 import minimist from 'minimist';
-import { parse, URLSearchParams } from 'url';
 import {
+	createHttpRouter,
+	createNodeWebsocketHandler,
+} from '../dist/esm/adapters/node/index.js';
+import {
+	createVerdant,
 	LocalFileStorage,
 	ReplicaType,
-	Server,
 	TokenProvider,
 } from '../dist/esm/index.js';
-import { sqlStorage } from '../dist/esm/storage/index.js';
+import { sqlShardStorage } from '../dist/esm/storage/index.js';
 
 const argv = minimist(process.argv.slice(1));
 
@@ -17,119 +22,117 @@ const PORT = argv.port || argv.p || process.env.VERDANT_PORT || 3242;
 const SECRET =
 	argv.secret || process.env.VERDANT_SECRET || 'notsecretnotsecretnotsecret';
 
-const tokenProvider = new TokenProvider({ secret: SECRET });
+const tokenProvider = new TokenProvider({
+	secret: SECRET,
+});
 
-const http = createServer((req, res) => {
-	const url = parse(req.url);
-	// write cors headers for incoming host
-	const origin = req.headers.origin;
-	res.setHeader('Access-Control-Allow-Origin', origin ?? '*');
-	res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-	res.setHeader(
-		'Access-Control-Allow-Headers',
-		'Content-Type, Authorization, X-Request-Id',
-	);
-	res.setHeader('Access-Control-Allow-Credentials', 'true');
-	res.setHeader('Access-Control-Max-Age', '86400');
-	if (req.method === 'OPTIONS') {
-		res.writeHead(200);
-		res.end();
-		return;
-	}
+// the "core" is a service API for interacting with libraries.
+// you could plug this into your own HTTP or other kind of interface,
+// but further on are some Hono-based tools to help get started.
+const core = createVerdant({
+	// SQLite databases for each library are stored in this directory
+	storage: sqlShardStorage({
+		databasesDirectory: 'verdant-dbs',
+	}),
+	// implement .get to retrieve detailed profile information for sync users
+	profiles: {
+		get: async (userId) => {
+			// you could fetch a profile record from a database here to augment
+			// this profile with name, image, etc.
+			// values will be cached, so don't worry too much about timing.
+			return { id: userId };
+		},
+	},
+	// required to validate sync access tokens generated from
+	// your API
+	tokenSecret: SECRET,
+	// optional; enables file sync
+	fileStorage: new LocalFileStorage({
+		rootDirectory: 'verdant-files',
+		// this matches an API you must host (see below)
+		host: `http://localhost:${PORT}/files`,
+		log: (level, ...args) => console.log(level, ...args),
+	}),
+	// optional logger
+	log: (level, ...args) => console.log(level, ...args),
+});
 
-	// serve files on the /files path
-	if (url.pathname.startsWith('/files/')) {
-		const file = decodeURIComponent(url.pathname.slice(7));
-		console.log('Serving file', file);
-		const fileStream = createReadStream(`files/${file}`);
-		fileStream.pipe(res);
-		fileStream.on('error', (err) => {
-			res.writeHead(404);
-			res.end();
-		});
-		return;
-	}
+// our verdant router will be mounted to a subpath
+// and handle all HTTP sync requests
+const verdantRouter = createHttpRouter(core);
 
-	// provide tokens on the /auth path
-	if (url.pathname.startsWith('/auth/')) {
-		// userId is provided as a query param
-		const params = new URLSearchParams(url.search);
-		const userId = params.get('userId');
+// this is "your" app -- Verdant lives in it,
+// but you control the API.
+const app = new Hono()
+	.use('*', async (c, next) => {
+		// simple request logger
+		console.log(`${c.req.method} ${c.req.url}`);
+		await next();
+	})
+	.use(
+		'*',
+		cors({
+			origin: (o) => o,
+			credentials: true,
+			allowHeaders: ['Content-Type', 'Authorization', 'X-Request-Id'],
+		}),
+	)
+	.route('/verdant', verdantRouter)
+	// issue sync tokens
+	.get('/auth/:libraryId', async (ctx) => {
+		// here you authenticate your user, authorize
+		// their access to a particular library, and
+		// issue a token.
+		const library = ctx.req.param('libraryId');
+
+		const user = ctx.req.query('userId');
+		const type = ctx.req.query('type') || ReplicaType.Realtime;
 
-		// library ID is in path
-		const libraryId = url.pathname.slice(6);
+		// remember to check that the user is allowed to sync
+		// to this library
 
 		const token = tokenProvider.getToken({
-			userId,
-			libraryId,
-			syncEndpoint: `http://localhost:${PORT}/sync`,
-			role: 'user',
-			type: ReplicaType.Realtime,
+			libraryId: library,
+			userId: user,
+			// this subpath matches the verdantRouter mount
+			syncEndpoint: `http://localhost:${PORT}/verdant`,
+			type,
 		});
-		res.writeHead(200, {
-			'Content-Type': 'application/json',
+		return ctx.json({
+			accessToken: token,
 		});
-		res.end(JSON.stringify({ accessToken: token }));
-		return;
-	} else if (url.pathname.startsWith('/sync')) {
-		if (url.pathname.startsWith('/sync/files/')) {
-			return verdant.handleFileRequest(req, res);
-		}
-		return verdant.handleRequest(req, res);
-	} else {
-		res.writeHead(404);
-		res.end();
-	}
-});
-
-const verdant = new Server({
-	storage: sqlStorage({
-		databaseFile: 'verdant.sqlite',
-	}),
-	tokenSecret: SECRET,
-	fileStorage: new LocalFileStorage({
-		rootDirectory: 'files',
-		host: `http://localhost:${3242}/files`,
-	}),
-	profiles: {
-		get: (userId) => ({
-			id: userId,
+	})
+	// (optional) serve uploaded files
+	// if you use LocalFileStorage
+	.get(
+		'/files/*',
+		serveStatic({
+			root: 'verdant-files',
+			rewriteRequestPath: (path) => path.replace('/files/', ''),
 		}),
-	},
-	httpServer: http,
-	log: (level, ...rest) => {
-		if (process.env.VERDANT_LOG === 'false') {
-			return;
-		}
-		if (level === 'debug' && process.env.VERDANT_DEBUG !== 'true') {
-			return;
-		}
-		console.log(level, ...rest);
-	},
-});
+	);
 
-verdant.on('error', (err) => {
-	console.error(err);
+const server = serve({
+	fetch: app.fetch,
+	port: parseInt(PORT.toString(), 10),
 });
 
-export default new Promise((resolve) => {
-	http.listen(PORT, () => {
-		console.log(`🌿 Verdant standalone server listening on port ${PORT}`);
-		console.log(``);
-		console.log(
-			`It's not recommended you use this server in production. It's a convenient way to test syncing locally, but has no authorization.`,
-		);
-		console.log(``);
-		console.log(
-			`To connect your client, supply "http://localhost:${PORT}/auth/<libraryId>?userId=<userId>" to sync.authEndpoint.`,
-		);
-		console.log(
-			`<libraryId> and <userId> are up to you and your app. Clients on the same library ID will sync data.`,
-		);
+// handle websocket sync! must be done like this, not included
+// in createHttpRouter!
+const onUpgrade = createNodeWebsocketHandler(core);
+server.addListener('upgrade', onUpgrade);
 
-		resolve({
-			httpServer: http,
-			verdant,
-		});
-	});
+server.addListener('listening', () => {
+	console.log(`🌿 Verdant standalone server listening on port ${PORT}`);
+	console.log(``);
+	console.log(
+		`Never use this server in production. It's a convenient way to test syncing locally, but has no authorization.`,
+	);
+	console.log(``);
+	console.log(
+		`To connect your client, import \`cliSync\` and pass \`cliSync(<libraryId>)\` to \`sync\`, or supply "http://localhost:${PORT}/auth/<libraryId>?userId=<userId>" to sync.authEndpoint.`,
+	);
+	console.log(
+		`<libraryId> and <userId> are up to you and your app. Clients on the same library ID will sync data.`,
+	);
 });

package/dist/esm/TokenVerifier.d.ts

@@ -4,6 +4,7 @@ export declare class TokenVerifier {
     constructor(config: {
         secret: string;
     });
+    get secret(): string;
     verifyToken: (token: string) => TokenInfo;
 }
 export interface TokenInfo {

package/dist/esm/TokenVerifier.js

@@ -29,5 +29,8 @@ export class TokenVerifier {
             }
         };
     }
+    get secret() {
+        return this.config.secret;
+    }
 }
 //# sourceMappingURL=TokenVerifier.js.map

package/dist/esm/TokenVerifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"TokenVerifier.js","sourceRoot":"","sources":["../../src/TokenVerifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,GAAmB,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,aAAa;IACzB,YAAoB,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;QAE9C,gBAAW,GAAG,CAAC,KAAa,EAAa,EAAE;YAC1C,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBACrD,QAAQ,EAAE,KAAK;iBACf,CAAe,CAAC;gBACjB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACpB,OAAO;oBACN,MAAM,EAAE,OAAO,CAAC,GAAG;oBACnB,SAAS,EAAE,OAAO,CAAC,GAAG;oBACtB,YAAY,EAAE,OAAO,CAAC,GAAG;oBACzB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,KAAK;iBACL,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,YAAY,GAAG,CAAC,iBAAiB,EAAE,CAAC;oBACxC,MAAM,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACxD,CAAC;gBACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;oBACxB,MAAM,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,IAAI,YAAY,CACrB,YAAY,CAAC,IAAI,CAAC,UAAU,EAC5B,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CACjB,CAAC;YACH,CAAC;QACF,CAAC,CAAC;IA7B+C,CAAC;CA8BlD"}
+{"version":3,"file":"TokenVerifier.js","sourceRoot":"","sources":["../../src/TokenVerifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAe,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,GAAmB,MAAM,cAAc,CAAC;AAE/C,MAAM,OAAO,aAAa;IACzB,YAAoB,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;QAM9C,gBAAW,GAAG,CAAC,KAAa,EAAa,EAAE;YAC1C,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBACrD,QAAQ,EAAE,KAAK;iBACf,CAAe,CAAC;gBACjB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACpB,OAAO;oBACN,MAAM,EAAE,OAAO,CAAC,GAAG;oBACnB,SAAS,EAAE,OAAO,CAAC,GAAG;oBACtB,YAAY,EAAE,OAAO,CAAC,GAAG;oBACzB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,KAAK;iBACL,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,YAAY,GAAG,CAAC,iBAAiB,EAAE,CAAC;oBACxC,MAAM,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACxD,CAAC;gBACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;oBACxB,MAAM,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,IAAI,YAAY,CACrB,YAAY,CAAC,IAAI,CAAC,UAAU,EAC5B,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CACjB,CAAC;YACH,CAAC;QACF,CAAC,CAAC;IAjC+C,CAAC;IAElD,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3B,CAAC;CA8BD"}

package/dist/esm/adapters/node/errorHandler.d.ts

@@ -0,0 +1,2 @@
+import { ErrorHandler } from 'hono';
+export declare const errorHandler: ErrorHandler;

package/dist/esm/adapters/node/errorHandler.js

@@ -0,0 +1,12 @@
+import { VerdantError } from '@verdant-web/common';
+export const errorHandler = (err, ctx) => {
+    if (err instanceof VerdantError) {
+        if (err.code > VerdantError.Code.Unexpected) {
+            console.error('Verdant error:', err);
+        }
+        return ctx.json(err.toResponse(), err.httpStatus);
+    }
+    console.error('Unexpected error:', err);
+    return ctx.json(new VerdantError(VerdantError.Code.Unexpected).toResponse(), 500);
+};
+//# sourceMappingURL=errorHandler.js.map

package/dist/esm/adapters/node/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../../../src/adapters/node/errorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACtD,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,UAAkC,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,GAAG,CAAC,IAAI,CACd,IAAI,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,EAC3D,GAAG,CACH,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/adapters/node/getRequestToken.d.ts

@@ -0,0 +1 @@
+export declare function getRequestToken(req: Request): string | null;

package/dist/esm/adapters/node/getRequestToken.js

@@ -0,0 +1,25 @@
+import { VerdantError } from '@verdant-web/common';
+export function getRequestToken(req) {
+    if (req.method === 'OPTIONS') {
+        // preflight request, np
+        return null;
+    }
+    // websocket compat - we only receive one header...
+    const protocolHeader = req.headers.get('Sec-WebSocket-Protocol');
+    if (protocolHeader) {
+        const [type, token] = protocolHeader.split(',');
+        if (type === 'Bearer') {
+            return token.trim();
+        }
+    }
+    const authHeader = req.headers.get('Authorization');
+    if (!authHeader) {
+        throw new VerdantError(VerdantError.Code.NoToken, undefined, 'Authorization header is required');
+    }
+    const [type, token] = authHeader.split(' ');
+    if (type !== 'Bearer') {
+        throw new VerdantError(VerdantError.Code.InvalidToken, undefined, 'Authorization type must be Bearer');
+    }
+    return token;
+}
+//# sourceMappingURL=getRequestToken.js.map

package/dist/esm/adapters/node/getRequestToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequestToken.js","sourceRoot":"","sources":["../../../../src/adapters/node/getRequestToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,wBAAwB;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IACD,mDAAmD;IACnD,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACjE,IAAI,cAAc,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACF,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,YAAY,CACrB,YAAY,CAAC,IAAI,CAAC,OAAO,EACzB,SAAS,EACT,kCAAkC,CAClC,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACrB,YAAY,CAAC,IAAI,CAAC,YAAY,EAC9B,SAAS,EACT,mCAAmC,CACnC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/esm/adapters/node/httpRouter.d.ts

@@ -0,0 +1,47 @@
+import { SingleNodeLibraryManager } from '../../libraries/singleNode.js';
+export declare function createHttpRouter(core: SingleNodeLibraryManager): import("hono/hono-base").HonoBase<{}, {
+    "*": {};
+} & {
+    "/": {
+        $post: {
+            input: {};
+            output: {};
+            outputFormat: string;
+            status: import("hono/utils/http-status").StatusCode;
+        };
+    };
+} & {
+    "/files/:fileId": {
+        $post: {
+            input: {
+                param: {
+                    fileId: string;
+                };
+            };
+            output: {
+                success: true;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+} & {
+    "/files/:fileId": {
+        $get: {
+            input: {
+                param: {
+                    fileId: string;
+                };
+            };
+            output: {
+                libraryId: string;
+                id: string;
+                name: string;
+                type: string;
+                url: string | null;
+            };
+            outputFormat: "json";
+            status: 200;
+        };
+    };
+}, "/">;

package/dist/esm/adapters/node/httpRouter.js

@@ -0,0 +1,88 @@
+import { VerdantError } from '@verdant-web/common';
+import { Hono } from 'hono';
+import { Readable } from 'stream';
+import { errorHandler } from './errorHandler.js';
+import { tokenMiddleware } from './tokenMiddleware.js';
+export function createHttpRouter(core) {
+    const mw = tokenMiddleware(core.tokenVerifier);
+    const app = new Hono()
+        .onError(errorHandler)
+        .use('*', async (c, next) => {
+        core.log('debug', 'Incoming request', {
+            method: c.req.method,
+            path: c.req.path,
+        });
+        await next();
+    })
+        .post('/', mw, async (ctx) => {
+        var _a;
+        const key = ctx.get('key');
+        const info = ctx.get('tokenInfo');
+        const microserver = await core.get(info.libraryId);
+        const finish = (_a = microserver.onRequest) === null || _a === void 0 ? void 0 : _a.call(microserver, key, ctx.req.raw, info);
+        const body = (await ctx.req.json());
+        if (!(body === null || body === void 0 ? void 0 : body.messages)) {
+            throw new VerdantError(VerdantError.Code.BodyRequired, undefined, 'Invalid request body');
+        }
+        for (const message of body.messages) {
+            await microserver.handleMessage(key, info, message);
+        }
+        const res = finish();
+        return res;
+    })
+        .post('/files/:fileId', mw, 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');
+        }
+        // TODO: remove this once I figure out why request file body parsing is
+        // hanging indefinitely.
+        if (core.__testMode) {
+            const microserver = await core.get(info.libraryId);
+            core.log('warn', 'TEST MODE: FILE WILL NOT BE WRITTEN', '\n', 'This Verdant server was launched in Test Mode. This is only meant for use', 'in automated testing environments. The file just uploaded WILL NOT be', 'stored on disk or retrievable.');
+            // Fake a file upload for testing
+            await microserver.uploadFile(new Readable({
+                read() {
+                    this.push('test');
+                    this.push(null);
+                },
+            }), {
+                id,
+                libraryId: info.libraryId,
+                fileName: 'test.txt',
+                type: 'text/plain',
+            });
+            return ctx.json({ success: true }, 200);
+        }
+        const form = await ctx.req.parseBody();
+        const file = form.file;
+        if (!file || !(file instanceof File)) {
+            throw new VerdantError(VerdantError.Code.InvalidRequest, undefined, 'No file was uploaded to the `file` form key');
+        }
+        const microserver = await core.get(info.libraryId);
+        const fileStream = file.stream();
+        await microserver.uploadFile(fileStream, {
+            id,
+            libraryId: info.libraryId,
+            fileName: file.name,
+            type: file.type,
+        });
+        return ctx.json({ success: true }, 200);
+    })
+        .get('/files/:fileId', mw, 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 microserver = await core.get(info.libraryId);
+        const file = await microserver.getFileInfo(id);
+        if (!file) {
+            throw new VerdantError(VerdantError.Code.NotFound, undefined, `File with ID ${id} not found`);
+        }
+        return ctx.json(file, 200);
+    });
+    return app;
+}
+//# sourceMappingURL=httpRouter.js.map

package/dist/esm/adapters/node/httpRouter.js.map

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

package/dist/esm/adapters/node/index.d.ts

@@ -0,0 +1,5 @@
+export { errorHandler } from '../node/errorHandler.js';
+export { getRequestToken } from '../node/getRequestToken.js';
+export * from './httpRouter.js';
+export { tokenMiddleware } from './tokenMiddleware.js';
+export * from './websocketHandler.js';

package/dist/esm/adapters/node/index.js

@@ -0,0 +1,6 @@
+export { errorHandler } from '../node/errorHandler.js';
+export { getRequestToken } from '../node/getRequestToken.js';
+export * from './httpRouter.js';
+export { tokenMiddleware } from './tokenMiddleware.js';
+export * from './websocketHandler.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,cAAc,uBAAuB,CAAC"}

package/dist/esm/adapters/node/tokenMiddleware.d.ts

@@ -0,0 +1,7 @@
+import { TokenInfo, TokenVerifier } from '../../TokenVerifier.js';
+export declare const tokenMiddleware: (tokenVerifier: TokenVerifier) => import("hono").MiddlewareHandler<{
+    Variables: {
+        key: string;
+        tokenInfo: TokenInfo;
+    };
+}, string, {}>;

package/dist/esm/adapters/node/tokenMiddleware.js

@@ -0,0 +1,22 @@
+import { generateId } from '@verdant-web/common';
+import { createMiddleware } from 'hono/factory';
+import { getRequestToken } from '../node/getRequestToken.js';
+export const tokenMiddleware = (tokenVerifier) => createMiddleware((ctx, next) => {
+    if (ctx.req.method === 'OPTIONS') {
+        // preflight request, np
+        return next();
+    }
+    const requestToken = getRequestToken(ctx.req.raw);
+    const key = generateId();
+    const info = tokenVerifier.verifyToken(requestToken);
+    ctx.set('key', key);
+    ctx.set('tokenInfo', info);
+    // if a Sec-Websocket-Protocol header was sent, we need to echo it back
+    // so the websocket connection is accepted by the client
+    const protocolHeader = ctx.req.header('Sec-WebSocket-Protocol');
+    if (protocolHeader) {
+        ctx.res.headers.set('Sec-WebSocket-Protocol', requestToken);
+    }
+    return next();
+});
+//# sourceMappingURL=tokenMiddleware.js.map

package/dist/esm/adapters/node/tokenMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenMiddleware.js","sourceRoot":"","sources":["../../../../src/adapters/node/tokenMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAA4B,EAAE,EAAE,CAC/D,gBAAgB,CAKb,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;IAChB,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,wBAAwB;QACxB,OAAO,IAAI,EAAE,CAAC;IACf,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAEnD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IACrD,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpB,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAE3B,uEAAuE;IACvE,wDAAwD;IACxD,MAAM,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAChE,IAAI,cAAc,EAAE,CAAC;QACpB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,IAAI,EAAE,CAAC;AACf,CAAC,CAAC,CAAC"}

package/dist/esm/adapters/node/websocketHandler.d.ts

@@ -0,0 +1,4 @@
+import { IncomingMessage } from 'node:http';
+import internal from 'node:stream';
+import { SingleNodeLibraryManager } from '../../libraries/singleNode.js';
+export declare function createNodeWebsocketHandler(core: SingleNodeLibraryManager): (req: IncomingMessage, socket: internal.Duplex, head: Buffer) => void;

package/dist/esm/adapters/node/websocketHandler.js

@@ -0,0 +1,54 @@
+import { VerdantError, assert, generateId, } from '@verdant-web/common';
+import { URL } from 'url';
+import { WebSocketServer } from 'ws';
+export function createNodeWebsocketHandler(core) {
+    const wss = new WebSocketServer({ noServer: true });
+    wss.on('connection', async (ws, req, info) => {
+        const key = generateId();
+        const microserver = await core.get(info.libraryId);
+        microserver.clientConnections.addSocket(key, ws, info);
+        ws.on('message', async (message) => {
+            const data = JSON.parse(message.toString());
+            await microserver.handleMessage(key, info, data);
+        });
+        ws.on('close', () => {
+            microserver.clientConnections.remove(key);
+            core.log('debug', 'Connection closed', { key, userId: info.userId });
+        });
+    });
+    function getRequestToken(req) {
+        if (req.headers['sec-websocket-protocol']) {
+            // hack: read the token from the websocket protocol header
+            const [type, token] = req.headers['sec-websocket-protocol'].split(',');
+            if (type === 'Bearer') {
+                return token.trim();
+            }
+        }
+        assert(req.url, 'Request URL is required');
+        const url = new URL(req.url, 'http://localhost');
+        const token = url.searchParams.get('token');
+        if (!token) {
+            throw new VerdantError(VerdantError.Code.NoToken, undefined, 'Token query parameter is required');
+        }
+        return token;
+    }
+    return (req, socket, head) => {
+        try {
+            const token = getRequestToken(req);
+            const info = core.tokenVerifier.verifyToken(token);
+            wss.handleUpgrade(req, socket, head, (ws) => {
+                wss.emit('connection', ws, req, info);
+            });
+        }
+        catch (err) {
+            if (err instanceof VerdantError && err.httpStatus === 401) {
+                socket.write('HTTP/1.1 401 Unauthorized\r\n' +
+                    'Connection: close\r\n' +
+                    'Content-Length: 0\r\n' +
+                    '\r\n');
+            }
+            socket.destroy();
+        }
+    };
+}
+//# sourceMappingURL=websocketHandler.js.map

package/dist/esm/adapters/node/websocketHandler.js.map

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

package/dist/esm/connections/ClientConnection.d.ts

@@ -0,0 +1,25 @@
+import { ServerMessage } from '@verdant-web/common';
+import { IncomingMessage, ServerResponse } from 'http';
+import { WebSocket as WSWebSocket } from 'ws';
+import { UserProfileLoader } from '../Profiles.js';
+import { TokenInfo } from '../TokenVerifier.js';
+import { MessageSender } from './MessageSender.js';
+import { Presence } from './Presence.js';
+export declare class ClientConnectionManager implements MessageSender {
+    private readonly connections;
+    readonly presence: Presence;
+    constructor({ profiles }: {
+        profiles: UserProfileLoader<any>;
+    });
+    addSocket: (key: string, socket: WebSocket | WSWebSocket, info: TokenInfo) => void;
+    addRequest: (key: string, request: IncomingMessage, response: ServerResponse, info: TokenInfo) => () => void;
+    addFetch: (key: string, req: Request, info: TokenInfo) => (() => Response);
+    remove: (key: string) => void;
+    respond: (key: string, message: ServerMessage) => void;
+    /**
+     * Broadcasts a message to all live-connected clients in a library.
+     * This does not reach push/pull clients.
+     */
+    broadcast: (message: ServerMessage, omitKeys?: string[]) => void;
+    disconnectAll: () => void;
+}