open-nest 0.0.0-stage → 0.0.1

package/dist/express.d.mts

@@ -0,0 +1,61 @@
+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

@@ -0,0 +1,46 @@
+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

@@ -0,0 +1,61 @@
+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

@@ -0,0 +1,46 @@
+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 };

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "open-nest",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Makes Nest applications compatible with Web Standard Request/Response handlers (Bun, Cloudflare, ...).",
+  "files": [
+    "package.json",
+    "readme.md",
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./fastify": {
+      "types": "./dist/fastify.d.mts",
+      "import": "./dist/fastify.mjs"
+    },
+    "./express": {
+      "types": "./dist/express.d.mts",
+      "import": "./dist/express.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown --clean",
+    "typecheck": "bun check",
+    "test": "bun test",
+    "lint": "oxlint --type-aware && oxfmt --check",
+    "format": "oxlint --fix --fix-suggestions && oxfmt"
+  },
+  "dependencies": {
+    "light-my-request": "6.8.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/core": "0.18.5",
+    "@types/bun": "latest",
+    "@types/node": "26.6.5",
+    "oxfmt": "0.66.0",
+    "oxlint": "1.81.0",
+    "oxlint-tsgolint": "7.0.2001",
+    "publint": "0.3.24",
+    "tsdown": "0.23.0",
+    "tsup": "8.5.1",
+    "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",
+    "reflect-metadata": "^0.1.12 || ^0.2.0",
+    "rxjs": "^7.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/platform-express": {
+      "optional": true
+    },
+    "@nestjs/platform-fastify": {
+      "optional": true
+    }
+  }
+}

package/readme.md

@@ -0,0 +1,94 @@
+# `open-nest`
+
+Turn a Nest application into a Web fetch handler. Pass a `Request`, get a `Response`, without calling `listen()`.
+
+## Installation
+
+```bash
+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.
+
+## 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 });
+
+await Bun.serve({
+  fetch,
+  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.
+
+You can close the Nest app and clear the cache with `fetch.close()`.
+
+```ts
+await fetch.close();
+```
+
+#### Configure
+
+`configure` runs after the app is created and before `init`. Use it for pipes, a global prefix, CORS, and the other app methods.
+
+```ts
+const fetch = createFetcher({
+  module: AppModule,
+  configure: (app) => {
+    app.setGlobalPrefix("api");
+  },
+});
+```
+
+#### Nest options
+
+`opts` is forwarded to `NestFactory.create` as `NestApplicationOptions`. When omitted, Nest keeps its own defaults.
+
+```ts
+const fetch = createFetcher({
+  module: AppModule,
+  opts: { logger: ["error", "warn"] },
+});
+```
+
+## Lifecycle
+
+#### Develop
+
+```bash
+bun dev
+```
+
+#### Test
+
+```bash
+bun test
+```
+
+#### Build
+
+```bash
+bun run build
+```
+
+#### Typecheck
+
+```bash
+bun typecheck
+```
+
+#### Lint / Format
+
+```bash
+bun lint
+bun format
+```

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.