@ripple-ts/adapter-node 0.2.213 → 0.2.215

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @ripple-ts/adapter-node
 
+## 0.2.215
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @ripple-ts/adapter@0.2.215
+
+## 0.2.214
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @ripple-ts/adapter@0.2.214
+
 ## 0.2.213
 
 ### Patch Changes

package/package.json

@@ -3,7 +3,7 @@
   "description": "Node.js adapter for Ripple metaframework (Web Request/Response bridge)",
   "license": "MIT",
   "author": "Dominic Gannaway",
-  "version": "0.2.213",
+  "version": "0.2.215",
   "type": "module",
   "module": "src/index.js",
   "main": "src/index.js",
@@ -15,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@ripple-ts/adapter": "0.2.213"
+    "@ripple-ts/adapter": "0.2.215"
   },
-  "homepage": "https://ripplejs.com",
+  "homepage": "https://ripple-ts.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Ripple-TS/ripple.git",

package/src/index.js

@@ -1,13 +1,50 @@
 import { createServer } from 'node:http';
+import { createReadStream, existsSync, statSync } from 'node:fs';
+import { resolve, sep } from 'node:path';
 import { Readable } from 'node:stream';
+import { createHash } from 'node:crypto';
+import { AsyncLocalStorage } from 'node:async_hooks';
 import {
 	DEFAULT_HOSTNAME,
 	DEFAULT_PORT,
+	DEFAULT_STATIC_PREFIX,
+	DEFAULT_STATIC_MAX_AGE,
+	get_mime_type,
+	get_static_cache_control,
 	internal_server_error_response,
 	run_next_middleware,
-	serveStatic as create_static_handler,
 } from '@ripple-ts/adapter';
 
+// Re-export conversion helpers for use by serverless function wrappers (e.g. Vercel)
+export { node_request_to_web_request as nodeRequestToWebRequest };
+export { web_response_to_node_response as webResponseToNodeResponse };
+
+// ============================================================================
+// Runtime primitives — platform-specific capabilities for Ripple's server runtime
+// ============================================================================
+
+/**
+ * Node.js runtime primitives for the Ripple adapter contract.
+ *
+ * Provides:
+ * - `hash`: SHA-256 hex digest truncated to 8 chars (matches compiler output)
+ * - `createAsyncContext`: AsyncLocalStorage-backed request-scoped context
+ *
+ * @type {import('@ripple-ts/adapter').RuntimePrimitives}
+ */
+export const runtime = {
+	hash(str) {
+		return createHash('sha256').update(str).digest('hex').slice(0, 8);
+	},
+	createAsyncContext() {
+		const als = new AsyncLocalStorage();
+		return {
+			run: (store, fn) => als.run(store, fn),
+			getStore: () => als.getStore(),
+		};
+	},
+};
+
 /**
  * @param {string | string[] | undefined} value
  * @returns {string | undefined}
@@ -170,7 +207,7 @@ export function serve(fetch_handler, options = {}) {
 	/** @type {ReturnType<typeof serveStatic> | null} */
 	let static_middleware = null;
 	if (static_options !== false) {
-		const { dir = 'public', ...static_handler_options } = static_options;
+		const { dir = '.', ...static_handler_options } = static_options;
 		static_middleware = serveStatic(dir, static_handler_options);
 	}
 
@@ -256,6 +293,86 @@ export function serve(fetch_handler, options = {}) {
 	};
 }
 
