error-mom 0.1.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ken Kai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.js

@@ -10,7 +10,7 @@ import { Command } from "commander";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-var VERSION = "0.1.1";
+var VERSION = "0.2.0";
 var CONFIG_DIR = join(homedir(), ".error-mom");
 var CONFIG_FILE = join(CONFIG_DIR, "config.json");
 var program = new Command().name("error-mom").description("Query and operate a self-hosted Error Mom incident desk").version(VERSION);
@@ -122,7 +122,7 @@ program.command("init").description("Create/select a project, install the SDK, a
     framework,
     setupFile: setupPath,
     verified: false,
-    nextAction: `Import ${setupPath} from the earliest ${framework} entry point, then run error-mom doctor --project-key <key>.`
+    nextAction: framework === "next" ? `Import ${setupPath} from the root layout for client errors; instrumentation.ts already reports server errors. For jobs/handlers that catch errors themselves (queues, webhooks, MCP tools), wrap them with errorMom.wrap(fn). Then run error-mom doctor --project-key <key>.` : `Import ${setupPath} from the earliest ${framework} entry point. For code where a framework catches errors itself (job runners, webhooks, MCP tools), wrap handlers with errorMom.wrap(fn). Then run error-mom doctor --project-key <key>.`
   });
 });
 program.command("mcp").description("Run Error Mom tools over MCP stdio for coding agents").action(async () => {
@@ -271,6 +271,7 @@ function installSdk(packageManager) {
 async function writeSetup(framework) {
   const sourceDirectory = existsSync(join(process.cwd(), "src")) ? "src" : ".";
   const relativePath = join(sourceDirectory, "error-mom.ts");
+  if (framework === "next") await writeNextInstrumentation(sourceDirectory);
   const environment = framework === "next" ? "process.env.NEXT_PUBLIC_" : framework === "vite" ? "import.meta.env.VITE_" : "process.env.";
   const moduleName = framework === "node" ? "@kenkaiiii/error-mom/node" : "@kenkaiiii/error-mom";
   const contents = `${framework === "next" ? '"use client";\n\n' : ""}import { initErrorMom } from "${moduleName}";
@@ -293,6 +294,35 @@ initErrorMom({
   await writeFile(join(process.cwd(), relativePath), contents);
   return relativePath;
 }
+async function writeNextInstrumentation(sourceDirectory) {
+  const file = join(process.cwd(), sourceDirectory, "instrumentation.ts");
+  if (existsSync(file)) return;
+  const contents = `import type { Instrumentation } from "next";
+
+// Reports server-side errors (API routes, SSR, server actions, middleware)
+// that Next.js catches before they can become uncaught exceptions.
+export const onRequestError: Instrumentation.onRequestError = async (
+  error,
+  request,
+  context,
+) => {
+  if (process.env.NEXT_RUNTIME !== "nodejs") return;
+  const server = process.env.NEXT_PUBLIC_ERROR_MOM_SERVER;
+  const projectKey = process.env.NEXT_PUBLIC_ERROR_MOM_PROJECT_KEY;
+  if (!server || !projectKey) return;
+  const { initErrorMom } = await import("@kenkaiiii/error-mom/node");
+  initErrorMom({
+    server,
+    projectKey,
+    environment: process.env.NEXT_PUBLIC_ERROR_MOM_ENVIRONMENT ?? "production",
+  }).captureError(error, {
+    culprit: \`\${request.method} \${request.path}\`,
+    tags: { routerKind: context.routerKind, routeType: context.routeType, runtime: "server" },
+  });
+};
+`;
+  await writeFile(file, contents);
+}
 async function appendEnvironment(framework, server, key) {
   const prefix = framework === "next" ? "NEXT_PUBLIC_" : framework === "vite" ? "VITE_" : "";
   const file = join(process.cwd(), ".env.local");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "error-mom",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Agent-first CLI and MCP tools for self-hosted Error Mom",
   "type": "module",
   "bin": {
@@ -11,11 +11,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup src/cli.ts --format esm --dts --clean",
-    "check": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^15.0.0",
@@ -28,5 +23,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --dts --clean",
+    "check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}