@untestutils/next 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 s00d
+
+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/dist/index.d.mts

@@ -0,0 +1,14 @@
+import { type FrameworkBaseOptions } from "@untestutils/core";
+import { type Recipe } from "@untestutils/core";
+export type NextRun = "server" | "dev" | "static";
+export interface NextOptions extends FrameworkBaseOptions {
+	run?: NextRun;
+}
+/**
+* Next.js Recipe factory.
+* `run: 'server'` (default) — `next build` + `next start`
+* `run: 'dev'` — `next dev` (never shared)
+* `run: 'static'` — `next build` with export + staticDir on `out/`
+*/
+export declare function next(opts: NextOptions): Recipe;
+export default next;

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { type FrameworkBaseOptions } from '@untestutils/core';
+import { type Recipe } from '@untestutils/core';
+export type NextRun = 'server' | 'dev' | 'static';
+export interface NextOptions extends FrameworkBaseOptions {
+    run?: NextRun;
+}
+/**
+ * Next.js Recipe factory.
+ * `run: 'server'` (default) — `next build` + `next start`
+ * `run: 'dev'` — `next dev` (never shared)
+ * `run: 'static'` — `next build` with export + staticDir on `out/`
+ */
+export declare function next(opts: NextOptions): Recipe;
+export default next;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA4B,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,WAAY,SAAQ,oBAAoB;IACvD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAYD;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAsF9C;AAED,eAAe,IAAI,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,117 @@
+import { existsSync } from "node:fs";
+import { join, resolve } from "pathe";
+import { assertAppRoot, cliFrameworkRecipe, frameworkRoots, resolveBin, staticDir } from "@untestutils/core";
+import { defineRecipe, runCommand } from "@untestutils/core";
+function resolveNextBin(root) {
+	return resolveBin({
+		label: "next",
+		roots: frameworkRoots(root),
+		directIds: ["next/dist/bin/next"],
+		packageJsonIds: ["next/package.json"],
+		binRelative: ["dist/bin/next"]
+	});
+}
+
+export function next(opts) {
+	const root = resolve(opts.root);
+	const runMode = opts.run ?? "server";
+	const id = opts.id ?? `next-${runMode}-${root.split("/").pop()}`;
+	const bin = () => resolveNextBin(root);
+	if (runMode === "dev") {
+		return cliFrameworkRecipe({
+			id,
+			root,
+			label: "next",
+			share: "never",
+			env: opts.env,
+			hashInputs: opts.hashInputs ?? [root, "run:dev"],
+			readyPath: opts.readyPath,
+			readyTimeoutMs: opts.readyTimeoutMs,
+			start: ({ port }) => ({
+				command: process.execPath,
+				args: [
+					bin(),
+					"dev",
+					"-H",
+					"127.0.0.1",
+					"-p",
+					String(port)
+				],
+				cwd: root,
+				env: { PORT: String(port) }
+			})
+		});
+	}
+	if (runMode === "static") {
+		const ensureRoot = () => assertAppRoot(root, "next");
+		const recipe = defineRecipe({
+			id,
+			share: "always",
+			hashInputs: async () => [
+				...opts.hashInputs ?? [root],
+				"run:static",
+				...opts.env ? [`env:${JSON.stringify(opts.env)}`] : []
+			],
+			ready: async () => {},
+			prepare: async () => {
+				ensureRoot();
+				const nextBin = bin();
+				const result = await runCommand(process.execPath, [nextBin, "build"], {
+					cwd: root,
+					env: {
+						...process.env,
+						...opts.env
+					},
+					timeoutMs: opts.readyTimeoutMs ?? 3e5
+				});
+				if (result.exitCode !== 0) {
+					throw new Error(`[untestutils/next] static build failed:\n${result.stderr.slice(-2e3)}`);
+				}
+				const out = join(root, "out");
+				if (!existsSync(out)) {
+					throw new Error(`[untestutils/next] expected ${out} after static export (set output: 'export' in next.config)`);
+				}
+			},
+			start: async (ctx) => {
+				ensureRoot();
+				const publicDir = join(root, "out");
+				const serving = staticDir({
+					id: `${id}-static-serve`,
+					root: publicDir
+				});
+				return serving.start(ctx);
+			}
+		});
+		recipe.root = root;
+		return recipe;
+	}
+	return cliFrameworkRecipe({
+		id,
+		root,
+		label: "next",
+		share: "always",
+		env: opts.env,
+		hashInputs: opts.hashInputs ?? [root, "run:server"],
+		readyPath: opts.readyPath,
+		readyTimeoutMs: opts.readyTimeoutMs,
+		prepare: () => ({
+			command: process.execPath,
+			args: [bin(), "build"],
+			cwd: root
+		}),
+		start: ({ port }) => ({
+			command: process.execPath,
+			args: [
+				bin(),
+				"start",
+				"-H",
+				"127.0.0.1",
+				"-p",
+				String(port)
+			],
+			cwd: root,
+			env: { PORT: String(port) }
+		})
+	});
+}
+export default next;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@untestutils/next",
+  "version": "0.5.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "pathe": "^2.0.3",
+    "@untestutils/core": "0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.1",
+    "publint": "^0.3.24",
+    "typescript": "^6.0.3",
+    "obuild": "^0.4.40"
+  },
+  "peerDependencies": {
+    "next": "*",
+    "react": "*",
+    "react-dom": "*"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "homepage": "https://s00d.github.io/untestutils/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/s00d/untestutils.git",
+    "directory": "packages/next"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "obuild && tsc -p tsconfig.build.json",
+    "publint": "publint --strict"
+  }
+}