@open-mercato/shared 0.6.7-develop.6828.1.ab1620a63e → 0.6.7-develop.6834.1.e76f4b8cbc

package/dist/lib/logger/index.js

@@ -1,12 +1,53 @@
 import { selectTransport } from "./transport.js";
-import { getLogLevel, isLevelEnabled, resetLogLevelCache, OM_LOG_LEVEL_ENV } from "./level.js";
+import { getLoggerExtension } from "./extension.js";
+import { isLevelEnabled } from "./level.js";
+import { getLogLevel, isLevelEnabled as isLevelEnabled2, resetLogLevelCache, OM_LOG_LEVEL_ENV } from "./level.js";
 import { resetServerLoggerCache, OM_LOG_DESTINATION_ENV } from "./transport.server.js";
 import { resetLogPrettyCache, OM_LOG_PRETTY_ENV } from "./transport.pretty.js";
+import {
+  getLoggerExtension as getLoggerExtension2,
+  registerLoggerExtension,
+  resetLoggerExtension
+} from "./extension.js";
 const loggerRegistry = /* @__PURE__ */ new Map();
+function createExtendedLogger(namespace, transport, bindings = {}) {
+  const emit = (level, msg, fields) => {
+    if (!isLevelEnabled(level)) return;
+    const extension = getLoggerExtension();
+    let context = {};
+    try {
+      context = extension?.enrich?.() ?? {};
+    } catch {
+    }
+    const mergedFields = { ...fields, ...context };
+    transport[level](msg, mergedFields);
+    try {
+      extension?.emit?.({
+        level,
+        namespace,
+        message: msg,
+        fields: { ...bindings, ...mergedFields },
+        time: Date.now()
+      });
+    } catch {
+    }
+  };
+  return {
+    debug: (msg, fields) => emit("debug", msg, fields),
+    info: (msg, fields) => emit("info", msg, fields),
+    warn: (msg, fields) => emit("warn", msg, fields),
+    error: (msg, fields) => emit("error", msg, fields),
+    child: (childBindings) => createExtendedLogger(
+      namespace,
+      transport.child(childBindings),
+      { ...bindings, ...childBindings }
+    )
+  };
+}
 function createLogger(namespace) {
   const existing = loggerRegistry.get(namespace);
   if (existing) return existing;
-  const created = selectTransport(namespace);
+  const created = createExtendedLogger(namespace, selectTransport(namespace));
   loggerRegistry.set(namespace, created);
   return created;
 }
@@ -19,9 +60,12 @@ export {
   OM_LOG_PRETTY_ENV,
   createLogger,
   getLogLevel,
-  isLevelEnabled,
+  getLoggerExtension2 as getLoggerExtension,
+  isLevelEnabled2 as isLevelEnabled,
+  registerLoggerExtension,
   resetLogLevelCache,
   resetLogPrettyCache,
+  resetLoggerExtension,
   resetLoggerRegistry,
   resetServerLoggerCache
 };

