Merge branch '2.0-maintenance' into 2.1-maintenance

Author: dahlia

CHANGES.md

@@ -8,6 +8,17 @@ Version 2.1.11
 
 To be released.
 
+### @fedify/init
+
+ -  Fixed the Nitro and Next.js project templates so their generated
+    *logging.ts* files are loaded during server startup.  Nitro projects now
+    get a server plugin that imports the LogTape configuration, and Next.js
+    projects get an *instrumentation.ts* `register()` hook that imports it in
+    the Node.js runtime before Fedify handles requests.  [[#725], [#727]]
+
+[#725]: https://github.com/fedify-dev/fedify/issues/725
+[#727]: https://github.com/fedify-dev/fedify/pull/727
+
 
 Version 2.1.10
 --------------
@@ -440,6 +451,20 @@ Released on March 24, 2026.
 [#599]: https://github.com/fedify-dev/fedify/pull/599
 
 
+Version 2.0.15
+--------------
+
+To be released.
+
+### @fedify/init
+
+ -  Fixed the Nitro and Next.js project templates so their generated
+    *logging.ts* files are loaded during server startup.  Nitro projects now
+    get a server plugin that imports the LogTape configuration, and Next.js
+    projects get an *instrumentation.ts* `register()` hook that imports it in
+    the Node.js runtime before Fedify handles requests.  [[#725], [#727]]
+
+
 Version 2.0.14
 --------------
 

packages/init/src/templates/next/instrumentation.ts.tpl

@@ -0,0 +1,5 @@
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("./logging");
+  }
+}

packages/init/src/templates/nitro/server/plugins/logging.ts.tpl

@@ -0,0 +1,3 @@
+import "../logging";
+
+export default function setupLogging() {}

packages/init/src/webframeworks.test.ts

@@ -0,0 +1,46 @@
+import { ok } from "node:assert/strict";
+import test from "node:test";
+import nextDescription from "./webframeworks/next.ts";
+import nitroDescription from "./webframeworks/nitro.ts";
+
+test("Nitro template loads LogTape during server startup", async () => {
+  const { files } = await nitroDescription.init({
+    projectName: "test-app",
+    dir: ".",
+    command: "init",
+    packageManager: "npm",
+    kvStore: "in-memory",
+    messageQueue: "in-process",
+    webFramework: "nitro",
+    testMode: false,
+    dryRun: true,
+  });
+
+  ok(files);
+  ok("server/plugins/logging.ts" in files);
+  const plugin = files["server/plugins/logging.ts"];
+  ok(plugin);
+  ok(plugin.includes('import "../logging";'));
+});
+
+test("Next.js template loads LogTape through instrumentation", async () => {
+  const { files } = await nextDescription.init({
+    projectName: "test-app",
+    dir: ".",
+    command: "init",
+    packageManager: "npm",
+    kvStore: "in-memory",
+    messageQueue: "in-process",
+    webFramework: "next",
+    testMode: false,
+    dryRun: true,
+  });
+
+  ok(files);
+  ok("instrumentation.ts" in files);
+  const instrumentation = files["instrumentation.ts"];
+  ok(instrumentation);
+  ok(instrumentation.includes("export async function register()"));
+  ok(instrumentation.includes("process.env.NEXT_RUNTIME"));
+  ok(instrumentation.includes('await import("./logging")'));
+});

packages/init/src/webframeworks/next.ts

@@ -21,6 +21,7 @@ const nextDescription: WebFrameworkDescription = {
     federationFile: "federation/index.ts",
     loggingFile: "logging.ts",
     files: {
+      "instrumentation.ts": await readTemplate("next/instrumentation.ts"),
       "middleware.ts": await readTemplate("next/middleware.ts"),
       ...(pm !== "deno"
         ? {

packages/init/src/webframeworks/nitro.ts

@@ -18,6 +18,9 @@ const nitroDescription: WebFrameworkDescription = {
     federationFile: "server/federation.ts",
     loggingFile: "server/logging.ts",
     files: {
+      "server/plugins/logging.ts": await readTemplate(
+        "nitro/server/plugins/logging.ts",
+      ),
       "server/middleware/federation.ts": await readTemplate(
         "nitro/server/middleware/federation.ts",
       ),