error-mom 0.1.1 → 0.3.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.3.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);
@@ -112,17 +112,18 @@ program.command("init").description("Create/select a project, install the SDK, a
   const setupPath = await writeSetup(framework);
   await writeFile(
     join(process.cwd(), ".error-mom.json"),
-    `${JSON.stringify({ server: config.server, projectId: project.id, projectName: project.name, framework }, null, 2)}
+    `${JSON.stringify({ server: config.server, projectId: project.id, projectName: project.name, framework: framework.id }, null, 2)}
 `
   );
   await appendEnvironment(framework, config.server, project.ingestKey);
   print({
     installed: !options.skipInstall,
     project: { id: project.id, name: project.name, slug: project.slug },
-    framework,
+    framework: framework.id,
     setupFile: setupPath,
     verified: false,
-    nextAction: `Import ${setupPath} from the earliest ${framework} entry point, then run error-mom doctor --project-key <key>.`
+    wiring: framework.wiring,
+    nextAction: `Wire it up: ${framework.wiring} For handlers where a framework catches errors itself (queue/cron jobs, webhooks, MCP tools), wrap each with errorMom.wrap(fn, { culprit: "<name>" }). Then run error-mom doctor --project-key <key>.`
   });
 });
 program.command("mcp").description("Run Error Mom tools over MCP stdio for coding agents").action(async () => {
@@ -243,14 +244,125 @@ async function readPackageJson(cwd) {
     );
   }
 }
+var FRAMEWORKS = [
+  [
+    "next",
+    {
+      id: "next",
+      envStyle: "next",
+      wiring: "Import the setup file from the root layout for client errors; the generated instrumentation.ts already reports server errors (API routes, SSR, server actions)."
+    }
+  ],
+  [
+    "@tauri-apps/api",
+    {
+      id: "tauri",
+      envStyle: "vite",
+      wiring: "Import the setup file first in the webview entry (main.tsx or equivalent). If the app spawns Node sidecar processes, also call initErrorMom from @kenkaiiii/error-mom/node at each sidecar entry so backend/LLM errors are reported too. Rust-side panics are not captured."
+    }
+  ],
+  [
+    "electron",
+    {
+      id: "electron",
+      envStyle: "node",
+      wiring: "Call initErrorMom from @kenkaiiii/error-mom/node at the TOP of the main process entry, and import @kenkaiiii/error-mom (browser build) first in each renderer entry. Both report to the same project."
+    }
+  ],
+  [
+    "astro",
+    {
+      id: "astro",
+      envStyle: "vite",
+      wiring: "Load the setup file as a client script in the base layout so it runs on every page. For SSR/API routes, add src/middleware.ts that wraps next() with errorMom.wrap using @kenkaiiii/error-mom/node."
+    }
+  ],
+  [
+    "@sveltejs/kit",
+    {
+      id: "sveltekit",
+      envStyle: "vite",
+      wiring: "Import the setup file in hooks.client.ts and export handleError from BOTH hooks.client.ts and hooks.server.ts calling errorMom.captureError(error); the server hook uses @kenkaiiii/error-mom/node. SvelteKit catches load/endpoint errors, so handleError is its official reporting hook."
+    }
+  ],
+  [
+    "nuxt",
+    {
+      id: "nuxt",
+      envStyle: "vite",
+      wiring: "Create a client plugin (plugins/error-mom.client.ts) importing the setup file, and a nitro plugin hooking 'error' with @kenkaiiii/error-mom/node for server-side errors."
+    }
+  ],
+  [
+    "@remix-run/react",
+    {
+      id: "remix",
+      envStyle: "node",
+      wiring: "Import the setup file in entry.client.tsx, and export handleError from entry.server.tsx calling errorMom.captureError(error). Remix catches loader/action errors and handleError is its official reporting hook."
+    }
+  ],
+  [
+    "@angular/core",
+    {
+      id: "angular",
+      envStyle: "node",
+      wiring: "Import the setup file in main.ts and provide a custom ErrorHandler that calls errorMom.captureError(error). Angular catches component errors in its own handler."
+    }
+  ],
+  [
+    "express",
+    {
+      id: "express",
+      envStyle: "node",
+      wiring: "Import the setup file at the TOP of the server entry, and add a final error middleware: (err, req, res, next) => { errorMom.captureError(err, { culprit: `${req.method} ${req.path}` }); next(err); }. Express catches route errors, so the middleware is where they surface."
+    }
+  ],
+  [
+    "fastify",
+    {
+      id: "fastify",
+      envStyle: "node",
+      wiring: "Import the setup file at the TOP of the server entry, and call errorMom.captureError(error) inside setErrorHandler before replying. Fastify catches handler errors there."
+    }
+  ],
+  [
+    "hono",
+    {
+      id: "hono",
+      envStyle: "node",
+      wiring: "Import the setup file at the TOP of the server entry, and call errorMom.captureError(err) inside app.onError. Hono catches handler errors there."
+    }
+  ],
+  [
+    "@nestjs/core",
+    {
+      id: "nestjs",
+      envStyle: "node",
+      wiring: "Import the setup file at the TOP of main.ts, and add a global exception filter that calls errorMom.captureError(exception) before delegating to the base filter."
+    }
+  ],
+  [
+    "vite",
+    {
+      id: "vite",
+      envStyle: "vite",
+      wiring: "Import the setup file first in the app entry (main.tsx or equivalent)."
+    }
+  ]
+];
 function detectFramework(packageJson) {
   const dependencies = {
     ...packageJson.dependencies ?? {},
     ...packageJson.devDependencies ?? {}
   };
-  if (dependencies.next) return "next";
-  if (dependencies.vite) return "vite";
-  return "node";
+  for (const [dependency, info] of FRAMEWORKS) {
+    if (dependencies[dependency]) return info;
+  }
+  return {
+    id: "node",
+    envStyle: "node",
+    wiring: "Import the setup file at the TOP of the main entry point, before anything else."
+  };
 }
 function detectPackageManager(cwd) {
   if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
@@ -271,30 +383,59 @@ function installSdk(packageManager) {
 async function writeSetup(framework) {
   const sourceDirectory = existsSync(join(process.cwd(), "src")) ? "src" : ".";
   const relativePath = join(sourceDirectory, "error-mom.ts");
-  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}";
+  if (framework.id === "next") await writeNextInstrumentation(sourceDirectory);
+  const environment = framework.envStyle === "next" ? "process.env.NEXT_PUBLIC_" : framework.envStyle === "vite" ? "import.meta.env.VITE_" : "process.env.";
+  const moduleName = framework.envStyle === "node" ? "@kenkaiiii/error-mom/node" : "@kenkaiiii/error-mom";
+  const contents = `${framework.id === "next" ? '"use client";\n\n' : ""}import { initErrorMom } from "${moduleName}";
 
 const server = ${environment}ERROR_MOM_SERVER;
 const projectKey = ${environment}ERROR_MOM_PROJECT_KEY;
 const release = ${environment}ERROR_MOM_RELEASE;
 
-if (!server || !projectKey) {
-  throw new Error("ERROR_MOM_SERVER and ERROR_MOM_PROJECT_KEY are required");
-}
-
-initErrorMom({
-  server,
-  projectKey,
-  environment: ${environment}ERROR_MOM_ENVIRONMENT ?? "production",
-  ...(release ? { release } : {}),
-});
+export const errorMom =
+  server && projectKey
+    ? initErrorMom({
+        server,
+        projectKey,
+        environment: ${environment}ERROR_MOM_ENVIRONMENT ?? "production",
+        ...(release ? { release } : {}),
+      })
+    : undefined;
 `;
   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 prefix = framework.envStyle === "next" ? "NEXT_PUBLIC_" : framework.envStyle === "vite" ? "VITE_" : "";
   const file = join(process.cwd(), ".env.local");
   const existing = existsSync(file) ? await readFile(file, "utf8") : "";
   const lines = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "error-mom",
-  "version": "0.1.1",
+  "version": "0.3.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"
+  }
+}