@open-mercato/cli 0.6.7-develop.6828.1.ab1620a63e → 0.6.7-develop.6842.1.8cd8a8883c

package/dist/bin.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bin.ts"],
-  "sourcesContent": ["/**\n * CLI binary entry point for @open-mercato/cli package.\n *\n * Called from within a Next.js app directory as: yarn mercato <command>\n * Uses dynamic app resolution to find generated files at .mercato/generated/\n */\nimport { run } from './mercato.js'\n\n// Commands that can run without bootstrap (without generated files)\n// - generate: creates the generated files\n// - db: uses resolver directly to find modules and migrations\n// - init: runs yarn commands to set up the app\n// - help: just shows help text\nconst BOOTSTRAP_FREE_COMMANDS = [\n  'generate',\n  'module',\n  'deploy',\n  'db',\n  'init',\n  'agentic:init',\n  'eject',\n  'test',\n  'test:integration',\n  'test:integration:coverage',\n  'test:integration:spec-coverage',\n  'test:ephemeral',\n  'test:integration:interactive',\n  'umes:list',\n  'umes:inspect',\n  'umes:check',\n  'help',\n  '--help',\n  '-h',\n]\n\nfunction assertNode24Runtime(): void {\n  const detectedNodeVersion = process.versions.node\n  const majorVersion = Number.parseInt(detectedNodeVersion.split('.')[0] ?? '0', 10)\n  if (majorVersion >= 24) {\n    return\n  }\n  throw new Error(\n    [\n      'Unsupported Node.js runtime.',\n      `Cause: Detected Node ${detectedNodeVersion}, but Open Mercato requires Node 24.x.`,\n      'What to do: switch your shell to Node 24 (for example `nvm use 24`), run `yarn install`, then retry.',\n    ].join(' '),\n  )\n}\n\nfunction needsBootstrap(argv: string[]): boolean {\n  const [, , first] = argv\n  if (!first) return false // help screen\n  return !BOOTSTRAP_FREE_COMMANDS.includes(first)\n}\n\nasync function tryBootstrap(): Promise<boolean> {\n  try {\n    const { bootstrapFromAppRoot } = await import('@open-mercato/shared/lib/bootstrap/dynamicLoader')\n    const { registerCliModules } = await import('./mercato.js')\n    // Use the CLI resolver to find the app directory (handles monorepo detection)\n    const { createResolver } = await import('./lib/resolver.js')\n    const resolver = createResolver()\n    const appDir = resolver.getAppDir()\n    const data = await bootstrapFromAppRoot(appDir)\n    // Register CLI modules directly to avoid module resolution issues\n    registerCliModules(data.modules)\n    return true\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    // Check if the error is about missing generated files\n    if (\n      message.includes('Cannot find module') &&\n      (message.includes('/generated/') || message.includes('.generated') || message.includes('.mercato'))\n    ) {\n      return false\n    }\n    // Re-throw other errors\n    throw err\n  }\n}\n\nasync function main(): Promise<void> {\n  assertNode24Runtime()\n  const requiresBootstrap = needsBootstrap(process.argv)\n\n  if (requiresBootstrap) {\n    const bootstrapSucceeded = await tryBootstrap()\n    if (!bootstrapSucceeded) {\n      console.error('\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557')\n      console.error('\u2551  Generated files not found!                                       \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551  The CLI requires generated files to discover modules.           \u2551')\n      console.error('\u2551  Please run the following command first:                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551    yarn mercato generate                                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D')\n      process.exit(1)\n    }\n  }\n\n  const code = await run(process.argv)\n  process.exit(code ?? 0)\n}\n\nmain().catch((error: unknown) => {\n  if (error instanceof Error) {\n    console.error(error.message)\n  } else {\n    console.error(error)\n  }\n  process.exit(1)\n})\n"],
-  "mappings": "AAMA,SAAS,WAAW;AAOpB,MAAM,0BAA0B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,sBAA4B;AACnC,QAAM,sBAAsB,QAAQ,SAAS;AAC7C,QAAM,eAAe,OAAO,SAAS,oBAAoB,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE;AACjF,MAAI,gBAAgB,IAAI;AACtB;AAAA,EACF;AACA,QAAM,IAAI;AAAA,IACR;AAAA,MACE;AAAA,MACA,wBAAwB,mBAAmB;AAAA,MAC3C;AAAA,IACF,EAAE,KAAK,GAAG;AAAA,EACZ;AACF;AAEA,SAAS,eAAe,MAAyB;AAC/C,QAAM,CAAC,EAAE,EAAE,KAAK,IAAI;AACpB,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,CAAC,wBAAwB,SAAS,KAAK;AAChD;AAEA,eAAe,eAAiC;AAC9C,MAAI;AACF,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,kDAAkD;AAChG,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,cAAc;AAE1D,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,mBAAmB;AAC3D,UAAM,WAAW,eAAe;AAChC,UAAM,SAAS,SAAS,UAAU;AAClC,UAAM,OAAO,MAAM,qBAAqB,MAAM;AAE9C,uBAAmB,KAAK,OAAO;AAC/B,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAE/D,QACE,QAAQ,SAAS,oBAAoB,MACpC,QAAQ,SAAS,aAAa,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,UAAU,IACjG;AACA,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,OAAsB;AACnC,sBAAoB;AACpB,QAAM,oBAAoB,eAAe,QAAQ,IAAI;AAErD,MAAI,mBAAmB;AACrB,UAAM,qBAAqB,MAAM,aAAa;AAC9C,QAAI,CAAC,oBAAoB;AACvB,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,OAAO,MAAM,IAAI,QAAQ,IAAI;AACnC,UAAQ,KAAK,QAAQ,CAAC;AACxB;AAEA,KAAK,EAAE,MAAM,CAAC,UAAmB;AAC/B,MAAI,iBAAiB,OAAO;AAC1B,YAAQ,MAAM,MAAM,OAAO;AAAA,EAC7B,OAAO;AACL,YAAQ,MAAM,KAAK;AAAA,EACrB;AACA,UAAQ,KAAK,CAAC;AAChB,CAAC;",
+  "sourcesContent": ["/**\n * CLI binary entry point for @open-mercato/cli package.\n *\n * Called from within a Next.js app directory as: yarn mercato <command>\n * Uses dynamic app resolution to find generated files at .mercato/generated/\n */\nimport {\n  getTelemetryRuntime,\n  isTelemetryBackendEnabled,\n} from '@open-mercato/shared/lib/telemetry/runtime'\n// `run` is imported dynamically inside `main()` so telemetry can initialize\n// before the mercato entry (and its Postgres driver) loads \u2014 see main().\n\n// Commands that can run without bootstrap (without generated files)\n// - generate: creates the generated files\n// - db: uses resolver directly to find modules and migrations\n// - init: runs yarn commands to set up the app\n// - help: just shows help text\nconst BOOTSTRAP_FREE_COMMANDS = [\n  'generate',\n  'module',\n  'deploy',\n  'db',\n  'init',\n  'agentic:init',\n  'telemetry',\n  'eject',\n  'test',\n  'test:integration',\n  'test:integration:coverage',\n  'test:integration:spec-coverage',\n  'test:ephemeral',\n  'test:integration:interactive',\n  'umes:list',\n  'umes:inspect',\n  'umes:check',\n  'help',\n  '--help',\n  '-h',\n]\n\nfunction assertNode24Runtime(): void {\n  const detectedNodeVersion = process.versions.node\n  const majorVersion = Number.parseInt(detectedNodeVersion.split('.')[0] ?? '0', 10)\n  if (majorVersion >= 24) {\n    return\n  }\n  throw new Error(\n    [\n      'Unsupported Node.js runtime.',\n      `Cause: Detected Node ${detectedNodeVersion}, but Open Mercato requires Node 24.x.`,\n      'What to do: switch your shell to Node 24 (for example `nvm use 24`), run `yarn install`, then retry.',\n    ].join(' '),\n  )\n}\n\nfunction needsBootstrap(argv: string[]): boolean {\n  const [, , first] = argv\n  if (!first) return false // help screen\n  return !BOOTSTRAP_FREE_COMMANDS.includes(first)\n}\n\nasync function tryBootstrap(): Promise<boolean> {\n  try {\n    const { bootstrapFromAppRoot } = await import('@open-mercato/shared/lib/bootstrap/dynamicLoader')\n    const { registerCliModules } = await import('./mercato.js')\n    // Use the CLI resolver to find the app directory (handles monorepo detection)\n    const { createResolver } = await import('./lib/resolver.js')\n    const resolver = createResolver()\n    const appDir = resolver.getAppDir()\n    const data = await bootstrapFromAppRoot(appDir)\n    // Register CLI modules directly to avoid module resolution issues\n    registerCliModules(data.modules)\n    return true\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    // Check if the error is about missing generated files\n    if (\n      message.includes('Cannot find module') &&\n      (message.includes('/generated/') || message.includes('.generated') || message.includes('.mercato'))\n    ) {\n      return false\n    }\n    // Re-throw other errors\n    throw err\n  }\n}\n\nasync function main(): Promise<void> {\n  assertNode24Runtime()\n  const requiresBootstrap = needsBootstrap(process.argv)\n\n  if (requiresBootstrap) {\n    // Load the app's `.env` BEFORE initTelemetry(): `run()` only dotenv-loads it\n    // later (ensureEnvLoaded), which is too late \u2014 TELEMETRY_BACKEND set only in\n    // `.env` would silently resolve to `noop` for worker/scheduler processes.\n    // The loader touches only the resolver + dotenv (no `pg`), preserving the\n    // instrumentation load-order guarantee below.\n    const { loadAppEnv } = await import('./lib/load-env.js')\n    await loadAppEnv()\n\n    // Initialize telemetry BEFORE bootstrapping the app graph. Bootstrap and the\n    // per-command handlers load MikroORM's Postgres driver \u2192 `pg`, and the\n    // OpenTelemetry pg/undici auto-instrumentation only records spans for a\n    // driver required AFTER the SDK has started. Registering here \u2014 ahead of any\n    // app module \u2014 is what lets long-running worker/scheduler processes emit DB\n    // spans (not just the bullmq-otel add/process envelope). The package itself\n    // is not imported unless an explicit supported backend is selected.\n    if (isTelemetryBackendEnabled()) {\n      const { initTelemetry } = await import('@open-mercato/telemetry')\n      await initTelemetry()\n    }\n\n    const bootstrapSucceeded = await tryBootstrap()\n    if (!bootstrapSucceeded) {\n      console.error('\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557')\n      console.error('\u2551  Generated files not found!                                       \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551  The CLI requires generated files to discover modules.           \u2551')\n      console.error('\u2551  Please run the following command first:                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551    yarn mercato generate                                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D')\n      process.exit(1)\n    }\n  }\n\n  // Dynamic import (not a top-level static import) so the mercato entry \u2014 and the\n  // Postgres driver it pulls in \u2014 loads only after initTelemetry() above.\n  const { run } = await import('./mercato.js')\n  const code = await run(process.argv)\n  // Flush spans/logs for commands that return (workers block forever and flush via\n  // their own shutdown handler instead).\n  await getTelemetryRuntime()?.shutdown()\n  process.exit(code ?? 0)\n}\n\nmain().catch((error: unknown) => {\n  if (error instanceof Error) {\n    console.error(error.message)\n  } else {\n    console.error(error)\n  }\n  process.exit(1)\n})\n"],
+  "mappings": "AAMA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AASP,MAAM,0BAA0B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,sBAA4B;AACnC,QAAM,sBAAsB,QAAQ,SAAS;AAC7C,QAAM,eAAe,OAAO,SAAS,oBAAoB,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE;AACjF,MAAI,gBAAgB,IAAI;AACtB;AAAA,EACF;AACA,QAAM,IAAI;AAAA,IACR;AAAA,MACE;AAAA,MACA,wBAAwB,mBAAmB;AAAA,MAC3C;AAAA,IACF,EAAE,KAAK,GAAG;AAAA,EACZ;AACF;AAEA,SAAS,eAAe,MAAyB;AAC/C,QAAM,CAAC,EAAE,EAAE,KAAK,IAAI;AACpB,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,CAAC,wBAAwB,SAAS,KAAK;AAChD;AAEA,eAAe,eAAiC;AAC9C,MAAI;AACF,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,kDAAkD;AAChG,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,cAAc;AAE1D,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,mBAAmB;AAC3D,UAAM,WAAW,eAAe;AAChC,UAAM,SAAS,SAAS,UAAU;AAClC,UAAM,OAAO,MAAM,qBAAqB,MAAM;AAE9C,uBAAmB,KAAK,OAAO;AAC/B,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAE/D,QACE,QAAQ,SAAS,oBAAoB,MACpC,QAAQ,SAAS,aAAa,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,UAAU,IACjG;AACA,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,OAAsB;AACnC,sBAAoB;AACpB,QAAM,oBAAoB,eAAe,QAAQ,IAAI;AAErD,MAAI,mBAAmB;AAMrB,UAAM,EAAE,WAAW,IAAI,MAAM,OAAO,mBAAmB;AACvD,UAAM,WAAW;AASjB,QAAI,0BAA0B,GAAG;AAC/B,YAAM,EAAE,cAAc,IAAI,MAAM,OAAO,yBAAyB;AAChE,YAAM,cAAc;AAAA,IACtB;AAEA,UAAM,qBAAqB,MAAM,aAAa;AAC9C,QAAI,CAAC,oBAAoB;AACvB,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAIA,QAAM,EAAE,IAAI,IAAI,MAAM,OAAO,cAAc;AAC3C,QAAM,OAAO,MAAM,IAAI,QAAQ,IAAI;AAGnC,QAAM,oBAAoB,GAAG,SAAS;AACtC,UAAQ,KAAK,QAAQ,CAAC;AACxB;AAEA,KAAK,EAAE,MAAM,CAAC,UAAmB;AAC/B,MAAI,iBAAiB,OAAO;AAC1B,YAAQ,MAAM,MAAM,OAAO;AAAA,EAC7B,OAAO;AACL,YAAQ,MAAM,KAAK;AAAA,EACrB;AACA,UAAQ,KAAK,CAAC;AAChB,CAAC;",
   "names": []
 }