package/dist/lib/logger/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/logger/index.ts"],
-  "sourcesContent": ["import { selectTransport } from './transport'\n\nexport type { LogLevel } from './level'\nexport { getLogLevel, isLevelEnabled, resetLogLevelCache, OM_LOG_LEVEL_ENV } from './level'\nexport { resetServerLoggerCache, OM_LOG_DESTINATION_ENV } from './transport.server'\nexport { resetLogPrettyCache, OM_LOG_PRETTY_ENV } from './transport.pretty'\n\nexport type LogBindings = Record<string, unknown>\n\nexport interface Logger {\n  debug(msg: string, fields?: LogBindings): void\n  info(msg: string, fields?: LogBindings): void\n  warn(msg: string, fields?: LogBindings): void\n  error(msg: string, fields?: LogBindings): void\n  /** Returns a logger with `bindings` merged into every subsequent line. */\n  child(bindings: LogBindings): Logger\n}\n\nconst loggerRegistry = new Map<string, Logger>()\n\n/** Create (or reuse) a namespaced logger. `namespace` is attached as `name`. */\nexport function createLogger(namespace: string): Logger {\n  const existing = loggerRegistry.get(namespace)\n  if (existing) return existing\n  const created = selectTransport(namespace)\n  loggerRegistry.set(namespace, created)\n  return created\n}\n\n/** Internal: clear cached loggers so tests can re-run transport selection. */\nexport function resetLoggerRegistry(): void {\n  loggerRegistry.clear()\n}\n"],
-  "mappings": "AAAA,SAAS,uBAAuB;AAGhC,SAAS,aAAa,gBAAgB,oBAAoB,wBAAwB;AAClF,SAAS,wBAAwB,8BAA8B;AAC/D,SAAS,qBAAqB,yBAAyB;AAavD,MAAM,iBAAiB,oBAAI,IAAoB;AAGxC,SAAS,aAAa,WAA2B;AACtD,QAAM,WAAW,eAAe,IAAI,SAAS;AAC7C,MAAI,SAAU,QAAO;AACrB,QAAM,UAAU,gBAAgB,SAAS;AACzC,iBAAe,IAAI,WAAW,OAAO;AACrC,SAAO;AACT;AAGO,SAAS,sBAA4B;AAC1C,iBAAe,MAAM;AACvB;",
-  "names": []
+  "sourcesContent": ["import { selectTransport } from './transport'\nimport { getLoggerExtension } from './extension'\nimport { isLevelEnabled, type LogLevel } from './level'\n\nexport type { LogLevel } from './level'\nexport { getLogLevel, isLevelEnabled, resetLogLevelCache, OM_LOG_LEVEL_ENV } from './level'\nexport { resetServerLoggerCache, OM_LOG_DESTINATION_ENV } from './transport.server'\nexport { resetLogPrettyCache, OM_LOG_PRETTY_ENV } from './transport.pretty'\nexport {\n  getLoggerExtension,\n  registerLoggerExtension,\n  resetLoggerExtension,\n} from './extension'\nexport type { LoggerExtension, LoggerExtensionRecord } from './extension'\n\nexport type LogBindings = Record<string, unknown>\n\nexport interface Logger {\n  debug(msg: string, fields?: LogBindings): void\n  info(msg: string, fields?: LogBindings): void\n  warn(msg: string, fields?: LogBindings): void\n  error(msg: string, fields?: LogBindings): void\n  /** Returns a logger with `bindings` merged into every subsequent line. */\n  child(bindings: LogBindings): Logger\n}\n\nconst loggerRegistry = new Map<string, Logger>()\n\nfunction createExtendedLogger(\n  namespace: string,\n  transport: Logger,\n  bindings: LogBindings = {},\n): Logger {\n  const emit = (\n    level: LogLevel,\n    msg: string,\n    fields?: LogBindings,\n  ): void => {\n    if (!isLevelEnabled(level)) return\n\n    const extension = getLoggerExtension()\n    let context: LogBindings = {}\n    try {\n      context = extension?.enrich?.() ?? {}\n    } catch {\n      // Observability must never alter application behavior.\n    }\n\n    const mergedFields = { ...fields, ...context }\n    transport[level](msg, mergedFields)\n\n    try {\n      extension?.emit?.({\n        level,\n        namespace,\n        message: msg,\n        fields: { ...bindings, ...mergedFields },\n        time: Date.now(),\n      })\n    } catch {\n      // Remote logging is best-effort; the local line has already been written.\n    }\n  }\n\n  return {\n    debug: (msg, fields) => emit('debug', msg, fields),\n    info: (msg, fields) => emit('info', msg, fields),\n    warn: (msg, fields) => emit('warn', msg, fields),\n    error: (msg, fields) => emit('error', msg, fields),\n    child: (childBindings) =>\n      createExtendedLogger(\n        namespace,\n        transport.child(childBindings),\n        { ...bindings, ...childBindings },\n      ),\n  }\n}\n\n/** Create (or reuse) a namespaced logger. `namespace` is attached as `name`. */\nexport function createLogger(namespace: string): Logger {\n  const existing = loggerRegistry.get(namespace)\n  if (existing) return existing\n  const created = createExtendedLogger(namespace, selectTransport(namespace))\n  loggerRegistry.set(namespace, created)\n  return created\n}\n\n/** Internal: clear cached loggers so tests can re-run transport selection. */\nexport function resetLoggerRegistry(): void {\n  loggerRegistry.clear()\n}\n"],
+  "mappings": "AAAA,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,sBAAqC;AAG9C,SAAS,aAAa,kBAAAA,iBAAgB,oBAAoB,wBAAwB;AAClF,SAAS,wBAAwB,8BAA8B;AAC/D,SAAS,qBAAqB,yBAAyB;AACvD;AAAA,EACE,sBAAAC;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcP,MAAM,iBAAiB,oBAAI,IAAoB;AAE/C,SAAS,qBACP,WACA,WACA,WAAwB,CAAC,GACjB;AACR,QAAM,OAAO,CACX,OACA,KACA,WACS;AACT,QAAI,CAAC,eAAe,KAAK,EAAG;AAE5B,UAAM,YAAY,mBAAmB;AACrC,QAAI,UAAuB,CAAC;AAC5B,QAAI;AACF,gBAAU,WAAW,SAAS,KAAK,CAAC;AAAA,IACtC,QAAQ;AAAA,IAER;AAEA,UAAM,eAAe,EAAE,GAAG,QAAQ,GAAG,QAAQ;AAC7C,cAAU,KAAK,EAAE,KAAK,YAAY;AAElC,QAAI;AACF,iBAAW,OAAO;AAAA,QAChB;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT,QAAQ,EAAE,GAAG,UAAU,GAAG,aAAa;AAAA,QACvC,MAAM,KAAK,IAAI;AAAA,MACjB,CAAC;AAAA,IACH,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,CAAC,KAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AAAA,IACjD,MAAM,CAAC,KAAK,WAAW,KAAK,QAAQ,KAAK,MAAM;AAAA,IAC/C,MAAM,CAAC,KAAK,WAAW,KAAK,QAAQ,KAAK,MAAM;AAAA,IAC/C,OAAO,CAAC,KAAK,WAAW,KAAK,SAAS,KAAK,MAAM;AAAA,IACjD,OAAO,CAAC,kBACN;AAAA,MACE;AAAA,MACA,UAAU,MAAM,aAAa;AAAA,MAC7B,EAAE,GAAG,UAAU,GAAG,cAAc;AAAA,IAClC;AAAA,EACJ;AACF;AAGO,SAAS,aAAa,WAA2B;AACtD,QAAM,WAAW,eAAe,IAAI,SAAS;AAC7C,MAAI,SAAU,QAAO;AACrB,QAAM,UAAU,qBAAqB,WAAW,gBAAgB,SAAS,CAAC;AAC1E,iBAAe,IAAI,WAAW,OAAO;AACrC,SAAO;AACT;AAGO,SAAS,sBAA4B;AAC1C,iBAAe,MAAM;AACvB;",
+  "names": ["isLevelEnabled", "getLoggerExtension"]
 }

