error-mom 0.2.0 → 0.3.0

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.2.0";
+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: 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>.`
+    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,25 +383,24 @@ 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}";
+  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;
@@ -324,7 +435,7 @@ export const onRequestError: Instrumentation.onRequestError = async (
   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.2.0",
+  "version": "0.3.0",
   "description": "Agent-first CLI and MCP tools for self-hosted Error Mom",
   "type": "module",
   "bin": {