+/**
+ * @param {string} base_dir
+ * @param {string} pathname
+ * @returns {string | null}
+ */
+function resolve_static_file_path(base_dir, pathname) {
+	const file_path = resolve(base_dir, `.${pathname}`);
+	const is_within_base_dir = file_path === base_dir || file_path.startsWith(base_dir + sep);
+	return is_within_base_dir ? file_path : null;
+}
+
+/**
+ * Create a request-based static file handler.
+ *
+ * @param {string} dir - Directory to serve files from (relative to cwd or absolute)
+ * @param {{ prefix?: string, maxAge?: number, immutable?: boolean }} [options]
+ * @returns {(request: Request) => Response | null}
+ */
+function create_static_handler(dir, options = {}) {
+	const {
+		prefix = DEFAULT_STATIC_PREFIX,
+		maxAge = DEFAULT_STATIC_MAX_AGE,
+		immutable = false,
+	} = options;
+
+	const base_dir = resolve(dir);
+
+	return function serve_static_request(request) {
+		const request_method = (request.method || 'GET').toUpperCase();
+		if (request_method !== 'GET' && request_method !== 'HEAD') {
+			return null;
+		}
+
+		let pathname;
+		try {
+			pathname = decodeURIComponent(new URL(request.url, 'http://localhost').pathname);
+		} catch {
+			return null;
+		}
+
+		if (!pathname.startsWith(prefix)) {
+			return null;
+		}
+
+		pathname = pathname.slice(prefix.length) || '/';
+		if (!pathname.startsWith('/')) {
+			pathname = '/' + pathname;
+		}
+
+		const file_path = resolve_static_file_path(base_dir, pathname);
+		if (file_path === null || !existsSync(file_path)) {
+			return null;
+		}
+
+		let file_stats;
+		try {
+			file_stats = statSync(file_path);
+		} catch {
+			return null;
+		}
+
+		if (file_stats.isDirectory()) {
+			return null;
+		}
+
+		const headers = new Headers();
+		headers.set('Content-Type', get_mime_type(file_path));
+		headers.set('Content-Length', String(file_stats.size));
+		headers.set('Cache-Control', get_static_cache_control(pathname, maxAge, immutable));
+
+		if (request_method === 'HEAD') {
+			return new Response(null, { status: 200, headers });
+		}
+
+		/** @type {BodyInit} */
+		const file_body = /** @type {any} */ (Readable.toWeb(createReadStream(file_path)));
+		return new Response(file_body, { status: 200, headers });
+	};
+}
+
 /**
  * Create a middleware that serves static files from a directory
  *

package/tests/serve.test.js

@@ -322,12 +322,10 @@ describe('@ripple-ts/adapter-node serve()', () => {
 		}
 	});
 
-	it('serves files from ./public by default', async () => {
-		const temp_dir = mkdtempSync(join(tmpdir(), 'adapter-node-default-static-'));
+	it('serves files from ./ by default', async () => {
+		const temp_dir = mkdtempSync(join(tmpdir(), 'adapter-node-default-static-dir'));
 		try {
-			const public_dir = join(temp_dir, 'public');
-			mkdirSync(public_dir);
-			writeFileSync(join(public_dir, 'llms.txt'), 'hello llms');
+			writeFileSync(join(temp_dir, 'llms.txt'), 'hello llms');
 
 			const fetch_handler = vi.fn(() => new Response('fallback', { status: 404 }));
 
@@ -346,11 +344,9 @@ describe('@ripple-ts/adapter-node serve()', () => {
 	});
 
 	it('can disable default static serving via options.static = false', async () => {
-		const temp_dir = mkdtempSync(join(tmpdir(), 'adapter-node-default-static-disabled-'));
+		const temp_dir = mkdtempSync(join(tmpdir(), 'adapter-node-default-static-disabled-dir'));
 		try {
-			const public_dir = join(temp_dir, 'public');
-			mkdirSync(public_dir);
-			writeFileSync(join(public_dir, 'llms.txt'), 'hello llms');
+			writeFileSync(join(temp_dir, 'llms.txt'), 'hello llms');
 
 			const fetch_handler = vi.fn(() => new Response('fallback', { status: 404 }));
 

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "noEmit": true
+  },
+  "include": ["./src/**/*", "./tests/**/*"],
+  "exclude": ["dist", "node_modules"]
+}

package/types/index.d.ts

@@ -1,10 +1,19 @@
 import type {
 	AdapterCoreOptions,
+	RuntimePrimitives,
 	ServeFunction,
 	ServeStaticOptions as BaseServeStaticOptions,
 	ServeStaticDirectoryOptions as BaseServeStaticDirectoryOptions,
 } from '@ripple-ts/adapter';
 
+/**
+ * Node.js runtime primitives for the Ripple adapter contract.
+ *
+ * - `hash`: SHA-256 (truncated to 8 hex chars) via `node:crypto`
+ * - `createAsyncContext`: `AsyncLocalStorage` from `node:async_hooks`
+ */
+export const runtime: RuntimePrimitives;
+
 export type ServeOptions = AdapterCoreOptions & {
 	middleware?:
 		| ((
@@ -37,3 +46,21 @@ export const serve: ServeFunction<
  * Create a middleware that serves static files from a directory
  */
 export function serveStatic(dir: string, options?: ServeStaticOptions): StaticMiddleware;
+
+/**
+ * Convert a Node.js IncomingMessage to a Web Request.
+ */
+export function nodeRequestToWebRequest(
+	node_request: import('node:http').IncomingMessage,
+	signal: AbortSignal,
+	trust_proxy?: boolean,
+): Request;
+
+/**
+ * Write a Web Response to a Node.js ServerResponse.
+ */
+export function webResponseToNodeResponse(
+	web_response: Response,
+	node_response: import('node:http').ServerResponse,
+	request_method: string,
+): void;