@chromahq/core 1.0.56 → 1.0.58

package/dist/{boot-CUFlC4bu.js → boot--zb14Gg3.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 {
@@ -1025,10 +1145,10 @@ const _AlarmAdapter = class _AlarmAdapter {
     /**
      * Initialize the Chrome Alarms listener (once)
      */
-    this.initializeAlarmListener = () => {
+    this.initializeAlarmListener = async () => {
       if (this.listenerRegistered) return;
       if (this.isChromeAlarmsAvailable()) {
-        this.clearStaleAlarms();
+        await this.clearStaleAlarms();
         chrome.alarms.onAlarm.addListener(this.handleAlarm);
         this.listenerRegistered = true;
         console.log("[AlarmAdapter] \u2705 Chrome Alarms API available and listener registered");
@@ -1039,20 +1159,31 @@ const _AlarmAdapter = class _AlarmAdapter {
       }
     };
     /**
-     * Clear any stale chroma alarms from previous SW instances
+     * Clear any stale chroma alarms from previous SW instances.
+     * Returns a promise that resolves once all stale alarms are cleared.
      */
     this.clearStaleAlarms = () => {
-      if (!this.isChromeAlarmsAvailable()) return;
-      chrome.alarms.getAll((alarms) => {
-        const staleAlarms = alarms.filter((a) => a.name.startsWith(_AlarmAdapter.ALARM_PREFIX));
-        if (staleAlarms.length > 0) {
-          console.log(
-            `[AlarmAdapter] \u{1F9F9} Clearing ${staleAlarms.length} stale alarms from previous session`
-          );
-          staleAlarms.forEach((alarm) => {
-            chrome.alarms.clear(alarm.name);
-          });
-        }
+      if (!this.isChromeAlarmsAvailable()) return Promise.resolve();
+      return new Promise((resolve) => {
+        chrome.alarms.getAll((alarms) => {
+          const staleAlarms = alarms.filter((a) => a.name.startsWith(_AlarmAdapter.ALARM_PREFIX));
+          if (staleAlarms.length > 0) {
+            console.log(
+              `[AlarmAdapter] \u{1F9F9} Clearing ${staleAlarms.length} stale alarms from previous session`
+            );
+            let cleared = 0;
+            staleAlarms.forEach((alarm) => {
+              chrome.alarms.clear(alarm.name, () => {
+                cleared++;
+                if (cleared === staleAlarms.length) {
+                  resolve();
+                }
+              });
+            });
+          } else {
+            resolve();
+          }
+        });
       });
     };
     /**
@@ -1157,7 +1288,7 @@ const _AlarmAdapter = class _AlarmAdapter {
         usingChromeApi: this.isChromeAlarmsAvailable()
       };
     };
-    this.initializeAlarmListener();
+    this.ready = this.initializeAlarmListener();
   }
 };
 _AlarmAdapter.ALARM_PREFIX = "chroma_job_";
@@ -2064,6 +2195,13 @@ class Scheduler {
         return;
       }
     }
+    this.alarm.ready.then(() => this.scheduleInternal(id, options));
+  }
+  scheduleInternal(id, options) {
+    const context = this.registry.getContext(id);
+    if (!context || context.isStopped() || context.isPaused()) {
+      return;
+    }
     const when = this.getScheduleTime(options);
     const now = Date.now();
     if (when <= now) {
@@ -2202,6 +2340,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 +2372,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 +2392,7 @@ class ApplicationBootstrap {
       if (!disableBootMethods) {
         await this.bootMessages();
         await this.bootServices();
+        this.wireEventSubscriptions();
       }
       this.logger.success("Chroma application initialization complete");
     } catch (error) {
@@ -2282,6 +2423,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
    */
@@ -2620,10 +2817,11 @@ class ApplicationBootstrap {
         if (!container.isBound(JobClass)) {
           container.bind(JobClass).toSelf().inSingletonScope();
         }
-        const id = `${jobName.toLowerCase()}:${JobClass.name.toLowerCase()} ${Math.random().toString(36).substring(2, 15)}`;
+        const id = `${jobName.toLowerCase()}:${JobClass.name.toLowerCase()}`;
         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 +2942,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 +2957,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--zb14Gg3.js.map