package/dist/lib/modules/registry.js

@@ -49,8 +49,12 @@ function getModules() {
   }
   return modules;
 }
+function tryGetModules() {
+  return getGlobalModules();
+}
 export {
   getModules,
-  registerModules
+  registerModules,
+  tryGetModules
 };
 //# sourceMappingURL=registry.js.map

package/dist/lib/modules/registry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/modules/registry.ts"],
-  "sourcesContent": ["import type { Module } from '@open-mercato/shared/modules/registry'\nimport { applyModuleOverridesToModules } from '@open-mercato/shared/modules/overrides'\nimport { invalidateDictionaryCache } from '../i18n/dictionary-cache'\nimport { createLogger } from '../logger'\n\nconst logger = createLogger('shared').child({ component: 'modules-registry' })\n\n// Registration pattern for publishable packages.\n// Use globalThis to survive tsx/esbuild module duplication where the same\n// registry.ts file can be loaded as multiple module instances when mixing\n// dynamic and static imports \u2014 for example a standalone integration test\n// bootstraps via the source path while a worker handler resolves it through\n// node_modules/@open-mercato/shared/dist/. Mirrors the same workaround used\n// by `getDiRegistrars()` in `../di/container.ts`.\nconst GLOBAL_KEY = '__openMercatoModulesRegistry__'\n\nfunction getGlobalModules(): Module[] | null {\n  return (globalThis as any)[GLOBAL_KEY] ?? null\n}\n\nfunction setGlobalModules(modules: Module[]): void {\n  ;(globalThis as any)[GLOBAL_KEY] = modules\n}\n\nfunction hasRuntimeContracts(entry: Module): boolean {\n  return Object.keys(entry).some((key) => key !== 'id' && key !== 'translations')\n}\n\nfunction isI18nOnlyRegistration(modules: Module[]): boolean {\n  return modules.length > 0 && modules.every((entry) => !hasRuntimeContracts(entry))\n}\n\nfunction mergeI18nModules(existing: Module[], incoming: Module[]): Module[] {\n  const incomingById = new Map(incoming.map((entry) => [entry.id, entry]))\n  const existingIds = new Set(existing.map((entry) => entry.id))\n  const merged = existing.map((entry) => {\n    const i18nModule = incomingById.get(entry.id)\n    if (!i18nModule?.translations) return entry\n    return {\n      ...entry,\n      translations: i18nModule.translations,\n    }\n  })\n\n  for (const entry of incoming) {\n    if (!existingIds.has(entry.id)) merged.push(entry)\n  }\n\n  return merged\n}\n\nexport function registerModules(modules: Module[]) {\n  const existing = getGlobalModules()\n  if (existing !== null && process.env.NODE_ENV === 'development') {\n    logger.debug('Modules re-registered (this may occur during HMR)')\n  }\n  const nextModules = applyModuleOverridesToModules(modules)\n  const shouldMergeI18nOnly = existing !== null\n    && existing.some(hasRuntimeContracts)\n    && isI18nOnlyRegistration(nextModules)\n  setGlobalModules(shouldMergeI18nOnly ? mergeI18nModules(existing, nextModules) : nextModules)\n  invalidateDictionaryCache()\n}\n\nexport function getModules(): Module[] {\n  const modules = getGlobalModules()\n  if (!modules) {\n    throw new Error('[Bootstrap] Modules not registered. Call registerModules() at bootstrap.')\n  }\n  return modules\n}\n"],
-  "mappings": "AACA,SAAS,qCAAqC;AAC9C,SAAS,iCAAiC;AAC1C,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,QAAQ,EAAE,MAAM,EAAE,WAAW,mBAAmB,CAAC;AAS7E,MAAM,aAAa;AAEnB,SAAS,mBAAoC;AAC3C,SAAQ,WAAmB,UAAU,KAAK;AAC5C;AAEA,SAAS,iBAAiB,SAAyB;AACjD;AAAC,EAAC,WAAmB,UAAU,IAAI;AACrC;AAEA,SAAS,oBAAoB,OAAwB;AACnD,SAAO,OAAO,KAAK,KAAK,EAAE,KAAK,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,cAAc;AAChF;AAEA,SAAS,uBAAuB,SAA4B;AAC1D,SAAO,QAAQ,SAAS,KAAK,QAAQ,MAAM,CAAC,UAAU,CAAC,oBAAoB,KAAK,CAAC;AACnF;AAEA,SAAS,iBAAiB,UAAoB,UAA8B;AAC1E,QAAM,eAAe,IAAI,IAAI,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AACvE,QAAM,cAAc,IAAI,IAAI,SAAS,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC;AAC7D,QAAM,SAAS,SAAS,IAAI,CAAC,UAAU;AACrC,UAAM,aAAa,aAAa,IAAI,MAAM,EAAE;AAC5C,QAAI,CAAC,YAAY,aAAc,QAAO;AACtC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,cAAc,WAAW;AAAA,IAC3B;AAAA,EACF,CAAC;AAED,aAAW,SAAS,UAAU;AAC5B,QAAI,CAAC,YAAY,IAAI,MAAM,EAAE,EAAG,QAAO,KAAK,KAAK;AAAA,EACnD;AAEA,SAAO;AACT;AAEO,SAAS,gBAAgB,SAAmB;AACjD,QAAM,WAAW,iBAAiB;AAClC,MAAI,aAAa,QAAQ,QAAQ,IAAI,aAAa,eAAe;AAC/D,WAAO,MAAM,mDAAmD;AAAA,EAClE;AACA,QAAM,cAAc,8BAA8B,OAAO;AACzD,QAAM,sBAAsB,aAAa,QACpC,SAAS,KAAK,mBAAmB,KACjC,uBAAuB,WAAW;AACvC,mBAAiB,sBAAsB,iBAAiB,UAAU,WAAW,IAAI,WAAW;AAC5F,4BAA0B;AAC5B;AAEO,SAAS,aAAuB;AACrC,QAAM,UAAU,iBAAiB;AACjC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AACA,SAAO;AACT;",
+  "sourcesContent": ["import type { Module } from '@open-mercato/shared/modules/registry'\nimport { applyModuleOverridesToModules } from '@open-mercato/shared/modules/overrides'\nimport { invalidateDictionaryCache } from '../i18n/dictionary-cache'\nimport { createLogger } from '../logger'\n\nconst logger = createLogger('shared').child({ component: 'modules-registry' })\n\n// Registration pattern for publishable packages.\n// Use globalThis to survive tsx/esbuild module duplication where the same\n// registry.ts file can be loaded as multiple module instances when mixing\n// dynamic and static imports \u2014 for example a standalone integration test\n// bootstraps via the source path while a worker handler resolves it through\n// node_modules/@open-mercato/shared/dist/. Mirrors the same workaround used\n// by `getDiRegistrars()` in `../di/container.ts`.\nconst GLOBAL_KEY = '__openMercatoModulesRegistry__'\n\nfunction getGlobalModules(): Module[] | null {\n  return (globalThis as any)[GLOBAL_KEY] ?? null\n}\n\nfunction setGlobalModules(modules: Module[]): void {\n  ;(globalThis as any)[GLOBAL_KEY] = modules\n}\n\nfunction hasRuntimeContracts(entry: Module): boolean {\n  return Object.keys(entry).some((key) => key !== 'id' && key !== 'translations')\n}\n\nfunction isI18nOnlyRegistration(modules: Module[]): boolean {\n  return modules.length > 0 && modules.every((entry) => !hasRuntimeContracts(entry))\n}\n\nfunction mergeI18nModules(existing: Module[], incoming: Module[]): Module[] {\n  const incomingById = new Map(incoming.map((entry) => [entry.id, entry]))\n  const existingIds = new Set(existing.map((entry) => entry.id))\n  const merged = existing.map((entry) => {\n    const i18nModule = incomingById.get(entry.id)\n    if (!i18nModule?.translations) return entry\n    return {\n      ...entry,\n      translations: i18nModule.translations,\n    }\n  })\n\n  for (const entry of incoming) {\n    if (!existingIds.has(entry.id)) merged.push(entry)\n  }\n\n  return merged\n}\n\nexport function registerModules(modules: Module[]) {\n  const existing = getGlobalModules()\n  if (existing !== null && process.env.NODE_ENV === 'development') {\n    logger.debug('Modules re-registered (this may occur during HMR)')\n  }\n  const nextModules = applyModuleOverridesToModules(modules)\n  const shouldMergeI18nOnly = existing !== null\n    && existing.some(hasRuntimeContracts)\n    && isI18nOnlyRegistration(nextModules)\n  setGlobalModules(shouldMergeI18nOnly ? mergeI18nModules(existing, nextModules) : nextModules)\n  invalidateDictionaryCache()\n}\n\nexport function getModules(): Module[] {\n  const modules = getGlobalModules()\n  if (!modules) {\n    throw new Error('[Bootstrap] Modules not registered. Call registerModules() at bootstrap.')\n  }\n  return modules\n}\n\n/**\n * Non-throwing counterpart of `getModules()` for call sites that have a\n * meaningful degraded behavior when bootstrap has not run \u2014 route unit tests\n * exercise a single handler without `registerModules()`, and a hard throw there\n * turns an unrelated assertion into a bootstrap error.\n */\nexport function tryGetModules(): Module[] | null {\n  return getGlobalModules()\n}\n"],
+  "mappings": "AACA,SAAS,qCAAqC;AAC9C,SAAS,iCAAiC;AAC1C,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,QAAQ,EAAE,MAAM,EAAE,WAAW,mBAAmB,CAAC;AAS7E,MAAM,aAAa;AAEnB,SAAS,mBAAoC;AAC3C,SAAQ,WAAmB,UAAU,KAAK;AAC5C;AAEA,SAAS,iBAAiB,SAAyB;AACjD;AAAC,EAAC,WAAmB,UAAU,IAAI;AACrC;AAEA,SAAS,oBAAoB,OAAwB;AACnD,SAAO,OAAO,KAAK,KAAK,EAAE,KAAK,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,cAAc;AAChF;AAEA,SAAS,uBAAuB,SAA4B;AAC1D,SAAO,QAAQ,SAAS,KAAK,QAAQ,MAAM,CAAC,UAAU,CAAC,oBAAoB,KAAK,CAAC;AACnF;AAEA,SAAS,iBAAiB,UAAoB,UAA8B;AAC1E,QAAM,eAAe,IAAI,IAAI,SAAS,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AACvE,QAAM,cAAc,IAAI,IAAI,SAAS,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC;AAC7D,QAAM,SAAS,SAAS,IAAI,CAAC,UAAU;AACrC,UAAM,aAAa,aAAa,IAAI,MAAM,EAAE;AAC5C,QAAI,CAAC,YAAY,aAAc,QAAO;AACtC,WAAO;AAAA,MACL,GAAG;AAAA,MACH,cAAc,WAAW;AAAA,IAC3B;AAAA,EACF,CAAC;AAED,aAAW,SAAS,UAAU;AAC5B,QAAI,CAAC,YAAY,IAAI,MAAM,EAAE,EAAG,QAAO,KAAK,KAAK;AAAA,EACnD;AAEA,SAAO;AACT;AAEO,SAAS,gBAAgB,SAAmB;AACjD,QAAM,WAAW,iBAAiB;AAClC,MAAI,aAAa,QAAQ,QAAQ,IAAI,aAAa,eAAe;AAC/D,WAAO,MAAM,mDAAmD;AAAA,EAClE;AACA,QAAM,cAAc,8BAA8B,OAAO;AACzD,QAAM,sBAAsB,aAAa,QACpC,SAAS,KAAK,mBAAmB,KACjC,uBAAuB,WAAW;AACvC,mBAAiB,sBAAsB,iBAAiB,UAAU,WAAW,IAAI,WAAW;AAC5F,4BAA0B;AAC5B;AAEO,SAAS,aAAuB;AACrC,QAAM,UAAU,iBAAiB;AACjC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AACA,SAAO;AACT;AAQO,SAAS,gBAAiC;AAC/C,SAAO,iBAAiB;AAC1B;",
   "names": []
 }

