@open-mercato/shared 0.4.5-develop-03023b2707 → 0.4.5-develop-0c30cb4b11

package/dist/modules/events/factory.js

@@ -29,6 +29,10 @@ function getAllDeclaredEventIds() {
 function getDeclaredEvents() {
   return [...allDeclaredEvents];
 }
+function isBroadcastEvent(eventId) {
+  const event = allDeclaredEvents.find((e) => e.id === eventId);
+  return event?.clientBroadcast === true;
+}
 let _registeredEventConfigs = null;
 function registerEventModuleConfigs(configs) {
   if (_registeredEventConfigs !== null && process.env.NODE_ENV === "development") {
@@ -82,6 +86,7 @@ export {
   getDeclaredEvents,
   getEventModuleConfigs,
   getGlobalEventBus,
+  isBroadcastEvent,
   isEventDeclared,
   registerEventModuleConfigs,
   setGlobalEventBus

package/dist/modules/events/factory.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/events/factory.ts"],
-  "sourcesContent": ["/**\n * Event Module Factory\n *\n * Provides factory functions for creating type-safe event configurations.\n */\n\nimport type {\n  EventDefinition,\n  EventModuleConfig,\n  EventPayload,\n  EmitOptions,\n  CreateModuleEventsOptions,\n  ModuleEventEmitter,\n} from './types'\n\n// =============================================================================\n// Global Event Bus Reference\n// =============================================================================\n\n/**\n * Type for the global event bus interface\n */\ninterface GlobalEventBus {\n  emit(event: string, payload: unknown, options?: EmitOptions): Promise<void>\n}\n\nconst GLOBAL_EVENT_BUS_KEY = '__openMercatoGlobalEventBus__'\n\n// Global event bus reference (set during bootstrap)\nlet globalEventBus: GlobalEventBus | null = null\n\n/**\n * Set the global event bus instance.\n * Called during app bootstrap to wire up event emission.\n */\nexport function setGlobalEventBus(bus: GlobalEventBus): void {\n  globalEventBus = bus\n  try {\n    ;(globalThis as Record<string, unknown>)[GLOBAL_EVENT_BUS_KEY] = bus\n  } catch {\n    // ignore global assignment failures\n  }\n}\n\n/**\n * Get the global event bus instance.\n * Returns null if not yet bootstrapped.\n */\nexport function getGlobalEventBus(): GlobalEventBus | null {\n  try {\n    const sharedBus = (globalThis as Record<string, unknown>)[GLOBAL_EVENT_BUS_KEY]\n    if (sharedBus && typeof sharedBus === 'object' && typeof (sharedBus as GlobalEventBus).emit === 'function') {\n      return sharedBus as GlobalEventBus\n    }\n  } catch {\n    // ignore global read failures\n  }\n  return globalEventBus\n}\n\n// =============================================================================\n// Event Registry for Validation\n// =============================================================================\n\n// Global set of all declared event IDs for runtime validation\nconst allDeclaredEventIds = new Set<string>()\n\n// Global registry of all declared events with their full definitions\nconst allDeclaredEvents: EventDefinition[] = []\n\n/**\n * Check if an event ID has been declared by any module.\n * Used for runtime validation to ensure only declared events are emitted.\n */\nexport function isEventDeclared(eventId: string): boolean {\n  return allDeclaredEventIds.has(eventId)\n}\n\n/**\n * Get all declared event IDs.\n * Useful for debugging and introspection.\n */\nexport function getAllDeclaredEventIds(): string[] {\n  return Array.from(allDeclaredEventIds)\n}\n\n/**\n * Get all declared events with their full definitions.\n * Used by the API to return available events for workflow triggers.\n */\nexport function getDeclaredEvents(): EventDefinition[] {\n  return [...allDeclaredEvents]\n}\n\n// =============================================================================\n// Bootstrap Registration (similar to searchModuleConfigs pattern)\n// =============================================================================\n\nlet _registeredEventConfigs: EventModuleConfig[] | null = null\n\n/**\n * Register event module configurations globally.\n * Called during app bootstrap with configs from events.generated.ts.\n */\nexport function registerEventModuleConfigs(configs: EventModuleConfig[]): void {\n  if (_registeredEventConfigs !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] Event module configs re-registered (this may occur during HMR)')\n  }\n  _registeredEventConfigs = configs\n}\n\n/**\n * Get registered event module configurations.\n * Returns empty array if not registered.\n */\nexport function getEventModuleConfigs(): EventModuleConfig[] {\n  return _registeredEventConfigs ?? []\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Creates a type-safe event configuration for a module.\n *\n * Usage in module events.ts:\n * ```typescript\n * import { createModuleEvents } from '@open-mercato/shared/modules/events'\n *\n * const events = [\n *   { id: 'customers.people.created', label: 'Person Created', category: 'crud' },\n *   { id: 'customers.people.updated', label: 'Person Updated', category: 'crud' },\n * ] as const\n *\n * export const eventsConfig = createModuleEvents({\n *   moduleId: 'customers',\n *   events,\n * })\n *\n * // Export the typed emit function for use in commands\n * export const emitCustomersEvent = eventsConfig.emit\n *\n * // Export event IDs as a type for external use\n * export type CustomersEventId = typeof events[number]['id']\n *\n * export default eventsConfig\n * ```\n *\n * TypeScript will enforce that only declared event IDs can be emitted:\n * ```typescript\n * // \u2705 This compiles - event is declared\n * emitCustomersEvent('customers.people.created', { id: '123', tenantId: 'abc' })\n *\n * // \u274C TypeScript error - event not declared\n * emitCustomersEvent('customers.people.exploded', { id: '123' })\n * ```\n */\nexport function createModuleEvents<\n  const TEvents extends readonly { id: string }[],\n  TEventIds extends TEvents[number]['id'] = TEvents[number]['id']\n>(options: CreateModuleEventsOptions<TEventIds>): EventModuleConfig<TEventIds> {\n  const { moduleId, events, strict = false } = options\n\n  // Build set of valid event IDs for runtime validation\n  const validEventIds = new Set(events.map(e => e.id))\n\n  // Build full event definitions with module added\n  const fullEvents: EventDefinition[] = events.map(e => ({\n    ...e,\n    module: moduleId,\n  }))\n\n  // Register all event IDs and definitions in the global registry\n  for (const eventId of validEventIds) {\n    allDeclaredEventIds.add(eventId)\n  }\n  for (const event of fullEvents) {\n    // Avoid duplicates if createModuleEvents is called multiple times (e.g., HMR)\n    if (!allDeclaredEvents.find(e => e.id === event.id)) {\n      allDeclaredEvents.push(event)\n    }\n  }\n\n  /**\n   * The emit function - validates events and delegates to the global event bus\n   */\n  const emit = async (\n    eventId: TEventIds,\n    payload: EventPayload,\n    emitOptions?: EmitOptions\n  ): Promise<void> => {\n    // Runtime validation - event must be declared\n    if (!validEventIds.has(eventId)) {\n      const message =\n        `[events] Module \"${moduleId}\" tried to emit undeclared event \"${eventId}\". ` +\n        `Add it to the module's events.ts file first.`\n\n      if (strict) {\n        throw new Error(message)\n      } else {\n        console.error(message)\n        // In non-strict mode, still emit but with warning\n      }\n    }\n\n    // Get event bus from global reference\n    const eventBus = getGlobalEventBus()\n    if (!eventBus) {\n      console.warn(`[events] Event bus not available, cannot emit \"${eventId}\"`)\n      return\n    }\n\n    await eventBus.emit(eventId, payload, emitOptions)\n  }\n\n  return {\n    moduleId,\n    events: fullEvents,\n    emit: emit as unknown as ModuleEventEmitter<TEventIds>,\n  }\n}\n"],
-  "mappings": "AA0BA,MAAM,uBAAuB;AAG7B,IAAI,iBAAwC;AAMrC,SAAS,kBAAkB,KAA2B;AAC3D,mBAAiB;AACjB,MAAI;AACF;AAAC,IAAC,WAAuC,oBAAoB,IAAI;AAAA,EACnE,QAAQ;AAAA,EAER;AACF;AAMO,SAAS,oBAA2C;AACzD,MAAI;AACF,UAAM,YAAa,WAAuC,oBAAoB;AAC9E,QAAI,aAAa,OAAO,cAAc,YAAY,OAAQ,UAA6B,SAAS,YAAY;AAC1G,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAOA,MAAM,sBAAsB,oBAAI,IAAY;AAG5C,MAAM,oBAAuC,CAAC;AAMvC,SAAS,gBAAgB,SAA0B;AACxD,SAAO,oBAAoB,IAAI,OAAO;AACxC;AAMO,SAAS,yBAAmC;AACjD,SAAO,MAAM,KAAK,mBAAmB;AACvC;AAMO,SAAS,oBAAuC;AACrD,SAAO,CAAC,GAAG,iBAAiB;AAC9B;AAMA,IAAI,0BAAsD;AAMnD,SAAS,2BAA2B,SAAoC;AAC7E,MAAI,4BAA4B,QAAQ,QAAQ,IAAI,aAAa,eAAe;AAC9E,YAAQ,MAAM,4EAA4E;AAAA,EAC5F;AACA,4BAA0B;AAC5B;AAMO,SAAS,wBAA6C;AAC3D,SAAO,2BAA2B,CAAC;AACrC;AAyCO,SAAS,mBAGd,SAA6E;AAC7E,QAAM,EAAE,UAAU,QAAQ,SAAS,MAAM,IAAI;AAG7C,QAAM,gBAAgB,IAAI,IAAI,OAAO,IAAI,OAAK,EAAE,EAAE,CAAC;AAGnD,QAAM,aAAgC,OAAO,IAAI,QAAM;AAAA,IACrD,GAAG;AAAA,IACH,QAAQ;AAAA,EACV,EAAE;AAGF,aAAW,WAAW,eAAe;AACnC,wBAAoB,IAAI,OAAO;AAAA,EACjC;AACA,aAAW,SAAS,YAAY;AAE9B,QAAI,CAAC,kBAAkB,KAAK,OAAK,EAAE,OAAO,MAAM,EAAE,GAAG;AACnD,wBAAkB,KAAK,KAAK;AAAA,IAC9B;AAAA,EACF;AAKA,QAAM,OAAO,OACX,SACA,SACA,gBACkB;AAElB,QAAI,CAAC,cAAc,IAAI,OAAO,GAAG;AAC/B,YAAM,UACJ,oBAAoB,QAAQ,qCAAqC,OAAO;AAG1E,UAAI,QAAQ;AACV,cAAM,IAAI,MAAM,OAAO;AAAA,MACzB,OAAO;AACL,gBAAQ,MAAM,OAAO;AAAA,MAEvB;AAAA,IACF;AAGA,UAAM,WAAW,kBAAkB;AACnC,QAAI,CAAC,UAAU;AACb,cAAQ,KAAK,kDAAkD,OAAO,GAAG;AACzE;AAAA,IACF;AAEA,UAAM,SAAS,KAAK,SAAS,SAAS,WAAW;AAAA,EACnD;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,EACF;AACF;",
+  "sourcesContent": ["/**\n * Event Module Factory\n *\n * Provides factory functions for creating type-safe event configurations.\n */\n\nimport type {\n  EventDefinition,\n  EventModuleConfig,\n  EventPayload,\n  EmitOptions,\n  CreateModuleEventsOptions,\n  ModuleEventEmitter,\n} from './types'\n\n// =============================================================================\n// Global Event Bus Reference\n// =============================================================================\n\n/**\n * Type for the global event bus interface\n */\ninterface GlobalEventBus {\n  emit(event: string, payload: unknown, options?: EmitOptions): Promise<void>\n}\n\nconst GLOBAL_EVENT_BUS_KEY = '__openMercatoGlobalEventBus__'\n\n// Global event bus reference (set during bootstrap)\nlet globalEventBus: GlobalEventBus | null = null\n\n/**\n * Set the global event bus instance.\n * Called during app bootstrap to wire up event emission.\n */\nexport function setGlobalEventBus(bus: GlobalEventBus): void {\n  globalEventBus = bus\n  try {\n    ;(globalThis as Record<string, unknown>)[GLOBAL_EVENT_BUS_KEY] = bus\n  } catch {\n    // ignore global assignment failures\n  }\n}\n\n/**\n * Get the global event bus instance.\n * Returns null if not yet bootstrapped.\n */\nexport function getGlobalEventBus(): GlobalEventBus | null {\n  try {\n    const sharedBus = (globalThis as Record<string, unknown>)[GLOBAL_EVENT_BUS_KEY]\n    if (sharedBus && typeof sharedBus === 'object' && typeof (sharedBus as GlobalEventBus).emit === 'function') {\n      return sharedBus as GlobalEventBus\n    }\n  } catch {\n    // ignore global read failures\n  }\n  return globalEventBus\n}\n\n// =============================================================================\n// Event Registry for Validation\n// =============================================================================\n\n// Global set of all declared event IDs for runtime validation\nconst allDeclaredEventIds = new Set<string>()\n\n// Global registry of all declared events with their full definitions\nconst allDeclaredEvents: EventDefinition[] = []\n\n/**\n * Check if an event ID has been declared by any module.\n * Used for runtime validation to ensure only declared events are emitted.\n */\nexport function isEventDeclared(eventId: string): boolean {\n  return allDeclaredEventIds.has(eventId)\n}\n\n/**\n * Get all declared event IDs.\n * Useful for debugging and introspection.\n */\nexport function getAllDeclaredEventIds(): string[] {\n  return Array.from(allDeclaredEventIds)\n}\n\n/**\n * Get all declared events with their full definitions.\n * Used by the API to return available events for workflow triggers.\n */\nexport function getDeclaredEvents(): EventDefinition[] {\n  return [...allDeclaredEvents]\n}\n\n/**\n * Check if an event has clientBroadcast enabled.\n * Used by the SSE endpoint to filter events for the DOM Event Bridge.\n */\nexport function isBroadcastEvent(eventId: string): boolean {\n  const event = allDeclaredEvents.find(e => e.id === eventId)\n  return event?.clientBroadcast === true\n}\n\n// =============================================================================\n// Bootstrap Registration (similar to searchModuleConfigs pattern)\n// =============================================================================\n\nlet _registeredEventConfigs: EventModuleConfig[] | null = null\n\n/**\n * Register event module configurations globally.\n * Called during app bootstrap with configs from events.generated.ts.\n */\nexport function registerEventModuleConfigs(configs: EventModuleConfig[]): void {\n  if (_registeredEventConfigs !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] Event module configs re-registered (this may occur during HMR)')\n  }\n  _registeredEventConfigs = configs\n}\n\n/**\n * Get registered event module configurations.\n * Returns empty array if not registered.\n */\nexport function getEventModuleConfigs(): EventModuleConfig[] {\n  return _registeredEventConfigs ?? []\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Creates a type-safe event configuration for a module.\n *\n * Usage in module events.ts:\n * ```typescript\n * import { createModuleEvents } from '@open-mercato/shared/modules/events'\n *\n * const events = [\n *   { id: 'customers.people.created', label: 'Person Created', category: 'crud' },\n *   { id: 'customers.people.updated', label: 'Person Updated', category: 'crud' },\n * ] as const\n *\n * export const eventsConfig = createModuleEvents({\n *   moduleId: 'customers',\n *   events,\n * })\n *\n * // Export the typed emit function for use in commands\n * export const emitCustomersEvent = eventsConfig.emit\n *\n * // Export event IDs as a type for external use\n * export type CustomersEventId = typeof events[number]['id']\n *\n * export default eventsConfig\n * ```\n *\n * TypeScript will enforce that only declared event IDs can be emitted:\n * ```typescript\n * // \u2705 This compiles - event is declared\n * emitCustomersEvent('customers.people.created', { id: '123', tenantId: 'abc' })\n *\n * // \u274C TypeScript error - event not declared\n * emitCustomersEvent('customers.people.exploded', { id: '123' })\n * ```\n */\nexport function createModuleEvents<\n  const TEvents extends readonly { id: string }[],\n  TEventIds extends TEvents[number]['id'] = TEvents[number]['id']\n>(options: CreateModuleEventsOptions<TEventIds>): EventModuleConfig<TEventIds> {\n  const { moduleId, events, strict = false } = options\n\n  // Build set of valid event IDs for runtime validation\n  const validEventIds = new Set(events.map(e => e.id))\n\n  // Build full event definitions with module added\n  const fullEvents: EventDefinition[] = events.map(e => ({\n    ...e,\n    module: moduleId,\n  }))\n\n  // Register all event IDs and definitions in the global registry\n  for (const eventId of validEventIds) {\n    allDeclaredEventIds.add(eventId)\n  }\n  for (const event of fullEvents) {\n    // Avoid duplicates if createModuleEvents is called multiple times (e.g., HMR)\n    if (!allDeclaredEvents.find(e => e.id === event.id)) {\n      allDeclaredEvents.push(event)\n    }\n  }\n\n  /**\n   * The emit function - validates events and delegates to the global event bus\n   */\n  const emit = async (\n    eventId: TEventIds,\n    payload: EventPayload,\n    emitOptions?: EmitOptions\n  ): Promise<void> => {\n    // Runtime validation - event must be declared\n    if (!validEventIds.has(eventId)) {\n      const message =\n        `[events] Module \"${moduleId}\" tried to emit undeclared event \"${eventId}\". ` +\n        `Add it to the module's events.ts file first.`\n\n      if (strict) {\n        throw new Error(message)\n      } else {\n        console.error(message)\n        // In non-strict mode, still emit but with warning\n      }\n    }\n\n    // Get event bus from global reference\n    const eventBus = getGlobalEventBus()\n    if (!eventBus) {\n      console.warn(`[events] Event bus not available, cannot emit \"${eventId}\"`)\n      return\n    }\n\n    await eventBus.emit(eventId, payload, emitOptions)\n  }\n\n  return {\n    moduleId,\n    events: fullEvents,\n    emit: emit as unknown as ModuleEventEmitter<TEventIds>,\n  }\n}\n"],
+  "mappings": "AA0BA,MAAM,uBAAuB;AAG7B,IAAI,iBAAwC;AAMrC,SAAS,kBAAkB,KAA2B;AAC3D,mBAAiB;AACjB,MAAI;AACF;AAAC,IAAC,WAAuC,oBAAoB,IAAI;AAAA,EACnE,QAAQ;AAAA,EAER;AACF;AAMO,SAAS,oBAA2C;AACzD,MAAI;AACF,UAAM,YAAa,WAAuC,oBAAoB;AAC9E,QAAI,aAAa,OAAO,cAAc,YAAY,OAAQ,UAA6B,SAAS,YAAY;AAC1G,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAOA,MAAM,sBAAsB,oBAAI,IAAY;AAG5C,MAAM,oBAAuC,CAAC;AAMvC,SAAS,gBAAgB,SAA0B;AACxD,SAAO,oBAAoB,IAAI,OAAO;AACxC;AAMO,SAAS,yBAAmC;AACjD,SAAO,MAAM,KAAK,mBAAmB;AACvC;AAMO,SAAS,oBAAuC;AACrD,SAAO,CAAC,GAAG,iBAAiB;AAC9B;AAMO,SAAS,iBAAiB,SAA0B;AACzD,QAAM,QAAQ,kBAAkB,KAAK,OAAK,EAAE,OAAO,OAAO;AAC1D,SAAO,OAAO,oBAAoB;AACpC;AAMA,IAAI,0BAAsD;AAMnD,SAAS,2BAA2B,SAAoC;AAC7E,MAAI,4BAA4B,QAAQ,QAAQ,IAAI,aAAa,eAAe;AAC9E,YAAQ,MAAM,4EAA4E;AAAA,EAC5F;AACA,4BAA0B;AAC5B;AAMO,SAAS,wBAA6C;AAC3D,SAAO,2BAA2B,CAAC;AACrC;AAyCO,SAAS,mBAGd,SAA6E;AAC7E,QAAM,EAAE,UAAU,QAAQ,SAAS,MAAM,IAAI;AAG7C,QAAM,gBAAgB,IAAI,IAAI,OAAO,IAAI,OAAK,EAAE,EAAE,CAAC;AAGnD,QAAM,aAAgC,OAAO,IAAI,QAAM;AAAA,IACrD,GAAG;AAAA,IACH,QAAQ;AAAA,EACV,EAAE;AAGF,aAAW,WAAW,eAAe;AACnC,wBAAoB,IAAI,OAAO;AAAA,EACjC;AACA,aAAW,SAAS,YAAY;AAE9B,QAAI,CAAC,kBAAkB,KAAK,OAAK,EAAE,OAAO,MAAM,EAAE,GAAG;AACnD,wBAAkB,KAAK,KAAK;AAAA,IAC9B;AAAA,EACF;AAKA,QAAM,OAAO,OACX,SACA,SACA,gBACkB;AAElB,QAAI,CAAC,cAAc,IAAI,OAAO,GAAG;AAC/B,YAAM,UACJ,oBAAoB,QAAQ,qCAAqC,OAAO;AAG1E,UAAI,QAAQ;AACV,cAAM,IAAI,MAAM,OAAO;AAAA,MACzB,OAAO;AACL,gBAAQ,MAAM,OAAO;AAAA,MAEvB;AAAA,IACF;AAGA,UAAM,WAAW,kBAAkB;AACnC,QAAI,CAAC,UAAU;AACb,cAAQ,KAAK,kDAAkD,OAAO,GAAG;AACzE;AAAA,IACF;AAEA,UAAM,SAAS,KAAK,SAAS,SAAS,WAAW;AAAA,EACnD;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/modules/registry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/modules/registry.ts"],
-  "sourcesContent": ["import type { ReactNode } from 'react'\nimport type { OpenApiRouteDoc, OpenApiMethodDoc } from '@open-mercato/shared/lib/openapi/types'\nimport type { DashboardWidgetModule } from './dashboard/widgets'\nimport type { InjectionWidgetModule, ModuleInjectionTable } from './widgets/injection'\n\n// Context passed to dynamic metadata guards\nexport type RouteVisibilityContext = { path?: string; auth?: any }\n\n// Metadata you can export from page.meta.ts or directly from a server page\nexport type PageMetadata = {\n  requireAuth?: boolean\n  requireRoles?: readonly string[]\n  // Optional fine-grained feature requirements\n  requireFeatures?: readonly string[]\n  // Titles and grouping (aliases supported)\n  title?: string\n  titleKey?: string\n  pageTitle?: string\n  pageTitleKey?: string\n  group?: string\n  groupKey?: string\n  pageGroup?: string\n  pageGroupKey?: string\n  // Ordering and visuals\n  order?: number\n  pageOrder?: number\n  icon?: ReactNode\n  navHidden?: boolean\n  // Dynamic flags\n  visible?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  enabled?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  // Optional static breadcrumb trail for header\n  breadcrumb?: Array<{ label: string; labelKey?: string; href?: string }>\n  // Navigation context for tiered navigation:\n  // - 'main' (default): Main sidebar business operations\n  // - 'admin': Collapsible \"Settings & Admin\" section at bottom of sidebar\n  // - 'settings': Hidden from sidebar, only accessible via Settings hub page\n  // - 'profile': Profile dropdown items\n  pageContext?: 'main' | 'admin' | 'settings' | 'profile'\n  placement?: {\n    section: string\n    sectionLabel?: string\n    sectionLabelKey?: string\n    order?: number\n  }\n}\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'\n\nexport type ApiHandler = (req: Request, ctx?: any) => Promise<Response> | Response\n\nexport type ModuleRoute = {\n  pattern?: string\n  path?: string\n  requireAuth?: boolean\n  requireRoles?: string[]\n  // Optional fine-grained feature requirements\n  requireFeatures?: string[]\n  title?: string\n  titleKey?: string\n  group?: string\n  groupKey?: string\n  icon?: ReactNode\n  order?: number\n  priority?: number\n  navHidden?: boolean\n  visible?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  enabled?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  breadcrumb?: Array<{ label: string; labelKey?: string; href?: string }>\n  pageContext?: 'main' | 'admin' | 'settings' | 'profile'\n  placement?: {\n    section: string\n    sectionLabel?: string\n    sectionLabelKey?: string\n    order?: number\n  }\n  Component: (props: any) => ReactNode | Promise<ReactNode>\n}\n\nexport type ModuleApiLegacy = {\n  method: HttpMethod\n  path: string\n  handler: ApiHandler\n  metadata?: Record<string, unknown>\n  docs?: OpenApiMethodDoc\n}\n\nexport type ModuleApiRouteFile = {\n  path: string\n  handlers: Partial<Record<HttpMethod, ApiHandler>>\n  requireAuth?: boolean\n  requireRoles?: string[]\n  // Optional fine-grained feature requirements for the entire route file\n  // Note: per-method feature requirements should be expressed inside metadata\n  requireFeatures?: string[]\n  docs?: OpenApiRouteDoc\n  metadata?: Partial<Record<HttpMethod, unknown>>\n}\n\nexport type ModuleApi = ModuleApiLegacy | ModuleApiRouteFile\n\nexport type ModuleCli = {\n  command: string\n  run: (argv: string[]) => Promise<void> | void\n}\n\nexport type ModuleInfo = {\n  name?: string\n  title?: string\n  version?: string\n  description?: string\n  author?: string\n  license?: string\n  homepage?: string\n  copyright?: string\n  // Optional hard dependencies: module ids that must be enabled\n  requires?: string[]\n  // Whether this module can be ejected into the app's src/modules/ for customization\n  ejectable?: boolean\n}\n\nexport type ModuleDashboardWidgetEntry = {\n  moduleId: string\n  key: string\n  source: 'app' | 'package'\n  loader: () => Promise<DashboardWidgetModule<any>>\n}\n\nexport type ModuleInjectionWidgetEntry = {\n  moduleId: string\n  key: string\n  source: 'app' | 'package'\n  loader: () => Promise<InjectionWidgetModule<any, any>>\n}\n\nexport type Module = {\n  id: string\n  info?: ModuleInfo\n  backendRoutes?: ModuleRoute[]\n  frontendRoutes?: ModuleRoute[]\n  apis?: ModuleApi[]\n  cli?: ModuleCli[]\n  translations?: Record<string, Record<string, string>>\n  // Optional: per-module feature declarations discovered from acl.ts (module root)\n  features?: Array<{ id: string; title: string; module: string }>\n  // Auto-discovered event subscribers\n  subscribers?: Array<{\n    id: string\n    event: string\n    persistent?: boolean\n    // Imported function reference; will be registered into event bus\n    handler: (payload: any, ctx: any) => Promise<void> | void\n  }>\n  // Auto-discovered queue workers\n  workers?: Array<{\n    id: string\n    queue: string\n    concurrency: number\n    // Imported function reference; will be called by the queue worker\n    handler: (job: unknown, ctx: unknown) => Promise<void> | void\n  }>\n  // Optional: per-module declared entity extensions and custom fields (static)\n  // Extensions discovered from data/extensions.ts; Custom fields discovered from ce.ts (entities[].fields)\n  entityExtensions?: import('./entities').EntityExtension[]\n  customFieldSets?: import('./entities').CustomFieldSet[]\n  // Optional: per-module declared custom entities (virtual/logical entities)\n  // Discovered from ce.ts (module root). Each entry represents an entityId with optional label/description.\n  customEntities?: Array<{ id: string; label?: string; description?: string }>\n  dashboardWidgets?: ModuleDashboardWidgetEntry[]\n  injectionWidgets?: ModuleInjectionWidgetEntry[]\n  injectionTable?: ModuleInjectionTable\n  // Optional: per-module vector search configuration (discovered from vector.ts)\n  vector?: import('./vector').VectorModuleConfig\n  // Optional: module-specific tenant setup configuration (from setup.ts)\n  setup?: import('./setup').ModuleSetupConfig\n}\n\nfunction normPath(s: string) {\n  return (s.startsWith('/') ? s : '/' + s).replace(/\\/+$/, '') || '/'\n}\n\nfunction matchPattern(pattern: string, pathname: string): Record<string, string | string[]> | undefined {\n  const p = normPath(pattern)\n  const u = normPath(pathname)\n  const pSegs = p.split('/').slice(1)\n  const uSegs = u.split('/').slice(1)\n  const params: Record<string, string | string[]> = {}\n  let i = 0\n  for (let j = 0; j < pSegs.length; j++, i++) {\n    const seg = pSegs[j]\n    const mCatchAll = seg.match(/^\\[\\.\\.\\.(.+)\\]$/)\n    const mOptCatch = seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/)\n    const mDyn = seg.match(/^\\[(.+)\\]$/)\n    if (mCatchAll) {\n      const key = mCatchAll[1]\n      if (i >= uSegs.length) return undefined\n      params[key] = uSegs.slice(i)\n      i = uSegs.length\n      return i === uSegs.length ? params : undefined\n    } else if (mOptCatch) {\n      const key = mOptCatch[1]\n      params[key] = i < uSegs.length ? uSegs.slice(i) : []\n      i = uSegs.length\n      return params\n    } else if (mDyn) {\n      if (i >= uSegs.length) return undefined\n      params[mDyn[1]] = uSegs[i]\n    } else {\n      if (i >= uSegs.length || uSegs[i] !== seg) return undefined\n    }\n  }\n  if (i !== uSegs.length) return undefined\n  return params\n}\n\nfunction getPattern(r: ModuleRoute) {\n  return r.pattern ?? r.path ?? '/'\n}\n\nexport function findFrontendMatch(modules: Module[], pathname: string): { route: ModuleRoute; params: Record<string, string | string[]> } | undefined {\n  for (const m of modules) {\n    const routes = m.frontendRoutes ?? []\n    for (const r of routes) {\n      const params = matchPattern(getPattern(r), pathname)\n      if (params) return { route: r, params }\n    }\n  }\n}\n\nexport function findBackendMatch(modules: Module[], pathname: string): { route: ModuleRoute; params: Record<string, string | string[]> } | undefined {\n  for (const m of modules) {\n    const routes = m.backendRoutes ?? []\n    for (const r of routes) {\n      const params = matchPattern(getPattern(r), pathname)\n      if (params) return { route: r, params }\n    }\n  }\n}\n\nexport function findApi(modules: Module[], method: HttpMethod, pathname: string): { handler: ApiHandler; params: Record<string, string | string[]>; requireAuth?: boolean; requireRoles?: string[]; metadata?: any } | undefined {\n  for (const m of modules) {\n    const apis = m.apis ?? []\n    for (const a of apis) {\n      if ('handlers' in a) {\n        const params = matchPattern(a.path, pathname)\n        const handler = (a.handlers as any)[method]\n        if (params && handler) return { handler, params, requireAuth: a.requireAuth, requireRoles: (a as any).requireRoles, metadata: (a as any).metadata }\n      } else {\n        const al = a as ModuleApiLegacy\n        if (al.method === method && al.path === pathname) {\n          return { handler: al.handler, params: {}, metadata: al.metadata }\n        }\n      }\n    }\n  }\n}\n\n// CLI modules registry - shared between CLI and module workers\nlet _cliModules: Module[] | null = null\n\nexport function registerCliModules(modules: Module[]) {\n  if (_cliModules !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] CLI modules re-registered (this may occur during HMR)')\n  }\n  _cliModules = modules\n}\n\nexport function getCliModules(): Module[] {\n  // Return empty array if not registered - allows generate command to work without bootstrap\n  return _cliModules ?? []\n}\n\nexport function hasCliModules(): boolean {\n  return _cliModules !== null && _cliModules.length > 0\n}\n"],
+  "sourcesContent": ["import type { ReactNode } from 'react'\nimport type { OpenApiRouteDoc, OpenApiMethodDoc } from '@open-mercato/shared/lib/openapi/types'\nimport type { DashboardWidgetModule } from './dashboard/widgets'\nimport type { InjectionAnyWidgetModule, ModuleInjectionTable } from './widgets/injection'\n\n// Context passed to dynamic metadata guards\nexport type RouteVisibilityContext = { path?: string; auth?: any }\n\n// Metadata you can export from page.meta.ts or directly from a server page\nexport type PageMetadata = {\n  requireAuth?: boolean\n  requireRoles?: readonly string[]\n  // Optional fine-grained feature requirements\n  requireFeatures?: readonly string[]\n  // Titles and grouping (aliases supported)\n  title?: string\n  titleKey?: string\n  pageTitle?: string\n  pageTitleKey?: string\n  group?: string\n  groupKey?: string\n  pageGroup?: string\n  pageGroupKey?: string\n  // Ordering and visuals\n  order?: number\n  pageOrder?: number\n  icon?: ReactNode\n  navHidden?: boolean\n  // Dynamic flags\n  visible?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  enabled?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  // Optional static breadcrumb trail for header\n  breadcrumb?: Array<{ label: string; labelKey?: string; href?: string }>\n  // Navigation context for tiered navigation:\n  // - 'main' (default): Main sidebar business operations\n  // - 'admin': Collapsible \"Settings & Admin\" section at bottom of sidebar\n  // - 'settings': Hidden from sidebar, only accessible via Settings hub page\n  // - 'profile': Profile dropdown items\n  pageContext?: 'main' | 'admin' | 'settings' | 'profile'\n  placement?: {\n    section: string\n    sectionLabel?: string\n    sectionLabelKey?: string\n    order?: number\n  }\n}\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'\n\nexport type ApiHandler = (req: Request, ctx?: any) => Promise<Response> | Response\n\nexport type ModuleRoute = {\n  pattern?: string\n  path?: string\n  requireAuth?: boolean\n  requireRoles?: string[]\n  // Optional fine-grained feature requirements\n  requireFeatures?: string[]\n  title?: string\n  titleKey?: string\n  group?: string\n  groupKey?: string\n  icon?: ReactNode\n  order?: number\n  priority?: number\n  navHidden?: boolean\n  visible?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  enabled?: (ctx: RouteVisibilityContext) => boolean | Promise<boolean>\n  breadcrumb?: Array<{ label: string; labelKey?: string; href?: string }>\n  pageContext?: 'main' | 'admin' | 'settings' | 'profile'\n  placement?: {\n    section: string\n    sectionLabel?: string\n    sectionLabelKey?: string\n    order?: number\n  }\n  Component: (props: any) => ReactNode | Promise<ReactNode>\n}\n\nexport type ModuleApiLegacy = {\n  method: HttpMethod\n  path: string\n  handler: ApiHandler\n  metadata?: Record<string, unknown>\n  docs?: OpenApiMethodDoc\n}\n\nexport type ModuleApiRouteFile = {\n  path: string\n  handlers: Partial<Record<HttpMethod, ApiHandler>>\n  requireAuth?: boolean\n  requireRoles?: string[]\n  // Optional fine-grained feature requirements for the entire route file\n  // Note: per-method feature requirements should be expressed inside metadata\n  requireFeatures?: string[]\n  docs?: OpenApiRouteDoc\n  metadata?: Partial<Record<HttpMethod, unknown>>\n}\n\nexport type ModuleApi = ModuleApiLegacy | ModuleApiRouteFile\n\nexport type ModuleCli = {\n  command: string\n  run: (argv: string[]) => Promise<void> | void\n}\n\nexport type ModuleInfo = {\n  name?: string\n  title?: string\n  version?: string\n  description?: string\n  author?: string\n  license?: string\n  homepage?: string\n  copyright?: string\n  // Optional hard dependencies: module ids that must be enabled\n  requires?: string[]\n  // Whether this module can be ejected into the app's src/modules/ for customization\n  ejectable?: boolean\n}\n\nexport type ModuleDashboardWidgetEntry = {\n  moduleId: string\n  key: string\n  source: 'app' | 'package'\n  loader: () => Promise<DashboardWidgetModule<any>>\n}\n\nexport type ModuleInjectionWidgetEntry = {\n  moduleId: string\n  key: string\n  source: 'app' | 'package'\n  loader: () => Promise<InjectionAnyWidgetModule<any, any>>\n}\n\nexport type Module = {\n  id: string\n  info?: ModuleInfo\n  backendRoutes?: ModuleRoute[]\n  frontendRoutes?: ModuleRoute[]\n  apis?: ModuleApi[]\n  cli?: ModuleCli[]\n  translations?: Record<string, Record<string, string>>\n  // Optional: per-module feature declarations discovered from acl.ts (module root)\n  features?: Array<{ id: string; title: string; module: string }>\n  // Auto-discovered event subscribers\n  subscribers?: Array<{\n    id: string\n    event: string\n    persistent?: boolean\n    // Imported function reference; will be registered into event bus\n    handler: (payload: any, ctx: any) => Promise<void> | void\n  }>\n  // Auto-discovered queue workers\n  workers?: Array<{\n    id: string\n    queue: string\n    concurrency: number\n    // Imported function reference; will be called by the queue worker\n    handler: (job: unknown, ctx: unknown) => Promise<void> | void\n  }>\n  // Optional: per-module declared entity extensions and custom fields (static)\n  // Extensions discovered from data/extensions.ts; Custom fields discovered from ce.ts (entities[].fields)\n  entityExtensions?: import('./entities').EntityExtension[]\n  customFieldSets?: import('./entities').CustomFieldSet[]\n  // Optional: per-module declared custom entities (virtual/logical entities)\n  // Discovered from ce.ts (module root). Each entry represents an entityId with optional label/description.\n  customEntities?: Array<{ id: string; label?: string; description?: string }>\n  dashboardWidgets?: ModuleDashboardWidgetEntry[]\n  injectionWidgets?: ModuleInjectionWidgetEntry[]\n  injectionTable?: ModuleInjectionTable\n  // Optional: per-module vector search configuration (discovered from vector.ts)\n  vector?: import('./vector').VectorModuleConfig\n  // Optional: module-specific tenant setup configuration (from setup.ts)\n  setup?: import('./setup').ModuleSetupConfig\n}\n\nfunction normPath(s: string) {\n  return (s.startsWith('/') ? s : '/' + s).replace(/\\/+$/, '') || '/'\n}\n\nfunction matchPattern(pattern: string, pathname: string): Record<string, string | string[]> | undefined {\n  const p = normPath(pattern)\n  const u = normPath(pathname)\n  const pSegs = p.split('/').slice(1)\n  const uSegs = u.split('/').slice(1)\n  const params: Record<string, string | string[]> = {}\n  let i = 0\n  for (let j = 0; j < pSegs.length; j++, i++) {\n    const seg = pSegs[j]\n    const mCatchAll = seg.match(/^\\[\\.\\.\\.(.+)\\]$/)\n    const mOptCatch = seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/)\n    const mDyn = seg.match(/^\\[(.+)\\]$/)\n    if (mCatchAll) {\n      const key = mCatchAll[1]\n      if (i >= uSegs.length) return undefined\n      params[key] = uSegs.slice(i)\n      i = uSegs.length\n      return i === uSegs.length ? params : undefined\n    } else if (mOptCatch) {\n      const key = mOptCatch[1]\n      params[key] = i < uSegs.length ? uSegs.slice(i) : []\n      i = uSegs.length\n      return params\n    } else if (mDyn) {\n      if (i >= uSegs.length) return undefined\n      params[mDyn[1]] = uSegs[i]\n    } else {\n      if (i >= uSegs.length || uSegs[i] !== seg) return undefined\n    }\n  }\n  if (i !== uSegs.length) return undefined\n  return params\n}\n\nfunction getPattern(r: ModuleRoute) {\n  return r.pattern ?? r.path ?? '/'\n}\n\nexport function findFrontendMatch(modules: Module[], pathname: string): { route: ModuleRoute; params: Record<string, string | string[]> } | undefined {\n  for (const m of modules) {\n    const routes = m.frontendRoutes ?? []\n    for (const r of routes) {\n      const params = matchPattern(getPattern(r), pathname)\n      if (params) return { route: r, params }\n    }\n  }\n}\n\nexport function findBackendMatch(modules: Module[], pathname: string): { route: ModuleRoute; params: Record<string, string | string[]> } | undefined {\n  for (const m of modules) {\n    const routes = m.backendRoutes ?? []\n    for (const r of routes) {\n      const params = matchPattern(getPattern(r), pathname)\n      if (params) return { route: r, params }\n    }\n  }\n}\n\nexport function findApi(modules: Module[], method: HttpMethod, pathname: string): { handler: ApiHandler; params: Record<string, string | string[]>; requireAuth?: boolean; requireRoles?: string[]; metadata?: any } | undefined {\n  for (const m of modules) {\n    const apis = m.apis ?? []\n    for (const a of apis) {\n      if ('handlers' in a) {\n        const params = matchPattern(a.path, pathname)\n        const handler = (a.handlers as any)[method]\n        if (params && handler) return { handler, params, requireAuth: a.requireAuth, requireRoles: (a as any).requireRoles, metadata: (a as any).metadata }\n      } else {\n        const al = a as ModuleApiLegacy\n        if (al.method === method && al.path === pathname) {\n          return { handler: al.handler, params: {}, metadata: al.metadata }\n        }\n      }\n    }\n  }\n}\n\n// CLI modules registry - shared between CLI and module workers\nlet _cliModules: Module[] | null = null\n\nexport function registerCliModules(modules: Module[]) {\n  if (_cliModules !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] CLI modules re-registered (this may occur during HMR)')\n  }\n  _cliModules = modules\n}\n\nexport function getCliModules(): Module[] {\n  // Return empty array if not registered - allows generate command to work without bootstrap\n  return _cliModules ?? []\n}\n\nexport function hasCliModules(): boolean {\n  return _cliModules !== null && _cliModules.length > 0\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/modules/widgets/injection-loader.js

@@ -139,7 +139,20 @@ async function loadInjectionTable() {
   return injectionTablePromise;
 }
 const widgetCache = /* @__PURE__ */ new Map();
-function ensureValidWidgetModule(mod, key, moduleId) {
+function isDataWidgetModule(widget) {
+  const keys = [
+    "columns",
+    "rowActions",
+    "bulkActions",
+    "filters",
+    "fields",
+    "steps",
+    "badge",
+    "menuItems"
+  ];
+  return keys.some((key) => key in widget);
+}
+function ensureValidInjectionModule(mod, key, moduleId) {
   if (!mod || typeof mod !== "object") {
     throw new Error(`Invalid injection widget module "${key}" from "${moduleId}" (expected object export)`);
   }
@@ -147,36 +160,76 @@ function ensureValidWidgetModule(mod, key, moduleId) {
   if (!widget || typeof widget !== "object") {
     throw new Error(`Invalid injection widget export "${key}" from "${moduleId}" (missing default export)`);
   }
-  if (!widget.metadata || typeof widget.metadata !== "object") {
+  if (!("metadata" in widget) || !widget.metadata || typeof widget.metadata !== "object") {
     throw new Error(`Injection widget "${key}" from "${moduleId}" is missing metadata`);
   }
-  const { metadata } = widget;
+  const metadata = widget.metadata;
   if (typeof metadata.id !== "string" || metadata.id.length === 0) {
     throw new Error(`Injection widget "${key}" from "${moduleId}" metadata.id must be a non-empty string`);
   }
-  if (typeof metadata.title !== "string" || metadata.title.length === 0) {
-    throw new Error(`Injection widget "${metadata.id}" from "${moduleId}" must have a title`);
-  }
-  return {
+  const normalized = {
     ...widget,
     metadata
   };
+  if ("Widget" in normalized && typeof normalized.Widget === "function") {
+    if (typeof metadata.title !== "string" || metadata.title.length === 0) {
+      throw new Error(`Injection widget "${metadata.id}" from "${moduleId}" must have a title`);
+    }
+    return normalized;
+  }
+  if (!isDataWidgetModule(normalized)) {
+    throw new Error(
+      `Injection widget "${metadata.id}" from "${moduleId}" must export either Widget component or a declarative data payload`
+    );
+  }
+  return normalized;
+}
+function isLoadedInjectionWidget(module) {
+  return "Widget" in module && typeof module.Widget === "function";
+}
+function isLoadedInjectionDataWidget(module) {
+  return !isLoadedInjectionWidget(module);
 }
 async function loadEntry(entry) {
   if (!widgetCache.has(entry.key)) {
-    const promise = entry.loader().then((mod) => ensureValidWidgetModule(mod, entry.key, entry.moduleId));
+    const promise = entry.loader().then((mod) => ensureValidInjectionModule(mod, entry.key, entry.moduleId));
     widgetCache.set(entry.key, promise);
   }
   return widgetCache.get(entry.key);
 }
+async function getResolvedEntriesForSpot(spotId) {
+  const table = await loadInjectionTable();
+  const exactEntries = table.get(spotId) ?? [];
+  const wildcardEntries = [];
+  for (const [candidateSpotId, candidateEntries] of table.entries()) {
+    if (candidateSpotId === spotId) continue;
+    if (!candidateSpotId.includes("*")) continue;
+    const pattern = new RegExp(`^${candidateSpotId.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*")}$`);
+    if (!pattern.test(spotId)) continue;
+    wildcardEntries.push(...candidateEntries);
+  }
+  const dedupedEntries = /* @__PURE__ */ new Map();
+  for (const entry of [...exactEntries, ...wildcardEntries]) {
+    const cacheKey = `${entry.moduleId}:${entry.widgetId}`;
+    const previous = dedupedEntries.get(cacheKey);
+    if (!previous || (entry.priority ?? 0) > (previous.priority ?? 0)) {
+      dedupedEntries.set(cacheKey, entry);
+    }
+  }
+  return Array.from(dedupedEntries.values()).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+}
 async function loadAllInjectionWidgets() {
   const widgetEntries = await loadWidgetEntries();
-  const loaded = await Promise.all(widgetEntries.map(async (entry) => {
-    const widget = await loadEntry(entry);
-    return { ...widget, moduleId: entry.moduleId, key: entry.key };
-  }));
+  const loaded = await Promise.all(
+    widgetEntries.map(async (entry) => {
+      const module = await loadEntry(entry);
+      if (!isLoadedInjectionWidget(module)) return null;
+      return { ...module, moduleId: entry.moduleId, key: entry.key };
+    })
+  );
   const byId = /* @__PURE__ */ new Map();
   for (const widget of loaded) {
+    if (!widget) continue;
     if (!byId.has(widget.metadata.id)) {
       byId.set(widget.metadata.id, widget);
     }
@@ -186,47 +239,54 @@ async function loadAllInjectionWidgets() {
 async function loadInjectionWidgetById(widgetId) {
   const widgetEntries = await loadWidgetEntries();
   for (const entry of widgetEntries) {
-    const widget = await loadEntry(entry);
-    if (widget.metadata.id === widgetId) {
-      return { ...widget, moduleId: entry.moduleId, key: entry.key };
+    const module = await loadEntry(entry);
+    if (!isLoadedInjectionWidget(module)) continue;
+    if (module.metadata.id === widgetId) {
+      return { ...module, moduleId: entry.moduleId, key: entry.key };
+    }
+  }
+  return null;
+}
+async function loadInjectionDataWidgetById(widgetId) {
+  const widgetEntries = await loadWidgetEntries();
+  for (const entry of widgetEntries) {
+    const module = await loadEntry(entry);
+    if (!isLoadedInjectionDataWidget(module)) continue;
+    if (module.metadata.id === widgetId) {
+      return { ...module, moduleId: entry.moduleId, key: entry.key };
     }
   }
   return null;
 }
 async function loadInjectionWidgetsForSpot(spotId) {
-  const table = await loadInjectionTable();
-  const exactEntries = table.get(spotId) ?? [];
-  const wildcardEntries = [];
-  for (const [candidateSpotId, candidateEntries] of table.entries()) {
-    if (candidateSpotId === spotId) continue;
-    if (!candidateSpotId.includes("*")) continue;
-    const pattern = new RegExp(`^${candidateSpotId.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*")}$`);
-    if (!pattern.test(spotId)) continue;
-    wildcardEntries.push(...candidateEntries);
+  const entries = await getResolvedEntriesForSpot(spotId);
+  const widgets = [];
+  for (const { widgetId, placement, priority } of entries) {
+    const widget = await loadInjectionWidgetById(widgetId);
+    if (!widget) continue;
+    const combinedPlacement = placement ? { ...placement, priority: typeof priority === "number" ? priority : 0 } : { priority: typeof priority === "number" ? priority : 0 };
+    widgets.push({ ...widget, placement: combinedPlacement });
   }
-  const dedupedEntries = /* @__PURE__ */ new Map();
-  for (const entry of [...exactEntries, ...wildcardEntries]) {
-    const key = `${entry.moduleId}:${entry.widgetId}`;
-    const previous = dedupedEntries.get(key);
-    if (!previous || (entry.priority ?? 0) > (previous.priority ?? 0)) {
-      dedupedEntries.set(key, entry);
-    }
+  return widgets;
+}
+async function loadInjectionDataWidgetsForSpot(spotId) {
+  const entries = await getResolvedEntriesForSpot(spotId);
+  const widgets = [];
+  for (const { widgetId, placement, priority } of entries) {
+    const widget = await loadInjectionDataWidgetById(widgetId);
+    if (!widget) continue;
+    const combinedPlacement = placement ? { ...placement, priority: typeof priority === "number" ? priority : 0 } : { priority: typeof priority === "number" ? priority : 0 };
+    widgets.push({ ...widget, placement: combinedPlacement });
   }
-  const entries = Array.from(dedupedEntries.values()).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
-  const widgets = await Promise.all(
-    entries.map(async ({ widgetId, placement, priority }) => {
-      const widget = await loadInjectionWidgetById(widgetId);
-      const combinedPlacement = placement ? { ...placement, priority: typeof priority === "number" ? priority : 0 } : { priority: typeof priority === "number" ? priority : 0 };
-      return widget ? { ...widget, placement: combinedPlacement } : null;
-    })
-  );
-  return widgets.filter((w) => w !== null);
+  return widgets;
 }
 export {
   getCoreInjectionTables,
   getCoreInjectionWidgets,
   invalidateInjectionWidgetCache,
   loadAllInjectionWidgets,
+  loadInjectionDataWidgetById,
+  loadInjectionDataWidgetsForSpot,
   loadInjectionWidgetById,
   loadInjectionWidgetsForSpot,
   registerCoreInjectionTables,

package/dist/modules/widgets/injection-loader.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/widgets/injection-loader.ts"],
-  "sourcesContent": ["import type { ModuleInjectionWidgetEntry } from '../registry'\nimport type {\n  InjectionWidgetMetadata,\n  InjectionWidgetModule,\n  InjectionSpotId,\n  ModuleInjectionSlot,\n  ModuleInjectionTable,\n  InjectionWidgetPlacement,\n} from './injection'\n\ntype LoadedWidgetModule = InjectionWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }\nexport type LoadedInjectionWidget = LoadedWidgetModule & {\n  moduleId: string\n  key: string\n  placement?: {\n    groupId?: string\n    groupLabel?: string\n    groupDescription?: string\n    column?: 1 | 2\n    kind?: 'tab' | 'group' | 'stack'\n    [k: string]: unknown\n  }\n}\n\ntype WidgetEntry = ModuleInjectionWidgetEntry & { moduleId: string }\n\n// Registration pattern for publishable packages\nlet _coreInjectionWidgetEntries: ModuleInjectionWidgetEntry[] | null = null\nlet _coreInjectionTables: Array<{ moduleId: string; table: ModuleInjectionTable }> | null = null\nconst GLOBAL_INJECTION_WIDGETS_KEY = '__openMercatoCoreInjectionWidgetEntries__'\nconst GLOBAL_INJECTION_TABLES_KEY = '__openMercatoCoreInjectionTables__'\n\nfunction readGlobalInjectionWidgets(): ModuleInjectionWidgetEntry[] | null {\n  try {\n    const value = (globalThis as Record<string, unknown>)[GLOBAL_INJECTION_WIDGETS_KEY]\n    return Array.isArray(value) ? (value as ModuleInjectionWidgetEntry[]) : null\n  } catch {\n    return null\n  }\n}\n\nfunction writeGlobalInjectionWidgets(entries: ModuleInjectionWidgetEntry[]) {\n  try {\n    ;(globalThis as Record<string, unknown>)[GLOBAL_INJECTION_WIDGETS_KEY] = entries\n  } catch {\n    // ignore global assignment failures\n  }\n}\n\nfunction readGlobalInjectionTables(): Array<{ moduleId: string; table: ModuleInjectionTable }> | null {\n  try {\n    const value = (globalThis as Record<string, unknown>)[GLOBAL_INJECTION_TABLES_KEY]\n    return Array.isArray(value) ? (value as Array<{ moduleId: string; table: ModuleInjectionTable }>) : null\n  } catch {\n    return null\n  }\n}\n\nfunction writeGlobalInjectionTables(tables: Array<{ moduleId: string; table: ModuleInjectionTable }>) {\n  try {\n    ;(globalThis as Record<string, unknown>)[GLOBAL_INJECTION_TABLES_KEY] = tables\n  } catch {\n    // ignore global assignment failures\n  }\n}\n\nexport function registerCoreInjectionWidgets(entries: ModuleInjectionWidgetEntry[]) {\n  if (_coreInjectionWidgetEntries !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] Core injection widgets re-registered (this may occur during HMR)')\n  }\n  _coreInjectionWidgetEntries = entries\n  writeGlobalInjectionWidgets(entries)\n}\n\nexport function getCoreInjectionWidgets(): ModuleInjectionWidgetEntry[] {\n  const globalEntries = readGlobalInjectionWidgets()\n  if (globalEntries) return globalEntries\n  if (!_coreInjectionWidgetEntries) {\n    // On client-side, bootstrap doesn't run - return empty array gracefully\n    if (typeof window !== 'undefined') {\n      return []\n    }\n    throw new Error('[Bootstrap] Core injection widgets not registered. Call registerCoreInjectionWidgets() at bootstrap.')\n  }\n  return _coreInjectionWidgetEntries\n}\n\nexport function registerCoreInjectionTables(tables: Array<{ moduleId: string; table: ModuleInjectionTable }>) {\n  if (_coreInjectionTables !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] Core injection tables re-registered (this may occur during HMR)')\n  }\n  _coreInjectionTables = tables\n  writeGlobalInjectionTables(tables)\n}\n\nexport function getCoreInjectionTables(): Array<{ moduleId: string; table: ModuleInjectionTable }> {\n  const globalTables = readGlobalInjectionTables()\n  if (globalTables) return globalTables\n  if (!_coreInjectionTables) {\n    // On client-side, bootstrap doesn't run - return empty array gracefully\n    if (typeof window !== 'undefined') {\n      return []\n    }\n    throw new Error('[Bootstrap] Core injection tables not registered. Call registerCoreInjectionTables() at bootstrap.')\n  }\n  return _coreInjectionTables\n}\n\nlet widgetEntriesPromise: Promise<WidgetEntry[]> | null = null\ntype TableEntry = {\n  widgetId: string\n  moduleId: string\n  priority: number\n  placement?: ModuleInjectionSlot extends infer S\n    ? S extends { widgetId: string }\n      ? Omit<S, 'widgetId' | 'priority'>\n      : never\n    : never\n}\nlet injectionTablePromise: Promise<Map<InjectionSpotId, TableEntry[]>> | null = null\n\nfunction isInjectionSlotObject(value: ModuleInjectionSlot): value is InjectionWidgetPlacement & { widgetId: string; priority?: number } {\n  return typeof value === 'object' && value !== null && 'widgetId' in value\n}\n\n/**\n * Invalidate the widget entries and widget module cache.\n * Call this when the generated registry is updated or modules are reloaded.\n */\nexport function invalidateInjectionWidgetCache() {\n  widgetEntriesPromise = null\n  injectionTablePromise = null\n  widgetCache.clear()\n}\n\nasync function loadWidgetEntries(): Promise<WidgetEntry[]> {\n  if (!widgetEntriesPromise) {\n    const promise = Promise.resolve().then(() =>\n      getCoreInjectionWidgets().map((entry) => ({\n        ...entry,\n        moduleId: entry.moduleId || 'unknown',\n      }))\n    )\n    widgetEntriesPromise = promise.catch((err) => {\n      // Clear cache on error so next call can retry after registration\n      if (widgetEntriesPromise === promise) {\n        widgetEntriesPromise = null\n      }\n      throw err\n    })\n  }\n  return widgetEntriesPromise\n}\n\nasync function loadInjectionTable(): Promise<Map<InjectionSpotId, TableEntry[]>> {\n  if (!injectionTablePromise) {\n    const promise = Promise.resolve().then(() => {\n      const list = getCoreInjectionTables()\n      const table = new Map<InjectionSpotId, TableEntry[]>()\n\n      for (const entry of list) {\n        const injectionTable = entry.table ?? {}\n        for (const [spotId, widgetIds] of Object.entries(injectionTable)) {\n          const widgets = Array.isArray(widgetIds) ? widgetIds : [widgetIds]\n          const existing = table.get(spotId) ?? []\n          for (const widgetEntry of widgets) {\n            if (typeof widgetEntry === 'string') {\n              existing.push({ widgetId: widgetEntry, moduleId: entry.moduleId, priority: 0 })\n              continue\n            }\n            if (isInjectionSlotObject(widgetEntry)) {\n              const { widgetId, priority = 0, ...placement } = widgetEntry\n              existing.push({\n                widgetId,\n                moduleId: entry.moduleId,\n                priority: typeof priority === 'number' ? priority : 0,\n                placement,\n              })\n              continue\n            }\n          }\n          table.set(spotId, existing)\n        }\n      }\n\n      for (const [spotId, widgets] of table.entries()) {\n        table.set(spotId, widgets.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0)))\n      }\n\n      return table\n    })\n    injectionTablePromise = promise.catch((err) => {\n      // Clear cache on error so next call can retry after registration\n      if (injectionTablePromise === promise) {\n        injectionTablePromise = null\n      }\n      throw err\n    })\n  }\n  return injectionTablePromise\n}\n\nconst widgetCache = new Map<string, Promise<LoadedWidgetModule>>()\n\nfunction ensureValidWidgetModule(mod: any, key: string, moduleId: string): LoadedWidgetModule {\n  if (!mod || typeof mod !== 'object') {\n    throw new Error(`Invalid injection widget module \"${key}\" from \"${moduleId}\" (expected object export)`)\n  }\n  const widget = (mod.default ?? mod) as InjectionWidgetModule<any, any>\n  if (!widget || typeof widget !== 'object') {\n    throw new Error(`Invalid injection widget export \"${key}\" from \"${moduleId}\" (missing default export)`)\n  }\n  if (!widget.metadata || typeof widget.metadata !== 'object') {\n    throw new Error(`Injection widget \"${key}\" from \"${moduleId}\" is missing metadata`)\n  }\n  const { metadata } = widget\n  if (typeof metadata.id !== 'string' || metadata.id.length === 0) {\n    throw new Error(`Injection widget \"${key}\" from \"${moduleId}\" metadata.id must be a non-empty string`)\n  }\n  if (typeof metadata.title !== 'string' || metadata.title.length === 0) {\n    throw new Error(`Injection widget \"${metadata.id}\" from \"${moduleId}\" must have a title`)\n  }\n  return {\n    ...widget,\n    metadata,\n  }\n}\n\nasync function loadEntry(entry: WidgetEntry): Promise<LoadedWidgetModule> {\n  if (!widgetCache.has(entry.key)) {\n    const promise = entry.loader()\n      .then((mod) => ensureValidWidgetModule(mod, entry.key, entry.moduleId))\n    widgetCache.set(entry.key, promise)\n  }\n  return widgetCache.get(entry.key)!\n}\n\nexport async function loadAllInjectionWidgets(): Promise<LoadedInjectionWidget[]> {\n  const widgetEntries = await loadWidgetEntries()\n  const loaded = await Promise.all(widgetEntries.map(async (entry) => {\n    const widget = await loadEntry(entry)\n    return { ...widget, moduleId: entry.moduleId, key: entry.key }\n  }))\n  const byId = new Map<string, LoadedWidgetModule & { moduleId: string; key: string }>()\n  for (const widget of loaded) {\n    if (!byId.has(widget.metadata.id)) {\n      byId.set(widget.metadata.id, widget)\n    }\n  }\n  return Array.from(byId.values())\n}\n\nexport async function loadInjectionWidgetById(widgetId: string): Promise<LoadedInjectionWidget | null> {\n  const widgetEntries = await loadWidgetEntries()\n  for (const entry of widgetEntries) {\n    const widget = await loadEntry(entry)\n    if (widget.metadata.id === widgetId) {\n      return { ...widget, moduleId: entry.moduleId, key: entry.key }\n    }\n  }\n  return null\n}\n\nexport async function loadInjectionWidgetsForSpot(spotId: InjectionSpotId): Promise<LoadedInjectionWidget[]> {\n  const table = await loadInjectionTable()\n  const exactEntries = table.get(spotId) ?? []\n  const wildcardEntries: TableEntry[] = []\n  for (const [candidateSpotId, candidateEntries] of table.entries()) {\n    if (candidateSpotId === spotId) continue\n    if (!candidateSpotId.includes('*')) continue\n    const pattern = new RegExp(`^${candidateSpotId.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&').replace(/\\*/g, '.*')}$`)\n    if (!pattern.test(spotId)) continue\n    wildcardEntries.push(...candidateEntries)\n  }\n  const dedupedEntries = new Map<string, TableEntry>()\n  for (const entry of [...exactEntries, ...wildcardEntries]) {\n    const key = `${entry.moduleId}:${entry.widgetId}`\n    const previous = dedupedEntries.get(key)\n    if (!previous || (entry.priority ?? 0) > (previous.priority ?? 0)) {\n      dedupedEntries.set(key, entry)\n    }\n  }\n  const entries = Array.from(dedupedEntries.values()).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0))\n  const widgets = await Promise.all(\n    entries.map(async ({ widgetId, placement, priority }) => {\n      const widget = await loadInjectionWidgetById(widgetId)\n      const combinedPlacement = placement\n        ? { ...placement, priority: typeof priority === 'number' ? priority : 0 }\n        : { priority: typeof priority === 'number' ? priority : 0 }\n      return widget ? { ...widget, placement: combinedPlacement } : null\n    })\n  )\n  return widgets.filter((w): w is NonNullable<typeof w> => w !== null)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { ModuleInjectionWidgetEntry } from '../registry'\nimport type {\n  InjectionAnyWidgetModule,\n  InjectionDataWidgetModule,\n  InjectionWidgetMetadata,\n  InjectionWidgetModule,\n  InjectionSpotId,\n  ModuleInjectionSlot,\n  ModuleInjectionTable,\n  InjectionWidgetPlacement,\n} from './injection'\n\ntype LoadedWidgetModule = InjectionWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }\ntype LoadedDataWidgetModule = InjectionDataWidgetModule & { metadata: InjectionWidgetMetadata }\n\nexport type LoadedInjectionWidget = LoadedWidgetModule & {\n  moduleId: string\n  key: string\n  placement?: {\n    groupId?: string\n    groupLabel?: string\n    groupDescription?: string\n    column?: 1 | 2\n    kind?: 'tab' | 'group' | 'stack'\n    [k: string]: unknown\n  }\n}\n\nexport type LoadedInjectionDataWidget = LoadedDataWidgetModule & {\n  moduleId: string\n  key: string\n  placement?: {\n    groupId?: string\n    groupLabel?: string\n    groupDescription?: string\n    column?: 1 | 2\n    kind?: 'tab' | 'group' | 'stack'\n    [k: string]: unknown\n  }\n}\n\ntype WidgetEntry = ModuleInjectionWidgetEntry & { moduleId: string }\n\n// Registration pattern for publishable packages\nlet _coreInjectionWidgetEntries: ModuleInjectionWidgetEntry[] | null = null\nlet _coreInjectionTables: Array<{ moduleId: string; table: ModuleInjectionTable }> | null = null\nconst GLOBAL_INJECTION_WIDGETS_KEY = '__openMercatoCoreInjectionWidgetEntries__'\nconst GLOBAL_INJECTION_TABLES_KEY = '__openMercatoCoreInjectionTables__'\n\nfunction readGlobalInjectionWidgets(): ModuleInjectionWidgetEntry[] | null {\n  try {\n    const value = (globalThis as Record<string, unknown>)[GLOBAL_INJECTION_WIDGETS_KEY]\n    return Array.isArray(value) ? (value as ModuleInjectionWidgetEntry[]) : null\n  } catch {\n    return null\n  }\n}\n\nfunction writeGlobalInjectionWidgets(entries: ModuleInjectionWidgetEntry[]) {\n  try {\n    ;(globalThis as Record<string, unknown>)[GLOBAL_INJECTION_WIDGETS_KEY] = entries\n  } catch {\n    // ignore global assignment failures\n  }\n}\n\nfunction readGlobalInjectionTables(): Array<{ moduleId: string; table: ModuleInjectionTable }> | null {\n  try {\n    const value = (globalThis as Record<string, unknown>)[GLOBAL_INJECTION_TABLES_KEY]\n    return Array.isArray(value) ? (value as Array<{ moduleId: string; table: ModuleInjectionTable }>) : null\n  } catch {\n    return null\n  }\n}\n\nfunction writeGlobalInjectionTables(tables: Array<{ moduleId: string; table: ModuleInjectionTable }>) {\n  try {\n    ;(globalThis as Record<string, unknown>)[GLOBAL_INJECTION_TABLES_KEY] = tables\n  } catch {\n    // ignore global assignment failures\n  }\n}\n\nexport function registerCoreInjectionWidgets(entries: ModuleInjectionWidgetEntry[]) {\n  if (_coreInjectionWidgetEntries !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] Core injection widgets re-registered (this may occur during HMR)')\n  }\n  _coreInjectionWidgetEntries = entries\n  writeGlobalInjectionWidgets(entries)\n}\n\nexport function getCoreInjectionWidgets(): ModuleInjectionWidgetEntry[] {\n  const globalEntries = readGlobalInjectionWidgets()\n  if (globalEntries) return globalEntries\n  if (!_coreInjectionWidgetEntries) {\n    // On client-side, bootstrap doesn't run - return empty array gracefully\n    if (typeof window !== 'undefined') {\n      return []\n    }\n    throw new Error('[Bootstrap] Core injection widgets not registered. Call registerCoreInjectionWidgets() at bootstrap.')\n  }\n  return _coreInjectionWidgetEntries\n}\n\nexport function registerCoreInjectionTables(tables: Array<{ moduleId: string; table: ModuleInjectionTable }>) {\n  if (_coreInjectionTables !== null && process.env.NODE_ENV === 'development') {\n    console.debug('[Bootstrap] Core injection tables re-registered (this may occur during HMR)')\n  }\n  _coreInjectionTables = tables\n  writeGlobalInjectionTables(tables)\n}\n\nexport function getCoreInjectionTables(): Array<{ moduleId: string; table: ModuleInjectionTable }> {\n  const globalTables = readGlobalInjectionTables()\n  if (globalTables) return globalTables\n  if (!_coreInjectionTables) {\n    // On client-side, bootstrap doesn't run - return empty array gracefully\n    if (typeof window !== 'undefined') {\n      return []\n    }\n    throw new Error('[Bootstrap] Core injection tables not registered. Call registerCoreInjectionTables() at bootstrap.')\n  }\n  return _coreInjectionTables\n}\n\nlet widgetEntriesPromise: Promise<WidgetEntry[]> | null = null\ntype TableEntry = {\n  widgetId: string\n  moduleId: string\n  priority: number\n  placement?: ModuleInjectionSlot extends infer S\n    ? S extends { widgetId: string }\n      ? Omit<S, 'widgetId' | 'priority'>\n      : never\n    : never\n}\nlet injectionTablePromise: Promise<Map<InjectionSpotId, TableEntry[]>> | null = null\n\nfunction isInjectionSlotObject(value: ModuleInjectionSlot): value is InjectionWidgetPlacement & { widgetId: string; priority?: number } {\n  return typeof value === 'object' && value !== null && 'widgetId' in value\n}\n\n/**\n * Invalidate the widget entries and widget module cache.\n * Call this when the generated registry is updated or modules are reloaded.\n */\nexport function invalidateInjectionWidgetCache() {\n  widgetEntriesPromise = null\n  injectionTablePromise = null\n  widgetCache.clear()\n}\n\nasync function loadWidgetEntries(): Promise<WidgetEntry[]> {\n  if (!widgetEntriesPromise) {\n    const promise = Promise.resolve().then(() =>\n      getCoreInjectionWidgets().map((entry) => ({\n        ...entry,\n        moduleId: entry.moduleId || 'unknown',\n      }))\n    )\n    widgetEntriesPromise = promise.catch((err) => {\n      if (widgetEntriesPromise === promise) {\n        widgetEntriesPromise = null\n      }\n      throw err\n    })\n  }\n  return widgetEntriesPromise\n}\n\nasync function loadInjectionTable(): Promise<Map<InjectionSpotId, TableEntry[]>> {\n  if (!injectionTablePromise) {\n    const promise = Promise.resolve().then(() => {\n      const list = getCoreInjectionTables()\n      const table = new Map<InjectionSpotId, TableEntry[]>()\n\n      for (const entry of list) {\n        const injectionTable = entry.table ?? {}\n        for (const [spotId, widgetIds] of Object.entries(injectionTable)) {\n          const widgets = Array.isArray(widgetIds) ? widgetIds : [widgetIds]\n          const existing = table.get(spotId) ?? []\n          for (const widgetEntry of widgets) {\n            if (typeof widgetEntry === 'string') {\n              existing.push({ widgetId: widgetEntry, moduleId: entry.moduleId, priority: 0 })\n              continue\n            }\n            if (isInjectionSlotObject(widgetEntry)) {\n              const { widgetId, priority = 0, ...placement } = widgetEntry\n              existing.push({\n                widgetId,\n                moduleId: entry.moduleId,\n                priority: typeof priority === 'number' ? priority : 0,\n                placement,\n              })\n              continue\n            }\n          }\n          table.set(spotId, existing)\n        }\n      }\n\n      for (const [spotId, widgets] of table.entries()) {\n        table.set(spotId, widgets.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0)))\n      }\n\n      return table\n    })\n    injectionTablePromise = promise.catch((err) => {\n      if (injectionTablePromise === promise) {\n        injectionTablePromise = null\n      }\n      throw err\n    })\n  }\n  return injectionTablePromise\n}\n\nconst widgetCache = new Map<string, Promise<InjectionAnyWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }>>()\n\nfunction isDataWidgetModule(widget: Record<string, unknown>): widget is LoadedDataWidgetModule {\n  const keys = [\n    'columns',\n    'rowActions',\n    'bulkActions',\n    'filters',\n    'fields',\n    'steps',\n    'badge',\n    'menuItems',\n  ]\n  return keys.some((key) => key in widget)\n}\n\nfunction ensureValidInjectionModule(mod: unknown, key: string, moduleId: string): (InjectionAnyWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }) {\n  if (!mod || typeof mod !== 'object') {\n    throw new Error(`Invalid injection widget module \"${key}\" from \"${moduleId}\" (expected object export)`)\n  }\n  const widget = (mod as { default?: InjectionAnyWidgetModule<any, any> }).default ?? (mod as InjectionAnyWidgetModule<any, any>)\n  if (!widget || typeof widget !== 'object') {\n    throw new Error(`Invalid injection widget export \"${key}\" from \"${moduleId}\" (missing default export)`) \n  }\n  if (!('metadata' in widget) || !widget.metadata || typeof widget.metadata !== 'object') {\n    throw new Error(`Injection widget \"${key}\" from \"${moduleId}\" is missing metadata`)\n  }\n  const metadata = widget.metadata\n  if (typeof metadata.id !== 'string' || metadata.id.length === 0) {\n    throw new Error(`Injection widget \"${key}\" from \"${moduleId}\" metadata.id must be a non-empty string`)\n  }\n  const normalized = {\n    ...widget,\n    metadata,\n  }\n\n  if ('Widget' in normalized && typeof normalized.Widget === 'function') {\n    if (typeof metadata.title !== 'string' || metadata.title.length === 0) {\n      throw new Error(`Injection widget \"${metadata.id}\" from \"${moduleId}\" must have a title`)\n    }\n    return normalized\n  }\n\n  if (!isDataWidgetModule(normalized as Record<string, unknown>)) {\n    throw new Error(\n      `Injection widget \"${metadata.id}\" from \"${moduleId}\" must export either Widget component or a declarative data payload`\n    )\n  }\n\n  return normalized\n}\n\nfunction isLoadedInjectionWidget(\n  module: InjectionAnyWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }\n): module is LoadedWidgetModule {\n  return 'Widget' in module && typeof module.Widget === 'function'\n}\n\nfunction isLoadedInjectionDataWidget(\n  module: InjectionAnyWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }\n): module is LoadedDataWidgetModule {\n  return !isLoadedInjectionWidget(module)\n}\n\nasync function loadEntry(entry: WidgetEntry): Promise<InjectionAnyWidgetModule<any, any> & { metadata: InjectionWidgetMetadata }> {\n  if (!widgetCache.has(entry.key)) {\n    const promise = entry.loader().then((mod) => ensureValidInjectionModule(mod, entry.key, entry.moduleId))\n    widgetCache.set(entry.key, promise)\n  }\n  return widgetCache.get(entry.key)!\n}\n\nasync function getResolvedEntriesForSpot(spotId: InjectionSpotId): Promise<TableEntry[]> {\n  const table = await loadInjectionTable()\n  const exactEntries = table.get(spotId) ?? []\n  const wildcardEntries: TableEntry[] = []\n\n  for (const [candidateSpotId, candidateEntries] of table.entries()) {\n    if (candidateSpotId === spotId) continue\n    if (!candidateSpotId.includes('*')) continue\n    const pattern = new RegExp(`^${candidateSpotId.replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&').replace(/\\*/g, '.*')}$`)\n    if (!pattern.test(spotId)) continue\n    wildcardEntries.push(...candidateEntries)\n  }\n\n  const dedupedEntries = new Map<string, TableEntry>()\n  for (const entry of [...exactEntries, ...wildcardEntries]) {\n    const cacheKey = `${entry.moduleId}:${entry.widgetId}`\n    const previous = dedupedEntries.get(cacheKey)\n    if (!previous || (entry.priority ?? 0) > (previous.priority ?? 0)) {\n      dedupedEntries.set(cacheKey, entry)\n    }\n  }\n\n  return Array.from(dedupedEntries.values()).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0))\n}\n\nexport async function loadAllInjectionWidgets(): Promise<LoadedInjectionWidget[]> {\n  const widgetEntries = await loadWidgetEntries()\n  const loaded = await Promise.all(\n    widgetEntries.map(async (entry) => {\n      const module = await loadEntry(entry)\n      if (!isLoadedInjectionWidget(module)) return null\n      return { ...module, moduleId: entry.moduleId, key: entry.key }\n    })\n  )\n  const byId = new Map<string, LoadedInjectionWidget>()\n  for (const widget of loaded) {\n    if (!widget) continue\n    if (!byId.has(widget.metadata.id)) {\n      byId.set(widget.metadata.id, widget)\n    }\n  }\n  return Array.from(byId.values())\n}\n\nexport async function loadInjectionWidgetById(widgetId: string): Promise<LoadedInjectionWidget | null> {\n  const widgetEntries = await loadWidgetEntries()\n  for (const entry of widgetEntries) {\n    const module = await loadEntry(entry)\n    if (!isLoadedInjectionWidget(module)) continue\n    if (module.metadata.id === widgetId) {\n      return { ...module, moduleId: entry.moduleId, key: entry.key }\n    }\n  }\n  return null\n}\n\nexport async function loadInjectionDataWidgetById(widgetId: string): Promise<LoadedInjectionDataWidget | null> {\n  const widgetEntries = await loadWidgetEntries()\n  for (const entry of widgetEntries) {\n    const module = await loadEntry(entry)\n    if (!isLoadedInjectionDataWidget(module)) continue\n    if (module.metadata.id === widgetId) {\n      return { ...module, moduleId: entry.moduleId, key: entry.key }\n    }\n  }\n  return null\n}\n\nexport async function loadInjectionWidgetsForSpot(spotId: InjectionSpotId): Promise<LoadedInjectionWidget[]> {\n  const entries = await getResolvedEntriesForSpot(spotId)\n  const widgets: LoadedInjectionWidget[] = []\n  for (const { widgetId, placement, priority } of entries) {\n    const widget = await loadInjectionWidgetById(widgetId)\n    if (!widget) continue\n    const combinedPlacement = placement\n      ? { ...placement, priority: typeof priority === 'number' ? priority : 0 }\n      : { priority: typeof priority === 'number' ? priority : 0 }\n    widgets.push({ ...widget, placement: combinedPlacement })\n  }\n  return widgets\n}\n\nexport async function loadInjectionDataWidgetsForSpot(spotId: InjectionSpotId): Promise<LoadedInjectionDataWidget[]> {\n  const entries = await getResolvedEntriesForSpot(spotId)\n  const widgets: LoadedInjectionDataWidget[] = []\n  for (const { widgetId, placement, priority } of entries) {\n    const widget = await loadInjectionDataWidgetById(widgetId)\n    if (!widget) continue\n    const combinedPlacement = placement\n      ? { ...placement, priority: typeof priority === 'number' ? priority : 0 }\n      : { priority: typeof priority === 'number' ? priority : 0 }\n    widgets.push({ ...widget, placement: combinedPlacement })\n  }\n  return widgets\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/widgets/injection-position.js

@@ -0,0 +1,48 @@
+var InjectionPosition = /* @__PURE__ */ ((InjectionPosition2) => {
+  InjectionPosition2["Before"] = "before";
+  InjectionPosition2["After"] = "after";
+  InjectionPosition2["First"] = "first";
+  InjectionPosition2["Last"] = "last";
+  return InjectionPosition2;
+})(InjectionPosition || {});
+function getInjectionPosition(placement) {
+  if (!placement?.position) return "last" /* Last */;
+  return placement.position;
+}
+function warnInvalidRelativeTo(relativeTo) {
+  if (process.env.NODE_ENV !== "development") return;
+  if (!relativeTo) return;
+  console.warn(`[InjectionPlacement] relativeTo target "${relativeTo}" not found, appending item at the end.`);
+}
+function insertByInjectionPlacement(items, item, placement, getItemId) {
+  const current = [...items];
+  const position = getInjectionPosition(placement);
+  if (position === "first" /* First */) {
+    current.unshift(item);
+    return current;
+  }
+  if (position === "last" /* Last */) {
+    current.push(item);
+    return current;
+  }
+  const relativeTo = placement?.relativeTo;
+  if (!relativeTo) {
+    current.push(item);
+    return current;
+  }
+  const targetIndex = current.findIndex((value) => getItemId(value) === relativeTo);
+  if (targetIndex < 0) {
+    warnInvalidRelativeTo(relativeTo);
+    current.push(item);
+    return current;
+  }
+  const insertIndex = position === "before" /* Before */ ? targetIndex : targetIndex + 1;
+  current.splice(insertIndex, 0, item);
+  return current;
+}
+export {
+  InjectionPosition,
+  getInjectionPosition,
+  insertByInjectionPlacement
+};
+//# sourceMappingURL=injection-position.js.map

package/dist/modules/widgets/injection-position.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/widgets/injection-position.ts"],
+  "sourcesContent": ["export enum InjectionPosition {\n  Before = 'before',\n  After = 'after',\n  First = 'first',\n  Last = 'last',\n}\n\nexport type InjectionPlacement = {\n  position?: InjectionPosition\n  relativeTo?: string\n}\n\nexport function getInjectionPosition(placement?: InjectionPlacement): InjectionPosition {\n  if (!placement?.position) return InjectionPosition.Last\n  return placement.position\n}\n\nfunction warnInvalidRelativeTo(relativeTo: string | undefined) {\n  if (process.env.NODE_ENV !== 'development') return\n  if (!relativeTo) return\n  console.warn(`[InjectionPlacement] relativeTo target \"${relativeTo}\" not found, appending item at the end.`)\n}\n\nexport function insertByInjectionPlacement<T>(\n  items: T[],\n  item: T,\n  placement: InjectionPlacement | undefined,\n  getItemId: (value: T) => string,\n): T[] {\n  const current = [...items]\n  const position = getInjectionPosition(placement)\n\n  if (position === InjectionPosition.First) {\n    current.unshift(item)\n    return current\n  }\n\n  if (position === InjectionPosition.Last) {\n    current.push(item)\n    return current\n  }\n\n  const relativeTo = placement?.relativeTo\n  if (!relativeTo) {\n    current.push(item)\n    return current\n  }\n\n  const targetIndex = current.findIndex((value) => getItemId(value) === relativeTo)\n  if (targetIndex < 0) {\n    warnInvalidRelativeTo(relativeTo)\n    current.push(item)\n    return current\n  }\n\n  const insertIndex = position === InjectionPosition.Before ? targetIndex : targetIndex + 1\n  current.splice(insertIndex, 0, item)\n  return current\n}\n"],
+  "mappings": "AAAO,IAAK,oBAAL,kBAAKA,uBAAL;AACL,EAAAA,mBAAA,YAAS;AACT,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,UAAO;AAJG,SAAAA;AAAA,GAAA;AAYL,SAAS,qBAAqB,WAAmD;AACtF,MAAI,CAAC,WAAW,SAAU,QAAO;AACjC,SAAO,UAAU;AACnB;AAEA,SAAS,sBAAsB,YAAgC;AAC7D,MAAI,QAAQ,IAAI,aAAa,cAAe;AAC5C,MAAI,CAAC,WAAY;AACjB,UAAQ,KAAK,2CAA2C,UAAU,yCAAyC;AAC7G;AAEO,SAAS,2BACd,OACA,MACA,WACA,WACK;AACL,QAAM,UAAU,CAAC,GAAG,KAAK;AACzB,QAAM,WAAW,qBAAqB,SAAS;AAE/C,MAAI,aAAa,qBAAyB;AACxC,YAAQ,QAAQ,IAAI;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,aAAa,mBAAwB;AACvC,YAAQ,KAAK,IAAI;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,WAAW;AAC9B,MAAI,CAAC,YAAY;AACf,YAAQ,KAAK,IAAI;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,QAAQ,UAAU,CAAC,UAAU,UAAU,KAAK,MAAM,UAAU;AAChF,MAAI,cAAc,GAAG;AACnB,0BAAsB,UAAU;AAChC,YAAQ,KAAK,IAAI;AACjB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,aAAa,wBAA2B,cAAc,cAAc;AACxF,UAAQ,OAAO,aAAa,GAAG,IAAI;AACnC,SAAO;AACT;",
+  "names": ["InjectionPosition"]
+}

package/dist/modules/widgets/injection-progress.js

@@ -0,0 +1 @@
+//# sourceMappingURL=injection-progress.js.map

package/dist/modules/widgets/injection-progress.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/shared",
-  "version": "0.4.5-develop-03023b2707",
+  "version": "0.4.5-develop-0c30cb4b11",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {

package/src/lib/bootstrap/factory.ts

@@ -6,6 +6,7 @@ import { registerEntityIds } from '../encryption/entityIds'
 import { registerEntityFields } from '../encryption/entityFields'
 import { registerSearchModuleConfigs } from '../../modules/search'
 import { registerAnalyticsModuleConfigs } from '../../modules/analytics'
+import { registerResponseEnrichers } from '../crud/enricher-registry'
 
 let _bootstrapped = false
 
@@ -54,6 +55,11 @@ export function createBootstrap(data: BootstrapData, options: BootstrapOptions =
       registerAnalyticsModuleConfigs(data.analyticsModuleConfigs)
     }
 
+    // === 6b. Response enrichers (for CRUD response enrichment) ===
+    if (data.enricherEntries) {
+      registerResponseEnrichers(data.enricherEntries)
+    }
+
     // === 7-8. UI Widgets and Optional packages (async to avoid circular deps) ===
     // Store the promise so CLI context can await it
     _asyncRegistrationPromise = registerWidgetsAndOptionalPackages(data, options)

package/src/lib/bootstrap/types.ts

@@ -14,6 +14,11 @@ export interface InjectionTableEntry {
   table: ModuleInjectionTable
 }
 
+export interface EnricherBootstrapEntry {
+  moduleId: string
+  enrichers: import('../../lib/crud/response-enricher').ResponseEnricher[]
+}
+
 export interface BootstrapData {
   modules: Module[]
   entities: OrmEntity[]
@@ -25,6 +30,7 @@ export interface BootstrapData {
   injectionTables: InjectionTableEntry[]
   searchModuleConfigs: SearchModuleConfig[]
   analyticsModuleConfigs?: AnalyticsModuleConfig[]
+  enricherEntries?: EnricherBootstrapEntry[]
 }
 
 export interface BootstrapOptions {

package/src/lib/crud/enricher-registry.ts

@@ -0,0 +1,68 @@
+/**
+ * Response Enricher Registry
+ *
+ * Global registry for response enrichers using the same globalThis pattern
+ * as injection widgets for HMR-safe storage.
+ */
+
+import type { EnricherRegistryEntry, ResponseEnricher } from './response-enricher'
+
+const GLOBAL_ENRICHERS_KEY = '__openMercatoResponseEnrichers__'
+
+let _enricherEntries: EnricherRegistryEntry[] | null = null
+
+function readGlobalEnrichers(): EnricherRegistryEntry[] | null {
+  try {
+    const value = (globalThis as Record<string, unknown>)[GLOBAL_ENRICHERS_KEY]
+    return Array.isArray(value) ? (value as EnricherRegistryEntry[]) : null
+  } catch {
+    return null
+  }
+}
+
+function writeGlobalEnrichers(entries: EnricherRegistryEntry[]) {
+  try {
+    ;(globalThis as Record<string, unknown>)[GLOBAL_ENRICHERS_KEY] = entries
+  } catch {
+    // ignore global assignment failures
+  }
+}
+
+/**
+ * Register response enrichers from all modules.
+ * Called during bootstrap after generated enrichers are imported.
+ */
+export function registerResponseEnrichers(
+  entries: Array<{ moduleId: string; enrichers: ResponseEnricher[] }>,
+) {
+  const flat: EnricherRegistryEntry[] = []
+  for (const entry of entries) {
+    for (const enricher of entry.enrichers) {
+      flat.push({ moduleId: entry.moduleId, enricher })
+    }
+  }
+  flat.sort((a, b) => (b.enricher.priority ?? 0) - (a.enricher.priority ?? 0))
+  _enricherEntries = flat
+  writeGlobalEnrichers(flat)
+}
+
+/**
+ * Get all registered response enrichers.
+ */
+export function getResponseEnrichers(): EnricherRegistryEntry[] {
+  const globalEntries = readGlobalEnrichers()
+  if (globalEntries) return globalEntries
+  if (!_enricherEntries) {
+    return []
+  }
+  return _enricherEntries
+}
+
+/**
+ * Get enrichers targeting a specific entity, sorted by priority (higher first).
+ */
+export function getEnrichersForEntity(targetEntity: string): EnricherRegistryEntry[] {
+  return getResponseEnrichers().filter(
+    (entry) => entry.enricher.targetEntity === targetEntity,
+  )
+}