@chromahq/core 1.0.55 → 1.0.57

package/dist/{boot-Bty0U5M4.js → boot-C2Rq9czO.js}

@@ -1,4 +1,124 @@
 import { Container } from '@inversifyjs/container';
+import { injectable } from '@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");
+let AppEventBus = class {
+  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 = [];
+  }
+};
+AppEventBus = __decorateClass([
+  injectable()
+], AppEventBus);
 
 const NONCE_STORE_STORAGE_KEY = "__CHROMA_NONCE_STORE__";
 class NonceService {
@@ -2200,6 +2320,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 = [];
   }
@@ -2230,7 +2351,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;
@@ -2250,10 +2372,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;
     }
   }
@@ -2261,7 +2384,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 {
@@ -2280,11 +2403,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(AppEventBus)) {
+      container.bind(AppEventBus).toSelf().inSingletonScope();
+    }
+    if (!container.isBound(EventBusToken)) {
+      container.bind(EventBusToken).toDynamicValue(() => container.get(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(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 = import.meta.glob(
       "/src/app/services/**/*.service.{ts,js}",
       { eager: true }
@@ -2299,7 +2478,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]}`);
       });
@@ -2307,10 +2486,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`
     );
   }
   /**
@@ -2442,17 +2621,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:`);
@@ -2470,7 +2649,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)...`);
@@ -2481,7 +2660,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(
@@ -2498,18 +2677,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 = import.meta.glob(
       "/src/app/messages/**/*.message.{ts,js}",
       { eager: true }
@@ -2522,7 +2701,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]}`
@@ -2537,30 +2716,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 = import.meta.glob(
       "/src/app/messages/**/*.message.{ts,js}",
       { eager: true }
@@ -2575,10 +2754,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 };
       }
     });
@@ -2588,7 +2767,7 @@ class ApplicationBootstrap {
    * Register jobs for scheduled execution
    */
   async registerJobs() {
-    this.logger.info("\u{1F552} Registering jobs...");
+    this.logger.info("Registering jobs...");
     const jobModules = import.meta.glob(
       "/src/app/jobs/**/*.job.{ts,js}",
       { eager: true }
@@ -2599,10 +2778,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);
       }
@@ -2622,23 +2801,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);
       }
     }
   }
@@ -2723,5 +2922,5 @@ class BootstrapBuilder {
   }
 }
 
-export { JobRegistry as J, NonceService as N, PopupVisibilityService as P, Scheduler as S, getPopupVisibilityService as a, arePortsClaimed as b, claimEarlyPorts as c, container as d, create as e, bootstrap as f, getNonceService as g, JobState as h, isEarlyListenerSetup as i, setupEarlyListener as s };
-//# sourceMappingURL=boot-Bty0U5M4.js.map
+export { AppEventBus as A, EventBusToken as E, JobRegistry as J, NonceService as N, PopupVisibilityService as P, Subscribe as S, SUBSCRIBE_METADATA_KEY as a, getNonceService as b, getPopupVisibilityService as c, claimEarlyPorts as d, arePortsClaimed as e, container as f, getSubscribeMetadata as g, create as h, isEarlyListenerSetup as i, bootstrap as j, Scheduler as k, JobState as l, setupEarlyListener as s };
+//# sourceMappingURL=boot-C2Rq9czO.js.map