@chromahq/core 1.0.56 → 1.0.58

package/dist/boot.es.js

@@ -1,3 +1,4 @@
-export { f as bootstrap, c as claimEarlyPorts, i as isEarlyListenerSetup, s as setupEarlyListener } from './boot-c2gJZWBc.js';
+export { j as bootstrap, d as claimEarlyPorts, i as isEarlyListenerSetup, s as setupEarlyListener } from './boot-DPtu_qKj.js';
 import '@inversifyjs/container';
+import '@inversifyjs/core';
 //# sourceMappingURL=boot.es.js.map

package/dist/boot.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"boot.es.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/index.cjs.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var core = require('@inversifyjs/core');
-var boot = require('./boot-CUFlC4bu.js');
+var boot = require('./boot--zb14Gg3.js');
 require('@inversifyjs/container');
 
 function Service() {
@@ -9,6 +9,7 @@ function Service() {
 }
 const Use = (id) => core.inject(id);
 const Store = () => Use(/* @__PURE__ */ Symbol.for("Store"));
+const EventBus = () => Use(/* @__PURE__ */ Symbol.for("EventBus"));
 
 class IMessage {
   handle(...args) {
@@ -102,11 +103,18 @@ function isDestroyable(obj) {
   return typeof obj.destroy === "function";
 }
 
+Object.defineProperty(exports, "AppEventBus", {
+  enumerable: true,
+  get: function () { return boot.AppEventBus; }
+});
+exports.EventBusToken = boot.EventBusToken;
 exports.JobRegistry = boot.JobRegistry;
 exports.JobState = boot.JobState;
 exports.NonceService = boot.NonceService;
 exports.PopupVisibilityService = boot.PopupVisibilityService;
+exports.SUBSCRIBE_METADATA_KEY = boot.SUBSCRIBE_METADATA_KEY;
 exports.Scheduler = boot.Scheduler;
+exports.Subscribe = boot.Subscribe;
 exports.arePortsClaimed = boot.arePortsClaimed;
 exports.bootstrap = boot.bootstrap;
 exports.claimEarlyPorts = boot.claimEarlyPorts;
@@ -114,10 +122,12 @@ exports.container = boot.container;
 exports.create = boot.create;
 exports.getNonceService = boot.getNonceService;
 exports.getPopupVisibilityService = boot.getPopupVisibilityService;
+exports.getSubscribeMetadata = boot.getSubscribeMetadata;
 exports.isEarlyListenerSetup = boot.isEarlyListenerSetup;
 exports.setupEarlyListener = boot.setupEarlyListener;
 exports.Booteable = Booteable;
 exports.Delay = Delay;
+exports.EventBus = EventBus;
 exports.Every = Every;
 exports.EverySeconds = EverySeconds;
 exports.IMessage = IMessage;

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/decorators/Service.ts","../src/decorators/Message.ts","../src/scheduler/core/Job.ts","../src/scheduler/decorators/Job.ts","../src/scheduler/decorators/Delay.ts","../src/scheduler/decorators/Every.ts","../src/scheduler/decorators/EverySeconds.ts","../src/services/booteable.ts"],"sourcesContent":["import { inject, injectable } from '@inversifyjs/core';\n\nexport function Service() {\n  return injectable();\n}\n\nexport const Use = (id: symbol | string | NewableFunction) => inject(id);\nexport const Store = () => Use(Symbol.for('Store'));\n","import { injectable } from '@inversifyjs/core';\n\nexport abstract class IMessage {\n  handle(...args: any[]): Promise<void> | void {\n    throw new Error('Method not implemented.');\n  }\n}\n\nexport function Message(name: string) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('name', name, constructor);\n    return constructor;\n  };\n}\n","import { IJob, JobContext } from './IJob';\n\nexport abstract class Job<T = unknown> implements IJob<T> {\n  constructor(public readonly data?: T) {}\n\n  abstract handle(context?: JobContext): Promise<void> | void;\n\n  pause?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} paused`);\n  }\n\n  resume?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} resumed`);\n  }\n\n  stop?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} stopped`);\n  }\n}\n","import { injectable } from '@inversifyjs/core';\nimport { JobOptions } from '../core/JobOptions';\n\nexport function JobConfig<T extends new (...args: any[]) => any>(options: JobOptions = {}) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('job:options', options, constructor);\n    return constructor;\n  };\n}\n","import { JobConfig } from './Job';\n\nexport const Delay = (ms: number) => JobConfig({ delay: ms });\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the Every decorator.\n */\nexport interface EveryOptions {\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n\n  /**\n   * Explicit job name (survives minification). Recommended for production builds.\n   */\n  name?: string;\n\n  /**\n   * If true, job starts paused and must be resumed manually via Scheduler.resume()\n   */\n  startPaused?: boolean;\n}\n\n/**\n * Decorator for scheduling jobs using cron expressions.\n *\n * @param cron - Cron expression (e.g., '0 *\\/5 * * * *' for every 5 minutes)\n * @param options - Optional configuration for the job\n *\n * @example\n * ```typescript\n * // Basic usage - runs every 5 minutes\n * @Every('0 *\\/5 * * * *')\n * export class MyJob { ... }\n *\n * // With options - only runs when popup is visible\n * @Every('0 *\\/5 * * * *', { requiresPopup: true, name: 'MyJob' })\n * export class MyJob { ... }\n * ```\n */\nexport function Every(cron: string, options?: EveryOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        cron,\n        requiresPopup: options?.requiresPopup ?? false,\n        startPaused: options?.startPaused ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the EverySeconds decorator.\n */\nexport interface EverySecondsOptions {\n  /** If true, job starts paused and must be resumed manually via Scheduler.resume() */\n  startPaused?: boolean;\n\n  /** Explicit job name (survives minification). Required for production builds. */\n  name?: string;\n\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n}\n\n/**\n * Decorator for jobs that run at a specific interval in seconds.\n * Unlike cron expressions which have minute-level granularity,\n * this decorator allows for second-level precision.\n *\n * @param seconds - The interval in seconds between job executions\n * @param options - Optional configuration (startPaused, name, requiresPopup, etc.)\n *\n * @example\n * ```typescript\n * // Auto-starting job (default)\n * @EverySeconds(5, { name: 'MyJob' })\n * export class MyJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs every 5 seconds');\n *   }\n * }\n *\n * // Job that only runs when popup is visible\n * @EverySeconds(10, { name: 'UiUpdateJob', requiresPopup: true })\n * export class UiUpdateJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Only runs when user is viewing extension');\n *   }\n * }\n *\n * // Paused job that must be manually resumed\n * @EverySeconds(2, { startPaused: true, name: 'OnDemandJob' })\n * export class OnDemandJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs when resumed');\n *   }\n * }\n * ```\n */\nexport function EverySeconds(seconds: number, options?: EverySecondsOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        delay: seconds * 1000,\n        recurring: true,\n        startPaused: options?.startPaused ?? false,\n        requiresPopup: options?.requiresPopup ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","export abstract class Booteable {\n  /**\n   * Boot method to be called when the service is initialized.\n   * This method can be used to perform any setup or initialization logic.\n   */\n  abstract boot(): void;\n  /**\n   * Optional destroy method to be called when the service is being destroyed.\n   * This can be used to clean up resources or perform any necessary teardown logic.\n   */\n  destroy?(): void {\n    // Default implementation does nothing\n  }\n}\n\nexport function isBooteable(obj: any): obj is Booteable {\n  return typeof obj.boot === 'function';\n}\n\nexport function isDestroyable(obj: any): obj is Booteable {\n  return typeof obj.destroy === 'function';\n}\n"],"names":["injectable","inject"],"mappings":";;;;;;AAEO,SAAS,OAAA,GAAU;AACxB,EAAA,OAAOA,eAAA,EAAW;AACpB;AAEO,MAAM,GAAA,GAAM,CAAC,EAAA,KAA0CC,WAAA,CAAO,EAAE;AAChE,MAAM,QAAQ,MAAM,GAAA,iBAAI,MAAA,CAAO,GAAA,CAAI,OAAO,CAAC;;ACL3C,MAAe,QAAA,CAAS;AAAA,EAC7B,UAAU,IAAA,EAAmC;AAC3C,IAAA,MAAM,IAAI,MAAM,yBAAyB,CAAA;AAAA;AAE7C;AAEO,SAAS,QAAQ,IAAA,EAAc;AACpC,EAAA,OAAO,SAAU,WAAA,EAAkB;AACjC,IAAAD,eAAA,GAAa,WAAW,CAAA;AACxB,IAAA,OAAA,CAAQ,cAAA,CAAe,MAAA,EAAQ,IAAA,EAAM,WAAW,CAAA;AAChD,IAAA,OAAO,WAAA;AAAA,GACT;AACF;;ACZO,MAAe,GAAA,CAAoC;AAAA,EACxD,YAA4B,IAAA,EAAU;AAAV,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA;AAAW,EAIvC,KAAA,GAA+B;AAC7B,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,IAAA,EAAO,IAAA,CAAK,WAAA,CAAY,IAAI,CAAA,OAAA,CAAS,CAAA;AAAA;AACnD,EAEA,MAAA,GAAgC;AAC9B,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,IAAA,EAAO,IAAA,CAAK,WAAA,CAAY,IAAI,CAAA,QAAA,CAAU,CAAA;AAAA;AACpD,EAEA,IAAA,GAA8B;AAC5B,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,IAAA,EAAO,IAAA,CAAK,WAAA,CAAY,IAAI,CAAA,QAAA,CAAU,CAAA;AAAA;AAEtD;;ACfO,SAAS,SAAA,CAAiD,OAAA,GAAsB,EAAC,EAAG;AACzF,EAAA,OAAO,SAAU,WAAA,EAAkB;AACjC,IAAAA,eAAA,GAAa,WAAW,CAAA;AACxB,IAAA,OAAA,CAAQ,cAAA,CAAe,aAAA,EAAe,OAAA,EAAS,WAAW,CAAA;AAC1D,IAAA,OAAO,WAAA;AAAA,GACT;AACF;;ACPO,MAAM,QAAQ,CAAC,EAAA,KAAe,UAAU,EAAE,KAAA,EAAO,IAAI;;ACsCrD,SAAS,KAAA,CAAM,MAAc,OAAA,EAAwB;AAC1D,EAAA,OAAO,SAAU,WAAA,EAAkB;AACjC,IAAAA,eAAA,GAAa,WAAW,CAAA;AAGxB,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,OAAA,CAAQ,cAAA,CAAe,MAAA,EAAQ,OAAA,CAAQ,IAAA,EAAM,WAAW,CAAA;AAAA;AAG1D,IAAA,OAAA,CAAQ,cAAA;AAAA,MACN,aAAA;AAAA,MACA;AAAA,QACE,IAAA;AAAA,QACA,aAAA,EAAe,SAAS,aAAA,IAAiB,KAAA;AAAA,QACzC,WAAA,EAAa,SAAS,WAAA,IAAe;AAAA,OACvC;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,WAAA;AAAA,GACT;AACF;;ACNO,SAAS,YAAA,CAAa,SAAiB,OAAA,EAA+B;AAC3E,EAAA,OAAO,SAAU,WAAA,EAAkB;AACjC,IAAAA,eAAA,GAAa,WAAW,CAAA;AAExB,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,OAAA,CAAQ,cAAA,CAAe,MAAA,EAAQ,OAAA,CAAQ,IAAA,EAAM,WAAW,CAAA;AAAA;AAG1D,IAAA,OAAA,CAAQ,cAAA;AAAA,MACN,aAAA;AAAA,MACA;AAAA,QACE,OAAO,OAAA,GAAU,GAAA;AAAA,QACjB,SAAA,EAAW,IAAA;AAAA,QACX,WAAA,EAAa,SAAS,WAAA,IAAe,KAAA;AAAA,QACrC,aAAA,EAAe,SAAS,aAAA,IAAiB;AAAA,OAC3C;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,WAAA;AAAA,GACT;AACF;;AC1EO,MAAe,SAAA,CAAU;AAAA;AAAA;AAAA;AAAA;AAAA,EAU9B,OAAA,GAAiB;AAAA;AAGnB;AAEO,SAAS,YAAY,GAAA,EAA4B;AACtD,EAAA,OAAO,OAAO,IAAI,IAAA,KAAS,UAAA;AAC7B;AAEO,SAAS,cAAc,GAAA,EAA4B;AACxD,EAAA,OAAO,OAAO,IAAI,OAAA,KAAY,UAAA;AAChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs.js","sources":["../src/decorators/Service.ts","../src/decorators/Message.ts","../src/scheduler/core/Job.ts","../src/scheduler/decorators/Job.ts","../src/scheduler/decorators/Delay.ts","../src/scheduler/decorators/Every.ts","../src/scheduler/decorators/EverySeconds.ts","../src/services/booteable.ts"],"sourcesContent":["import { inject, injectable } from '@inversifyjs/core';\n\nexport function Service() {\n  return injectable();\n}\n\nexport const Use = (id: symbol | string | NewableFunction) => inject(id);\nexport const Store = () => Use(Symbol.for('Store'));\nexport const EventBus = () => Use(Symbol.for('EventBus'));\n","import { injectable } from '@inversifyjs/core';\n\nexport abstract class IMessage {\n  handle(...args: any[]): Promise<void> | void {\n    throw new Error('Method not implemented.');\n  }\n}\n\nexport function Message(name: string) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('name', name, constructor);\n    return constructor;\n  };\n}\n","import { IJob, JobContext } from './IJob';\n\nexport abstract class Job<T = unknown> implements IJob<T> {\n  constructor(public readonly data?: T) {}\n\n  abstract handle(context?: JobContext): Promise<void> | void;\n\n  pause?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} paused`);\n  }\n\n  resume?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} resumed`);\n  }\n\n  stop?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} stopped`);\n  }\n}\n","import { injectable } from '@inversifyjs/core';\nimport { JobOptions } from '../core/JobOptions';\n\nexport function JobConfig<T extends new (...args: any[]) => any>(options: JobOptions = {}) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('job:options', options, constructor);\n    return constructor;\n  };\n}\n","import { JobConfig } from './Job';\n\nexport const Delay = (ms: number) => JobConfig({ delay: ms });\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the Every decorator.\n */\nexport interface EveryOptions {\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n\n  /**\n   * Explicit job name (survives minification). Recommended for production builds.\n   */\n  name?: string;\n\n  /**\n   * If true, job starts paused and must be resumed manually via Scheduler.resume()\n   */\n  startPaused?: boolean;\n}\n\n/**\n * Decorator for scheduling jobs using cron expressions.\n *\n * @param cron - Cron expression (e.g., '0 *\\/5 * * * *' for every 5 minutes)\n * @param options - Optional configuration for the job\n *\n * @example\n * ```typescript\n * // Basic usage - runs every 5 minutes\n * @Every('0 *\\/5 * * * *')\n * export class MyJob { ... }\n *\n * // With options - only runs when popup is visible\n * @Every('0 *\\/5 * * * *', { requiresPopup: true, name: 'MyJob' })\n * export class MyJob { ... }\n * ```\n */\nexport function Every(cron: string, options?: EveryOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        cron,\n        requiresPopup: options?.requiresPopup ?? false,\n        startPaused: options?.startPaused ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the EverySeconds decorator.\n */\nexport interface EverySecondsOptions {\n  /** If true, job starts paused and must be resumed manually via Scheduler.resume() */\n  startPaused?: boolean;\n\n  /** Explicit job name (survives minification). Required for production builds. */\n  name?: string;\n\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n}\n\n/**\n * Decorator for jobs that run at a specific interval in seconds.\n * Unlike cron expressions which have minute-level granularity,\n * this decorator allows for second-level precision.\n *\n * @param seconds - The interval in seconds between job executions\n * @param options - Optional configuration (startPaused, name, requiresPopup, etc.)\n *\n * @example\n * ```typescript\n * // Auto-starting job (default)\n * @EverySeconds(5, { name: 'MyJob' })\n * export class MyJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs every 5 seconds');\n *   }\n * }\n *\n * // Job that only runs when popup is visible\n * @EverySeconds(10, { name: 'UiUpdateJob', requiresPopup: true })\n * export class UiUpdateJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Only runs when user is viewing extension');\n *   }\n * }\n *\n * // Paused job that must be manually resumed\n * @EverySeconds(2, { startPaused: true, name: 'OnDemandJob' })\n * export class OnDemandJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs when resumed');\n *   }\n * }\n * ```\n */\nexport function EverySeconds(seconds: number, options?: EverySecondsOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        delay: seconds * 1000,\n        recurring: true,\n        startPaused: options?.startPaused ?? false,\n        requiresPopup: options?.requiresPopup ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","export abstract class Booteable {\n  /**\n   * Boot method to be called when the service is initialized.\n   * This method can be used to perform any setup or initialization logic.\n   */\n  abstract boot(): void;\n  /**\n   * Optional destroy method to be called when the service is being destroyed.\n   * This can be used to clean up resources or perform any necessary teardown logic.\n   */\n  destroy?(): void {\n    // Default implementation does nothing\n  }\n}\n\nexport function isBooteable(obj: any): obj is Booteable {\n  return typeof obj.boot === 'function';\n}\n\nexport function isDestroyable(obj: any): obj is Booteable {\n  return typeof obj.destroy === 'function';\n}\n"],"names":["injectable","inject"],"mappings":"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"}

