Merge branch '2.1-maintenance'

Author: dahlia

CHANGES.md

@@ -262,6 +262,24 @@ To be released.
 [#722]: https://github.com/fedify-dev/fedify/pull/722
 
 
+Version 2.1.11
+--------------
+
+To be released.
+
+### @fedify/init
+
+ -  Fixed the Astro, Nitro, and Next.js project templates so their generated
+    *logging.ts* files are loaded during server startup before Fedify handles
+    requests.  Nitro projects now get a server plugin that imports the LogTape
+    configuration, Next.js projects get an *instrumentation.ts* `register()`
+    hook that imports it in the Node.js runtime, and Astro projects import it
+    in *src/middleware.ts*.  [[#725], [#727]]
+
+[#725]: https://github.com/fedify-dev/fedify/issues/725
+[#727]: https://github.com/fedify-dev/fedify/pull/727
+
+
 Version 2.1.10
 --------------
 
@@ -691,6 +709,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
 --------------
 

deno.lock

@@ -1,3 +1,4 @@
+import "./logging.ts";
 import { fedifyMiddleware } from "@fedify/astro";
 import federation from "./federation.ts";
 

packages/init/src/templates/astro/src/middleware.ts.tpl

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

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

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

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

@@ -0,0 +1,69 @@
+import { ok } from "node:assert/strict";
+import test from "node:test";
+import astroDescription from "./webframeworks/astro.ts";
+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,
+    allowNonEmpty: false,
+  });
+
+  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,
+    allowNonEmpty: false,
+  });
+
+  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")'));
+});
+
+test("Astro template loads LogTape through middleware", async () => {
+  const { files } = await astroDescription.init({
+    projectName: "test-app",
+    dir: ".",
+    command: "init",
+    packageManager: "npm",
+    kvStore: "in-memory",
+    messageQueue: "in-process",
+    webFramework: "astro",
+    testMode: false,
+    dryRun: true,
+    allowNonEmpty: false,
+  });
+
+  ok(files);
+  const middleware = files["src/middleware.ts"];
+  ok(middleware);
+  ok(middleware.includes('import "./logging.ts";'));
+});

packages/init/src/webframeworks.test.ts

@@ -22,6 +22,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" && {
         "eslint.config.ts": await readTemplate("defaults/eslint.config.ts"),

packages/init/src/webframeworks/next.ts

@@ -19,6 +19,9 @@ const nitroDescription: WebFrameworkDescription = {
     loggingFile: "server/logging.ts",
     env: testMode ? { HOST: "127.0.0.1" } : {} as Record<string, string>,
     files: {
+      "server/plugins/logging.ts": await readTemplate(
+        "nitro/server/plugins/logging.ts",
+      ),
       "server/middleware/federation.ts": await readTemplate(
         "nitro/server/middleware/federation.ts",
       ),