package/dist/lib/telemetry/runtime.js

@@ -0,0 +1,35 @@
+const GLOBAL_KEY = /* @__PURE__ */ Symbol.for("@open-mercato/shared.telemetryRuntime");
+const ENABLED_BACKENDS = /* @__PURE__ */ new Set(["console", "signoz", "newrelic", "otlp"]);
+function store() {
+  const globalStore = globalThis;
+  let current = globalStore[GLOBAL_KEY];
+  if (!current) {
+    current = {};
+    globalStore[GLOBAL_KEY] = current;
+  }
+  return current;
+}
+function isTelemetryBackendEnabled(raw) {
+  const value = raw ?? (typeof process === "undefined" ? void 0 : process.env.TELEMETRY_BACKEND);
+  return ENABLED_BACKENDS.has((value ?? "").trim().toLowerCase());
+}
+function registerTelemetryRuntime(runtime) {
+  store().active = runtime;
+  return () => {
+    const current = store();
+    if (current.active === runtime) current.active = void 0;
+  };
+}
+function getTelemetryRuntime() {
+  return store().active;
+}
+function resetTelemetryRuntime() {
+  store().active = void 0;
+}
+export {
+  getTelemetryRuntime,
+  isTelemetryBackendEnabled,
+  registerTelemetryRuntime,
+  resetTelemetryRuntime
+};
+//# sourceMappingURL=runtime.js.map