package/dist/index.d.ts

@@ -3,12 +3,162 @@ import { Container } from '@inversifyjs/container';
 declare function Service(): ClassDecorator;
 declare const Use: (id: symbol | string | NewableFunction) => MethodDecorator & ParameterDecorator & PropertyDecorator;
 declare const Store: () => MethodDecorator & ParameterDecorator & PropertyDecorator;
+declare const EventBus: () => MethodDecorator & ParameterDecorator & PropertyDecorator;
 
 declare abstract class IMessage {
     handle(...args: any[]): Promise<void> | void;
 }
 declare function Message(name: string): (constructor: any) => any;
 
+/**
+ * @fileoverview Method decorator for subscribing to application events.
+ *
+ * The `@Subscribe` decorator marks a method as an event handler. During
+ * bootstrap, the framework scans all registered services and jobs for
+ * methods decorated with `@Subscribe` and wires them to the {@link AppEventBus}.
+ *
+ * @module events/Subscribe
+ *
+ * @example
+ * ```typescript
+ * import { Service, Subscribe } from '@chromahq/core';
+ *
+ * @Service()
+ * class MyService {
+ *   @Subscribe('auth:login')
+ *   async onLogin(payload: { walletId: string }) {
+ *     console.log('User logged in:', payload.walletId);
+ *   }
+ *
+ *   @Subscribe('wallet:selected')
+ *   onWalletSelected(payload: { walletId: string }) {
+ *     // handle wallet selection change
+ *   }
+ * }
+ * ```
+ */
+/** Reflect metadata key used to store subscription info on a class */
+declare const SUBSCRIBE_METADATA_KEY = "chroma:subscribe";
+/**
+ * Metadata entry stored by the @Subscribe decorator.
+ *
+ * @interface
+ */
+interface SubscribeMetadata {
+    /** The event name to subscribe to (e.g. 'auth:login') */
+    eventName: string;
+    /** The method name on the class prototype */
+    methodName: string;
+}
+/**
+ * Method decorator that subscribes the decorated method to a named event.
+ *
+ * The method will be called with the event payload whenever the event is
+ * emitted through the {@link AppEventBus}. Multiple methods on the same
+ * class can subscribe to different (or the same) events.
+ *
+ * @param eventName - the event identifier to subscribe to (e.g. 'auth:login')
+ * @returns MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * @Subscribe('auth:login')
+ * async onLogin(payload: { walletId: string }) {
+ *   await this.refreshData(payload.walletId);
+ * }
+ * ```
+ */
+declare function Subscribe(eventName: string): (target: object, propertyKey: string, _descriptor: PropertyDescriptor) => void;
+/**
+ * Read all @Subscribe metadata entries from a class constructor.
+ *
+ * @param constructor - the class constructor to inspect
+ * @returns array of subscription metadata (empty if none)
+ */
+declare function getSubscribeMetadata(constructor: Function): SubscribeMetadata[];
+
+/**
+ * @fileoverview Generic application-wide event bus.
+ *
+ * Provides a centralised pub/sub mechanism for decoupled communication
+ * between services, jobs, and handlers. The bus is created once during
+ * bootstrap, bound to the DI container, and can be injected into any
+ * `@Service()` or job via `@Use(AppEventBus)`.
+ *
+ * The framework automatically wires methods decorated with `@Subscribe`
+ * during the bootstrap phase, but manual subscriptions via {@link on}
+ * are also supported.
+ *
+ * @module events/AppEventBus
+ *
+ * @example
+ * ```typescript
+ * import { Service, EventBus } from '@chromahq/core';
+ * import type { AppEventBus } from '@chromahq/core';
+ *
+ * @Service()
+ * class AuthService {
+ *   constructor(@EventBus() private bus: AppEventBus) {}
+ *
+ *   async login(walletId: string) {
+ *     // ... perform login ...
+ *     await this.bus.emit('auth:login', { walletId });
+ *   }
+ * }
+ * ```
+ */
+/** Handler function signature for event subscriptions */
+type EventHandler<T = unknown> = (payload: T) => void | Promise<void>;
+/** DI container token for resolving the AppEventBus singleton */
+declare const EventBusToken: unique symbol;
+/**
+ * Generic application event bus.
+ *
+ * Implements a simple pub/sub pattern. Handlers are invoked in parallel
+ * via `Promise.allSettled` — a failure in one handler never prevents
+ * other handlers from executing.
+ */
+declare class AppEventBus {
+    /** Registry of all active subscriptions */
+    private subscriptions;
+    /** Auto-incrementing ID counter */
+    private nextId;
+    /**
+     * 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<T = unknown>(eventName: string, handler: EventHandler<T>, handlerName: string): () => void;
+    /**
+     * 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
+     */
+    emit<T = unknown>(eventName: string, payload?: T): Promise<void>;
+    /**
+     * Get the total number of active subscriptions.
+     * Useful for debugging and testing.
+     */
+    getSubscriptionCount(): number;
+    /**
+     * Get the number of subscriptions for a specific event.
+     *
+     * @param eventName - the event to count subscriptions for
+     */
+    getSubscriptionCountForEvent(eventName: string): number;
+    /**
+     * Remove all subscriptions. Primarily for testing.
+     */
+    clearAllSubscriptions(): void;
+}
+
 /**
  * Configuration options for scheduled jobs.
  */