package/dist/lib/load-env.js

@@ -0,0 +1,24 @@
+import fs from "node:fs";
+import path from "node:path";
+async function loadAppEnv(options = {}) {
+  try {
+    const { createResolver } = await import("./resolver.js");
+    const appDir = createResolver(options.cwd).getAppDir();
+    const envPath = path.join(appDir, ".env");
+    if (fs.existsSync(envPath)) {
+      const dotenv = await import("dotenv");
+      dotenv.config({ path: envPath, quiet: true });
+      return;
+    }
+  } catch {
+  }
+  try {
+    const dotenv = await import("dotenv");
+    dotenv.config({ quiet: true });
+  } catch {
+  }
+}
+export {
+  loadAppEnv
+};
+//# sourceMappingURL=load-env.js.map

package/dist/lib/load-env.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/load-env.ts"],
+  "sourcesContent": ["import fs from 'node:fs'\nimport path from 'node:path'\n\n/**\n * Bootstrap-free `.env` loader for the CLI binary. `bin.ts` must load the app's\n * `.env` BEFORE `initTelemetry()` so `TELEMETRY_*` set only in `.env` resolves a\n * real backend for worker/scheduler processes \u2014 `run()`'s `ensureEnvLoaded()`\n * happens after telemetry init, which is too late. Deliberately read-only (no\n * `.env.example` copy \u2014 that UX stays in `ensureEnvLoaded`) and pulls in only the\n * resolver + dotenv, so nothing here loads `pg` and the OTEL instrumentation\n * load-order guarantee is preserved.\n */\nexport async function loadAppEnv(options: { cwd?: string } = {}): Promise<void> {\n  try {\n    const { createResolver } = await import('./resolver.js')\n    const appDir = createResolver(options.cwd).getAppDir()\n    const envPath = path.join(appDir, '.env')\n    if (fs.existsSync(envPath)) {\n      const dotenv = await import('dotenv')\n      dotenv.config({ path: envPath, quiet: true })\n      return\n    }\n  } catch {\n    // Resolver can fail outside an app dir \u2014 fall through to plain cwd loading.\n  }\n  try {\n    const dotenv = await import('dotenv')\n    dotenv.config({ quiet: true })\n  } catch {}\n}\n"],
+  "mappings": "AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAWjB,eAAsB,WAAW,UAA4B,CAAC,GAAkB;AAC9E,MAAI;AACF,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,eAAe;AACvD,UAAM,SAAS,eAAe,QAAQ,GAAG,EAAE,UAAU;AACrD,UAAM,UAAU,KAAK,KAAK,QAAQ,MAAM;AACxC,QAAI,GAAG,WAAW,OAAO,GAAG;AAC1B,YAAM,SAAS,MAAM,OAAO,QAAQ;AACpC,aAAO,OAAO,EAAE,MAAM,SAAS,OAAO,KAAK,CAAC;AAC5C;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AACA,MAAI;AACF,UAAM,SAAS,MAAM,OAAO,QAAQ;AACpC,WAAO,OAAO,EAAE,OAAO,KAAK,CAAC;AAAA,EAC/B,QAAQ;AAAA,EAAC;AACX;",
+  "names": []
+}

