fedify-dev · 2chanhaeng · Oct 22, 2025 · Oct 23, 2025 · Oct 23, 2025 · Oct 23, 2025
diff --git a/CHANGES.md b/CHANGES.md
@@ -126,6 +126,12 @@ To be released.
     `-t`/`--traverse` option, allowing users to traverse multiple collections
     in a single command.  [[#408], [#449] by Jiwon Kwon]
 
+ -  Added `fedify test-init` command to test `fedify init` command.  This
+    command create test server with various combinations of options and test
+    the server using `fedify lookup` command.  This command is for
+    contributors who make integration with various frameworks.  [[#461] by
+    Chanhaeng Lee]
+
 [#374]: https://github.com/fedify-dev/fedify/issues/374
 [#397]: https://github.com/fedify-dev/fedify/issues/397
 [#408]: https://github.com/fedify-dev/fedify/issues/408
@@ -134,6 +140,7 @@ To be released.
 [#456]: https://github.com/fedify-dev/fedify/issues/456
 [#457]: https://github.com/fedify-dev/fedify/pull/457
 [#458]: https://github.com/fedify-dev/fedify/pull/458
+[#461]: https://github.com/fedify-dev/fedify/issues/461
 
 ### @fedify/relay
 

diff --git a/deno.lock b/deno.lock
diff --git a/docs/cli.md b/docs/cli.md
@@ -120,10 +120,8 @@ fedify init my-fedify-project
 The above command will start the interactive prompt to initialize a new Fedify
 project.  It will ask you a few questions to set up the project:
 
- -  JavaScript runtime: [Deno], [Bun], or [Node.js]
- -  Package manager (if Node.js): [npm], [pnpm], or [Yarn]
- -  Web framework: Bare-bones, [Fresh] (if Deno), [Hono], [Express] (unless
-    Deno), or [Nitro] (unless Deno)
+ -  Package manager: [Deno], [Bun], [npm], [pnpm], or [Yarn]
+ -  Web framework: [Hono], [Express], [Nitro], or [Next.js] 
  -  key–value store: In-memory, [Redis], [PostgreSQL], or [Deno KV] (if Deno)
  -  Message queue: In-memory, [Redis], [PostgreSQL], [AMQP] (e.g., [RabbitMQ]),
     or [Deno KV] (if Deno)
@@ -138,6 +136,7 @@ interactive prompts:
 [Hono]: https://hono.dev/
 [Express]: https://expressjs.com/
 [Nitro]: https://nitro.unjs.io/
+[Next.js]: https://nextjs.org/
 [Redis]: https://redis.io/
 [PostgreSQL]: https://www.postgresql.org/
 [AMQP]: https://www.amqp.org/
@@ -225,6 +224,81 @@ This option works with all other initialization options, allowing you to preview
 different configurations before making a decision.
 
 
+`fedify test-init`: Testing ActivityPub initialization
+------------------------------------------------------
+
+*This command is available since Fedify 2.0.0.*
+
+> [!WARNING]
+> `bun`, `yarn` runtime and `Next.js` web framework are not supported in this 
+> command yet.
+
+> [!NOTE]
+> You need to install and run [Redis server], [PostgreSQL server], and AMQP
+> server (e.g., [RabbitMQ server])locally to test those integrations.
+
+
+The `fedify test-init` command is used to test the `fedify init` command.
+It creates a temporary Fedify project with various combinations of options and
+tests the server using `lookup` command.  This command is for contributors who
+make integration with various frameworks.
+
+~~~~ sh
+fedify test-init
+~~~~
+
+The above command will start testing the `fedify init` command with various 
+combinations of options and configurations. It will create temporary 
+directories for each test case, initialize a Fedify project with the specified 
+options, start the server, and run the `fedify lookup` command to verify that 
+the server is functioning correctly.
+
+If you want to test a specific combination of options, you can specify them
+with `fedify init` options. For example, the below command tests the `fedify
+init` command with Deno runtime and Hono web framework:
+
+~~~~ sh
+fedify test-init -r deno -w hono
+~~~~
+
+If you do not specify some options, it will test all the available options for 
+those. So the above command will test all combinations of key–value stores and 
+message queues with Deno runtime and Hono web framework.
+
+You can also specify several options in a single category. For example, the
+below command tests the `fedify init` command with both Redis and PostgreSQL as
+key–value stores:
+
+~~~~ sh
+fedify test-init -k redis -k postgres
+~~~~
+
+
+[Redis server]: https://redis.io/docs/latest/operate/oss_and_stack/install/archive/install-redis/
+[PostgreSQL server]: https://www.postgresql.org/download/
+[RabbitMQ server]: https://www.rabbitmq.com/docs/download
+
+### `-h`/`--hyd-run`: Create temporary project and `lookup` an object
+
+If you want to test except `--dry-run` option, you can use the `-h`/`--hyd-run` option. This will create a temporary project and run the `lookup` command on it.
+
+~~~~ sh
+fedify test-init -h
+~~~~
+
+### `-d`/`--dry-run`: Preview without creating files
+
+If you want to test dry-run only, you can use the `-d`/`--dry-run` option. 
+This will save outputs and errors to text files instead of creating a 
+temporary project.
+
+~~~~ sh
+fedify test-init -d
+~~~~
+
+If you did not specify `-h` or `-d` option, it will run both options by 
+default.
+
 `fedify lookup`: Looking up an ActivityPub object
 -------------------------------------------------
 

diff --git a/packages/cli/src/init/action/configs.ts b/packages/cli/src/init/action/configs.ts
@@ -1,4 +1,16 @@
-import { join as joinPath } from "node:path";
+import {
+  concat,
+  filter,
+  keys,
+  map,
+  pick,
+  pipe,
+  toArray,
+} from "@fxts/core/index.js";
+import { uniq } from "es-toolkit";
+import { realpathSync } from "node:fs";
+import { join as joinPath, relative } from "node:path";
+import { merge } from "../../utils.ts";
 import biome from "../json/biome.json" with { type: "json" };
 import vscodeSettingsForDeno from "../json/vscode-settings-for-deno.json" with {
   type: "json",
@@ -7,6 +19,8 @@ import vscodeSettings from "../json/vscode-settings.json" with {
   type: "json",
 };
 import type { InitCommandData } from "../types.ts";
+import { PACKAGES_PATH } from "./const.ts";
+import { getDependencies, getDevDependencies, joinDepsReg } from "./deps.ts";
 
 /**
  * Loads Deno configuration object with compiler options, unstable features, and tasks.
@@ -16,20 +30,47 @@ import type { InitCommandData } from "../types.ts";
  * @returns Configuration object with path and Deno-specific settings
  */
 export const loadDenoConfig = (
-  { kv, mq, initializer, dir }: InitCommandData,
+  data: InitCommandData,
 ) => ({
-  path: joinPath(dir, "deno.json"),
+  path: "deno.json",
   data: {
-    compilerOptions: initializer.compilerOptions,
+    ...pick(["compilerOptions", "tasks"], data.initializer),
+    unstable: getUnstable(data),
+    nodeModulesDir: "auto",
+    imports: joinDepsReg("deno")(getDependencies(data)),
+    ...(data.testMode ? { links: getLinks(data) } : {}),
   },
-  unstable: [
-    "temporal",
-    ...kv.denoUnstable ?? [],
-    ...mq.denoUnstable ?? [],
-  ],
-  tasks: initializer.tasks,
 });
 
+const getUnstable = <T extends Pick<InitCommandData, "kv" | "mq">>({
+  kv: { denoUnstable: kv = [] },
+  mq: { denoUnstable: mq = [] },
+}: T) =>
+  pipe(
+    ["temporal"],
+    concat(kv),
+    concat(mq),
+    toArray,
+    uniq,
+  );
+
+const getLinks = <
+  T extends Pick<InitCommandData, "kv" | "mq" | "initializer" | "dir">,
+>({ kv, mq, initializer, dir }: T) =>
+  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) => joinPath(PACKAGES_PATH, dep)),
+    map((absolutePath) => realpathSync(absolutePath)),
+    map((realAbsolutePath) => relative(realpathSync(dir), realAbsolutePath)),
+    toArray,
+  );
+
 /**
  * Loads TypeScript configuration object for Node.js/Bun projects.
  * Uses compiler options from the framework initializer.
@@ -51,11 +92,15 @@ export const loadTsConfig = ({ initializer, dir }: InitCommandData) => ({
  * @param param0 - Destructured initialization data containing initializer and directory
  * @returns Configuration object with path and package.json settings
  */
-export const loadPackageJson = ({ initializer, dir }: InitCommandData) => ({
-  path: joinPath(dir, "package.json"),
+export const loadPackageJson = (
+  data: InitCommandData,
+) => ({
+  path: "package.json",
   data: {
     type: "module",
-    scripts: initializer.tasks,
+    scripts: data.initializer.tasks,
+    dependencies: getDependencies(data),
+    devDependencies: getDevDependencies(data),
   },
 });
 

diff --git a/packages/cli/src/init/action/const.ts b/packages/cli/src/init/action/const.ts
@@ -0,0 +1,9 @@
+import { join as joinPath } from "node:path";
+
+export const PACKAGES_PATH = joinPath(
+  import.meta.dirname!, // action
+  "..", // init
+  "..", // src
+  "..", // cli
+  "..", // packages
+);