package/dist/lib/telemetry/runtime.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/telemetry/runtime.ts"],
+  "sourcesContent": ["export type TelemetryTraceCarrier = Record<string, string>\n\nexport type TelemetryRuntime = {\n  /**\n   * True only when the active SDK may safely use the process-global W3C\n   * propagator for cross-boundary extraction.\n   */\n  canUseGlobalTracePropagation(): boolean\n  captureTraceContext(): TelemetryTraceCarrier\n  continueTrace<T>(\n    carrier: TelemetryTraceCarrier | undefined,\n    name: string,\n    fn: () => T,\n    options?: { kind?: 'internal' | 'server' | 'client' | 'producer' | 'consumer' },\n  ): T\n  recordHttpDuration(method: string, route: string, status: number, startedAt: number): void\n  reportError(\n    error: unknown,\n    context?: {\n      module?: string\n      attributes?: Record<string, string | number | boolean | undefined>\n    },\n  ): void\n  shutdown(): Promise<void>\n}\n\nconst GLOBAL_KEY = Symbol.for('@open-mercato/shared.telemetryRuntime')\nconst ENABLED_BACKENDS = new Set(['console', 'signoz', 'newrelic', 'otlp'])\n\ntype TelemetryRuntimeStore = {\n  active?: TelemetryRuntime\n}\n\nfunction store(): TelemetryRuntimeStore {\n  const globalStore = globalThis as unknown as Record<symbol, TelemetryRuntimeStore | undefined>\n  let current = globalStore[GLOBAL_KEY]\n  if (!current) {\n    current = {}\n    globalStore[GLOBAL_KEY] = current\n  }\n  return current\n}\n\n/**\n * This check is intentionally owned by shared code so hosts can decide whether\n * to dynamically import the telemetry package without evaluating that package.\n */\nexport function isTelemetryBackendEnabled(raw?: string): boolean {\n  const value = raw ?? (\n    typeof process === 'undefined'\n      ? undefined\n      : process.env.TELEMETRY_BACKEND\n  )\n  return ENABLED_BACKENDS.has((value ?? '').trim().toLowerCase())\n}\n\nexport function registerTelemetryRuntime(runtime: TelemetryRuntime): () => void {\n  store().active = runtime\n  return () => {\n    const current = store()\n    if (current.active === runtime) current.active = undefined\n  }\n}\n\nexport function getTelemetryRuntime(): TelemetryRuntime | undefined {\n  return store().active\n}\n\n/** Test-only: clear the process-wide telemetry bridge. */\nexport function resetTelemetryRuntime(): void {\n  store().active = undefined\n}\n"],
+  "mappings": "AA0BA,MAAM,aAAa,uBAAO,IAAI,uCAAuC;AACrE,MAAM,mBAAmB,oBAAI,IAAI,CAAC,WAAW,UAAU,YAAY,MAAM,CAAC;AAM1E,SAAS,QAA+B;AACtC,QAAM,cAAc;AACpB,MAAI,UAAU,YAAY,UAAU;AACpC,MAAI,CAAC,SAAS;AACZ,cAAU,CAAC;AACX,gBAAY,UAAU,IAAI;AAAA,EAC5B;AACA,SAAO;AACT;AAMO,SAAS,0BAA0B,KAAuB;AAC/D,QAAM,QAAQ,QACZ,OAAO,YAAY,cACf,SACA,QAAQ,IAAI;AAElB,SAAO,iBAAiB,KAAK,SAAS,IAAI,KAAK,EAAE,YAAY,CAAC;AAChE;AAEO,SAAS,yBAAyB,SAAuC;AAC9E,QAAM,EAAE,SAAS;AACjB,SAAO,MAAM;AACX,UAAM,UAAU,MAAM;AACtB,QAAI,QAAQ,WAAW,QAAS,SAAQ,SAAS;AAAA,EACnD;AACF;AAEO,SAAS,sBAAoD;AAClE,SAAO,MAAM,EAAE;AACjB;AAGO,SAAS,wBAA8B;AAC5C,QAAM,EAAE,SAAS;AACnB;",
+  "names": []
+}