package/dist/lib/telemetry-init.js

@@ -0,0 +1,358 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+const BULLMQ_OTEL_VERSION = "^1.3.1";
+const ENV_BLOCK = `
+# --- Telemetry & Observability (vendor-neutral OTLP: traces, logs, metrics, errors) ---
+# Off by default: leave TELEMETRY_BACKEND unset (or =noop) for a hard no-op
+# (the OpenTelemetry SDK is never loaded). Set to 'console' for local span/metric
+# output, or an OTLP backend to export: 'signoz' | 'newrelic' | 'otlp' (generic).
+# All three OTLP names use the same exporter \u2014 they differ only by the endpoint +
+# headers below. Any OTLP backend is a one-line swap; no code change.
+# TELEMETRY_BACKEND=otlp
+# Logs use the shared logger facade and its OM_LOG_LEVEL / OM_LOG_PRETTY /
+# OM_LOG_DESTINATION controls. Telemetry adds remote export; it does not create
+# a second local output path.
+# TELEMETRY_SAMPLING_RATIO=1.0        # 0.0\u20131.0 (default 1.0 dev / 0.1 prod)
+# TELEMETRY_TRUST_INBOUND_TRACE=false # default false: root-per-request (ignore an
+#                                     # inbound traceparent from a proxy/LB). Set true
+#                                     # only behind a trusted upstream whose trace continues.
+#                                     # This also enables richer bullmq-otel spans;
+#                                     # otherwise async queues use metadata._trace.
+#
+# OTLP endpoint + auth \u2014 pick ONE vendor (use your region's host):
+#   SigNoz Cloud:
+# OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.<region>.signoz.cloud:443
+# OTEL_EXPORTER_OTLP_HEADERS=signoz-ingestion-key=<your-ingestion-key>
+#   New Relic (OTLP-native; EU host shown, US is https://otlp.nr-data.net):
+# OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net
+# OTEL_EXPORTER_OTLP_HEADERS=api-key=<your-ingest-license-key>
+#
+# Resource identity: keep one stable service name across environments and
+# separate envs via the deployment.environment resource attribute.
+# OTEL_SERVICE_NAME=open-mercato
+# OTEL_RESOURCE_ATTRIBUTES=deployment.environment=local
+`;
+const INSTRUMENTATION_TS = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'
+
+export async function register(): Promise<void> {
+  // Initialize telemetry (no-op unless TELEMETRY_BACKEND is set). OTEL's NodeSDK
+  // is Node-only and incompatible with the edge runtime, so the telemetry
+  // bootstrap \u2014 which can pull in the SDK \u2014 is imported only on the Node.js
+  // runtime. The helper owns init + graceful degrade + shutdown flush.
+  if (
+    process.env.NEXT_RUNTIME === 'nodejs'
+    && isTelemetryBackendEnabled()
+  ) {
+    const { registerTelemetryForNextjs } = await import('@open-mercato/telemetry/nextjs')
+    await registerTelemetryForNextjs()
+  }
+}
+`;
+const DISPATCHER_SNIPPET = `  // add near the other imports:
+  import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'
+
+  // in the dispatcher's success path, just before returning the response:
+  getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, finalResponse.status, startedAt)
+
+  // in the dispatcher's catch (error) block, before re-throwing:
+  getTelemetryRuntime()?.reportError(error, {
+    attributes: { 'http.request.method': method, 'http.route': match.route.path, 'http.response.status_code': 500 },
+  })
+  getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, 500, startedAt)`;
+function parseArgs(args) {
+  return {
+    dryRun: args.includes("--dry-run") || args.includes("-n")
+  };
+}
+function resolveOpenMercatoVersion(pkg) {
+  for (const field of ["dependencies", "devDependencies"]) {
+    const deps = pkg[field];
+    if (deps && typeof deps === "object") {
+      for (const [name, version] of Object.entries(deps)) {
+        if (name.startsWith("@open-mercato/") && typeof version === "string") return version;
+      }
+    }
+  }
+  return "*";
+}
+function patchPackageJson(appDir, options) {
+  const file = "package.json";
+  const path = join(appDir, file);
+  const raw = readFileSync(path, "utf8");
+  const pkg = JSON.parse(raw);
+  const version = resolveOpenMercatoVersion(pkg);
+  const hasTelemetry = Boolean(pkg.dependencies?.["@open-mercato/telemetry"]);
+  const hasBullmqOtel = Boolean(pkg.optionalDependencies?.["bullmq-otel"]);
+  if (hasTelemetry && hasBullmqOtel) {
+    return { file, status: "skipped", detail: "@open-mercato/telemetry already installed" };
+  }
+  const deps = { ...pkg.dependencies ?? {} };
+  if (!hasTelemetry) deps["@open-mercato/telemetry"] = version;
+  const optDeps = { ...pkg.optionalDependencies ?? {} };
+  if (!hasBullmqOtel) optDeps["bullmq-otel"] = BULLMQ_OTEL_VERSION;
+  const next = {
+    ...pkg,
+    dependencies: sortRecord(deps),
+    optionalDependencies: sortRecord(optDeps)
+  };
+  if (!options.dryRun) writeFileSync(path, `${JSON.stringify(next, null, 2)}
+`);
+  return {
+    file,
+    status: "patched",
+    detail: `+@open-mercato/telemetry@${version}${hasBullmqOtel ? "" : ` +bullmq-otel@${BULLMQ_OTEL_VERSION} (optional)`} \u2014 run \`yarn install\``
+  };
+}
+function sortRecord(record) {
+  return Object.fromEntries(Object.entries(record).sort(([a], [b]) => a.localeCompare(b)));
+}
+function patchEnvFile(appDir, relativePath, options) {
+  const path = join(appDir, relativePath);
+  if (!existsSync(path)) return null;
+  const content = readFileSync(path, "utf8");
+  if (content.includes("TELEMETRY_BACKEND")) {
+    return { file: relativePath, status: "skipped", detail: "TELEMETRY_* block already present" };
+  }
+  const next = `${content.replace(/\s*$/, "")}
+${ENV_BLOCK}`;
+  if (!options.dryRun) writeFileSync(path, next);
+  return { file: relativePath, status: "patched", detail: "appended commented TELEMETRY_* / OTEL_* block" };
+}
+function patchInstrumentation(appDir, options) {
+  const file = "src/instrumentation.ts";
+  const path = join(appDir, file);
+  if (!existsSync(path)) {
+    if (!options.dryRun) {
+      mkdirSync(dirname(path), { recursive: true });
+      writeFileSync(path, INSTRUMENTATION_TS);
+    }
+    return { file, status: "created", detail: "Node-runtime-guarded registerTelemetryForNextjs() bootstrap" };
+  }
+  const content = readFileSync(path, "utf8");
+  if (content.includes("registerTelemetryForNextjs")) {
+    if (content.includes("isTelemetryBackendEnabled")) {
+      return { file, status: "skipped", detail: "telemetry already wired" };
+    }
+    const migrated = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'
+` + content.replace(
+      `if (process.env.NEXT_RUNTIME === 'nodejs') {`,
+      `if (process.env.NEXT_RUNTIME === 'nodejs' && isTelemetryBackendEnabled()) {`
+    );
+    if (!options.dryRun) writeFileSync(path, migrated);
+    return { file, status: "patched", detail: "added the explicit backend import guard" };
+  }
+  const anchor = content.match(/export\s+async\s+function\s+register\s*\([^)]*\)\s*:\s*Promise<void>\s*\{/);
+  if (!anchor || anchor.index === void 0) {
+    return {
+      file,
+      status: "manual",
+      detail: "register() not found \u2014 add the telemetry bootstrap manually",
+      manualSnippet: INSTRUMENTATION_TS
+    };
+  }
+  const insertAt = anchor.index + anchor[0].length;
+  const block = `
+  // Initialize telemetry (no-op unless TELEMETRY_BACKEND is set); Node-only.
+  if (process.env.NEXT_RUNTIME === 'nodejs' && isTelemetryBackendEnabled()) {
+    const { registerTelemetryForNextjs } = await import('@open-mercato/telemetry/nextjs')
+    await registerTelemetryForNextjs()
+  }`;
+  const importLine = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'
+`;
+  const withImport = content.includes("isTelemetryBackendEnabled") ? content : importLine + content;
+  const shiftedInsertAt = insertAt + (withImport.length - content.length);
+  const next = withImport.slice(0, shiftedInsertAt) + block + withImport.slice(shiftedInsertAt);
+  if (!options.dryRun) writeFileSync(path, next);
+  return { file, status: "patched", detail: "inserted registerTelemetryForNextjs() into register()" };
+}
+async function patchNextConfig(appDir, options) {
+  const file = "next.config.ts";
+  const path = join(appDir, file);
+  if (!existsSync(path)) {
+    return { file, status: "manual", detail: "next.config.ts not found", manualSnippet: nextConfigSnippet() };
+  }
+  const { Project, SyntaxKind } = await import("ts-morph");
+  const project = new Project({ skipAddingFilesFromTsConfig: true, skipFileDependencyResolution: true });
+  const sf = project.addSourceFileAtPath(path);
+  const telemetryConfigImport = sf.getImportDeclarations().find((decl) => [
+    "@open-mercato/telemetry/nextjs",
+    "@open-mercato/telemetry/nextjs-config"
+  ].includes(decl.getModuleSpecifierValue()));
+  const hasImport = Boolean(telemetryConfigImport);
+  const hasCanonicalImport = telemetryConfigImport?.getModuleSpecifierValue() === "@open-mercato/telemetry/nextjs-config";
+  const arrayProp = sf.getDescendantsOfKind(SyntaxKind.PropertyAssignment).find((prop) => prop.getName() === "serverExternalPackages");
+  const arrayInit = arrayProp?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression);
+  if (!arrayInit) {
+    return {
+      file,
+      status: "manual",
+      detail: "serverExternalPackages array not found",
+      manualSnippet: nextConfigSnippet()
+    };
+  }
+  const hasSpread = arrayInit.getElements().some((el) => el.getText().includes("telemetryServerExternalPackages"));
+  if (hasCanonicalImport && hasSpread) {
+    return { file, status: "skipped", detail: "telemetryServerExternalPackages already wired" };
+  }
+  let text = readFileSync(path, "utf8");
+  if (!hasSpread) {
+    const start = arrayInit.getStart();
+    const end = arrayInit.getEnd();
+    text = text.slice(0, start) + insertSpread(text.slice(start, end)) + text.slice(end);
+  }
+  text = text.replace(
+    "from '@open-mercato/telemetry/nextjs'",
+    "from '@open-mercato/telemetry/nextjs-config'"
+  );
+  if (!hasImport) {
+    const importRegex = /^import[^\n]*$/gm;
+    let lastImport = null;
+    let match;
+    while ((match = importRegex.exec(text)) !== null) lastImport = match;
+    const insertAt = lastImport ? lastImport.index + lastImport[0].length : 0;
+    text = text.slice(0, insertAt) + `
+import { telemetryServerExternalPackages } from '@open-mercato/telemetry/nextjs-config'` + text.slice(insertAt);
+  }
+  if (!options.dryRun) writeFileSync(path, text);
+  return { file, status: "patched", detail: "spread telemetryServerExternalPackages into serverExternalPackages" };
+}
+function insertSpread(arrayText) {
+  const inner = arrayText.slice(1, -1);
+  if (inner.includes("\n")) {
+    const elementIndent = inner.match(/\n([ \t]+)\S/)?.[1] ?? "  ";
+    const closeIndent = arrayText.match(/\n([ \t]*)\]$/)?.[1] ?? "";
+    const trimmed = inner.replace(/\s*$/, "");
+    const separator = trimmed === "" || trimmed.endsWith(",") ? "" : ",";
+    return `[${trimmed}${separator}
+${elementIndent}...telemetryServerExternalPackages,
+${closeIndent}]`;
+  }
+  const flat = inner.trim();
+  return flat === "" ? "[...telemetryServerExternalPackages]" : `[${flat}, ...telemetryServerExternalPackages]`;
+}
+function nextConfigSnippet() {
+  return `import { telemetryServerExternalPackages } from '@open-mercato/telemetry/nextjs-config'
+// serverExternalPackages: [ ...existing, ...telemetryServerExternalPackages ]`;
+}
+function patchDispatcher(appDir, options) {
+  const file = "src/app/api/[...slug]/route.ts";
+  const path = join(appDir, file);
+  if (!existsSync(path)) {
+    return { file, status: "manual", detail: "dispatcher not found", manualSnippet: DISPATCHER_SNIPPET };
+  }
+  let content = readFileSync(path, "utf8");
+  if (content.includes("from '@open-mercato/shared/lib/telemetry/runtime'") && content.includes("getTelemetryRuntime()?.recordHttpDuration")) {
+    return { file, status: "skipped", detail: "telemetry already wired" };
+  }
+  if (content.includes("import { reportError } from '@open-mercato/telemetry'") && content.includes("import { recordHttpDuration } from '@open-mercato/telemetry/nextjs'")) {
+    content = content.replace(
+      "import { reportError } from '@open-mercato/telemetry'\nimport { recordHttpDuration } from '@open-mercato/telemetry/nextjs'",
+      "import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'"
+    ).replace(/\brecordHttpDuration\(/g, "getTelemetryRuntime()?.recordHttpDuration(").replace(/\breportError\(/g, "getTelemetryRuntime()?.reportError(");
+    if (!options.dryRun) writeFileSync(path, content);
+    return { file, status: "patched", detail: "migrated dispatcher to the default-off runtime bridge" };
+  }
+  const importAnchor = "import { isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'";
+  const returnMatch = content.match(/^([ \t]*)return finalResponse\s*$/m);
+  const catchRegex = /^([ \t]*)\}\s*catch\s*\(error\)\s*\{[ \t]*$/gm;
+  const catchMatch = findCatchAfter(content, catchRegex, returnMatch?.index ?? -1);
+  if (!content.includes(importAnchor) || !returnMatch || returnMatch.index === void 0 || !catchMatch) {
+    return {
+      file,
+      status: "manual",
+      detail: "dispatcher shape not recognized \u2014 apply the snippet by hand",
+      manualSnippet: DISPATCHER_SNIPPET
+    };
+  }
+  content = content.replace(
+    importAnchor,
+    `${importAnchor}
+import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'`
+  );
+  const ret = content.match(/^([ \t]*)return finalResponse\s*$/m);
+  if (!ret || ret.index === void 0) {
+    return { file, status: "manual", detail: "success-path anchor lost", manualSnippet: DISPATCHER_SNIPPET };
+  }
+  const retIndent = ret[1];
+  content = content.slice(0, ret.index) + `${retIndent}getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, finalResponse.status, startedAt)
+` + content.slice(ret.index);
+  const catch2 = findCatchAfter(content, /^([ \t]*)\}\s*catch\s*\(error\)\s*\{[ \t]*$/gm, content.indexOf("return finalResponse"));
+  if (!catch2) {
+    return { file, status: "manual", detail: "catch anchor lost", manualSnippet: DISPATCHER_SNIPPET };
+  }
+  const bodyIndent = `${catch2.indent}  `;
+  const insertAt = catch2.index + catch2.length;
+  const block = `
+${bodyIndent}getTelemetryRuntime()?.reportError(error, {
+${bodyIndent}  attributes: { 'http.request.method': method, 'http.route': match.route.path, 'http.response.status_code': 500 },
+${bodyIndent}})
+${bodyIndent}getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, 500, startedAt)`;
+  content = content.slice(0, insertAt) + block + content.slice(insertAt);
+  if (!options.dryRun) writeFileSync(path, content);
+  return { file, status: "patched", detail: "wired reportError (5xx) + http.server.request.duration metric" };
+}
+function findCatchAfter(content, regex, afterIndex) {
+  regex.lastIndex = 0;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    if (match.index > afterIndex) {
+      return { index: match.index, length: match[0].length, indent: match[1] };
+    }
+  }
+  return null;
+}
+async function runTelemetryInit(args) {
+  const appDir = resolve(".");
+  const options = parseArgs(args);
+  if (!existsSync(join(appDir, "src", "modules.ts"))) {
+    console.error("\u274C  Not an Open Mercato app directory (src/modules.ts not found)");
+    return 1;
+  }
+  if (!existsSync(join(appDir, "package.json"))) {
+    console.error("\u274C  package.json not found");
+    return 1;
+  }
+  console.log("");
+  console.log(options.dryRun ? "\u{1F52D} Telemetry init (dry run \u2014 no files written)\n" : "\u{1F52D} Wiring @open-mercato/telemetry into this app\n");
+  const results = [];
+  results.push(patchPackageJson(appDir, options));
+  const envExample = patchEnvFile(appDir, ".env.example", options);
+  if (envExample) results.push(envExample);
+  const env = patchEnvFile(appDir, ".env", options);
+  if (env) results.push(env);
+  results.push(patchInstrumentation(appDir, options));
+  results.push(await patchNextConfig(appDir, options));
+  results.push(patchDispatcher(appDir, options));
+  const icon = { created: "\u270D\uFE0F ", patched: "\u2705", skipped: "\u23ED\uFE0F ", manual: "\u26A0\uFE0F " };
+  for (const result of results) {
+    console.log(`${icon[result.status]} ${result.file} \u2014 ${result.detail}`);
+  }
+  const manual = results.filter((result) => result.status === "manual");
+  for (const result of manual) {
+    if (!result.manualSnippet) continue;
+    console.log("");
+    console.log(`\u2500\u2500 manual step for ${result.file} \u2500\u2500`);
+    console.log(result.manualSnippet);
+  }
+  console.log("");
+  const changed = results.some((result) => result.status === "patched" || result.status === "created");
+  if (options.dryRun) {
+    console.log("Dry run complete \u2014 re-run without --dry-run to apply.");
+  } else if (changed) {
+    console.log("Next steps:");
+    console.log("  1. yarn install                 (resolve @open-mercato/telemetry + the OTEL SDK)");
+    console.log("  2. set TELEMETRY_BACKEND + OTEL_EXPORTER_OTLP_* in .env");
+    console.log("  3. yarn typecheck && yarn build (verify the wiring)");
+  } else {
+    console.log("Nothing to do \u2014 telemetry is already wired.");
+  }
+  if (manual.length > 0) {
+    console.log("");
+    console.log(`\u26A0\uFE0F  ${manual.length} file(s) need a manual edit (shown above) \u2014 the rest were applied automatically.`);
+  }
+  return 0;
+}
+export {
+  runTelemetryInit
+};
+//# sourceMappingURL=telemetry-init.js.map

package/dist/lib/telemetry-init.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/telemetry-init.ts"],
+  "sourcesContent": ["import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'\nimport { dirname, join, resolve } from 'node:path'\n\n/**\n * `mercato telemetry init` \u2014 wire `@open-mercato/telemetry` into an app that was\n * scaffolded before telemetry existed. Deterministic, idempotent, and safe to\n * re-run: each step detects whether it is already applied and skips.\n *\n * The web-tier wiring lives in app-owned source files (a dependency bump cannot\n * touch them), so this patches them in place using the same idioms the rest of\n * the CLI uses: JSON edits, detect-before-append for `.env`, a ts-morph edit for\n * `next.config.ts`, and anchored insertion for `instrumentation.ts` + the API\n * dispatcher. When a file's shape is not recognized (a customized dispatcher, an\n * unusual next.config), the step degrades to printing the exact snippet and\n * flags it as a manual step rather than editing code it does not understand.\n *\n * Worker/scheduler telemetry is not handled here \u2014 it ships transitively via\n * `@open-mercato/cli`'s telemetry dependency once the app updates its packages.\n */\n\nconst BULLMQ_OTEL_VERSION = '^1.3.1'\n\ntype StepStatus = 'created' | 'patched' | 'skipped' | 'manual'\n\ntype StepResult = {\n  file: string\n  status: StepStatus\n  detail: string\n  /** Snippet to show when the step needs manual work. */\n  manualSnippet?: string\n}\n\ntype TelemetryInitOptions = {\n  dryRun: boolean\n}\n\nconst ENV_BLOCK = `\n# --- Telemetry & Observability (vendor-neutral OTLP: traces, logs, metrics, errors) ---\n# Off by default: leave TELEMETRY_BACKEND unset (or =noop) for a hard no-op\n# (the OpenTelemetry SDK is never loaded). Set to 'console' for local span/metric\n# output, or an OTLP backend to export: 'signoz' | 'newrelic' | 'otlp' (generic).\n# All three OTLP names use the same exporter \u2014 they differ only by the endpoint +\n# headers below. Any OTLP backend is a one-line swap; no code change.\n# TELEMETRY_BACKEND=otlp\n# Logs use the shared logger facade and its OM_LOG_LEVEL / OM_LOG_PRETTY /\n# OM_LOG_DESTINATION controls. Telemetry adds remote export; it does not create\n# a second local output path.\n# TELEMETRY_SAMPLING_RATIO=1.0        # 0.0\u20131.0 (default 1.0 dev / 0.1 prod)\n# TELEMETRY_TRUST_INBOUND_TRACE=false # default false: root-per-request (ignore an\n#                                     # inbound traceparent from a proxy/LB). Set true\n#                                     # only behind a trusted upstream whose trace continues.\n#                                     # This also enables richer bullmq-otel spans;\n#                                     # otherwise async queues use metadata._trace.\n#\n# OTLP endpoint + auth \u2014 pick ONE vendor (use your region's host):\n#   SigNoz Cloud:\n# OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.<region>.signoz.cloud:443\n# OTEL_EXPORTER_OTLP_HEADERS=signoz-ingestion-key=<your-ingestion-key>\n#   New Relic (OTLP-native; EU host shown, US is https://otlp.nr-data.net):\n# OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.eu01.nr-data.net\n# OTEL_EXPORTER_OTLP_HEADERS=api-key=<your-ingest-license-key>\n#\n# Resource identity: keep one stable service name across environments and\n# separate envs via the deployment.environment resource attribute.\n# OTEL_SERVICE_NAME=open-mercato\n# OTEL_RESOURCE_ATTRIBUTES=deployment.environment=local\n`\n\nconst INSTRUMENTATION_TS = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\n\nexport async function register(): Promise<void> {\n  // Initialize telemetry (no-op unless TELEMETRY_BACKEND is set). OTEL's NodeSDK\n  // is Node-only and incompatible with the edge runtime, so the telemetry\n  // bootstrap \u2014 which can pull in the SDK \u2014 is imported only on the Node.js\n  // runtime. The helper owns init + graceful degrade + shutdown flush.\n  if (\n    process.env.NEXT_RUNTIME === 'nodejs'\n    && isTelemetryBackendEnabled()\n  ) {\n    const { registerTelemetryForNextjs } = await import('@open-mercato/telemetry/nextjs')\n    await registerTelemetryForNextjs()\n  }\n}\n`\n\nconst DISPATCHER_SNIPPET = `  // add near the other imports:\n  import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'\n\n  // in the dispatcher's success path, just before returning the response:\n  getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, finalResponse.status, startedAt)\n\n  // in the dispatcher's catch (error) block, before re-throwing:\n  getTelemetryRuntime()?.reportError(error, {\n    attributes: { 'http.request.method': method, 'http.route': match.route.path, 'http.response.status_code': 500 },\n  })\n  getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, 500, startedAt)`\n\nfunction parseArgs(args: string[]): TelemetryInitOptions {\n  return {\n    dryRun: args.includes('--dry-run') || args.includes('-n'),\n  }\n}\n\n/** Read the version an app already pins its `@open-mercato/*` deps to (lockstep). */\nfunction resolveOpenMercatoVersion(pkg: Record<string, unknown>): string {\n  for (const field of ['dependencies', 'devDependencies'] as const) {\n    const deps = pkg[field]\n    if (deps && typeof deps === 'object') {\n      for (const [name, version] of Object.entries(deps as Record<string, string>)) {\n        if (name.startsWith('@open-mercato/') && typeof version === 'string') return version\n      }\n    }\n  }\n  return '*'\n}\n\nfunction patchPackageJson(appDir: string, options: TelemetryInitOptions): StepResult {\n  const file = 'package.json'\n  const path = join(appDir, file)\n  const raw = readFileSync(path, 'utf8')\n  const pkg = JSON.parse(raw) as {\n    dependencies?: Record<string, string>\n    optionalDependencies?: Record<string, string>\n  }\n  const version = resolveOpenMercatoVersion(pkg)\n  const hasTelemetry = Boolean(pkg.dependencies?.['@open-mercato/telemetry'])\n  const hasBullmqOtel = Boolean(pkg.optionalDependencies?.['bullmq-otel'])\n  if (hasTelemetry && hasBullmqOtel) {\n    return { file, status: 'skipped', detail: '@open-mercato/telemetry already installed' }\n  }\n\n  const deps = { ...(pkg.dependencies ?? {}) }\n  if (!hasTelemetry) deps['@open-mercato/telemetry'] = version\n  const optDeps = { ...(pkg.optionalDependencies ?? {}) }\n  if (!hasBullmqOtel) optDeps['bullmq-otel'] = BULLMQ_OTEL_VERSION\n\n  const next = {\n    ...pkg,\n    dependencies: sortRecord(deps),\n    optionalDependencies: sortRecord(optDeps),\n  }\n  if (!options.dryRun) writeFileSync(path, `${JSON.stringify(next, null, 2)}\\n`)\n  return {\n    file,\n    status: 'patched',\n    detail: `+@open-mercato/telemetry@${version}${hasBullmqOtel ? '' : ` +bullmq-otel@${BULLMQ_OTEL_VERSION} (optional)`} \u2014 run \\`yarn install\\``,\n  }\n}\n\nfunction sortRecord(record: Record<string, string>): Record<string, string> {\n  return Object.fromEntries(Object.entries(record).sort(([a], [b]) => a.localeCompare(b)))\n}\n\nfunction patchEnvFile(appDir: string, relativePath: string, options: TelemetryInitOptions): StepResult | null {\n  const path = join(appDir, relativePath)\n  if (!existsSync(path)) return null\n  const content = readFileSync(path, 'utf8')\n  if (content.includes('TELEMETRY_BACKEND')) {\n    return { file: relativePath, status: 'skipped', detail: 'TELEMETRY_* block already present' }\n  }\n  const next = `${content.replace(/\\s*$/, '')}\\n${ENV_BLOCK}`\n  if (!options.dryRun) writeFileSync(path, next)\n  return { file: relativePath, status: 'patched', detail: 'appended commented TELEMETRY_* / OTEL_* block' }\n}\n\nfunction patchInstrumentation(appDir: string, options: TelemetryInitOptions): StepResult {\n  const file = 'src/instrumentation.ts'\n  const path = join(appDir, file)\n  if (!existsSync(path)) {\n    if (!options.dryRun) {\n      mkdirSync(dirname(path), { recursive: true })\n      writeFileSync(path, INSTRUMENTATION_TS)\n    }\n    return { file, status: 'created', detail: 'Node-runtime-guarded registerTelemetryForNextjs() bootstrap' }\n  }\n  const content = readFileSync(path, 'utf8')\n  if (content.includes('registerTelemetryForNextjs')) {\n    if (content.includes('isTelemetryBackendEnabled')) {\n      return { file, status: 'skipped', detail: 'telemetry already wired' }\n    }\n    const migrated =\n      `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\\n` +\n      content.replace(\n        `if (process.env.NEXT_RUNTIME === 'nodejs') {`,\n        `if (process.env.NEXT_RUNTIME === 'nodejs' && isTelemetryBackendEnabled()) {`,\n      )\n    if (!options.dryRun) writeFileSync(path, migrated)\n    return { file, status: 'patched', detail: 'added the explicit backend import guard' }\n  }\n  const anchor = content.match(/export\\s+async\\s+function\\s+register\\s*\\([^)]*\\)\\s*:\\s*Promise<void>\\s*\\{/)\n  if (!anchor || anchor.index === undefined) {\n    return {\n      file,\n      status: 'manual',\n      detail: 'register() not found \u2014 add the telemetry bootstrap manually',\n      manualSnippet: INSTRUMENTATION_TS,\n    }\n  }\n  const insertAt = anchor.index + anchor[0].length\n  const block =\n    `\\n  // Initialize telemetry (no-op unless TELEMETRY_BACKEND is set); Node-only.` +\n    `\\n  if (process.env.NEXT_RUNTIME === 'nodejs' && isTelemetryBackendEnabled()) {` +\n    `\\n    const { registerTelemetryForNextjs } = await import('@open-mercato/telemetry/nextjs')` +\n    `\\n    await registerTelemetryForNextjs()` +\n    `\\n  }`\n  const importLine = `import { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\\n`\n  const withImport = content.includes('isTelemetryBackendEnabled')\n    ? content\n    : importLine + content\n  const shiftedInsertAt = insertAt + (withImport.length - content.length)\n  const next = withImport.slice(0, shiftedInsertAt) + block + withImport.slice(shiftedInsertAt)\n  if (!options.dryRun) writeFileSync(path, next)\n  return { file, status: 'patched', detail: 'inserted registerTelemetryForNextjs() into register()' }\n}\n\nasync function patchNextConfig(appDir: string, options: TelemetryInitOptions): Promise<StepResult> {\n  const file = 'next.config.ts'\n  const path = join(appDir, file)\n  if (!existsSync(path)) {\n    return { file, status: 'manual', detail: 'next.config.ts not found', manualSnippet: nextConfigSnippet() }\n  }\n  // Use ts-morph to *detect* the real `serverExternalPackages` array literal\n  // (robust against a match inside a comment/string), then do the *insertion*\n  // via a formatting-preserving text splice so the user's config stays tidy.\n  const { Project, SyntaxKind } = await import('ts-morph')\n  const project = new Project({ skipAddingFilesFromTsConfig: true, skipFileDependencyResolution: true })\n  const sf = project.addSourceFileAtPath(path)\n\n  const telemetryConfigImport = sf\n    .getImportDeclarations()\n    .find((decl) => [\n      '@open-mercato/telemetry/nextjs',\n      '@open-mercato/telemetry/nextjs-config',\n    ].includes(decl.getModuleSpecifierValue()))\n  const hasImport = Boolean(telemetryConfigImport)\n  const hasCanonicalImport =\n    telemetryConfigImport?.getModuleSpecifierValue() === '@open-mercato/telemetry/nextjs-config'\n\n  const arrayProp = sf\n    .getDescendantsOfKind(SyntaxKind.PropertyAssignment)\n    .find((prop) => prop.getName() === 'serverExternalPackages')\n  const arrayInit = arrayProp?.getInitializerIfKind(SyntaxKind.ArrayLiteralExpression)\n  if (!arrayInit) {\n    return {\n      file,\n      status: 'manual',\n      detail: 'serverExternalPackages array not found',\n      manualSnippet: nextConfigSnippet(),\n    }\n  }\n  const hasSpread = arrayInit.getElements().some((el) => el.getText().includes('telemetryServerExternalPackages'))\n  if (hasCanonicalImport && hasSpread) {\n    return { file, status: 'skipped', detail: 'telemetryServerExternalPackages already wired' }\n  }\n\n  let text = readFileSync(path, 'utf8')\n  // Splice the array first, using the AST node's byte offsets (formatting-agnostic:\n  // handles both single-line and multi-line arrays). Do this before modifying\n  // imports, because either an inserted import or the legacy import migration\n  // shifts the array offsets captured from the original source.\n  if (!hasSpread) {\n    const start = arrayInit.getStart()\n    const end = arrayInit.getEnd()\n    text = text.slice(0, start) + insertSpread(text.slice(start, end)) + text.slice(end)\n  }\n  text = text.replace(\n    \"from '@open-mercato/telemetry/nextjs'\",\n    \"from '@open-mercato/telemetry/nextjs-config'\",\n  )\n  if (!hasImport) {\n    const importRegex = /^import[^\\n]*$/gm\n    let lastImport: RegExpExecArray | null = null\n    let match: RegExpExecArray | null\n    while ((match = importRegex.exec(text)) !== null) lastImport = match\n    const insertAt = lastImport ? lastImport.index + lastImport[0].length : 0\n    text =\n      text.slice(0, insertAt) +\n      `\\nimport { telemetryServerExternalPackages } from '@open-mercato/telemetry/nextjs-config'` +\n      text.slice(insertAt)\n  }\n  if (!options.dryRun) writeFileSync(path, text)\n  return { file, status: 'patched', detail: 'spread telemetryServerExternalPackages into serverExternalPackages' }\n}\n\n/** Add `...telemetryServerExternalPackages` as the last element of an array literal, preserving its style. */\nfunction insertSpread(arrayText: string): string {\n  const inner = arrayText.slice(1, -1)\n  if (inner.includes('\\n')) {\n    const elementIndent = inner.match(/\\n([ \\t]+)\\S/)?.[1] ?? '  '\n    const closeIndent = arrayText.match(/\\n([ \\t]*)\\]$/)?.[1] ?? ''\n    const trimmed = inner.replace(/\\s*$/, '')\n    const separator = trimmed === '' || trimmed.endsWith(',') ? '' : ','\n    return `[${trimmed}${separator}\\n${elementIndent}...telemetryServerExternalPackages,\\n${closeIndent}]`\n  }\n  const flat = inner.trim()\n  return flat === '' ? '[...telemetryServerExternalPackages]' : `[${flat}, ...telemetryServerExternalPackages]`\n}\n\nfunction nextConfigSnippet(): string {\n  return (\n    `import { telemetryServerExternalPackages } from '@open-mercato/telemetry/nextjs-config'\\n` +\n    `// serverExternalPackages: [ ...existing, ...telemetryServerExternalPackages ]`\n  )\n}\n\n/**\n * Auto-patch the catch-all API dispatcher \u2014 but only when it still matches the\n * known scaffold shape (all anchors present, telemetry not yet wired). On any\n * mismatch, print the snippet and mark it manual rather than editing an\n * unrecognized (customized) handler.\n */\nfunction patchDispatcher(appDir: string, options: TelemetryInitOptions): StepResult {\n  const file = 'src/app/api/[...slug]/route.ts'\n  const path = join(appDir, file)\n  if (!existsSync(path)) {\n    return { file, status: 'manual', detail: 'dispatcher not found', manualSnippet: DISPATCHER_SNIPPET }\n  }\n  let content = readFileSync(path, 'utf8')\n  if (\n    content.includes(\"from '@open-mercato/shared/lib/telemetry/runtime'\")\n    && content.includes('getTelemetryRuntime()?.recordHttpDuration')\n  ) {\n    return { file, status: 'skipped', detail: 'telemetry already wired' }\n  }\n  if (\n    content.includes(\"import { reportError } from '@open-mercato/telemetry'\")\n    && content.includes(\"import { recordHttpDuration } from '@open-mercato/telemetry/nextjs'\")\n  ) {\n    content = content\n      .replace(\n        \"import { reportError } from '@open-mercato/telemetry'\\nimport { recordHttpDuration } from '@open-mercato/telemetry/nextjs'\",\n        \"import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'\",\n      )\n      .replace(/\\brecordHttpDuration\\(/g, 'getTelemetryRuntime()?.recordHttpDuration(')\n      .replace(/\\breportError\\(/g, 'getTelemetryRuntime()?.reportError(')\n    if (!options.dryRun) writeFileSync(path, content)\n    return { file, status: 'patched', detail: 'migrated dispatcher to the default-off runtime bridge' }\n  }\n\n  const importAnchor = \"import { isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'\"\n  const returnMatch = content.match(/^([ \\t]*)return finalResponse\\s*$/m)\n  // The handleRequest catch is the first `} catch (error) {` after the success return.\n  const catchRegex = /^([ \\t]*)\\}\\s*catch\\s*\\(error\\)\\s*\\{[ \\t]*$/gm\n  const catchMatch = findCatchAfter(content, catchRegex, returnMatch?.index ?? -1)\n\n  if (!content.includes(importAnchor) || !returnMatch || returnMatch.index === undefined || !catchMatch) {\n    return {\n      file,\n      status: 'manual',\n      detail: 'dispatcher shape not recognized \u2014 apply the snippet by hand',\n      manualSnippet: DISPATCHER_SNIPPET,\n    }\n  }\n\n  // 1) imports\n  content = content.replace(\n    importAnchor,\n    `${importAnchor}\\nimport { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'`,\n  )\n\n  // 2) success-path metric (re-match after the import edit shifted offsets)\n  const ret = content.match(/^([ \\t]*)return finalResponse\\s*$/m)\n  if (!ret || ret.index === undefined) {\n    return { file, status: 'manual', detail: 'success-path anchor lost', manualSnippet: DISPATCHER_SNIPPET }\n  }\n  const retIndent = ret[1]\n  content =\n    content.slice(0, ret.index) +\n    `${retIndent}getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, finalResponse.status, startedAt)\\n` +\n    content.slice(ret.index)\n\n  // 3) catch-block error funnel + 500 metric\n  const catch2 = findCatchAfter(content, /^([ \\t]*)\\}\\s*catch\\s*\\(error\\)\\s*\\{[ \\t]*$/gm, content.indexOf('return finalResponse'))\n  if (!catch2) {\n    return { file, status: 'manual', detail: 'catch anchor lost', manualSnippet: DISPATCHER_SNIPPET }\n  }\n  const bodyIndent = `${catch2.indent}  `\n  const insertAt = catch2.index + catch2.length\n  const block =\n    `\\n${bodyIndent}getTelemetryRuntime()?.reportError(error, {` +\n    `\\n${bodyIndent}  attributes: { 'http.request.method': method, 'http.route': match.route.path, 'http.response.status_code': 500 },` +\n    `\\n${bodyIndent}})` +\n    `\\n${bodyIndent}getTelemetryRuntime()?.recordHttpDuration(method, match.route.path, 500, startedAt)`\n  content = content.slice(0, insertAt) + block + content.slice(insertAt)\n\n  if (!options.dryRun) writeFileSync(path, content)\n  return { file, status: 'patched', detail: 'wired reportError (5xx) + http.server.request.duration metric' }\n}\n\nfunction findCatchAfter(\n  content: string,\n  regex: RegExp,\n  afterIndex: number,\n): { index: number; length: number; indent: string } | null {\n  regex.lastIndex = 0\n  let match: RegExpExecArray | null\n  while ((match = regex.exec(content)) !== null) {\n    if (match.index > afterIndex) {\n      return { index: match.index, length: match[0].length, indent: match[1] }\n    }\n  }\n  return null\n}\n\nexport async function runTelemetryInit(args: string[]): Promise<number> {\n  const appDir = resolve('.')\n  const options = parseArgs(args)\n\n  if (!existsSync(join(appDir, 'src', 'modules.ts'))) {\n    console.error('\u274C  Not an Open Mercato app directory (src/modules.ts not found)')\n    return 1\n  }\n  if (!existsSync(join(appDir, 'package.json'))) {\n    console.error('\u274C  package.json not found')\n    return 1\n  }\n\n  console.log('')\n  console.log(options.dryRun ? '\uD83D\uDD2D Telemetry init (dry run \u2014 no files written)\\n' : '\uD83D\uDD2D Wiring @open-mercato/telemetry into this app\\n')\n\n  const results: StepResult[] = []\n  results.push(patchPackageJson(appDir, options))\n  const envExample = patchEnvFile(appDir, '.env.example', options)\n  if (envExample) results.push(envExample)\n  const env = patchEnvFile(appDir, '.env', options)\n  if (env) results.push(env)\n  results.push(patchInstrumentation(appDir, options))\n  results.push(await patchNextConfig(appDir, options))\n  results.push(patchDispatcher(appDir, options))\n\n  const icon: Record<StepStatus, string> = { created: '\u270D\uFE0F ', patched: '\u2705', skipped: '\u23ED\uFE0F ', manual: '\u26A0\uFE0F ' }\n  for (const result of results) {\n    console.log(`${icon[result.status]} ${result.file} \u2014 ${result.detail}`)\n  }\n\n  const manual = results.filter((result) => result.status === 'manual')\n  for (const result of manual) {\n    if (!result.manualSnippet) continue\n    console.log('')\n    console.log(`\u2500\u2500 manual step for ${result.file} \u2500\u2500`)\n    console.log(result.manualSnippet)\n  }\n\n  console.log('')\n  const changed = results.some((result) => result.status === 'patched' || result.status === 'created')\n  if (options.dryRun) {\n    console.log('Dry run complete \u2014 re-run without --dry-run to apply.')\n  } else if (changed) {\n    console.log('Next steps:')\n    console.log('  1. yarn install                 (resolve @open-mercato/telemetry + the OTEL SDK)')\n    console.log('  2. set TELEMETRY_BACKEND + OTEL_EXPORTER_OTLP_* in .env')\n    console.log('  3. yarn typecheck && yarn build (verify the wiring)')\n  } else {\n    console.log('Nothing to do \u2014 telemetry is already wired.')\n  }\n  if (manual.length > 0) {\n    console.log('')\n    console.log(`\u26A0\uFE0F  ${manual.length} file(s) need a manual edit (shown above) \u2014 the rest were applied automatically.`)\n  }\n  return 0\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/mercato.js

@@ -649,7 +649,10 @@ async function buildAllModules() {
 async function run(argv = process.argv) {
   const [, , ...parts] = argv;
   const [first, second, ...remaining] = parts;
-  await ensureEnvLoaded({ createIfMissing: first !== "deploy", quiet: first === "deploy" });
+  await ensureEnvLoaded({
+    createIfMissing: first !== "deploy" && first !== "telemetry",
+    quiet: first === "deploy" || first === "telemetry"
+  });
   if (first === "init") {
     const { execSync } = await import("child_process");
     console.log("\u{1F680} Initializing Open Mercato app...\n");
@@ -1059,6 +1062,17 @@ async function run(argv = process.argv) {
     const exitCode = await runAgenticInit(parts.slice(1));
     return exitCode;
   }
+  if (first === "telemetry") {
+    if (second === "init") {
+      const { runTelemetryInit } = await import("./lib/telemetry-init.js");
+      return runTelemetryInit(remaining.filter(Boolean));
+    }
+    console.log("Usage: yarn mercato telemetry init [--dry-run]");
+    console.log("  Wires @open-mercato/telemetry into this app (package.json, .env,");
+    console.log("  instrumentation.ts, next.config.ts, and the API dispatcher).");
+    console.log("  Idempotent and safe to re-run. Use --dry-run to preview changes.");
+    return second && second !== "help" && second !== "--help" && second !== "-h" ? 1 : 0;
+  }
   if (first === "module") {
     try {
       const subcommand = second;