open-nest 0.0.1 → 0.0.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "open-nest",
-  "version": "0.0.1",
-  "description": "Makes Nest applications compatible with Web Standard Request/Response handlers (Bun, Cloudflare, ...).",
+  "version": "0.0.2",
+  "description": "Run any Nest application as a Web-Standard Request/Response handler. First class support for Bun, Node, and Cloudflare Workers.",
   "files": [
     "package.json",
     "readme.md",
@@ -10,13 +10,21 @@
   "type": "module",
   "sideEffects": false,
   "exports": {
-    "./fastify": {
-      "types": "./dist/fastify.d.mts",
-      "import": "./dist/fastify.mjs"
+    ".": {
+      "types": "./dist/fetch.d.mts",
+      "import": "./dist/fetch.mjs"
     },
-    "./express": {
-      "types": "./dist/express.d.mts",
-      "import": "./dist/express.mjs"
+    "./bun": {
+      "types": "./dist/bun.d.mts",
+      "import": "./dist/bun.mjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.mts",
+      "import": "./dist/node.mjs"
+    },
+    "./workers": {
+      "types": "./dist/workers.d.mts",
+      "import": "./dist/workers.mjs"
     },
     "./package.json": "./package.json"
   },
@@ -26,36 +34,58 @@
     "typecheck": "bun check",
     "test": "bun test",
     "lint": "oxlint --type-aware && oxfmt --check",
-    "format": "oxlint --fix --fix-suggestions && oxfmt"
+    "format": "oxlint --fix --fix-suggestions && oxfmt",
+    "example:bun": "bun examples/bun/index.ts",
+    "example:bun-websockets": "bun examples/bun-websockets/index.ts",
+    "example:node": "node --no-strip-types --import tsx examples/node/index.ts",
+    "example:node-websockets": "node --no-strip-types --import tsx examples/node-websockets/index.ts",
+    "example:workers": "bunx wrangler dev --config examples/workers/wrangler.jsonc --tsconfig ../../tsconfig.json"
   },
   "dependencies": {
-    "light-my-request": "6.8.0"
+    "ws": "8.22.0"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "0.18.5",
+    "@nats-io/transport-node": "3.4.0",
+    "@nestjs/common": "12.1.3",
+    "@nestjs/core": "12.1.3",
+    "@nestjs/microservices": "12.1.3",
+    "@nestjs/platform-express": "12.1.3",
+    "@nestjs/platform-socket.io": "12.1.3",
+    "@nestjs/websockets": "12.1.3",
     "@types/bun": "latest",
+    "@types/express": "5.0.6",
     "@types/node": "26.6.5",
-    "oxfmt": "0.66.0",
-    "oxlint": "1.81.0",
-    "oxlint-tsgolint": "7.0.2001",
-    "publint": "0.3.24",
+    "@types/ws": "8.18.2",
+    "amqp-connection-manager": "5.0.0",
+    "amqplib": "2.2.0",
+    "class-transformer": "0.5.1",
+    "class-validator": "0.15.1",
+    "express": "5.3.0",
+    "helmet": "8.3.0",
+    "ioredis": "6.0.0",
+    "kafkajs": "2.2.4",
+    "mqtt": "5.16.0",
+    "oxfmt": "0.72.0",
+    "oxlint": "1.87.0",
+    "oxlint-tsgolint": "7.0.2003",
+    "publint": "0.3.25",
+    "reflect-metadata": "0.2.2",
+    "rxjs": "7.8.2",
     "tsdown": "0.23.0",
     "tsup": "8.5.1",
+    "tsx": "4.23.15",
     "typescript": "7.0.2"
   },
   "peerDependencies": {
     "@nestjs/common": "^12.0.0",
     "@nestjs/core": "^12.0.0",
-    "@nestjs/platform-express": "^12.0.0",
-    "@nestjs/platform-fastify": "^12.0.0",
+    "@nestjs/websockets": "^12.0.0",
     "reflect-metadata": "^0.1.12 || ^0.2.0",
     "rxjs": "^7.1.0"
   },
   "peerDependenciesMeta": {
-    "@nestjs/platform-express": {
-      "optional": true
-    },
-    "@nestjs/platform-fastify": {
+    "@nestjs/websockets": {
       "optional": true
     }
   }

package/readme.md

@@ -1,6 +1,13 @@
 # `open-nest`
 
-Turn a Nest application into a Web fetch handler. Pass a `Request`, get a `Response`, without calling `listen()`.
+[![Workers](https://img.shields.io/badge/WORKERS-000000?style=for-the-badge&logo=cloudflareworkers&logoColor=white)](https://workers.cloudflare.com)
+[![Bun](https://img.shields.io/badge/BUN-000000?style=for-the-badge&logo=bun&logoColor=white)](https://bun.sh)
+[![Node](https://img.shields.io/badge/NODE-000000?style=for-the-badge&logo=nodedotjs&logoColor=white)](https://nodejs.org)<br>
+[![Validate](https://github.com/juriadams/open-nest/actions/workflows/validate.yml/badge.svg)](https://github.com/juriadams/open-nest/actions/workflows/validate.yml)
+[![npm version](https://img.shields.io/npm/v/open-nest)](https://www.npmjs.com/package/open-nest)
+[![bundle size](https://img.shields.io/bundlejs/size/open-nest)](https://bundlejs.com/?q=open-nest)
+
+Run any Nest application as a Web-Standard `Request`/`Response` handler. First class support for **Bun**, **Node**, and **Cloudflare Workers**.
 
 ## Installation
 
@@ -8,87 +15,178 @@ Turn a Nest application into a Web fetch handler. Pass a `Request`, get a `Respo
 bun add open-nest
 ```
 
-Nest, `reflect-metadata`, `rxjs`, and your platform package are peer dependencies. An existing Nest app already has them. Import `open-nest/fastify` or `open-nest/express` to match the platform you use.
+Peer dependencies are `@nestjs/common`, `@nestjs/core`, `reflect-metadata`, and `rxjs`. WebSocket gateways also need `@nestjs/websockets`. These should already ship with your Nest installation.
+
+## Examples
+
+- [`examples/workers`](/examples/workers)<br />
+  <sup>[readme](/examples/workers/readme.md) ⋅ [code](/examples/workers/)</sup><br />
+  Run a Nest application on Cloudflare Workers.
+
+- [`examples/bun`](/examples/bun)<br />
+  <sup>[readme](/examples/bun/readme.md) ⋅ [code](/examples/bun/)</sup><br />
+  Run a Nest application via `Bun.serve`.
+
+- [`examples/bun-websockets`](/examples/bun-websockets)<br />
+  <sup>[readme](/examples/bun-websockets/readme.md) ⋅ [code](/examples/bun-websockets/)</sup><br />
+  Run a Nest application via `Bun.serve` with WebSockets.
+
+- [`examples/node`](/examples/node)<br />
+  <sup>[readme](/examples/node/readme.md) ⋅ [code](/examples/node/)</sup><br />
+  Run a Nest application via `http.Server`.
+
+- [`examples/node-websockets`](/examples/node-websockets)<br />
+  <sup>[readme](/examples/node-websockets/readme.md) ⋅ [code](/examples/node-websockets/)</sup><br />
+  Run a Nest application via `http.Server` with WebSockets.
 
 ## Usage
 
 ```ts
 import "reflect-metadata";
-import { Controller, Get, Module } from "@nestjs/common";
-import { createFetcher } from "open-nest/fastify";
-import { AppModule } from "@/app.module";
 
-const fetch = createFetcher({ module: AppModule });
+import { createFetcher } from "open-nest";
+
+import { AppModule } from "@/app/module";
+
+const fetcher = createFetcher({ module: AppModule });
 
 await Bun.serve({
-  fetch,
+  fetch: fetcher,
   port: 3000,
 });
 ```
 
-Express follows the same pattern, imported from `open-nest/express`.
-
-The Nest app boots on the first request and its instance is cached for all further requests.
+`createFetcher` from `open-nest` is the HTTP entry. It returns a function from `Request` to `Response`. WebSocket gateways and static files are available for the respective runtime under `open-nest/bun` and `open-nest/node`.
 
-You can close the Nest app and clear the cache with `fetch.close()`.
+### Bun
 
 ```ts
-await fetch.close();
-```
+import "reflect-metadata";
 
-#### Configure
+import { BunWsAdapter, createBunServer } from "open-nest/bun";
 
-`configure` runs after the app is created and before `init`. Use it for pipes, a global prefix, CORS, and the other app methods.
+import { AppModule } from "@/app/module";
 
-```ts
-const fetch = createFetcher({
+await createBunServer({
   module: AppModule,
+  port: 3000,
   configure: (app) => {
-    app.setGlobalPrefix("api");
+    app.useWebSocketAdapter(new BunWsAdapter());
+    app.useStaticAssets("public", { prefix: "/static" });
   },
 });
 ```
 
-#### Nest options
+`createBunServer` from `open-nest/bun` serves that handler with `Bun.serve`. It upgrades gateway paths and serves files with `Bun.file()`.
 
-`opts` is forwarded to `NestFactory.create` as `NestApplicationOptions`. When omitted, Nest keeps its own defaults.
+- `createBunServer` initializes the Nest application once and starts and returns a `Bun.serve` instance.
+- `BunWsAdapter` is the Nest WebSocket adapter. `Bun.serve` performs the upgrade.
+- `BunAdapter` extends `FetchAdapter` and implements `useStaticAssets` with `Bun.file()`.
+
+### Node
 
 ```ts
-const fetch = createFetcher({
+import "reflect-metadata";
+
+import { createNodeServer, NodeWsAdapter } from "open-nest/node";
+
+import { AppModule } from "@/app/module";
+
+await createNodeServer({
   module: AppModule,
-  opts: { logger: ["error", "warn"] },
+  port: 3000,
+  configure: (app) => {
+    app.useWebSocketAdapter(new NodeWsAdapter());
+    app.useStaticAssets("public", { prefix: "/static" });
+  },
 });
 ```
 
-## Lifecycle
+`createNodeServer` from `open-nest/node` initializes the Nest application and starts and returns a `http.Server` instance. HTTP uses `node:http`, `node:stream`, and `node:fs` (`openAsBlob`).
 
-#### Develop
+Gateway upgrades go through [`ws`](https://github.com/websockets/ws). The WebSocket client is the global `WebSocket` from Node 22 onward.
 
-```bash
-bun dev
-```
+- `createNodeServer` initializes the Nest application once and starts and returns a `http.Server` instance.
+- `NodeWsAdapter` is the Nest WebSocket adapter. Upgrades go through `ws`.
+- `NodeAdapter` extends `FetchAdapter` and implements `useStaticAssets` with `node:fs`.
 
-#### Test
+### Workers
 
-```bash
-bun test
+```ts
+import "reflect-metadata";
+
+import {
+  createWorkerFetcher,
+  workerContext,
+  type WorkerExecutionContext,
+} from "open-nest/workers";
+
+interface Env {
+  APP_NAME: string;
+  CACHE: KVNamespace;
+}
+
+@Controller()
+class AppController {
+  @Get()
+  async index() {
+    const { env, ctx } = workerContext<Env>();
+    const lastOpenedAt = await env.CACHE.get("last-opened-at");
+
+    ctx.waitUntil(env.CACHE.put("last-opened-at", new Date().toISOString()));
+
+    return { data: { app: env.APP_NAME, lastOpenedAt }, error: null };
+  }
+}
+
+@Module({ controllers: [AppController] })
+class AppModule {}
+
+const fetcher = createWorkerFetcher<Env>({ module: AppModule });
+
+export default {
+  fetch: (request: Request, env: Env, ctx: WorkerExecutionContext) =>
+    fetcher(request, env, ctx),
+};
 ```
 
-#### Build
+`createWorkerFetcher` from `open-nest/workers` initializes the Nest application and returns a handler of `(request, env, ctx)`.
 
-```bash
-bun run build
+Pass bindings and the execution context through, then read them with `workerContext()` from a controller or provider. The Worker needs the `nodejs_compat` compatibility flag.
+
+- `createWorkerFetcher` initializes the Nest application once and returns a handler of `(request, env, ctx)`.
+- `workerContext()` reads the bindings and the raw execution context for the request in flight.
+- `WorkerExecutionContext` is the `ctx` argument: `waitUntil`, `passThroughOnException`, and `props`.
+
+### App Configuration
+
+```ts
+const fetcher = createFetcher({
+  module: AppModule,
+  configure: (app) => {
+    app.enableCors();
+    app.setGlobalPrefix("api");
+  },
+});
 ```
 
-#### Typecheck
+`configure` runs after the app is created and before `init`. Use it for pipes, a global prefix, CORS, and the other app methods.
+
+### App Instance
 
-```bash
-bun typecheck
+```ts
+const app = await fetcher.app();
 ```
 
-#### Lint / Format
+`app()` resolves the underlying Nest application.
 
-```bash
-bun lint
-bun format
+#### Nest Options
+
+```ts
+const fetcher = createFetcher({
+  module: AppModule,
+  opts: { logger: ["error", "warn"] },
+});
 ```
+
+`opts` is forwarded to `NestFactory.create` as `NestApplicationOptions`. When omitted, Nest keeps its own defaults.

package/dist/express.d.mts

@@ -1,61 +0,0 @@
-import { NestExpressApplication } from "@nestjs/platform-express";
-import { NestApplicationOptions, Type } from "@nestjs/common";
-//#region src/adapters/express/index.d.ts
-/**
- * Options for {@link createFetcher}.
- */
-export interface CreateHandlerOptions {
-  /**
-   * Root Nest module.
-   */
-  module: Type<any>;
-  /**
-   * Optional hook to configure the app before init (pipes, prefix, cors, ...).
-   *
-   * @example
-   * ```ts
-   * const fetch = createFetcher({
-   *   module: AppModule,
-   *   configure: (app) => {
-   *     app.use(cors());
-   *     app.use(bodyParser.json());
-   *   },
-   * });
-   * ```
-   */
-  configure?: (app: NestExpressApplication) => void | Promise<void>;
-  /**
-   * Optional Nest factory options.
-   *
-   * @example
-   * ```ts
-   * const fetch = createFetcher({
-   *   module: AppModule,
-   *   opts: { logger: ["error", "warn"] },
-   * });
-   * ```
-   */
-  opts?: NestApplicationOptions;
-}
-export interface Fetcher {
-  (request: Request): Promise<Response>;
-  /**
-   * Resolves the underlying Nest app instance.
-   * @example
-   * ```ts
-   * const app = await fetch.app();
-   * ```
-   */
-  app(): Promise<NestExpressApplication>;
-  /**
-   * Closes the underlying Nest app.
-   *
-   * @example
-   * ```ts
-   * await fetch.close();
-   * ```
-   */
-  close(): Promise<void>;
-}
-export declare function createFetcher({ module, configure, opts }: CreateHandlerOptions): Fetcher;
-//#endregion

package/dist/express.mjs

@@ -1,46 +0,0 @@
-import { NestFactory } from "@nestjs/core";
-import { ExpressAdapter } from "@nestjs/platform-express";
-import inject from "light-my-request";
-//#region src/adapters/express/index.ts
-function createFetcher({ module, configure, opts }) {
-	let pending;
-	const instance = () => {
-		if (pending) return pending;
-		pending = (async () => {
-			const app = await NestFactory.create(module, new ExpressAdapter(), opts);
-			await configure?.(app);
-			await app.init();
-			return app;
-		})();
-		return pending;
-	};
-	const handler = (async (request) => {
-		const app = await instance();
-		const url = new URL(request.url);
-		const hasBody = !["GET", "HEAD"].includes(request.method);
-		const res = await inject(app.getHttpAdapter().getInstance(), {
-			method: request.method,
-			url: url.pathname + url.search,
-			headers: Object.fromEntries(request.headers),
-			payload: hasBody ? Buffer.from(await request.arrayBuffer()) : void 0
-		});
-		const headers = new Headers();
-		for (const [k, v] of Object.entries(res.headers)) {
-			if (k === "content-length" || k === "transfer-encoding") continue;
-			if (Array.isArray(v)) v.forEach((x) => headers.append(k, x));
-			else if (v != null) headers.set(k, String(v));
-		}
-		return new Response(res.rawPayload, {
-			status: res.statusCode,
-			headers
-		});
-	});
-	handler.app = instance;
-	handler.close = async () => {
-		if (pending) await (await pending).close();
-		pending = void 0;
-	};
-	return handler;
-}
-//#endregion
-export { createFetcher };

package/dist/fastify.d.mts

@@ -1,61 +0,0 @@
-import { NestFastifyApplication } from "@nestjs/platform-fastify";
-import { NestApplicationOptions, Type } from "@nestjs/common";
-//#region src/adapters/fastify/index.d.ts
-/**
- * Options for {@link createFetcher}.
- */
-export interface CreateHandlerOptions {
-  /**
-   * Root Nest module.
-   */
-  module: Type<any>;
-  /**
-   * Optional hook to configure the app before init (pipes, prefix, cors, ...).
-   *
-   * @example
-   * ```ts
-   * const fetch = createFetcher({
-   *   module: AppModule,
-   *   configure: (app) => {
-   *     app.use(cors());
-   *     app.use(bodyParser.json());
-   *   },
-   * });
-   * ```
-   */
-  configure?: (app: NestFastifyApplication) => void | Promise<void>;
-  /**
-   * Optional Nest factory options.
-   *
-   * @example
-   * ```ts
-   * const fetch = createFetcher({
-   *   module: AppModule,
-   *   opts: { logger: ["error", "warn"] },
-   * });
-   * ```
-   */
-  opts?: NestApplicationOptions;
-}
-export interface Fetcher {
-  (request: Request): Promise<Response>;
-  /**
-   * Resolves the underlying Nest app instance.
-   * @example
-   * ```ts
-   * const app = await fetch.app();
-   * ```
-   */
-  app(): Promise<NestFastifyApplication>;
-  /**
-   * Closes the underlying Nest app.
-   *
-   * @example
-   * ```ts
-   * await fetch.close();
-   * ```
-   */
-  close(): Promise<void>;
-}
-export declare function createFetcher({ module, configure, opts }: CreateHandlerOptions): Fetcher;
-//#endregion

package/dist/fastify.mjs

@@ -1,46 +0,0 @@
-import { NestFactory } from "@nestjs/core";
-import { FastifyAdapter } from "@nestjs/platform-fastify";
-//#region src/adapters/fastify/index.ts
-function createFetcher({ module, configure, opts }) {
-	let pending;
-	const instance = () => {
-		if (pending) return pending;
-		pending = (async () => {
-			const app = await NestFactory.create(module, new FastifyAdapter(), opts);
-			await configure?.(app);
-			await app.init();
-			await app.getHttpAdapter().getInstance().ready();
-			return app;
-		})();
-		return pending;
-	};
-	const handler = (async (request) => {
-		const app = await instance();
-		const url = new URL(request.url);
-		const hasBody = !["GET", "HEAD"].includes(request.method);
-		const res = await app.getHttpAdapter().getInstance().inject({
-			method: request.method,
-			url: url.pathname + url.search,
-			headers: Object.fromEntries(request.headers),
-			payload: hasBody ? Buffer.from(await request.arrayBuffer()) : void 0
-		});
-		const headers = new Headers();
-		for (const [k, v] of Object.entries(res.headers)) {
-			if (k === "content-length" || k === "transfer-encoding") continue;
-			if (Array.isArray(v)) v.forEach((x) => headers.append(k, x));
-			else if (v != null) headers.set(k, String(v));
-		}
-		return new Response(res.rawPayload, {
-			status: res.statusCode,
-			headers
-		});
-	});
-	handler.app = instance;
-	handler.close = async () => {
-		if (pending) await (await pending).close();
-		pending = void 0;
-	};
-	return handler;
-}
-//#endregion
-export { createFetcher };