@fedify/init 2.4.0-dev.1797 → 2.4.0-dev.1827

package/dist/action/patch.js

@@ -3,7 +3,7 @@ import { createFile, throwUnlessNotExists } from "../lib.js";
 import { displayFile, noticeFilesToCreate, noticeFilesToInsert } from "./notice.js";
 import { joinDir, stringifyEnvs } from "./utils.js";
 import { devToolConfigs, loadDenoConfig, loadOxfmtConfig, loadOxlintConfig, loadPackageJson, loadTsConfig, loadVscodeExtensions, loadVscodeSettings } from "./configs.js";
-import { getImports, loadFederation, loadLogging } from "./templates.js";
+import { getImports, loadFederation, loadLogging, loadTest } from "./templates.js";
 import { always, apply, entries, map, pipe, pipeLazy, tap } from "@fxts/core";
 import { toMerged } from "es-toolkit";
 import { access, readFile } from "node:fs/promises";
@@ -80,6 +80,7 @@ const getFiles = async (data) => ({
 		...data
 	}),
 	[data.initializer.loggingFile]: await loadLogging(data),
+	[data.initializer.testFile]: await loadTest(data),
 	".env": stringifyEnvs(data.env),
 	...data.initializer.files
 });
@@ -119,6 +120,7 @@ const getJsons = (data) => {
 const getGeneratedFilePaths = (data) => [
 	data.initializer.federationFile,
 	data.initializer.loggingFile,
+	data.initializer.testFile,
 	".env",
 	...Object.keys(data.initializer.files ?? {}),
 	...Object.keys(getJsons(data)),

package/dist/action/templates.js

@@ -1,5 +1,5 @@
 import { replace } from "../utils.js";
-import { readTemplate } from "../lib.js";
+import { getDevCommand, readTemplate } from "../lib.js";
 import { needsDenoDotenv } from "./utils.js";
 import { concat, entries, join, map, pipe, when } from "@fxts/core";
 import { toMerged } from "es-toolkit";
@@ -30,6 +30,18 @@ const getFederationTemplate = (packageManager) => packageManager === "deno" ? "d
 */
 const loadLogging = async ({ projectName, initializer }) => pipe(await readTemplate(initializer.loggingTemplate ?? "defaults/logging.ts"), replace(/\/\* project name \*\//, JSON.stringify(projectName)));
 /**
+* Loads the smoke-test script content for the initializer.
+*
+* Every framework shares the same *defaults/smoke.test.ts* template, so unlike
+* {@link loadLogging} there is no per-framework template override.  The
+* template spawns the project's own dev server, so it needs the dev command
+* for the chosen package manager baked in at generation time.
+*
+* @param param0 - {@link InitCommandData} containing `packageManager`
+* @returns The complete smoke-test script content as a string
+*/
+const loadTest = async ({ packageManager }) => pipe(await readTemplate("defaults/smoke.test.ts"), replace(/\/\* dev command \*\//, JSON.stringify(getDevCommand(packageManager).split(" ")).replaceAll(",", ", ")));
+/**
 * Generates import statements for KV store and message queue dependencies.
 * Merges imports from both KV and MQ configurations and creates proper
 * ES module import syntax.
@@ -75,4 +87,4 @@ const ENV_REG_EXP = /process\.env\.(\w+)/g;
 */
 const convertEnv = (obj, pm) => pm === "deno" && ENV_REG_EXP.test(obj) ? obj.replaceAll(ENV_REG_EXP, (_, g1) => `Deno.env.get("${g1}")`) : obj;
 //#endregion
-export { convertEnv, getAlias, getImports, loadFederation, loadLogging };
+export { convertEnv, getAlias, getImports, loadFederation, loadLogging, loadTest };

package/dist/ask/kv.js

@@ -1,6 +1,6 @@
+import { KV_STORE } from "../const.js";
 import { printErrorMessage } from "../utils.js";
 import { isTest, kvStores } from "../lib.js";
-import { KV_STORE } from "../const.js";
 import { select } from "@inquirer/prompts";
 import { pipe, tap, throwError, unless, when } from "@fxts/core/index.js";
 //#region src/ask/kv.ts

package/dist/ask/mq.js

@@ -1,6 +1,6 @@
+import { MESSAGE_QUEUE } from "../const.js";
 import { printErrorMessage } from "../utils.js";
 import { isTest, messageQueues } from "../lib.js";
-import { MESSAGE_QUEUE } from "../const.js";
 import { select } from "@inquirer/prompts";
 import { pipe, tap, throwError, unless, when } from "@fxts/core/index.js";
 //#region src/ask/mq.ts

package/dist/ask/pm.js

@@ -1,46 +1,64 @@
-import { getInstallUrl, isPackageManagerAvailable, kvStores, messageQueues, packageManagers, runtimes } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { printErrorMessage } from "../utils.js";
+import { checkAllRuntimes, getInstallUrl, isPackageManagerAvailable, isTest, runtimes } from "../lib.js";
+import { pmToRt } from "../webframeworks/utils.js";
 import webFrameworks from "../webframeworks/mod.js";
-import { pipe, when } from "@fxts/core";
+import process from "node:process";
 import { select } from "@inquirer/prompts";
-import { message } from "@optique/core/message";
+import { message, optionName, text } from "@optique/core/message";
 import { print } from "@optique/run";
 //#region src/ask/pm.ts
 /**
 * Fills in the package manager by prompting the user if not provided.
-* Ensures the selected package manager is compatible with the chosen web framework.
-* If the selected package manager is not installed, informs the user and prompts again.
+* Ensures the selected package manager is compatible with the chosen web
+* framework and installed on the system. When an explicitly requested package
+* manager is unavailable, informs the user and prompts again.
 *
 * @param options - Initialization options possibly containing a packageManager and webFramework
 * @returns A promise resolving to options with a guaranteed packageManager
 */
 const fillPackageManager = async ({ packageManager, ...options }) => {
-	const pm = packageManager ?? await askPackageManager(options.webFramework);
-	if (await isPackageManagerAvailable(pm)) return {
+	const choices = await calculateChoices(options.webFramework);
+	if (packageManager != null) {
+		const choice = choices.find(({ value }) => value === packageManager);
+		if (choice.disabled == null) return {
+			...options,
+			packageManager
+		};
+		print(message`${optionName(choice.name)} ${text(choice.disabled)}`);
+		if (isTest(options)) process.exit(1);
+	}
+	return {
 		...options,
-		packageManager: pm
+		packageManager: await askPackageManager(choices)
 	};
-	noticeInstallUrl(pm);
-	return await fillPackageManager(options);
 };
-const askPackageManager = (wf) => select({
+const calculateChoices = async (wf) => {
+	const runtimeChecks = await checkAllRuntimes(webFrameworks[wf].minRuntimeVersions);
+	const choices = await Promise.all(PACKAGE_MANAGER.map(choicePackageManager(wf, runtimeChecks)));
+	if (choices.every((choice) => choice.disabled)) {
+		printErrorMessage`No package manager with a supported runtime is available for ${webFrameworks[wf].label}.`;
+		process.exit(1);
+	}
+	return choices;
+};
+const askPackageManager = (choices) => select({
 	message: "Choose the package manager to use",
-	choices: PACKAGE_MANAGER.map(choicePackageManager(wf))
-});
-const choicePackageManager = (wf) => (value) => ({
-	name: isWfSupportsPm(wf, value) ? value : `${value} (not supported with ${webFrameworks[wf].label})`,
-	value,
-	disabled: !isWfSupportsPm(wf, value)
+	choices
 });
-const isWfSupportsPm = (wf, pm) => webFrameworks[wf].packageManagers.includes(pm);
-const noticeInstallUrl = (pm) => {
-	const label = getLabel(pm);
-	const url = getInstallUrl(pm);
-	print(message`  Package manager ${label} is not installed.`);
-	print(message`  You can install it from following link: ${url}`);
-	print(message`  or choose another package manager:`);
+const choicePackageManager = (wf, runtimeChecks) => async (value) => {
+	const check = runtimeChecks[pmToRt(value)];
+	const label = runtimes[pmToRt(value)].label;
+	const disabled = !isWfSupportsPm(wf, value) ? `not supported with ${webFrameworks[wf].label}` : check.status === "unsupported" ? `requires ${label} ${check.required} or later (detected: ${check.detected})` : check.status === "missing" ? `requires ${label} which is not installed` : check.status === "malformed" ? `could not detect ${label} version` : pmToRt(value) === "node" && !await isPackageManagerAvailable(value) ? `is not installed; install it from ${getInstallUrl(value)}` : "";
+	return disabled === "" ? {
+		name: value,
+		value
+	} : {
+		name: value,
+		value,
+		disabled
+	};
 };
-const getLabel = (name) => pipe(name, whenHasLabel(webFrameworks), whenHasLabel(packageManagers), whenHasLabel(messageQueues), whenHasLabel(kvStores), whenHasLabel(runtimes));
-const whenHasLabel = (desc) => when((name) => name in desc, (name) => desc[name].label);
+const isWfSupportsPm = (wf, pm) => webFrameworks[wf].packageManagers.includes(pm);
 //#endregion
 export { fillPackageManager as default };

package/dist/const.js

@@ -1,5 +1,6 @@
 import kv_default from "./json/kv.js";
 import mq_default from "./json/mq.js";
+import rt_default from "./json/rt.js";
 //#region src/const.ts
 /** All supported package manager identifiers, in display order. */
 const PACKAGE_MANAGER = [
@@ -26,6 +27,8 @@ const WEB_FRAMEWORK = [
 const MESSAGE_QUEUE = Object.keys(mq_default);
 /** All supported key-value store backend identifiers. */
 const KV_STORE = Object.keys(kv_default);
+/** All supported runtime identifiers. */
+const RUNTIME = Object.keys(rt_default);
 /**
 * External database services that need to be running for integration tests.
 * Used by the test suite to check service availability before running tests.
@@ -37,4 +40,4 @@ const DB_TO_CHECK = [
 	"amqp"
 ];
 //#endregion
-export { DB_TO_CHECK, KV_STORE, MESSAGE_QUEUE, PACKAGE_MANAGER, WEB_FRAMEWORK };
+export { DB_TO_CHECK, KV_STORE, MESSAGE_QUEUE, PACKAGE_MANAGER, RUNTIME, WEB_FRAMEWORK };

package/dist/deno.js

@@ -1,4 +1,4 @@
 //#region deno.json
-var version = "2.4.0-dev.1797+6c3f0b36";
+var version = "2.4.0-dev.1827+b66cedd5";
 //#endregion
 export { version };

package/dist/json/rt.js

@@ -3,27 +3,20 @@ var rt_default = {
 	deno: {
 		"label": "Deno",
 		"checkCommand": ["deno", "--version"],
-		"outputPattern": "^deno\\s+\\d+\\.\\d+\\.\\d+\\b"
+		"outputPattern": "^deno\\s+(\\d+\\.\\d+\\.\\d+\\b)",
+		"minVersion": "2.0.0"
 	},
 	bun: {
 		"label": "Bun",
 		"checkCommand": ["bun", "--version"],
-		"outputPattern": "^\\d+\\.\\d+\\.\\d+$"
+		"outputPattern": "^(\\d+\\.\\d+\\.\\d+\\b)",
+		"minVersion": "1.1.0"
 	},
-	pnpm: {
+	node: {
 		"label": "Node.js",
 		"checkCommand": ["node", "--version"],
-		"outputPattern": "^v\\d+\\.\\d+\\.\\d+$"
-	},
-	yarn: {
-		"label": "Node.js",
-		"checkCommand": ["node", "--version"],
-		"outputPattern": "^v\\d+\\.\\d+\\.\\d+$"
-	},
-	npm: {
-		"label": "Node.js",
-		"checkCommand": ["node", "--version"],
-		"outputPattern": "^v\\d+\\.\\d+\\.\\d+$"
+		"outputPattern": "^v(\\d+\\.\\d+\\.\\d+\\b)",
+		"minVersion": "22.0.0"
 	}
 };
 //#endregion

package/dist/json/rt.json

@@ -5,7 +5,8 @@
       "deno",
       "--version"
     ],
-    "outputPattern": "^deno\\s+\\d+\\.\\d+\\.\\d+\\b"
+    "outputPattern": "^deno\\s+(\\d+\\.\\d+\\.\\d+\\b)",
+    "minVersion": "2.0.0"
   },
   "bun": {
     "label": "Bun",
@@ -13,30 +14,16 @@
       "bun",
       "--version"
     ],
-    "outputPattern": "^\\d+\\.\\d+\\.\\d+$"
+    "outputPattern": "^(\\d+\\.\\d+\\.\\d+\\b)",
+    "minVersion": "1.1.0"
   },
-  "pnpm": {
+  "node": {
     "label": "Node.js",
     "checkCommand": [
       "node",
       "--version"
     ],
-    "outputPattern": "^v\\d+\\.\\d+\\.\\d+$"
-  },
-  "yarn": {
-    "label": "Node.js",
-    "checkCommand": [
-      "node",
-      "--version"
-    ],
-    "outputPattern": "^v\\d+\\.\\d+\\.\\d+$"
-  },
-  "npm": {
-    "label": "Node.js",
-    "checkCommand": [
-      "node",
-      "--version"
-    ],
-    "outputPattern": "^v\\d+\\.\\d+\\.\\d+$"
+    "outputPattern": "^v(\\d+\\.\\d+\\.\\d+\\b)",
+    "minVersion": "22.0.0"
   }
 }

package/dist/lib.js

@@ -1,8 +1,9 @@
 import { version } from "./deno.js";
 import kv_default from "./json/kv.js";
 import mq_default from "./json/mq.js";
-import pm_default from "./json/pm.js";
 import rt_default from "./json/rt.js";
+import { RUNTIME } from "./const.js";
+import pm_default from "./json/pm.js";
 import { CommandError, isNotFoundError, runSubCommand } from "./utils.js";
 import { entries, evolve, fromEntries, isObject, map, negate, pipe, throwIf } from "@fxts/core";
 import process from "node:process";
@@ -119,6 +120,81 @@ async function isCommandAvailable({ checkCommand, outputPattern }) {
 	}
 }
 /**
+* Compares two dotted version strings segment by segment and returns whether
+* `detected` is higher than or equal to `required`.
+*/
+function verifyRuntimeVersion(detected, required) {
+	const detectedParts = detected.split(".").map(Number);
+	const requiredParts = required.split(".").map(Number);
+	for (let i = 0; i < Math.max(detectedParts.length, requiredParts.length); i++) {
+		const detectedPart = detectedParts[i] ?? 0;
+		const requiredPart = requiredParts[i] ?? 0;
+		if (detectedPart > requiredPart) return true;
+		if (detectedPart < requiredPart) return false;
+	}
+	return true;
+}
+/**
+* Runs a runtime's version command and classifies the result as `"ok"`,
+* `"unsupported"`, `"missing"`, or `"malformed"` against its `minVersion`.
+*/
+async function checkRuntimeVersion({ checkCommand, outputPattern, minVersion }) {
+	try {
+		const { stdout } = await $`${checkCommand}`.stdout("piped").spawn();
+		logger.debug("The stdout of the command {command} is: {stdout}", {
+			command: checkCommand,
+			stdout
+		});
+		const detected = outputPattern.exec(stdout.trim())?.[1] ?? null;
+		if (detected == null) return {
+			status: "malformed",
+			detected: null,
+			required: minVersion
+		};
+		if (!verifyRuntimeVersion(detected, minVersion)) return {
+			status: "unsupported",
+			detected,
+			required: minVersion
+		};
+		return {
+			status: "ok",
+			detected,
+			required: minVersion
+		};
+	} catch (error) {
+		if (isNotFoundError(error)) return {
+			status: "missing",
+			detected: null,
+			required: minVersion
+		};
+		logger.debug("The command {command} failed with the error: {error}", {
+			command: checkCommand,
+			error
+		});
+		throw error;
+	}
+}
+/**
+* Resolves the required version for `runtime` as the higher of its base minimum
+* and an optional framework `override`.
+*/
+function resolveRequiredVersion(runtime, override) {
+	const base = runtimes[runtime].minVersion;
+	return override != null && verifyRuntimeVersion(override, base) ? override : base;
+}
+/**
+* Checks every supported runtime once and returns a map from each runtime
+* identifier to its version-check result, applying framework `overrides` on
+* top of each runtime's base minimum.
+*/
+async function checkAllRuntimes(overrides = {}) {
+	const checked = await Promise.all(RUNTIME.map(async (runtime) => [runtime, await checkRuntimeVersion({
+		...runtimes[runtime],
+		minVersion: resolveRequiredVersion(runtime, overrides[runtime])
+	})]));
+	return Object.fromEntries(checked);
+}
+/**
 * Creates a file at the given path with the given content, creating
 * any necessary parent directories along the way.
 */
@@ -291,4 +367,4 @@ const isDirectory = async (path) => {
 /** Returns `true` if the current run is in test mode. */
 const isTest = ({ testMode }) => testMode;
 //#endregion
-export { PACKAGE_VERSION, createFile, getBuildCommand, getDevCommand, getInstallUrl, isDirectoryEmpty, isPackageManagerAvailable, isTest, kvStores, logger, messageQueues, packageManagers, readTemplate, runtimes, throwUnlessNotExists };
+export { PACKAGE_VERSION, checkAllRuntimes, createFile, getBuildCommand, getDevCommand, getInstallUrl, isDirectoryEmpty, isPackageManagerAvailable, isTest, kvStores, logger, messageQueues, packageManagers, readTemplate, resolveRequiredVersion, runtimes, throwUnlessNotExists, verifyRuntimeVersion };

package/dist/templates/defaults/smoke.test.ts.tpl

@@ -0,0 +1,170 @@
+import { getDocumentLoader } from "@fedify/fedify";
+import { type Actor, isActor, lookupObject } from "@fedify/vocab";
+import { spawn, spawnSync } from "node:child_process";
+import type { Readable } from "node:stream";
+
+const DEV_COMMAND: string[] = /* dev command */;
+const HANDLE = "john";
+const STARTUP_TIMEOUT = 15_000;
+const IS_WINDOWS = process.platform === "win32";
+
+async function main(): Promise<void> {
+  const [command, ...args] = DEV_COMMAND;
+  const server = spawn(command, args, {
+    stdio: ["ignore", "pipe", "pipe"],
+    shell: IS_WINDOWS,
+    windowsHide: true,
+    detached: !IS_WINDOWS,
+  });
+  server.on("error", () => {});
+
+  const exitOnSignal = () => {
+    stopServer(server);
+    process.exit(1);
+  };
+  process.once("SIGINT", exitOnSignal);
+  process.once("SIGTERM", exitOnSignal);
+
+  let output = "";
+  const collectOutput = (stream: Readable | null) => {
+    const decoder = new TextDecoder();
+    stream?.on("data", (chunk: Buffer) => {
+      output += decoder.decode(chunk, { stream: true });
+    });
+  };
+  collectOutput(server.stdout);
+  collectOutput(server.stderr);
+
+  try {
+    const port = await determinePort(server);
+    const target = `http://localhost:${port}/users/${HANDLE}`;
+    await waitForServer(target);
+    console.log(`Server is up at http://localhost:${port}.`);
+    const actor = await checkActor(target);
+    console.log(actor);
+    console.log(`Smoke test passed: ${target} resolved to an actor.`);
+  } catch (error) {
+    console.error("Smoke test failed:", error instanceof Error ? error.message : error);
+    if (output.trim() !== "") {
+      console.error(`\nDev server output:\n${output}`);
+    }
+    process.exitCode = 1;
+  } finally {
+    stopServer(server);
+  }
+}
+
+function stripEscape(text: string): string {
+  return text.replace(new RegExp("\\u001B\\[[0-9;]*[A-Za-z]", "g"), "");
+}
+
+function determinePort(server: ReturnType<typeof spawn>): Promise<number> {
+  const portPatterns = [
+    /listening on.*:(\d+)/i,
+    /server.*:(\d+)/i,
+    /https?:\/\/localhost:(\d+)/i,
+    /https?:\/\/0\.0\.0\.0:(\d+)/i,
+    /https?:\/\/127\.0\.0\.1:(\d+)/i,
+    /https?:\/\/[^:]+:(\d+)/i,
+  ];
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      reject(
+        new Error(
+          `Timeout: Could not determine port from server output within ${STARTUP_TIMEOUT}ms.`,
+        ),
+      );
+    }, STARTUP_TIMEOUT);
+
+    const findPort = (text: string) => {
+      for (const pattern of portPatterns) {
+        const match = text.match(pattern);
+        if (match && match[1]) {
+          const port = Number.parseInt(match[1], 10);
+          if (port > 0 && port < 65536) return port;
+        }
+      }
+      return null;
+    };
+
+    const scan = (stream: Readable | null) => {
+      const decoder = new TextDecoder();
+      let text = "";
+      stream?.on("data", (chunk: Buffer) => {
+        text += decoder.decode(chunk, { stream: true });
+        const port = findPort(stripEscape(text));
+        if (port != null) {
+          clearTimeout(timeout);
+          resolve(port);
+        }
+      });
+    };
+
+    scan(server.stdout);
+    scan(server.stderr);
+    server.once("exit", (code) => {
+      clearTimeout(timeout);
+      reject(new Error(`The dev server exited early with code ${String(code)}.`));
+    });
+  });
+}
+
+async function waitForServer(url: string): Promise<void> {
+  const startTime = Date.now();
+  let lastStatus: number | undefined;
+
+  while (Date.now() - startTime < STARTUP_TIMEOUT) {
+    try {
+      const response = await fetch(url, {
+        headers: { Accept: "application/activity+json" },
+        signal: AbortSignal.timeout(1000),
+      });
+      await response.body?.cancel();
+      if (response.ok) return;
+      lastStatus = response.status;
+    } catch {
+      // Server not ready yet, continue waiting
+    }
+    await new Promise((resolve) => setTimeout(resolve, 500));
+  }
+  throw new Error(
+    `The server did not become ready within ${STARTUP_TIMEOUT}ms.` +
+      (lastStatus == null ? "" : `  Last response status: ${lastStatus}.`),
+  );
+}
+
+async function checkActor(url: string): Promise<Actor> {
+  const object = await lookupObject(url, {
+    documentLoader: getDocumentLoader({ allowPrivateAddress: true }),
+  });
+  if (object == null) {
+    throw new Error(`Could not resolve an actor at ${url}.`);
+  }
+  if (!isActor(object)) {
+    throw new Error(`Expected an actor at ${url}, but got a non-actor object.`);
+  }
+  return object;
+}
+
+function stopServer(server: ReturnType<typeof spawn>): void {
+  if (server.pid == null) return;
+  if (IS_WINDOWS) {
+    spawnSync("taskkill", ["/pid", String(server.pid), "/T", "/F"], {
+      stdio: "ignore",
+      windowsHide: true,
+    });
+    return;
+  }
+  try {
+    process.kill(-server.pid, "SIGKILL");
+  } catch {
+    // Process group already exited.
+  }
+  try {
+    server.kill("SIGKILL");
+  } catch {
+    // Process already exited.
+  }
+}
+
+await main();

package/dist/test/db.js

@@ -1,5 +1,5 @@
-import { printErrorMessage, printMessage } from "../utils.js";
 import { DB_TO_CHECK } from "../const.js";
+import { printErrorMessage, printMessage } from "../utils.js";
 import db_to_check_default from "../json/db-to-check.js";
 import { concat, filter, pipe, toArray, uniq } from "@fxts/core";
 import { createConnection } from "node:net";

package/dist/types.d.ts

@@ -30,6 +30,8 @@ interface WebFrameworkInitializer {
   federationFile: string;
   /** Relative path where the logging configuration file will be created. */
   loggingFile: string;
+  /** Relative path where the smoke-test script file will be created. */
+  testFile: string;
   /** Optional template path for the logging configuration file. */
   loggingTemplate?: string;
   /**

package/dist/utils.js

@@ -65,7 +65,7 @@ const createJsonDepthGuard = () => {
 /** Checks whether a string or array-like value has a length greater than zero. */
 const notEmpty = (s) => s.length > 0;
 /** Type guard that checks whether an error is a "file not found" (`ENOENT`) error. */
-const isNotFoundError = (e) => isObject(e) && "code" in e && e.code === "ENOENT";
+const isNotFoundError = (e) => isObject(e) && ("code" in e && e.code === "ENOENT" || "exitCode" in e && e.exitCode === 127);
 /**
 * Error thrown when a spawned shell command exits with a non-zero code.
 * Captures stdout, stderr, exit code, and the original command array.

package/dist/webframeworks/astro.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "@logtape/logtape" as _logtape_logtape, "npm:@astrojs/node" as npm__astrojs_node, "npm:@deno/astro-adapter" as npm__deno_astro_adapter, "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@types/node@22" as npm__types_node_22, "npm:astro" as npm_astro, "npm:create-astro" as npm_create_astro, "npm:oxlint" as npm_oxlint, "npm:prettier" as npm_prettier, "npm:prettier-plugin-astro" as npm_prettier_plugin_astro, "npm:typescript" as npm_typescript } from "../json/deps.js";
 import { defaultDenoDependencies } from "./const.js";
-import { getInstruction, pmToRt } from "./utils.js";
+import { getInstruction, getTestDependencies, getTestTask, pmToRt } from "./utils.js";
 //#region src/webframeworks/astro.ts
 const astroNodeBunDevDependencies = {
 	"@fedify/lint": PACKAGE_VERSION,
@@ -27,6 +27,7 @@ const astroDescription = {
 	label: "Astro",
 	packageManagers: PACKAGE_MANAGER,
 	defaultPort: 4321,
+	minRuntimeVersions: { node: "22.12.0" },
 	init: async ({ packageManager: pm }) => {
 		const dependencies = pm === "deno" ? {
 			...defaultDenoDependencies,
@@ -54,10 +55,12 @@ const astroDescription = {
 				...pm !== "deno" ? {
 					typescript: npm_typescript,
 					"@types/node": npm__types_node_22
-				} : {}
+				} : {},
+				...getTestDependencies(pm)
 			},
 			federationFile: "src/federation.ts",
 			loggingFile: "src/logging.ts",
+			testFile: "scripts/smoke.test.ts",
 			format: pm === "deno" ? void 0 : { tool: "prettier" },
 			files: {
 				"astro.config.ts": await readTemplate(`astro/astro.config.${pmToRt(pm)}.ts`),
@@ -106,18 +109,21 @@ const TASKS = {
 	"deno": {
 		dev: `${astroDenoCommand} dev`,
 		build: `${astroDenoCommand} build`,
-		preview: `${astroDenoCommand} preview`
+		preview: `${astroDenoCommand} preview`,
+		test: getTestTask("deno")
 	},
 	"bun": {
 		dev: "bunx --bun astro dev",
 		build: "bunx --bun astro build",
 		preview: "bun ./dist/server/entry.mjs",
+		test: getTestTask("bun"),
 		...astroNodeBunDevToolTasks
 	},
 	"node": {
 		dev: "dotenvx run -- astro dev",
 		build: "dotenvx run -- astro build",
 		preview: "dotenvx run -- astro preview",
+		test: getTestTask("npm"),
 		...astroNodeBunDevToolTasks
 	}
 };

package/dist/webframeworks/bare-bones.js

@@ -1,8 +1,8 @@
-import { readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { readTemplate } from "../lib.js";
 import { "@hongminhee/x-forwarded-fetch" as _hongminhee_x_forwarded_fetch, "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@hono/node-server" as npm__hono_node_server, "npm:@types/bun" as npm__types_bun, "npm:@types/node@25" as npm__types_node_25, "npm:tsx" as npm_tsx, "npm:x-forwarded-fetch" as npm_x_forwarded_fetch } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, nodeBunDevToolTasks, pmToRt } from "./utils.js";
+import { getInstruction, getTestTask, nodeBunDevToolTasks, pmToRt } from "./utils.js";
 //#region src/webframeworks/bare-bones.ts
 const bareBonesDescription = {
 	label: "Bare-bones",
@@ -16,6 +16,7 @@ const bareBonesDescription = {
 		},
 		federationFile: "src/federation.ts",
 		loggingFile: "src/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		files: { "src/main.ts": await readTemplate(`bare-bones/main/${pmToRt(pm)}.ts`) },
 		compilerOptions: pm === "deno" ? {
 			"jsx": "precompile",
@@ -46,16 +47,19 @@ const getDependencies = (pm) => pm === "deno" ? {
 const TASKS = {
 	deno: {
 		dev: "deno run -A --watch ./src/main.ts",
-		prod: "deno run -A ./src/main.ts"
+		prod: "deno run -A ./src/main.ts",
+		test: getTestTask("deno")
 	},
 	bun: {
 		dev: "bun run --hot ./src/main.ts",
 		prod: "bun run ./src/main.ts",
+		test: getTestTask("bun"),
 		...nodeBunDevToolTasks
 	},
 	node: {
 		dev: "dotenvx run -- tsx watch ./src/main.ts",
 		prod: "dotenvx run -- node --import tsx ./src/main.ts",
+		test: getTestTask("npm"),
 		...nodeBunDevToolTasks
 	}
 };

package/dist/webframeworks/elysia.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@elysiajs/node" as npm__elysiajs_node, "npm:@sinclair/typebox" as npm__sinclair_typebox, "npm:@types/bun" as npm__types_bun, "npm:@types/node@25" as npm__types_node_25, "npm:elysia" as npm_elysia, "npm:openapi-types" as npm_openapi_types, "npm:tsx" as npm_tsx, "npm:typescript" as npm_typescript } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, nodeBunDevToolTasks, pmToRt } from "./utils.js";
+import { getInstruction, getTestTask, nodeBunDevToolTasks, pmToRt } from "./utils.js";
 //#region src/webframeworks/elysia.ts
 const elysiaDescription = {
 	label: "Elysia",
@@ -36,6 +36,7 @@ const elysiaDescription = {
 		},
 		federationFile: "src/federation.ts",
 		loggingFile: "src/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		files: { "src/index.ts": (await readTemplate(`elysia/index/${pmToRt(pm)}.ts`)).replace(/\/\* logger \*\//, projectName) },
 		compilerOptions: pm === "deno" || pm === "bun" ? void 0 : {
 			"lib": ["ESNext", "DOM"],
@@ -54,17 +55,20 @@ const elysiaDescription = {
 const TASKS = {
 	deno: {
 		dev: "deno serve --allow-read --allow-env --allow-net --watch ./src/index.ts",
-		prod: "deno serve --allow-read --allow-env --allow-net ./src/index.ts"
+		prod: "deno serve --allow-read --allow-env --allow-net ./src/index.ts",
+		test: getTestTask("deno")
 	},
 	bun: {
 		dev: "bun run --hot ./src/index.ts",
 		prod: "bun run ./src/index.ts",
+		test: getTestTask("bun"),
 		...nodeBunDevToolTasks
 	},
 	node: {
 		dev: "dotenvx run -- tsx watch src/index.ts",
 		build: "tsc src/index.ts --outDir dist",
 		start: "NODE_ENV=production dotenvx run -- node dist/index.js",
+		test: getTestTask("npm"),
 		...nodeBunDevToolTasks
 	}
 };

package/dist/webframeworks/express.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@types/bun" as npm__types_bun, "npm:@types/express" as npm__types_express, "npm:express" as npm_express, "npm:tsx" as npm_tsx } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, nodeBunDevToolTasks, pmToRt } from "./utils.js";
+import { getInstruction, getTestTask, nodeBunDevToolTasks, pmToRt } from "./utils.js";
 //#region src/webframeworks/express.ts
 const expressDescription = {
 	label: "Express",
@@ -25,6 +25,7 @@ const expressDescription = {
 		},
 		federationFile: "src/federation.ts",
 		loggingFile: "src/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		files: {
 			"src/app.ts": (await readTemplate("express/app.ts")).replace(/\/\* logger \*\//, projectName),
 			"src/index.ts": await readTemplate("express/index.ts")
@@ -46,16 +47,19 @@ const expressDescription = {
 const TASKS = {
 	deno: {
 		dev: "deno run --allow-read --allow-net --allow-env --allow-sys --watch ./src/index.ts",
-		prod: "deno run --allow-read --allow-net --allow-env --allow-sys ./src/index.ts"
+		prod: "deno run --allow-read --allow-net --allow-env --allow-sys ./src/index.ts",
+		test: getTestTask("deno")
 	},
 	bun: {
 		dev: "bun run --hot ./src/index.ts",
 		prod: "bun run ./src/index.ts",
+		test: getTestTask("bun"),
 		...nodeBunDevToolTasks
 	},
 	node: {
 		dev: "dotenvx run -- tsx watch ./src/index.ts",
 		prod: "dotenvx run -- node --import tsx ./src/index.ts",
+		test: getTestTask("npm"),
 		...nodeBunDevToolTasks
 	}
 };

package/dist/webframeworks/hono.js

@@ -1,9 +1,9 @@
+import { PACKAGE_MANAGER } from "../const.js";
 import { replace } from "../utils.js";
 import { PACKAGE_VERSION, readTemplate } from "../lib.js";
-import { PACKAGE_MANAGER } from "../const.js";
 import { "@hongminhee/x-forwarded-fetch" as _hongminhee_x_forwarded_fetch, "@hono/hono" as _hono_hono, "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@hono/node-server" as npm__hono_node_server, "npm:@types/bun" as npm__types_bun, "npm:hono" as npm_hono, "npm:tsx" as npm_tsx, "npm:x-forwarded-fetch" as npm_x_forwarded_fetch } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, nodeBunDevToolTasks, pmToRt } from "./utils.js";
+import { getInstruction, getTestTask, nodeBunDevToolTasks, pmToRt } from "./utils.js";
 import { pipe } from "@fxts/core";
 //#region src/webframeworks/hono.ts
 const honoDescription = {
@@ -18,6 +18,7 @@ const honoDescription = {
 		},
 		federationFile: "src/federation.ts",
 		loggingFile: "src/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		files: {
 			"src/app.tsx": pipe(await readTemplate("hono/app.tsx"), replace(/\/\* hono \*\//, pm === "deno" ? "@hono/hono" : "hono"), replace(/\/\* logger \*\//, projectName)),
 			"src/index.ts": await readTemplate(`hono/index/${pmToRt(pm)}.ts`)
@@ -58,16 +59,19 @@ const getDependencies = (pm) => pm === "deno" ? {
 const TASKS = {
 	deno: {
 		dev: "deno run -A --watch ./src/index.ts",
-		prod: "deno run -A ./src/index.ts"
+		prod: "deno run -A ./src/index.ts",
+		test: getTestTask("deno")
 	},
 	bun: {
 		dev: "bun run --hot ./src/index.ts",
 		prod: "bun run ./src/index.ts",
+		test: getTestTask("bun"),
 		...nodeBunDevToolTasks
 	},
 	node: {
 		dev: "dotenvx run -- tsx watch ./src/index.ts",
 		prod: "dotenvx run -- node --import tsx ./src/index.ts",
+		test: getTestTask("npm"),
 		...nodeBunDevToolTasks
 	}
 };

package/dist/webframeworks/next.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "npm:@types/node@20" as npm__types_node_20 } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, getNodeBunDevToolTasks } from "./utils.js";
+import { getInstruction, getNodeBunDevToolTasks, getTestDependencies, getTestTask } from "./utils.js";
 //#region src/webframeworks/next.ts
 const nextDescription = {
 	label: "Next.js",
@@ -21,16 +21,21 @@ const nextDescription = {
 		},
 		devDependencies: {
 			"@types/node": npm__types_node_20,
-			...defaultDevDependencies
+			...defaultDevDependencies,
+			...getTestDependencies(pm)
 		},
 		federationFile: "federation/index.ts",
 		loggingFile: "logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		format: { ignorePatterns: [".next/**"] },
 		files: {
 			"instrumentation.ts": await readTemplate("next/instrumentation.ts"),
 			"middleware.ts": await readTemplate("next/middleware.ts")
 		},
-		tasks: getNodeBunDevToolTasks(pm),
+		tasks: {
+			...getNodeBunDevToolTasks(pm),
+			test: getTestTask(pm)
+		},
 		instruction: getInstruction(pm, 3e3)
 	})
 };

package/dist/webframeworks/nitro.js

@@ -1,7 +1,7 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, getNodeBunDevToolTasks } from "./utils.js";
+import { getInstruction, getNodeBunDevToolTasks, getTestDependencies, getTestTask } from "./utils.js";
 //#region src/webframeworks/nitro.ts
 const nitroDescription = {
 	label: "Nitro",
@@ -19,9 +19,13 @@ const nitroDescription = {
 			"@fedify/h3": PACKAGE_VERSION,
 			...pm === "deno" && defaultDenoDependencies
 		},
-		devDependencies: defaultDevDependencies,
+		devDependencies: {
+			...defaultDevDependencies,
+			...getTestDependencies(pm)
+		},
 		federationFile: "server/federation.ts",
 		loggingFile: "server/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		format: { ignorePatterns: [".output/**"] },
 		env: testMode ? { HOST: "127.0.0.1" } : {},
 		files: {
@@ -51,7 +55,10 @@ const nitroDescription = {
 			lib: ["ESNext", "DOM"],
 			baseUrl: "."
 		},
-		tasks: getNodeBunDevToolTasks(pm),
+		tasks: {
+			...getNodeBunDevToolTasks(pm),
+			test: getTestTask(pm)
+		},
 		instruction: getInstruction(pm, 3e3)
 	})
 };

package/dist/webframeworks/nuxt.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "npm:@types/node@25" as npm__types_node_25, "npm:typescript" as npm_typescript } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, getNodeBunDevToolTasks } from "./utils.js";
+import { getInstruction, getNodeBunDevToolTasks, getTestDependencies, getTestTask } from "./utils.js";
 //#region src/webframeworks/nuxt.ts
 const nuxtDescription = {
 	label: "Nuxt",
@@ -14,18 +14,23 @@ const nuxtDescription = {
 		devDependencies: {
 			...defaultDevDependencies,
 			"typescript": npm_typescript,
-			"@types/node": npm__types_node_25
+			"@types/node": npm__types_node_25,
+			...getTestDependencies(pm)
 		},
 		federationFile: "server/federation.ts",
 		loggingFile: "server/logging.ts",
 		loggingTemplate: "nuxt/server/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		format: { ignorePatterns: [".output/**"] },
 		env: testMode ? { HOST: "127.0.0.1" } : {},
 		files: {
 			"nuxt.config.ts": await readTemplate("nuxt/nuxt.config.ts"),
 			"server/plugins/logging.ts": await readTemplate("nuxt/server/plugins/logging.ts")
 		},
-		tasks: getNodeBunDevToolTasks(pm),
+		tasks: {
+			...getNodeBunDevToolTasks(pm),
+			test: getTestTask(pm)
+		},
 		instruction: getInstruction(pm, 3e3)
 	})
 };

package/dist/webframeworks/solidstart.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@solidjs/router" as npm__solidjs_router, "npm:@solidjs/start" as npm__solidjs_start, "npm:@types/node@22" as npm__types_node_22, "npm:solid-js" as npm_solid_js, "npm:typescript" as npm_typescript, "npm:vinxi" as npm_vinxi } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, nodeBunDevToolTasks, pmToRt } from "./utils.js";
+import { getInstruction, getTestDependencies, getTestTask, nodeBunDevToolTasks, pmToRt } from "./utils.js";
 //#region src/webframeworks/solidstart.ts
 const NPM_SOLIDSTART = `npm:@solidjs/start@${npm__solidjs_start}`;
 const solidstartDescription = {
@@ -14,10 +14,12 @@ const solidstartDescription = {
 		devDependencies: {
 			...defaultDevDependencies,
 			typescript: npm_typescript,
-			"@types/node": npm__types_node_22
+			"@types/node": npm__types_node_22,
+			...getTestDependencies(pm)
 		},
 		federationFile: "src/federation.ts",
 		loggingFile: "src/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		format: { ignorePatterns: [".solid/**", ".vinxi/**"] },
 		files: {
 			"app.config.ts": (await readTemplate("solidstart/app.config.ts")).replace(/\/\* preset \*\//, pm === "deno" ? "deno-server" : "node-server"),
@@ -70,18 +72,21 @@ const TASKS = {
 	deno: {
 		dev: "deno run -A npm:vinxi dev",
 		build: "deno run -A npm:vinxi build",
-		start: "deno run -A npm:vinxi start"
+		start: "deno run -A npm:vinxi start",
+		test: getTestTask("deno")
 	},
 	bun: {
 		dev: "bunx vinxi dev",
 		build: "bunx vinxi build",
 		start: "bunx vinxi start",
+		test: getTestTask("bun"),
 		...nodeBunDevToolTasks
 	},
 	node: {
 		dev: "vinxi dev",
 		build: "vinxi build",
 		start: "dotenvx run -- vinxi start",
+		test: getTestTask("npm"),
 		...nodeBunDevToolTasks
 	}
 };

package/dist/webframeworks/sveltekit.js

@@ -1,8 +1,8 @@
-import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
+import { PACKAGE_VERSION, readTemplate } from "../lib.js";
 import { "npm:@dotenvx/dotenvx" as npm__dotenvx_dotenvx, "npm:@types/node@25" as npm__types_node_25, "npm:typescript" as npm_typescript } from "../json/deps.js";
 import { defaultDenoDependencies, defaultDevDependencies } from "./const.js";
-import { getInstruction, nodeBunDevToolTasks, pmToRt } from "./utils.js";
+import { getInstruction, getTestDependencies, getTestTask, nodeBunDevToolTasks, pmToRt } from "./utils.js";
 //#region src/webframeworks/sveltekit.ts
 const sveltekitDescription = {
 	label: "SvelteKit",
@@ -18,13 +18,18 @@ const sveltekitDescription = {
 			...defaultDevDependencies,
 			"typescript": npm_typescript,
 			"@types/node": npm__types_node_25,
-			...pmToRt(pm) === "deno" ? {} : { "@dotenvx/dotenvx": npm__dotenvx_dotenvx }
+			...pmToRt(pm) === "deno" ? {} : { "@dotenvx/dotenvx": npm__dotenvx_dotenvx },
+			...getTestDependencies(pm)
 		},
 		federationFile: "src/lib/federation.ts",
 		loggingFile: "src/lib/logging.ts",
+		testFile: "scripts/smoke.test.ts",
 		env: testMode ? { HOST: "127.0.0.1" } : {},
 		files: { "src/hooks.server.ts": await readTemplate("sveltekit/hooks.server.ts") },
-		tasks: pmToRt(pm) === "deno" ? {} : { ...TASKS },
+		tasks: pmToRt(pm) === "deno" ? { test: getTestTask("deno") } : {
+			...TASKS,
+			test: getTestTask(pm)
+		},
 		instruction: getInstruction(pm, 5173)
 	})
 };

package/dist/webframeworks/utils.js

@@ -1,4 +1,5 @@
 import { getDevCommand } from "../lib.js";
+import { "npm:tsx" as npm_tsx } from "../json/deps.js";
 import { commandLine, message } from "@optique/core/message";
 //#region src/webframeworks/utils.ts
 const nodeBunDevToolTasks = {
@@ -7,6 +8,19 @@ const nodeBunDevToolTasks = {
 	lint: "oxlint ."
 };
 const getNodeBunDevToolTasks = (pm) => pm === "deno" ? {} : nodeBunDevToolTasks;
+const SMOKE_TEST_FILE = "scripts/smoke.test.ts";
+/**
+* Returns the `test` task command that runs the generated smoke-test
+* script (`WebFrameworkInitializer.testFile`) with the runtime matching the
+* given package manager.
+*/
+const getTestTask = (pm) => pmToRt(pm) === "deno" ? `deno run -A ${SMOKE_TEST_FILE}` : pmToRt(pm) === "bun" ? `bun run ${SMOKE_TEST_FILE}` : `tsx ${SMOKE_TEST_FILE}`;
+/**
+* Returns the dev dependencies the `test` task needs beyond what the
+* framework already declares.  Node.js runs the smoke-test script through
+* `tsx`; Deno and Bun execute TypeScript natively.
+*/
+const getTestDependencies = (pm) => pmToRt(pm) === "node" ? { tsx: npm_tsx } : {};
 /**
 * Generates the post-initialization instruction message that shows
 * the user how to start the dev server and look up an actor.
@@ -32,4 +46,4 @@ Then, try to look up an actor from your server:
 */
 const pmToRt = (pm) => pm !== "deno" && pm !== "bun" ? "node" : pm;
 //#endregion
-export { getInstruction, getNodeBunDevToolTasks, nodeBunDevToolTasks, pmToRt };
+export { getInstruction, getNodeBunDevToolTasks, getTestDependencies, getTestTask, nodeBunDevToolTasks, pmToRt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/init",
-  "version": "2.4.0-dev.1797+6c3f0b36",
+  "version": "2.4.0-dev.1827+b66cedd5",
   "description": "Project initializer for Fedify",
   "keywords": [
     "fedify",