@@ -601,6 +751,7 @@ declare class Scheduler {
      */
     private resumePopupDependentJobs;
     schedule(id: string, options: JobOptions): void;
+    private scheduleInternal;
     pause(id: string): void;
     resume(id: string): void;
     stop(id: string): void;
@@ -668,5 +819,5 @@ declare class JobRegistry {
     private createJobContext;
 }
 
-export { Booteable, Delay, Every, EverySeconds, IMessage, Job, JobRegistry, JobState, Message, NonceService, PopupVisibilityService, Scheduler, Service, Store, Use, arePortsClaimed, bootstrap, claimEarlyPorts, container, create, getNonceService, getPopupVisibilityService, isBooteable, isDestroyable, isEarlyListenerSetup, setupEarlyListener };
-export type { CriticalPayload, EveryOptions, EverySecondsOptions, IJob, JobContext, NonceCheckResult };
+export { AppEventBus, Booteable, Delay, EventBus, EventBusToken, Every, EverySeconds, IMessage, Job, JobRegistry, JobState, Message, NonceService, PopupVisibilityService, SUBSCRIBE_METADATA_KEY, Scheduler, Service, Store, Subscribe, Use, arePortsClaimed, bootstrap, claimEarlyPorts, container, create, getNonceService, getPopupVisibilityService, getSubscribeMetadata, isBooteable, isDestroyable, isEarlyListenerSetup, setupEarlyListener };
+export type { CriticalPayload, EventHandler, EveryOptions, EverySecondsOptions, IJob, JobContext, NonceCheckResult, SubscribeMetadata };

package/dist/index.es.js

@@ -1,5 +1,5 @@
 import { inject, injectable } from '@inversifyjs/core';
-export { J as JobRegistry, h as JobState, N as NonceService, P as PopupVisibilityService, S as Scheduler, b as arePortsClaimed, f as bootstrap, c as claimEarlyPorts, d as container, e as create, g as getNonceService, a as getPopupVisibilityService, i as isEarlyListenerSetup, s as setupEarlyListener } from './boot-c2gJZWBc.js';
+export { A as AppEventBus, E as EventBusToken, J as JobRegistry, l as JobState, N as NonceService, P as PopupVisibilityService, a as SUBSCRIBE_METADATA_KEY, k as Scheduler, S as Subscribe, e as arePortsClaimed, j as bootstrap, d as claimEarlyPorts, f as container, h as create, b as getNonceService, c as getPopupVisibilityService, g as getSubscribeMetadata, i as isEarlyListenerSetup, s as setupEarlyListener } from './boot-DPtu_qKj.js';
 import '@inversifyjs/container';
 
 function Service() {
@@ -7,6 +7,7 @@ function Service() {
 }
 const Use = (id) => inject(id);
 const Store = () => Use(/* @__PURE__ */ Symbol.for("Store"));
+const EventBus = () => Use(/* @__PURE__ */ Symbol.for("EventBus"));
 
 class IMessage {
   handle(...args) {
@@ -100,5 +101,5 @@ function isDestroyable(obj) {
   return typeof obj.destroy === "function";
 }
 
-export { Booteable, Delay, Every, EverySeconds, IMessage, Job, Message, Service, Store, Use, isBooteable, isDestroyable };
+export { Booteable, Delay, EventBus, Every, EverySeconds, IMessage, Job, Message, Service, Store, Use, isBooteable, isDestroyable };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/decorators/Service.ts","../src/decorators/Message.ts","../src/scheduler/core/Job.ts","../src/scheduler/decorators/Job.ts","../src/scheduler/decorators/Delay.ts","../src/scheduler/decorators/Every.ts","../src/scheduler/decorators/EverySeconds.ts","../src/services/booteable.ts"],"sourcesContent":["import { inject, injectable } from '@inversifyjs/core';\n\nexport function Service() {\n  return injectable();\n}\n\nexport const Use = (id: symbol | string | NewableFunction) => inject(id);\nexport const Store = () => Use(Symbol.for('Store'));\n","import { injectable } from '@inversifyjs/core';\n\nexport abstract class IMessage {\n  handle(...args: any[]): Promise<void> | void {\n    throw new Error('Method not implemented.');\n  }\n}\n\nexport function Message(name: string) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('name', name, constructor);\n    return constructor;\n  };\n}\n","import { IJob, JobContext } from './IJob';\n\nexport abstract class Job<T = unknown> implements IJob<T> {\n  constructor(public readonly data?: T) {}\n\n  abstract handle(context?: JobContext): Promise<void> | void;\n\n  pause?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} paused`);\n  }\n\n  resume?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} resumed`);\n  }\n\n  stop?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} stopped`);\n  }\n}\n","import { injectable } from '@inversifyjs/core';\nimport { JobOptions } from '../core/JobOptions';\n\nexport function JobConfig<T extends new (...args: any[]) => any>(options: JobOptions = {}) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('job:options', options, constructor);\n    return constructor;\n  };\n}\n","import { JobConfig } from './Job';\n\nexport const Delay = (ms: number) => JobConfig({ delay: ms });\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the Every decorator.\n */\nexport interface EveryOptions {\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n\n  /**\n   * Explicit job name (survives minification). Recommended for production builds.\n   */\n  name?: string;\n\n  /**\n   * If true, job starts paused and must be resumed manually via Scheduler.resume()\n   */\n  startPaused?: boolean;\n}\n\n/**\n * Decorator for scheduling jobs using cron expressions.\n *\n * @param cron - Cron expression (e.g., '0 *\\/5 * * * *' for every 5 minutes)\n * @param options - Optional configuration for the job\n *\n * @example\n * ```typescript\n * // Basic usage - runs every 5 minutes\n * @Every('0 *\\/5 * * * *')\n * export class MyJob { ... }\n *\n * // With options - only runs when popup is visible\n * @Every('0 *\\/5 * * * *', { requiresPopup: true, name: 'MyJob' })\n * export class MyJob { ... }\n * ```\n */\nexport function Every(cron: string, options?: EveryOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        cron,\n        requiresPopup: options?.requiresPopup ?? false,\n        startPaused: options?.startPaused ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the EverySeconds decorator.\n */\nexport interface EverySecondsOptions {\n  /** If true, job starts paused and must be resumed manually via Scheduler.resume() */\n  startPaused?: boolean;\n\n  /** Explicit job name (survives minification). Required for production builds. */\n  name?: string;\n\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n}\n\n/**\n * Decorator for jobs that run at a specific interval in seconds.\n * Unlike cron expressions which have minute-level granularity,\n * this decorator allows for second-level precision.\n *\n * @param seconds - The interval in seconds between job executions\n * @param options - Optional configuration (startPaused, name, requiresPopup, etc.)\n *\n * @example\n * ```typescript\n * // Auto-starting job (default)\n * @EverySeconds(5, { name: 'MyJob' })\n * export class MyJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs every 5 seconds');\n *   }\n * }\n *\n * // Job that only runs when popup is visible\n * @EverySeconds(10, { name: 'UiUpdateJob', requiresPopup: true })\n * export class UiUpdateJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Only runs when user is viewing extension');\n *   }\n * }\n *\n * // Paused job that must be manually resumed\n * @EverySeconds(2, { startPaused: true, name: 'OnDemandJob' })\n * export class OnDemandJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs when resumed');\n *   }\n * }\n * ```\n */\nexport function EverySeconds(seconds: number, options?: EverySecondsOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        delay: seconds * 1000,\n        recurring: true,\n        startPaused: options?.startPaused ?? false,\n        requiresPopup: options?.requiresPopup ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","export abstract class Booteable {\n  /**\n   * Boot method to be called when the service is initialized.\n   * This method can be used to perform any setup or initialization logic.\n   */\n  abstract boot(): void;\n  /**\n   * Optional destroy method to be called when the service is being destroyed.\n   * This can be used to clean up resources or perform any necessary teardown logic.\n   */\n  destroy?(): void {\n    // Default implementation does nothing\n  }\n}\n\nexport function isBooteable(obj: any): obj is Booteable {\n  return typeof obj.boot === 'function';\n}\n\nexport function isDestroyable(obj: any): obj is Booteable {\n  return typeof obj.destroy === 'function';\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.es.js","sources":["../src/decorators/Service.ts","../src/decorators/Message.ts","../src/scheduler/core/Job.ts","../src/scheduler/decorators/Job.ts","../src/scheduler/decorators/Delay.ts","../src/scheduler/decorators/Every.ts","../src/scheduler/decorators/EverySeconds.ts","../src/services/booteable.ts"],"sourcesContent":["import { inject, injectable } from '@inversifyjs/core';\n\nexport function Service() {\n  return injectable();\n}\n\nexport const Use = (id: symbol | string | NewableFunction) => inject(id);\nexport const Store = () => Use(Symbol.for('Store'));\nexport const EventBus = () => Use(Symbol.for('EventBus'));\n","import { injectable } from '@inversifyjs/core';\n\nexport abstract class IMessage {\n  handle(...args: any[]): Promise<void> | void {\n    throw new Error('Method not implemented.');\n  }\n}\n\nexport function Message(name: string) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('name', name, constructor);\n    return constructor;\n  };\n}\n","import { IJob, JobContext } from './IJob';\n\nexport abstract class Job<T = unknown> implements IJob<T> {\n  constructor(public readonly data?: T) {}\n\n  abstract handle(context?: JobContext): Promise<void> | void;\n\n  pause?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} paused`);\n  }\n\n  resume?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} resumed`);\n  }\n\n  stop?(): Promise<void> | void {\n    console.log(`Job ${this.constructor.name} stopped`);\n  }\n}\n","import { injectable } from '@inversifyjs/core';\nimport { JobOptions } from '../core/JobOptions';\n\nexport function JobConfig<T extends new (...args: any[]) => any>(options: JobOptions = {}) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    Reflect.defineMetadata('job:options', options, constructor);\n    return constructor;\n  };\n}\n","import { JobConfig } from './Job';\n\nexport const Delay = (ms: number) => JobConfig({ delay: ms });\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the Every decorator.\n */\nexport interface EveryOptions {\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n\n  /**\n   * Explicit job name (survives minification). Recommended for production builds.\n   */\n  name?: string;\n\n  /**\n   * If true, job starts paused and must be resumed manually via Scheduler.resume()\n   */\n  startPaused?: boolean;\n}\n\n/**\n * Decorator for scheduling jobs using cron expressions.\n *\n * @param cron - Cron expression (e.g., '0 *\\/5 * * * *' for every 5 minutes)\n * @param options - Optional configuration for the job\n *\n * @example\n * ```typescript\n * // Basic usage - runs every 5 minutes\n * @Every('0 *\\/5 * * * *')\n * export class MyJob { ... }\n *\n * // With options - only runs when popup is visible\n * @Every('0 *\\/5 * * * *', { requiresPopup: true, name: 'MyJob' })\n * export class MyJob { ... }\n * ```\n */\nexport function Every(cron: string, options?: EveryOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        cron,\n        requiresPopup: options?.requiresPopup ?? false,\n        startPaused: options?.startPaused ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","import { injectable } from '@inversifyjs/core';\n\n/**\n * Options for the EverySeconds decorator.\n */\nexport interface EverySecondsOptions {\n  /** If true, job starts paused and must be resumed manually via Scheduler.resume() */\n  startPaused?: boolean;\n\n  /** Explicit job name (survives minification). Required for production builds. */\n  name?: string;\n\n  /**\n   * If true, the job will only execute when the popup (or extension view) is visible.\n   * This reduces unnecessary background activity when the user isn't looking at the extension.\n   */\n  requiresPopup?: boolean;\n}\n\n/**\n * Decorator for jobs that run at a specific interval in seconds.\n * Unlike cron expressions which have minute-level granularity,\n * this decorator allows for second-level precision.\n *\n * @param seconds - The interval in seconds between job executions\n * @param options - Optional configuration (startPaused, name, requiresPopup, etc.)\n *\n * @example\n * ```typescript\n * // Auto-starting job (default)\n * @EverySeconds(5, { name: 'MyJob' })\n * export class MyJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs every 5 seconds');\n *   }\n * }\n *\n * // Job that only runs when popup is visible\n * @EverySeconds(10, { name: 'UiUpdateJob', requiresPopup: true })\n * export class UiUpdateJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Only runs when user is viewing extension');\n *   }\n * }\n *\n * // Paused job that must be manually resumed\n * @EverySeconds(2, { startPaused: true, name: 'OnDemandJob' })\n * export class OnDemandJob implements IJob {\n *   async handle(context: JobContext) {\n *     console.log('Runs when resumed');\n *   }\n * }\n * ```\n */\nexport function EverySeconds(seconds: number, options?: EverySecondsOptions) {\n  return function (constructor: any) {\n    injectable()(constructor);\n    // Set explicit name metadata to survive minification\n    if (options?.name) {\n      Reflect.defineMetadata('name', options.name, constructor);\n    }\n\n    Reflect.defineMetadata(\n      'job:options',\n      {\n        delay: seconds * 1000,\n        recurring: true,\n        startPaused: options?.startPaused ?? false,\n        requiresPopup: options?.requiresPopup ?? false,\n      },\n      constructor,\n    );\n    return constructor;\n  };\n}\n","export abstract class Booteable {\n  /**\n   * Boot method to be called when the service is initialized.\n   * This method can be used to perform any setup or initialization logic.\n   */\n  abstract boot(): void;\n  /**\n   * Optional destroy method to be called when the service is being destroyed.\n   * This can be used to clean up resources or perform any necessary teardown logic.\n   */\n  destroy?(): void {\n    // Default implementation does nothing\n  }\n}\n\nexport function isBooteable(obj: any): obj is Booteable {\n  return typeof obj.boot === 'function';\n}\n\nexport function isDestroyable(obj: any): obj is Booteable {\n  return typeof obj.destroy === 'function';\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chromahq/core",
-  "version": "1.0.56",
+  "version": "1.0.58",
   "description": "Core library for building Chrome extensions with Chroma framework",
   "type": "module",
   "main": "dist/index.cjs.js",