@chromahq/core 1.0.55 → 1.0.57

package/dist/{boot-BMZdye6C.js → boot-DIMyFZvd.js}

@@ -1,6 +1,126 @@
 'use strict';
 
 var container$1 = require('@inversifyjs/container');
+var core = require('@inversifyjs/core');
+
+const SUBSCRIBE_METADATA_KEY = "chroma:subscribe";
+function Subscribe(eventName) {
+  return function(target, propertyKey, _descriptor) {
+    const key = "chroma:subscribe";
+    const constructor = target.constructor;
+    const existing = Reflect.getMetadata(key, constructor) || [];
+    existing.push({ eventName, methodName: propertyKey });
+    Reflect.defineMetadata(key, existing, constructor);
+  };
+}
+function getSubscribeMetadata(constructor) {
+  return Reflect.getMetadata("chroma:subscribe", constructor) || [];
+}
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+const EventBusToken = /* @__PURE__ */ Symbol.for("EventBus");
+exports.AppEventBus = class AppEventBus {
+  constructor() {
+    /** Registry of all active subscriptions */
+    this.subscriptions = [];
+    /** Auto-incrementing ID counter */
+    this.nextId = 0;
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Subscribe
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Subscribe to a named event.
+   *
+   * @param eventName - the event to listen for
+   * @param handler - callback invoked with the event payload
+   * @param handlerName - human-readable name for logging
+   * @returns an unsubscribe function
+   */
+  on(eventName, handler, handlerName) {
+    const id = ++this.nextId;
+    this.subscriptions.push({
+      id,
+      eventName,
+      handler,
+      handlerName
+    });
+    return () => {
+      this.subscriptions = this.subscriptions.filter((s) => s.id !== id);
+    };
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Emit
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Emit a named event to all matching subscribers.
+   *
+   * Handlers execute in parallel. Individual handler failures are caught
+   * and logged — they do not propagate or block other handlers.
+   *
+   * @param eventName - the event to emit
+   * @param payload - optional data passed to every handler
+   */
+  async emit(eventName, payload) {
+    const matching = this.subscriptions.filter((s) => s.eventName === eventName);
+    if (matching.length === 0) {
+      return;
+    }
+    const results = await Promise.allSettled(
+      matching.map(async (sub) => {
+        try {
+          await sub.handler(payload);
+        } catch (error) {
+          console.error(
+            `[AppEventBus] Handler "${sub.handlerName}" failed for event "${eventName}":`,
+            error
+          );
+          throw error;
+        }
+      })
+    );
+    const failed = results.filter((r) => r.status === "rejected").length;
+    if (failed > 0) {
+      console.warn(
+        `[AppEventBus] ${failed}/${matching.length} handler(s) failed for event "${eventName}"`
+      );
+    }
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Utilities
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Get the total number of active subscriptions.
+   * Useful for debugging and testing.
+   */
+  getSubscriptionCount() {
+    return this.subscriptions.length;
+  }
+  /**
+   * Get the number of subscriptions for a specific event.
+   *
+   * @param eventName - the event to count subscriptions for
+   */
+  getSubscriptionCountForEvent(eventName) {
+    return this.subscriptions.filter((s) => s.eventName === eventName).length;
+  }
+  /**
+   * Remove all subscriptions. Primarily for testing.
+   */
+  clearAllSubscriptions() {
+    this.subscriptions = [];
+  }
+};
+exports.AppEventBus = __decorateClass([
+  core.injectable()
+], exports.AppEventBus);
 
 const NONCE_STORE_STORAGE_KEY = "__CHROMA_NONCE_STORE__";
 class NonceService {
@@ -2202,6 +2322,7 @@ class ApplicationBootstrap {
   constructor() {
     this.serviceDependencies = /* @__PURE__ */ new Map();
     this.serviceRegistry = /* @__PURE__ */ new Map();
+    this.jobRegistry = /* @__PURE__ */ new Map();
     this.logger = new BootstrapLogger();
     this.storeDefinitions = [];
   }
@@ -2232,7 +2353,8 @@ class ApplicationBootstrap {
   }) {
     try {
       this.logger = new BootstrapLogger(enableLogs);
-      this.logger.info("\u{1F680} Starting Chroma application bootstrap...");
+      this.logger.info("Starting Chroma application bootstrap...");
+      this.initializeEventBus();
       await this.discoverAndInitializeStores();
       await this.discoverServices();
       const store = this.storeDefinitions[0].store;
@@ -2252,10 +2374,11 @@ class ApplicationBootstrap {
       if (!disableBootMethods) {
         await this.bootMessages();
         await this.bootServices();
+        this.wireEventSubscriptions();
       }
-      this.logger.success("\u{1F389} Chroma application initialization complete!");
+      this.logger.success("Chroma application initialization complete");
     } catch (error) {
-      this.logger.error("\u{1F4A5} Application bootstrap failed:", error);
+      this.logger.error("Application bootstrap failed:", error);
       throw error;
     }
   }
@@ -2263,7 +2386,7 @@ class ApplicationBootstrap {
    * Boot all registered services by calling their onBoot method if present
    */
   async bootServices() {
-    this.logger.info("\u{1F680} Booting services...");
+    this.logger.info("Booting services...");
     const bootPromises = Array.from(this.serviceRegistry.entries()).map(
       async ([serviceName, ServiceClass]) => {
         try {
@@ -2282,11 +2405,67 @@ class ApplicationBootstrap {
     );
     await Promise.all(bootPromises);
   }
+  /**
+   * Create and bind the global AppEventBus singleton to the DI container.
+   * Called early in bootstrap so any service can inject it.
+   */
+  initializeEventBus() {
+    if (!container.isBound(exports.AppEventBus)) {
+      container.bind(exports.AppEventBus).toSelf().inSingletonScope();
+    }
+    if (!container.isBound(EventBusToken)) {
+      container.bind(EventBusToken).toDynamicValue(() => container.get(exports.AppEventBus)).inSingletonScope();
+    }
+    this.logger.debug("AppEventBus bound to DI container");
+  }
+  /**
+   * Scan all registered services and jobs for @Subscribe metadata and
+   * wire the decorated methods to the AppEventBus.
+   *
+   * This runs after bootServices so every singleton is already instantiated.
+   */
+  wireEventSubscriptions() {
+    this.logger.info("Wiring @Subscribe event subscriptions...");
+    const bus = container.get(exports.AppEventBus);
+    let wiredCount = 0;
+    const scan = (name, Constructor) => {
+      const metadata = getSubscribeMetadata(Constructor);
+      if (metadata.length === 0) {
+        return;
+      }
+      let instance;
+      try {
+        instance = container.get(Constructor);
+      } catch {
+        this.logger.warn(`Could not resolve instance for ${name}, skipping @Subscribe wiring`);
+        return;
+      }
+      for (const { eventName, methodName } of metadata) {
+        const method = instance[methodName];
+        if (typeof method !== "function") {
+          this.logger.warn(
+            `@Subscribe('${eventName}') on ${name}.${methodName} is not a function, skipping`
+          );
+          continue;
+        }
+        bus.on(eventName, method.bind(instance), `${name}.${methodName}`);
+        wiredCount++;
+        this.logger.debug(`Wired @Subscribe('${eventName}') \u2192 ${name}.${methodName}`);
+      }
+    };
+    for (const [name, Constructor] of this.serviceRegistry) {
+      scan(name, Constructor);
+    }
+    for (const [name, Constructor] of this.jobRegistry) {
+      scan(name, Constructor);
+    }
+    this.logger.success(`Wired ${wiredCount} @Subscribe handler(s) to AppEventBus`);
+  }
   /**
    * Discover all services in the application directory
    */
   async discoverServices() {
-    this.logger.info("\u{1F50D} Discovering services...");
+    this.logger.info("Discovering services...");
     const serviceModules = undefined(
       "/src/app/services/**/*.service.{ts,js}",
       { eager: true }
@@ -2301,7 +2480,7 @@ class ApplicationBootstrap {
     }
     const circularDepsResult = this.detectCircularDependencies(serviceClasses);
     if (circularDepsResult.hasCircularDependencies) {
-      this.logger.error("\u{1F4A5} Circular dependencies detected!");
+      this.logger.error("Circular dependencies detected!");
       circularDepsResult.cycles.forEach((cycle, index) => {
         this.logger.error(`Cycle ${index + 1}: ${cycle.cycle.join(" \u2192 ")} \u2192 ${cycle.cycle[0]}`);
       });
@@ -2309,10 +2488,10 @@ class ApplicationBootstrap {
     }
     for (const ServiceClass of serviceClasses) {
       container.bind(ServiceClass).toSelf().inSingletonScope();
-      this.logger.debug(`\u{1F4E6} Discovered service: ${ServiceClass.name}`);
+      this.logger.debug(`Discovered service: ${ServiceClass.name}`);
     }
     this.logger.success(
-      `\u2705 Registered ${serviceClasses.length} services without circular dependencies`
+      `Registered ${serviceClasses.length} services without circular dependencies`
     );
   }
   /**
@@ -2444,17 +2623,17 @@ class ApplicationBootstrap {
   analyzeDependencies() {
     const serviceClasses = Array.from(this.serviceRegistry.values());
     const result = this.detectCircularDependencies(serviceClasses);
-    this.logger.info("\u{1F4CA} Dependency Analysis Report:");
+    this.logger.info("Dependency Analysis Report:");
     this.logger.info(`Total Services: ${result.dependencyGraph.size}`);
     if (result.hasCircularDependencies) {
-      this.logger.error(`\u{1F504} Circular Dependencies Found: ${result.cycles.length}`);
+      this.logger.error(`Circular Dependencies Found: ${result.cycles.length}`);
       result.cycles.forEach((cycle, index) => {
         this.logger.error(`  Cycle ${index + 1}: ${cycle.cycle.join(" \u2192 ")} \u2192 ${cycle.cycle[0]}`);
       });
     } else {
-      this.logger.success("\u2705 No circular dependencies detected");
+      this.logger.success("No circular dependencies detected");
     }
-    this.logger.info("\u{1F333} Service Dependency Tree:");
+    this.logger.info("Service Dependency Tree:");
     for (const [serviceName, node] of result.dependencyGraph) {
       if (node.dependencies.length > 0) {
         this.logger.info(`  ${serviceName} depends on:`);
@@ -2472,7 +2651,7 @@ class ApplicationBootstrap {
   async discoverAndInitializeStores() {
     try {
       if (this.storeDefinitions.length === 0) {
-        this.logger.debug("\u{1F4ED} No store definitions provided");
+        this.logger.debug("No store definitions provided");
         return;
       }
       this.logger.info(`Initializing ${this.storeDefinitions.length} store(s)...`);
@@ -2483,7 +2662,7 @@ class ApplicationBootstrap {
         const classes = store.classes;
         container.bind(diKey).toConstantValue(storeInstance);
         if (isFirstStore) {
-          container.bind(Symbol.for("Store")).toConstantValue(storeInstance);
+          container.bind(/* @__PURE__ */ Symbol.for("Store")).toConstantValue(storeInstance);
           isFirstStore = false;
         }
         await this.registerMessageClass(
@@ -2500,18 +2679,18 @@ class ApplicationBootstrap {
             `store:${store.def.name}:reset`
           );
         }
-        this.logger.debug(`\u2705 Initialized store: ${store.def.name}`);
+        this.logger.debug(`Initialized store: ${store.def.name}`);
       }
-      this.logger.success(`\u2705 Initialized ${this.storeDefinitions.length} store(s)`);
+      this.logger.success(`Initialized ${this.storeDefinitions.length} store(s)`);
     } catch (error) {
-      this.logger.error("\u274C Failed to initialize stores:", error);
+      this.logger.error("Failed to initialize stores:", error);
     }
   }
   /**
    * Register message handlers
    */
   async registerMessages() {
-    this.logger.info("\u{1F4E8} Registering messages...");
+    this.logger.info("Registering messages...");
     const messageModules = undefined(
       "/src/app/messages/**/*.message.{ts,js}",
       { eager: true }
@@ -2524,7 +2703,7 @@ class ApplicationBootstrap {
     if (messageClasses.length > 0) {
       const circularDepsResult = this.detectCircularDependencies(messageClasses);
       if (circularDepsResult.hasCircularDependencies) {
-        this.logger.error("\u{1F4A5} Circular dependencies detected in messages!");
+        this.logger.error("Circular dependencies detected in messages!");
         circularDepsResult.cycles.forEach((cycle, index) => {
           this.logger.error(
             `Message Cycle ${index + 1}: ${cycle.cycle.join(" \u2192 ")} \u2192 ${cycle.cycle[0]}`
@@ -2539,30 +2718,30 @@ class ApplicationBootstrap {
       try {
         for (const [name, ServiceClass] of this.serviceRegistry) {
           if (!ServiceClass) {
-            this.logger.warn(`\u26A0\uFE0F Service not found in registry: ${name}`);
+            this.logger.warn(`Service not found in registry: ${name}`);
           }
           if (!container.isBound(ServiceClass)) {
-            this.logger.warn(`\u26A0\uFE0F Service not bound in container: ${name}`);
+            this.logger.warn(`Service not bound in container: ${name}`);
           }
         }
         const messageMetadata = Reflect.getMetadata("name", MessageClass);
         const messageName = messageMetadata || MessageClass.name;
         container.bind(messageName).to(MessageClass).inSingletonScope();
-        this.logger.success(`\u2705 Registered message: ${messageName}`);
+        this.logger.success(`Registered message: ${messageName}`);
       } catch (error) {
-        this.logger.error(`\u274C Failed to register message ${MessageClass.name}:`, error);
+        this.logger.error(`Failed to register message ${MessageClass.name}:`, error);
       }
     }
   }
   async registerMessageClass(MessageClass, name) {
     container.bind(name).to(MessageClass).inSingletonScope();
-    this.logger.success(`\u2705 Registered message: ${name}`);
+    this.logger.success(`Registered message: ${name}`);
   }
   /**
    * Boot all registered messages
    */
   async bootMessages() {
-    this.logger.info("\u{1F680} Booting messages...");
+    this.logger.info("Booting messages...");
     const messageModules = undefined(
       "/src/app/messages/**/*.message.{ts,js}",
       { eager: true }
@@ -2577,10 +2756,10 @@ class ApplicationBootstrap {
         const messageName = messageMetadata || MessageClass.name;
         const messageInstance = container.get(messageName);
         await messageInstance.boot();
-        this.logger.success(`\u2705 Booted message: ${messageName}`);
+        this.logger.success(`Booted message: ${messageName}`);
         return { messageName, success: true };
       } catch (error) {
-        this.logger.error(`\u274C Failed to boot message ${MessageClass.name}:`, error);
+        this.logger.error(`Failed to boot message ${MessageClass.name}:`, error);
         return { messageName: MessageClass.name, success: false, error };
       }
     });
@@ -2590,7 +2769,7 @@ class ApplicationBootstrap {
    * Register jobs for scheduled execution
    */
   async registerJobs() {
-    this.logger.info("\u{1F552} Registering jobs...");
+    this.logger.info("Registering jobs...");
     const jobModules = undefined(
       "/src/app/jobs/**/*.job.{ts,js}",
       { eager: true }
@@ -2601,10 +2780,10 @@ class ApplicationBootstrap {
     this.logger.debug("container isBound(Scheduler)", { isBound: container.isBound(Scheduler) });
     for (const [name, ServiceClass] of this.serviceRegistry) {
       if (!ServiceClass) {
-        this.logger.warn(`\u26A0\uFE0F Service not found in registry: ${name}`);
+        this.logger.warn(`Service not found in registry: ${name}`);
       }
       if (!container.isBound(ServiceClass)) {
-        this.logger.warn(`\u26A0\uFE0F Service not bound in container: ${name}`);
+        this.logger.warn(`Service not bound in container: ${name}`);
       } else {
         container.get(ServiceClass);
       }
@@ -2624,23 +2803,43 @@ class ApplicationBootstrap {
         container.bind(id).to(JobClass).inSingletonScope();
         const options = Reflect.getMetadata("job:options", JobClass) || {};
         jobEntries.push({ JobClass, jobName, id, options });
-        this.logger.debug(`\u{1F4E6} Bound job: ${jobName}`);
+        this.jobRegistry.set(jobName, JobClass);
+        this.logger.debug(`Bound job: ${jobName}`);
       } catch (error) {
-        this.logger.error(`\u274C Failed to bind job ${JobClass.name}:`, error);
+        this.logger.error(`Failed to bind job ${JobClass.name}:`, error);
       }
     }
     for (const { JobClass, jobName, id, options } of jobEntries) {
       try {
         const instance = container.get(JobClass);
         JobRegistry.instance.register(id, instance, options);
+        if (typeof instance.onBoot === "function") {
+          this.logger.info(`Executing onBoot for job: ${jobName}`);
+          try {
+            if (options.requiresPopup) {
+              const isPopupVisible = PopupVisibilityService.instance.isPopupVisible();
+              if (!isPopupVisible) {
+                this.logger.debug(`Skipping onBoot for job ${jobName} - popup not visible`);
+              } else {
+                await instance.onBoot();
+                this.logger.debug(`Executed onBoot for job: ${jobName}`);
+              }
+            } else {
+              await instance.onBoot();
+              this.logger.debug(`Executed onBoot for job: ${jobName}`);
+            }
+          } catch (error) {
+            this.logger.error(`Failed to execute onBoot for job ${jobName}:`, error);
+          }
+        }
         if (!options.startPaused) {
           this.scheduler.schedule(id, options);
         } else {
-          this.logger.info(`\u23F8\uFE0F Job ${jobName} registered but paused (startPaused: true)`);
+          this.logger.info(`Job ${jobName} registered but paused (startPaused: true)`);
         }
-        this.logger.success(`\u2705 Registered job: ${jobName}`);
+        this.logger.success(`Registered job: ${jobName}`);
       } catch (error) {
-        this.logger.error(`\u274C Failed to register job ${JobClass.name}:`, error);
+        this.logger.error(`Failed to register job ${JobClass.name}:`, error);
       }
     }
   }
@@ -2725,11 +2924,14 @@ class BootstrapBuilder {
   }
 }
 
+exports.EventBusToken = EventBusToken;
 exports.JobRegistry = JobRegistry;
 exports.JobState = JobState;
 exports.NonceService = NonceService;
 exports.PopupVisibilityService = PopupVisibilityService;
+exports.SUBSCRIBE_METADATA_KEY = SUBSCRIBE_METADATA_KEY;
 exports.Scheduler = Scheduler;
+exports.Subscribe = Subscribe;
 exports.arePortsClaimed = arePortsClaimed;
 exports.bootstrap = bootstrap;
 exports.claimEarlyPorts = claimEarlyPorts;
@@ -2737,6 +2939,7 @@ exports.container = container;
 exports.create = create;
 exports.getNonceService = getNonceService;
 exports.getPopupVisibilityService = getPopupVisibilityService;
+exports.getSubscribeMetadata = getSubscribeMetadata;
 exports.isEarlyListenerSetup = isEarlyListenerSetup;
 exports.setupEarlyListener = setupEarlyListener;
-//# sourceMappingURL=boot-BMZdye6C.js.map
+//# sourceMappingURL=boot-DIMyFZvd.js.map