@chromahq/core 1.0.56 → 1.0.57

package/dist/{boot-CUFlC4bu.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 = [];
   }
@@ -2233,6 +2354,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;
@@ -2252,6 +2374,7 @@ class ApplicationBootstrap {
       if (!disableBootMethods) {
         await this.bootMessages();
         await this.bootServices();
+        this.wireEventSubscriptions();
       }
       this.logger.success("Chroma application initialization complete");
     } catch (error) {
@@ -2282,6 +2405,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(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
    */
@@ -2624,6 +2803,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);
@@ -2744,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;
@@ -2756,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-CUFlC4bu.js.map
+//# sourceMappingURL=boot-DIMyFZvd.js.map