package/dist/lib/version.js

@@ -1,4 +1,4 @@
-const APP_VERSION = "0.6.7-develop.6828.1.ab1620a63e";
+const APP_VERSION = "0.6.7-develop.6834.1.e76f4b8cbc";
 const appVersion = APP_VERSION;
 export {
   APP_VERSION,

package/dist/lib/version.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/version.ts"],
-  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.7-develop.6828.1.ab1620a63e';\nexport const appVersion = APP_VERSION;\n"],
+  "sourcesContent": ["// Build-time generated version\nexport const APP_VERSION = '0.6.7-develop.6834.1.e76f4b8cbc';\nexport const appVersion = APP_VERSION;\n"],
   "mappings": "AACO,MAAM,cAAc;AACpB,MAAM,aAAa;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.6.7-develop.6828.1.ab1620a63e",
+  "version": "0.6.7-develop.6834.1.e76f4b8cbc",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -105,7 +105,7 @@
     "@mikro-orm/core": "^7.1.8",
     "@mikro-orm/decorators": "^7.1.8",
     "@mikro-orm/postgresql": "^7.1.8",
-    "@open-mercato/cache": "0.6.7-develop.6828.1.ab1620a63e",
+    "@open-mercato/cache": "0.6.7-develop.6834.1.e76f4b8cbc",
     "@types/sanitize-html": "^2.16.1",
     "dotenv": "^17.4.2",
     "pino": "^10.3.1",

package/src/lib/bootstrap/__tests__/dynamicLoader.aliasResolver.test.ts

@@ -0,0 +1,98 @@
+/**
+ * @jest-environment node
+ *
+ * The CLI bundle's `@/` alias must mirror what the app tsconfig maps, because the dynamic
+ * bootstrap path compiles app sources (`src/di.ts`) and generated registries that import app
+ * modules through the alias. The tsconfig maps `@/.mercato/*` to the app root and every other
+ * `@/*` to the app's `src/` directory; resolving everything against the app root silently sends
+ * `@/lib/x` to a path that does not exist.
+ */
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
+import { createCliBundlePlugins } from '../dynamicLoader'
+
+async function bundleWithCliPlugins(appRoot: string, entry: string): Promise<string> {
+  const esbuild = await import('esbuild')
+  const outfile = path.join(appRoot, 'bundle.mjs')
+  await esbuild.build({
+    entryPoints: [entry],
+    outfile,
+    absWorkingDir: appRoot,
+    bundle: true,
+    format: 'esm',
+    platform: 'node',
+    target: 'node18',
+    plugins: createCliBundlePlugins(appRoot),
+  })
+  return fs.readFileSync(outfile, 'utf8')
+}
+
+describe('createCliBundlePlugins — @/ alias resolution', () => {
+  let appRoot: string
+
+  beforeEach(() => {
+    appRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'om-alias-resolver-'))
+    fs.mkdirSync(path.join(appRoot, 'src', 'lib'), { recursive: true })
+    fs.mkdirSync(path.join(appRoot, 'src', 'modules', 'demo'), { recursive: true })
+    fs.mkdirSync(path.join(appRoot, '.mercato', 'generated'), { recursive: true })
+
+    fs.writeFileSync(
+      path.join(appRoot, 'src', 'lib', 'marker.ts'),
+      "export const srcLibMarker = 'resolved-from-src-lib'\n",
+    )
+    fs.writeFileSync(
+      path.join(appRoot, 'src', 'modules', 'demo', 'index.ts'),
+      "export const srcModuleMarker = 'resolved-from-src-module-index'\n",
+    )
+    fs.writeFileSync(
+      path.join(appRoot, '.mercato', 'generated', 'registry.generated.ts'),
+      "export const generatedMarker = 'resolved-from-generated'\n",
+    )
+  })
+
+  afterEach(() => {
+    fs.rmSync(appRoot, { recursive: true, force: true })
+  })
+
+  it('resolves @/* against the app src directory and @/.mercato/* against the app root', async () => {
+    const entry = path.join(appRoot, '.mercato', 'generated', 'entry.ts')
+    fs.writeFileSync(
+      entry,
+      [
+        "import { srcLibMarker } from '@/lib/marker'",
+        "import { srcModuleMarker } from '@/modules/demo'",
+        "import { generatedMarker } from '@/.mercato/generated/registry.generated'",
+        'export const markers = [srcLibMarker, srcModuleMarker, generatedMarker]',
+        '',
+      ].join('\n'),
+    )
+
+    const output = await bundleWithCliPlugins(appRoot, entry)
+
+    expect(output).toContain('resolved-from-src-lib')
+    expect(output).toContain('resolved-from-src-module-index')
+    expect(output).toContain('resolved-from-generated')
+  })
+
+  it('prefers an app-root match when the specifier has no src counterpart', async () => {
+    fs.writeFileSync(
+      path.join(appRoot, 'root-only.ts'),
+      "export const rootOnlyMarker = 'resolved-from-app-root'\n",
+    )
+    const entry = path.join(appRoot, '.mercato', 'generated', 'entry.ts')
+    fs.writeFileSync(
+      entry,
+      [
+        "import { rootOnlyMarker } from '@/root-only'",
+        'export const markers = [rootOnlyMarker]',
+        '',
+      ].join('\n'),
+    )
+
+    const output = await bundleWithCliPlugins(appRoot, entry)
+
+    expect(output).toContain('resolved-from-app-root')
+  })
+})

