@fedify/init 2.1.0-dev.418 → 2.1.0-dev.438

package/dist/action/configs.js

@@ -4,12 +4,11 @@ import vscode_settings_for_deno_default from "../json/vscode-settings-for-deno.j
 import vscode_settings_default from "../json/vscode-settings.js";
 import { PACKAGES_PATH } from "./const.js";
 import { getDependencies, getDevDependencies, joinDepsReg } from "./deps.js";
-import { uniq } from "es-toolkit";
 import { execFileSync } from "node:child_process";
 import { getLogger } from "@logtape/logtape";
 import { realpathSync } from "node:fs";
 import { join, relative } from "node:path";
-import { concat, filter, keys, map, pick, pipe, toArray } from "@fxts/core/index.js";
+import { always, cases, concat, filter, head, isArray, isEmpty, isNull, isString, keys, map, pick, pipe, prop, toArray, uniq, unless, when, zip } from "@fxts/core/index.js";
 
 //#region src/action/configs.ts
 const logger = getLogger([
@@ -25,36 +24,27 @@ const logger = getLogger([
 * @param param0 - Destructured initialization data containing KV, MQ, initializer, and directory
 * @returns Configuration object with path and Deno-specific settings
 */
-const loadDenoConfig = (data) => {
-	const unstable = getUnstable(data);
-	return {
-		path: "deno.json",
-		data: {
-			...pick(["compilerOptions", "tasks"], data.initializer),
-			...unstable.length > 0 ? { unstable } : {},
-			nodeModulesDir: "auto",
-			imports: joinDepsReg("deno")(getDependencies(data)),
-			lint: { plugins: ["jsr:@fedify/lint"] },
-			...data.testMode ? { links: getLinks(data) } : {}
-		}
-	};
-};
-const getUnstable = ({ kv: { denoUnstable: kv = [] }, mq: { denoUnstable: mq = [] } }) => pipe(needsUnstableTemporal() ? ["temporal"] : [], concat(kv), concat(mq), toArray, uniq);
+const loadDenoConfig = (data) => ({
+	path: "deno.json",
+	data: {
+		...pick(["compilerOptions", "tasks"], data.initializer),
+		...getUnstable(data),
+		nodeModulesDir: "auto",
+		imports: joinDepsReg("deno")(getDependencies(data)),
+		lint: { plugins: ["jsr:@fedify/lint"] },
+		...data.testMode && !data.dryRun ? { links: getLinks(data) } : {}
+	}
+});
+const getUnstable = ({ kv: { denoUnstable: kv = [] }, mq: { denoUnstable: mq = [] } }) => pipe(needsUnstableTemporal() ? ["temporal"] : [], concat(kv), concat(mq), uniq, toArray, cases(isEmpty, always({}), (unstable) => ({ unstable })));
 const TEMPORAL_STABLE_FROM = [
 	2,
 	7,
 	0
 ];
-const needsUnstableTemporal = () => {
-	const version = getInstalledDenoVersion();
-	if (version == null) return true;
-	return compareVersions(version, TEMPORAL_STABLE_FROM) < 0;
-};
-const getInstalledDenoVersion = () => {
-	const deno = getDenoVersionFromRuntime();
-	if (deno != null) return deno;
+const needsUnstableTemporal = () => pipe(getDenoVersionFromRuntime(), when(isNull, getDenoVersionFromCommand), when(isString, parseVersion), cases(isArray, isLaterOrEqualThan(TEMPORAL_STABLE_FROM), always(true)));
+const getDenoVersionFromCommand = () => {
 	try {
-		const output = execFileSync("deno", ["--version"], {
+		return execFileSync("deno", ["--version"], {
 			encoding: "utf8",
 			stdio: [
 				"ignore",
@@ -62,37 +52,15 @@ const getInstalledDenoVersion = () => {
 				"ignore"
 			]
 		});
-		const version = output.match(/^deno\s+(\d+)\.(\d+)\.(\d+)/m);
-		if (version == null) return null;
-		return [
-			Number(version[1]),
-			Number(version[2]),
-			Number(version[3])
-		];
 	} catch (error) {
 		logger.debug("Failed to get Deno version by executing `deno --version`: {error}", { error });
 		return null;
 	}
 };
-const getDenoVersionFromRuntime = () => {
-	const deno = globalThis.Deno?.version?.deno;
-	if (deno == null) return null;
-	const version = deno.match(/^(\d+)\.(\d+)\.(\d+)/);
-	if (version == null) return null;
-	return [
-		Number(version[1]),
-		Number(version[2]),
-		Number(version[3])
-	];
-};
-const compareVersions = (a, b) => {
-	for (let i = 0; i < a.length; i++) {
-		if (a[i] < b[i]) return -1;
-		if (a[i] > b[i]) return 1;
-	}
-	return 0;
-};
-const getLinks = ({ kv, mq, initializer, dir }) => pipe({ "@fedify/fedify": "" }, merge(initializer.dependencies), merge(kv.dependencies), merge(mq.dependencies), keys, filter((dep) => dep.includes("@fedify/")), map((dep) => dep.replace("@fedify/", "")), map((dep) => join(PACKAGES_PATH, dep)), map((absolutePath) => realpathSync(absolutePath)), map((realAbsolutePath) => relative(realpathSync(dir), realAbsolutePath)), toArray);
+const getDenoVersionFromRuntime = () => pipe(globalThis, prop("Deno"), prop("version"), prop("deno"));
+const parseVersion = (deno) => pipe(deno.match(/^(\d+)\.(\d+)\.(\d+)/), unless(isNull, (arr) => arr.map(Number)));
+const isLaterOrEqualThan = (basis) => (target) => pipe(zip(basis, target), filter(([b, t]) => t !== b), head, (a) => a ? a[0] < a[1] : true);
+const getLinks = ({ kv, mq, initializer, dir }) => pipe({ "@fedify/fedify": "" }, merge(initializer.dependencies), merge(kv.dependencies), merge(mq.dependencies), keys, filter((dep) => dep.includes("@fedify/")), map((dep) => dep.replace("@fedify/", "")), map((dep) => join(PACKAGES_PATH, dep)), map(realpathSync), map((realAbsolutePath) => relative(realpathSync(dir), realAbsolutePath)), toArray);
 /**
 * Loads TypeScript configuration object for Node.js/Bun projects.
 * Uses compiler options from the framework initializer.

package/dist/action/const.js

@@ -1,6 +1,10 @@
 import { join } from "node:path";
 
 //#region src/action/const.ts
+/**
+* Absolute path to the monorepo *packages/* directory.
+* Used in test mode to resolve local `@fedify/*` package paths.
+*/
 const PACKAGES_PATH = join(import.meta.dirname, "..", "..", "..");
 
 //#endregion

package/dist/action/deps.js

@@ -30,7 +30,7 @@ const convertFedifyToLocal = (name) => pipe(name, replace("@fedify/", ""), (pkg)
 *               and message queue descriptions
 * @returns A record of devDependencies with their versions
 */
-const getDevDependencies = ({ initializer, kv, mq, packageManager }) => pipe({ "@biomejs/biome": "^2.2.4" }, merge(initializer.devDependencies), merge(kv.devDependencies), merge(mq.devDependencies), normalizePackageNames(packageManager));
+const getDevDependencies = ({ initializer, kv, mq, packageManager, testMode }) => pipe({ "@biomejs/biome": "^2.2.4" }, merge(initializer.devDependencies), merge(kv.devDependencies), merge(mq.devDependencies), when(always(testMode), isDeno({ packageManager }) ? removeFedifyDeps : addLocalFedifyDeps), normalizePackageNames(packageManager));
 /**
 * Joins package names with their versions for installation dependencies.
 * For Deno, it prefixes packages with 'jsr:'

package/dist/action/env.js

@@ -3,6 +3,11 @@ import { noticeConfigEnv, noticeEnvKeyValue } from "./notice.js";
 import { entries, forEach, pipeLazy, tap, toArray, when } from "@fxts/core";
 
 //#region src/action/env.ts
+/**
+* Displays environment variable recommendations to the user.
+* Lists the `.env` key-value pairs from the combined KV store and message
+* queue configurations, so the user knows what to configure.
+*/
 const recommendConfigEnv = pipeLazy((data) => data.env, entries, toArray, when(notEmpty, tap(noticeConfigEnv)), forEach(noticeEnvKeyValue));
 var env_default = recommendConfigEnv;
 

package/dist/action/install.js

@@ -2,6 +2,10 @@ import { CommandError, runSubCommand } from "../utils.js";
 import { apply, pipe } from "@fxts/core";
 
 //#region src/action/install.ts
+/**
+* Runs `<packageManager> install` in the project directory to install all
+* dependencies. Logs an error message if the installation fails.
+*/
 const installDependencies = (data) => pipe(data, ({ packageManager, dir }) => [[packageManager, "install"], { cwd: dir }], apply(runSubCommand)).catch((e) => {
 	if (e instanceof CommandError) {
 		console.error(`Failed to install dependencies using ${data.packageManager}.`);

package/dist/action/notice.js

@@ -3,6 +3,7 @@ import { text } from "@optique/core";
 import { flow } from "es-toolkit";
 
 //#region src/action/notice.ts
+/** Prints the Feddy ASCII art banner to stderr. */
 function drawDinosaur() {
 	const d = flow(colors.bgBlue, colors.black);
 	const f = colors.blue;
@@ -15,33 +16,53 @@ ${d("  <__.|_|-|_|      ")}  ${f("|_|  \\___|\\__,_|_|_|  \\__, |")}
 ${d("                   ")}  ${f("                      |___/")}
 `);
 }
+/** Prints the user's selected initialization options to stdout. */
 const noticeOptions = ({ packageManager, webFramework, kvStore, messageQueue }) => printMessage`
   Package manager: ${packageManager};
   Web framework: ${webFramework};
   Key–value store: ${kvStore};
   Message queue: ${messageQueue};
 `;
+/**
+* Prints the precommand that would be run in dry-run mode,
+* showing the directory and command to execute.
+*/
 function noticePrecommand({ initializer: { command: command$1 }, dir }) {
 	printMessage`📦 Would run command:`;
 	printMessage`  cd ${dir}`;
 	printMessage`  ${command$1.join(" ")}\n`;
 }
+/** Prints a header indicating that text files would be created. */
 const noticeFilesToCreate = () => printMessage`📄 Would create files:\n`;
+/** Prints a header indicating that JSON files would be created or updated. */
 const noticeFilesToInsert = () => printMessage`Would create/update JSON files:\n`;
+/** Prints a header indicating that dependencies would be installed. */
 const noticeDepsIfExist = () => printMessage`📦 Would install dependencies:`;
+/** Prints a header indicating that dev dependencies would be installed. */
 const noticeDevDepsIfExist = () => printMessage`📦 Would install dev dependencies:`;
+/** Prints a single dependency name and version. */
 const noticeDeps = ([name, version]) => printMessage`${name}@${version}`;
+/**
+* Displays a file's path and content with a horizontal rule separator,
+* used in dry-run mode to preview generated files.
+*/
 function displayFile(path, content, emoji = "📄") {
 	printMessage`${emoji} ${path}`;
 	printMessage`${"─".repeat(60)}`;
 	printMessage`${content}`;
 	printMessage`${"─".repeat(60)}\n`;
 }
+/** Prints a notice recommending the user edit the `.env` file. */
 const noticeConfigEnv = () => printMessage`Note that you probably want to edit the ${".env"} file.
 It currently contains the following values:\n`;
+/** Prints a single environment variable key-value pair. */
 const noticeEnvKeyValue = ([key, value]) => {
 	printMessage`${text(`  ${key}='${value}'`)}`;
 };
+/**
+* Prints the post-initialization instructions, showing how to start
+* the dev server and where to edit the federation configuration.
+*/
 const noticeHowToRun = ({ initializer: { instruction, federationFile } }) => printMessage`
 ${instruction}
     

package/dist/action/set.js

@@ -1,6 +1,6 @@
 import { merge, set } from "../utils.js";
 import { kvStores, messageQueues } from "../lib.js";
-import webframeworks_default from "../webframeworks.js";
+import webframeworks_default from "../webframeworks/mod.js";
 import { pipe } from "@fxts/core";
 import { existsSync } from "node:fs";
 import { realpath } from "node:fs/promises";

package/dist/action/utils.js

@@ -1,9 +1,16 @@
 import { join } from "node:path";
 
 //#region src/action/utils.ts
+/** Returns `true` if the current run is in dry-run mode. */
 const isDry = ({ dryRun }) => dryRun;
+/** Returns `true` if the framework initializer has a precommand to execute. */
 const hasCommand = (data) => !!data.initializer.command;
+/** Returns `true` if the selected package manager is Deno. */
 const isDeno = ({ packageManager }) => packageManager === "deno";
+/**
+* Returns a function that prepends the project directory to a
+* `[filename, content]` tuple, resolving the filename into an absolute path.
+*/
 const joinDir = (dir) => ([filename, content]) => [join(dir, ...filename.split("/")), content];
 /**
 * Stringify an object into a valid `.env` file format.

package/dist/ask/mod.js

@@ -6,6 +6,12 @@ import wf_default from "./wf.js";
 import { pipe } from "@fxts/core";
 
 //#region src/ask/mod.ts
+/**
+* Orchestrates all interactive prompts to fill in missing initialization options.
+* Prompts the user in sequence for: project directory, web framework,
+* package manager, message queue, and key-value store.
+* Returns a fully resolved {@link InitCommandOptions} with all fields guaranteed.
+*/
 const askOptions = (options) => pipe(options, dir_default, wf_default, pm_default, mq_default, kv_default);
 var ask_default = askOptions;
 

package/dist/ask/pm.js

@@ -1,6 +1,6 @@
 import { getInstallUrl, isPackageManagerAvailable, kvStores, messageQueues, packageManagers, runtimes } from "../lib.js";
 import { PACKAGE_MANAGER } from "../const.js";
-import webframeworks_default from "../webframeworks.js";
+import webframeworks_default from "../webframeworks/mod.js";
 import { pipe, when } from "@fxts/core";
 import { select } from "@inquirer/prompts";
 import { message } from "@optique/core/message";

package/dist/ask/wf.js

@@ -1,5 +1,5 @@
 import { WEB_FRAMEWORK } from "../const.js";
-import webframeworks_default from "../webframeworks.js";
+import webframeworks_default from "../webframeworks/mod.js";
 import { select } from "@inquirer/prompts";
 
 //#region src/ask/wf.ts

package/dist/command.d.ts

@@ -2,24 +2,33 @@ import * as _optique_core0 from "@optique/core";
 import { InferValue } from "@optique/core";
 
 //#region src/command.d.ts
+
+/**
+ * The `@optique/core` option schema for the `fedify init` command.
+ * Defines `dir`, `webFramework`, `packageManager`, `kvStore`, `messageQueue`,
+ * and `dryRun` options that the CLI parser will accept.
+ */
 declare const initOptions: _optique_core0.Parser<"sync", {
   readonly dir: string;
-  readonly webFramework: "hono" | "nitro" | "next" | "elysia" | "express";
+  readonly webFramework: "hono" | "nitro" | "next" | "elysia" | "astro" | "express";
   readonly packageManager: "deno" | "pnpm" | "bun" | "yarn" | "npm";
   readonly kvStore: "denokv" | "redis" | "postgres";
   readonly messageQueue: "denokv" | "redis" | "postgres" | "amqp";
   readonly dryRun: boolean;
 }, {
   readonly dir: [_optique_core0.ValueParserResult<string>];
-  readonly webFramework: [_optique_core0.ValueParserResult<"hono" | "nitro" | "next" | "elysia" | "express">];
+  readonly webFramework: [_optique_core0.ValueParserResult<"hono" | "nitro" | "next" | "elysia" | "astro" | "express">];
   readonly packageManager: [_optique_core0.ValueParserResult<"deno" | "pnpm" | "bun" | "yarn" | "npm">];
   readonly kvStore: [_optique_core0.ValueParserResult<"denokv" | "redis" | "postgres">];
   readonly messageQueue: [_optique_core0.ValueParserResult<"denokv" | "redis" | "postgres" | "amqp">];
   readonly dryRun: _optique_core0.ValueParserResult<boolean>;
 }>;
+/**
+ * The `fedify init` CLI command parser.
+ */
 declare const initCommand: _optique_core0.Parser<"sync", {
   readonly dir: string;
-  readonly webFramework: "hono" | "nitro" | "next" | "elysia" | "express";
+  readonly webFramework: "hono" | "nitro" | "next" | "elysia" | "astro" | "express";
   readonly packageManager: "deno" | "pnpm" | "bun" | "yarn" | "npm";
   readonly kvStore: "denokv" | "redis" | "postgres";
   readonly messageQueue: "denokv" | "redis" | "postgres" | "amqp";
@@ -27,6 +36,10 @@ declare const initCommand: _optique_core0.Parser<"sync", {
 } & {
   readonly command: "init";
 }, ["matched", string] | ["parsing", Record<string | symbol, unknown>]>;
+/** The inferred value type produced by parsing the `fedify init` command. */
 type InitCommand = InferValue<typeof initCommand>;
+/**
+ * The `test-init` CLI command parser.
+ */
 //#endregion
 export { InitCommand, initCommand, initOptions };

package/dist/command.js

@@ -7,6 +7,11 @@ const webFramework = optional(option("-w", "--web-framework", choice(WEB_FRAMEWO
 const packageManager = optional(option("-p", "--package-manager", choice(PACKAGE_MANAGER, { metavar: "PACKAGE_MANAGER" }), { description: message`The package manager to use for installing dependencies.` }));
 const kvStore = optional(option("-k", "--kv-store", choice(KV_STORE, { metavar: "KV_STORE" }), { description: message`The key-value store to use for caching and some other features.` }));
 const messageQueue = optional(option("-m", "--message-queue", choice(MESSAGE_QUEUE, { metavar: "MESSAGE_QUEUE" }), { description: message`The message queue to use for background tasks.` }));
+/**
+* The `@optique/core` option schema for the `fedify init` command.
+* Defines `dir`, `webFramework`, `packageManager`, `kvStore`, `messageQueue`,
+* and `dryRun` options that the CLI parser will accept.
+*/
 const initOptions = object("Initialization options", {
 	dir: optional(argument(path({ metavar: "DIR" }), { description: message`The project directory to initialize.  If a specified directory does not exist, it will be created.` })),
 	webFramework,
@@ -15,6 +20,9 @@ const initOptions = object("Initialization options", {
 	messageQueue,
 	dryRun: option("--dry-run", { description: message`Perform a trial run with no changes made.` })
 });
+/**
+* The `fedify init` CLI command parser.
+*/
 const initCommand = command("init", merge(initOptions, object({ command: constant("init") })), {
 	brief: message`Initialize a new Fedify project directory.`,
 	description: message`Initialize a new Fedify project directory.
@@ -25,6 +33,9 @@ Unless you specify all options (${optionNames(["-w", "--web-framework"])}, ${opt
 });
 const noHydRun = object({ noHydRun: option("--no-hyd-run", { description: message`Log outputs without creating files.` }) });
 const noDryRun = object({ noDryRun: option("--no-dry-run", { description: message`Test with files creations and installations.` }) });
+/**
+* The `test-init` CLI command parser.
+*/
 const testInitCommand = command("test-init", merge(object("Initialization options", {
 	webFramework: multiple(webFramework),
 	packageManager: multiple(packageManager),

package/dist/const.d.ts

@@ -1,4 +1,7 @@
 //#region src/const.d.ts
+/** All supported package manager identifiers, in display order. */
 declare const PACKAGE_MANAGER: readonly ["deno", "pnpm", "bun", "yarn", "npm"];
+/** All supported web framework identifiers, in display order. */
+
 //#endregion
 export { PACKAGE_MANAGER };

package/dist/const.js

@@ -1,4 +1,5 @@
 //#region src/const.ts
+/** All supported package manager identifiers, in display order. */
 const PACKAGE_MANAGER = [
 	"deno",
 	"pnpm",
@@ -6,24 +7,32 @@ const PACKAGE_MANAGER = [
 	"yarn",
 	"npm"
 ];
+/** All supported web framework identifiers, in display order. */
 const WEB_FRAMEWORK = [
 	"hono",
 	"nitro",
 	"next",
 	"elysia",
+	"astro",
 	"express"
 ];
+/** All supported message queue backend identifiers. */
 const MESSAGE_QUEUE = [
 	"denokv",
 	"redis",
 	"postgres",
 	"amqp"
 ];
+/** All supported key-value store backend identifiers. */
 const KV_STORE = [
 	"denokv",
 	"redis",
 	"postgres"
 ];
+/**
+* External database services that need to be running for integration tests.
+* Used by the test suite to check service availability before running tests.
+*/
 const DB_TO_CHECK = [
 	"redis",
 	"postgres",

package/dist/deno.js

@@ -1,6 +1,6 @@
 //#region deno.json
 var name = "@fedify/init";
-var version = "2.1.0-dev.418+6c060f4a";
+var version = "2.1.0-dev.438+de6972c1";
 var license = "MIT";
 var exports = "./src/mod.ts";
 var imports = {

package/dist/json/kv.js

@@ -33,6 +33,23 @@ var postgres = {
 	"object": "new PostgresKvStore(postgres(process.env.POSTGRES_URL))",
 	"env": { "POSTGRES_URL": "postgres://postgres@localhost:5432/postgres" }
 };
+var mysql = {
+	"label": "MySQL/MariaDB",
+	"packageManagers": [
+		"deno",
+		"bun",
+		"npm",
+		"yarn",
+		"pnpm"
+	],
+	"dependencies": { "npm:mysql2": "^3.18.0" },
+	"imports": {
+		"@fedify/mysql": { "MysqlKvStore": "MysqlKvStore" },
+		"mysql2/promise": { "default": "mysql" }
+	},
+	"object": "new MysqlKvStore(mysql.createPool(process.env.MYSQL_URL))",
+	"env": { "MYSQL_URL": "mysql://root@localhost/fedify" }
+};
 var denokv = {
 	"label": "Deno KV",
 	"packageManagers": ["deno"],
@@ -43,6 +60,7 @@ var denokv = {
 var kv_default = {
 	redis,
 	postgres,
+	mysql,
 	denokv
 };
 

package/dist/json/kv.json

@@ -29,6 +29,21 @@
       "POSTGRES_URL": "postgres://postgres@localhost:5432/postgres"
     }
   },
+  "mysql": {
+    "label": "MySQL/MariaDB",
+    "packageManagers": ["deno", "bun", "npm", "yarn", "pnpm"],
+    "dependencies": {
+      "npm:mysql2": "^3.18.0"
+    },
+    "imports": {
+      "@fedify/mysql": { "MysqlKvStore": "MysqlKvStore" },
+      "mysql2/promise": { "default": "mysql" }
+    },
+    "object": "new MysqlKvStore(mysql.createPool(process.env.MYSQL_URL))",
+    "env": {
+      "MYSQL_URL": "mysql://root@localhost/fedify"
+    }
+  },
   "denokv": {
     "label": "Deno KV",
     "packageManagers": ["deno"],

package/dist/lib.js

@@ -6,7 +6,6 @@ import pm_default from "./json/pm.js";
 import rt_default from "./json/rt.js";
 import { entries, evolve, fromEntries, isObject, map, negate, pipe, throwIf } from "@fxts/core";
 import process from "node:process";
-import { commandLine, message } from "@optique/core/message";
 import { toMerged } from "es-toolkit";
 import { getLogger } from "@logtape/logtape";
 import { readFileSync } from "node:fs";
@@ -14,20 +13,44 @@ import { mkdir, readdir, writeFile } from "node:fs/promises";
 import { dirname, join as join$1 } from "node:path";
 
 //#region src/lib.ts
+/** The current `@fedify/init` package version, read from *deno.json*. */
 const PACKAGE_VERSION = deno_default.version;
+/** Logger instance for the `fedify init` command, scoped to `["fedify", "cli", "init"]`. */
 const logger = getLogger([
 	"fedify",
 	"cli",
 	"init"
 ]);
 const addFedifyDeps = (json) => Object.fromEntries(Object.entries(json).map(([key, value]) => [key, toMerged(value, { dependencies: { [`@fedify/${key}`]: PACKAGE_VERSION } })]));
+/**
+* KV store descriptions loaded from *json/kv.json*, enriched with the
+* appropriate `@fedify/*` dependency at the current package version.
+*/
 const kvStores = addFedifyDeps(kv_default);
+/**
+* Message queue descriptions loaded from *json/mq.json*, enriched with the
+* appropriate `@fedify/*` dependency at the current package version.
+*/
 const messageQueues = addFedifyDeps(mq_default);
 const toRegExp = (str) => new RegExp(str);
 const convertPattern = (obj) => pipe(obj, entries, map(([key, value]) => [key, evolve({ outputPattern: toRegExp })(value)]), fromEntries);
+/**
+* Package manager descriptions loaded from *json/pm.json*, with
+* `outputPattern` strings converted to `RegExp` instances.
+*/
 const packageManagers = convertPattern(pm_default);
+/**
+* Runtime descriptions loaded from *json/rt.json*, with `outputPattern`
+* strings converted to `RegExp` instances.
+*/
 const runtimes = convertPattern(rt_default);
+/** Returns the installation URL for the given package manager. */
 const getInstallUrl = (pm) => packageManagers[pm].installUrl;
+/**
+* Checks whether a package manager is installed and available on the system.
+* Runs the package manager's check command and verifies its output.
+* On Windows, also tries the `.cmd` variant of the command.
+*/
 async function isPackageManagerAvailable(pm) {
 	if (await isCommandAvailable(packageManagers[pm])) return true;
 	if (process.platform !== "win32") return false;
@@ -38,17 +61,19 @@ async function isPackageManagerAvailable(pm) {
 	})) return true;
 	return false;
 }
+/**
+* Reads a template file from the *templates/* directory and returns its content.
+* Appends `.tpl` to the given path before reading.
+*
+* @param templatePath - Relative path within the templates directory
+*   (e.g., `"defaults/federation.ts"`)
+* @returns The template file content as a string
+*/
 const readTemplate = (templatePath) => readFileSync(join$1(import.meta.dirname, "templates", ...(templatePath + ".tpl").split("/")), "utf8");
-const getInstruction = (pm, port) => message`
-To start the server, run the following command:
-
-  ${commandLine(getDevCommand(pm))}
-
-Then, try look up an actor from your server:
-
-  ${commandLine(`fedify lookup http://localhost:${port}/users/john`)}
-
-`;
+/**
+* Returns the shell command string to start the dev server for the given
+* package manager (e.g., `"deno task dev"`, `"bun dev"`, `"npm run dev"`).
+*/
 const getDevCommand = (pm) => pm === "deno" ? "deno task dev" : pm === "bun" ? "bun dev" : `${pm} run dev`;
 async function isCommandAvailable({ checkCommand, outputPattern }) {
 	try {
@@ -71,12 +96,24 @@ async function isCommandAvailable({ checkCommand, outputPattern }) {
 		throw error;
 	}
 }
+/**
+* Creates a file at the given path with the given content, creating
+* any necessary parent directories along the way.
+*/
 async function createFile(path, content) {
 	await mkdir(dirname(path), { recursive: true });
 	await writeFile(path, content);
 }
 const isNotExistsError = (e) => isObject(e) && "code" in e && e.code === "ENOENT";
+/**
+* Throws the given error unless it is an `ENOENT` (file not found) error.
+* Used to silently handle missing files while re-throwing other errors.
+*/
 const throwUnlessNotExists = throwIf(negate(isNotExistsError));
+/**
+* Checks whether a directory is empty or does not exist.
+* Returns `true` if the directory has no entries or does not exist yet.
+*/
 const isDirectoryEmpty = async (path) => {
 	try {
 		const files = await readdir(path);
@@ -86,45 +123,8 @@ const isDirectoryEmpty = async (path) => {
 		return true;
 	}
 };
-/**
-* Converts a package manager to its corresponding runtime.
-* @param pm - The package manager (deno, bun, npm, yarn, pnpm)
-* @returns The runtime name (deno, bun, or node)
-*/
-const packageManagerToRuntime = (pm) => pm === "deno" ? "deno" : pm === "bun" ? "bun" : "node";
-const getNextInitCommand = (pm) => [
-	...createNextAppCommand(pm),
-	".",
-	"--yes"
-];
-const createNextAppCommand = (pm) => pm === "deno" ? [
-	"deno",
-	"-Ar",
-	"npm:create-next-app@latest"
-] : pm === "bun" ? [
-	"bun",
-	"create",
-	"next-app"
-] : pm === "npm" ? ["npx", "create-next-app"] : [
-	pm,
-	"dlx",
-	"create-next-app"
-];
-const getNitroInitCommand = (pm) => [
-	...createNitroAppCommand(pm),
-	pm === "deno" ? "npm:giget@latest" : "giget@latest",
-	"nitro",
-	".",
-	"&&",
-	"rm",
-	"nitro.config.ts"
-];
-const createNitroAppCommand = (pm) => pm === "deno" ? [
-	"deno",
-	"run",
-	"-A"
-] : pm === "bun" ? ["bunx"] : pm === "npm" ? ["npx"] : [pm, "dlx"];
+/** Returns `true` if the current run is in test mode. */
 const isTest = ({ testMode }) => testMode;
 
 //#endregion
-export { PACKAGE_VERSION, createFile, getDevCommand, getInstallUrl, getInstruction, getNextInitCommand, getNitroInitCommand, isDirectoryEmpty, isPackageManagerAvailable, isTest, kvStores, logger, messageQueues, packageManagerToRuntime, packageManagers, readTemplate, runtimes, throwUnlessNotExists };
+export { PACKAGE_VERSION, createFile, getDevCommand, getInstallUrl, isDirectoryEmpty, isPackageManagerAvailable, isTest, kvStores, logger, messageQueues, packageManagers, readTemplate, runtimes, throwUnlessNotExists };

package/dist/templates/astro/astro.config.deno.ts.tpl

@@ -0,0 +1,10 @@
+import deno from "@deno/astro-adapter";
+import { fedifyIntegration } from "@fedify/astro";
+import { defineConfig } from "astro/config";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [fedifyIntegration()],
+  output: "server",
+  adapter: deno(),
+});

package/dist/templates/astro/astro.config.node.ts.tpl

@@ -0,0 +1,10 @@
+import node from "@astrojs/node";
+import { fedifyIntegration } from "@fedify/astro";
+import { defineConfig } from "astro/config";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [fedifyIntegration()],
+  output: "server",
+  adapter: node({ mode: "standalone" }),
+});

package/dist/templates/astro/src/middleware.ts.tpl

@@ -0,0 +1,4 @@
+import { fedifyMiddleware } from "@fedify/astro";
+import federation from "./federation.ts";
+
+export const onRequest = fedifyMiddleware(federation, (_context) => undefined);