@chromahq/core 1.0.56 → 1.0.57

package/dist/{boot-c2gJZWBc.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 = [];
   }
@@ -2231,6 +2352,7 @@ class ApplicationBootstrap {
     try {
       this.logger = new BootstrapLogger(enableLogs);
       this.logger.info("Starting Chroma application bootstrap...");
+      this.initializeEventBus();
       await this.discoverAndInitializeStores();
       await this.discoverServices();
       const store = this.storeDefinitions[0].store;
@@ -2250,6 +2372,7 @@ class ApplicationBootstrap {
       if (!disableBootMethods) {
         await this.bootMessages();
         await this.bootServices();
+        this.wireEventSubscriptions();
       }
       this.logger.success("Chroma application initialization complete");
     } catch (error) {
@@ -2280,6 +2403,62 @@ 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
    */
@@ -2622,6 +2801,7 @@ class ApplicationBootstrap {
         container.bind(id).to(JobClass).inSingletonScope();
         const options = Reflect.getMetadata("job:options", JobClass) || {};
         jobEntries.push({ JobClass, jobName, id, options });
+        this.jobRegistry.set(jobName, JobClass);
         this.logger.debug(`Bound job: ${jobName}`);
       } catch (error) {
         this.logger.error(`Failed to bind job ${JobClass.name}:`, error);
@@ -2742,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-c2gJZWBc.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