package/src/lib/bootstrap/__tests__/dynamicLoader.appDi.test.ts

@@ -0,0 +1,211 @@
+/**
+ * @jest-environment node
+ *
+ * Regression guard: the worker/CLI/scheduler bootstrap path (bootstrapFromAppRoot) must register
+ * the app-level DI hook (`src/di.ts`) the same way the Next.js runtime does through its own
+ * `src/bootstrap.ts`. Without it, `getAppDiRegistrar()` stays null in those processes, so the app's
+ * registrations silently never run there and every request container falls back to a doomed
+ * `import('@/di')` — the `@/` alias does not exist in a plain Node ESM process, so it throws
+ * ERR_MODULE_NOT_FOUND once per created container (once per queued job).
+ *
+ * Like the #4327 guard next to it, this test authors both the `.ts` sources and fresh compiled
+ * `.mjs` siblings so compileAndImport takes its cache path and never invokes esbuild. The `.mjs`
+ * stubs use module.exports because Jest's CJS runtime handles the dynamic import().
+ *
+ * `bootstrapFromAppRoot` reaches the factory through `import('./factory.js')`, a specifier with no
+ * on-disk counterpart under Jest's CJS resolver, so it is mocked virtually.
+ */
+jest.mock('../../logger', () => {
+  const logger = {
+    debug: jest.fn(),
+    info: jest.fn(),
+    warn: jest.fn(),
+    error: jest.fn(),
+    child: () => logger,
+  }
+  return { createLogger: () => logger }
+})
+
+const createBootstrapMock = jest.fn(() => () => {})
+
+jest.mock(
+  '../factory.js',
+  () => ({
+    createBootstrap: (...args: unknown[]) => createBootstrapMock(...(args as [])),
+    waitForAsyncRegistration: async () => {},
+  }),
+  { virtual: true },
+)
+
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import crypto from 'node:crypto'
+import { createLogger } from '../../logger'
+import { bootstrapFromAppRoot } from '../dynamicLoader'
+
+const mockedLogger = createLogger('shared') as unknown as {
+  debug: jest.Mock
+  error: jest.Mock
+}
+
+const APP_DI_CALL_COUNTER_KEY = '__omTestAppDiRegisterCalls__'
+
+const GENERATED_MODULES: Record<string, { ts: string; compiled: string }> = {
+  'entities.ids.generated': { ts: 'export const E = {}', compiled: 'module.exports = { E: {} }' },
+  'modules.cli.generated': { ts: 'export const modules = []', compiled: 'module.exports = { modules: [] }' },
+  'entities.generated': { ts: 'export const entities = []', compiled: 'module.exports = { entities: [] }' },
+  'di.generated': { ts: 'export const diRegistrars = []', compiled: 'module.exports = { diRegistrars: [] }' },
+}
+
+const APP_TSCONFIG = JSON.stringify({
+  compilerOptions: {
+    experimentalDecorators: true,
+    emitDecoratorMetadata: true,
+    useDefineForClassFields: false,
+    target: 'ES2022',
+  },
+})
+
+const APP_DI_TS = 'export function register() {}'
+
+const APP_DI_COMPILED = [
+  'module.exports = {',
+  '  register: () => {',
+  `    globalThis['${APP_DI_CALL_COUNTER_KEY}'] = (globalThis['${APP_DI_CALL_COUNTER_KEY}'] ?? 0) + 1`,
+  '  },',
+  '}',
+].join('\n')
+
+function hash(content: string): string {
+  return crypto.createHash('sha256').update(content).digest('hex')
+}
+
+function writeCompiledPair(
+  appRoot: string,
+  sourcePath: string,
+  compiledPath: string,
+  source: { ts: string; compiled: string },
+) {
+  fs.writeFileSync(sourcePath, source.ts)
+  fs.writeFileSync(compiledPath, source.compiled)
+  const sourceRelativePath = path.relative(appRoot, sourcePath).split(path.sep).join('/')
+  fs.writeFileSync(`${compiledPath}.cache.json`, JSON.stringify({
+    version: 4,
+    inputHash: hash(JSON.stringify({
+      version: 4,
+      sourceHash: hash(source.ts),
+      tsconfigHashes: {
+        'tsconfig.json': hash(APP_TSCONFIG),
+      },
+    })),
+    outputHash: hash(source.compiled),
+    dependencies: {
+      [sourceRelativePath]: hash(source.ts),
+    },
+  }))
+}
+
+const createdAppRoots: string[] = []
+
+function createAppRoot(appDi: { ts: string; compiled: string } | null): string {
+  const appRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'om-bootstrap-app-di-'))
+  const generatedDir = path.join(appRoot, '.mercato', 'generated')
+  fs.mkdirSync(generatedDir, { recursive: true })
+  fs.writeFileSync(path.join(appRoot, 'tsconfig.json'), APP_TSCONFIG)
+
+  for (const [baseName, source] of Object.entries(GENERATED_MODULES)) {
+    writeCompiledPair(
+      appRoot,
+      path.join(generatedDir, `${baseName}.ts`),
+      path.join(generatedDir, `${baseName}.mjs`),
+      source,
+    )
+  }
+
+  if (appDi) {
+    fs.mkdirSync(path.join(appRoot, 'src'), { recursive: true })
+    writeCompiledPair(
+      appRoot,
+      path.join(appRoot, 'src', 'di.ts'),
+      path.join(generatedDir, 'app-di.compiled.mjs'),
+      appDi,
+    )
+  }
+
+  createdAppRoots.push(appRoot)
+  return appRoot
+}
+
+function appDiRegistrarArgument(): unknown {
+  const [, options] = createBootstrapMock.mock.calls[0] as unknown as [unknown, Record<string, unknown>]
+  return options?.appDiRegistrar
+}
+
+describe('bootstrapFromAppRoot — app-level DI reaches worker/CLI processes', () => {
+  afterAll(() => {
+    for (const root of createdAppRoots) {
+      fs.rmSync(root, { recursive: true, force: true })
+    }
+  })
+
+  beforeEach(() => {
+    createBootstrapMock.mockClear()
+    mockedLogger.debug.mockClear()
+    mockedLogger.error.mockClear()
+    delete (globalThis as Record<string, unknown>)[APP_DI_CALL_COUNTER_KEY]
+  })
+
+  it('passes the app DI register() from src/di.ts to createBootstrap', async () => {
+    const appRoot = createAppRoot({ ts: APP_DI_TS, compiled: APP_DI_COMPILED })
+
+    await bootstrapFromAppRoot(appRoot)
+
+    const registrar = appDiRegistrarArgument()
+    expect(typeof registrar).toBe('function')
+
+    await (registrar as (container: unknown) => unknown)({})
+    expect((globalThis as Record<string, unknown>)[APP_DI_CALL_COUNTER_KEY]).toBe(1)
+    expect(mockedLogger.error).not.toHaveBeenCalled()
+  })
+
+  it('bootstraps without an app DI registrar when src/di.ts is absent', async () => {
+    const appRoot = createAppRoot(null)
+
+    await bootstrapFromAppRoot(appRoot)
+
+    expect(createBootstrapMock).toHaveBeenCalledTimes(1)
+    expect(appDiRegistrarArgument()).toBeUndefined()
+    expect(mockedLogger.error).not.toHaveBeenCalled()
+  })
+
+  it('reports an error and keeps bootstrapping when src/di.ts fails to load', async () => {
+    const appRoot = createAppRoot({
+      ts: APP_DI_TS,
+      compiled: "throw new Error('src/di.ts is broken')",
+    })
+
+    await bootstrapFromAppRoot(appRoot)
+
+    expect(createBootstrapMock).toHaveBeenCalledTimes(1)
+    expect(appDiRegistrarArgument()).toBeUndefined()
+    expect(mockedLogger.error).toHaveBeenCalledTimes(1)
+    const [message, fields] = mockedLogger.error.mock.calls[0] as [string, Record<string, unknown>]
+    expect(message).toContain('Failed to load the app-level DI module')
+    expect((fields.err as Error).message).toContain('src/di.ts is broken')
+  })
+
+  it('reports an error and keeps bootstrapping when src/di.ts exports no register()', async () => {
+    const appRoot = createAppRoot({
+      ts: APP_DI_TS,
+      compiled: 'module.exports = {}',
+    })
+
+    await bootstrapFromAppRoot(appRoot)
+
+    expect(createBootstrapMock).toHaveBeenCalledTimes(1)
+    expect(appDiRegistrarArgument()).toBeUndefined()
+    expect(mockedLogger.error).toHaveBeenCalledTimes(1)
+    expect(mockedLogger.error.mock.calls[0][0]).toContain('exports no register()')
+  })
+})