@wirestate/react 0.6.0

package/esm/development/wirestate-core/commands/command-bus.js

@@ -0,0 +1,112 @@
+import { ERROR_CODE_FAILED_TO_RESOLVE_COMMAND_HANDLER } from '../error/error-code.js';
+import { WirestateError } from '../error/wirestate-error.js';
+import { ECommandStatus } from '../types/commands.js';
+
+/**
+ * Dispatches commands to handlers.
+ *
+ * Unlike queries, command execution always wraps the handler in a promise
+ * and returns a descriptor with task, status, and responder.
+ */
+var CommandBus = /** @class */function () {
+  function CommandBus() {
+    /**
+     * Internal handler storage.
+     * Uses a stack for each command type to support shadowing.
+     */
+    this.handlers = new Map();
+  }
+  /**
+   * Registers a command handler.
+   * Returns an unregister function.
+   *
+   * @param type - command type
+   * @param handler - handler function
+   * @returns unregister function
+   */
+  CommandBus.prototype.register = function (type, handler) {
+    var _this = this;
+    var stack = this.handlers.get(type);
+    if (!stack) {
+      stack = [];
+      this.handlers.set(type, stack);
+    }
+    stack.push(handler);
+    return function () {
+      var current = _this.handlers.get(type);
+      if (!current) {
+        return;
+      }
+      var index = current.indexOf(handler);
+      if (index >= 0) {
+        current.splice(index, 1);
+      }
+      // Clean empty stacks.
+      if (current.length === 0) {
+        _this.handlers.delete(type);
+      }
+    };
+  };
+  /**
+   * Dispatches a command to the last registered handler.
+   * Wraps the handler execution in a promise and returns a descriptor.
+   *
+   * @param type - command type
+   * @param data - command payload
+   * @returns command descriptor with task, status, and responder
+   *
+   * @throws if no handler is registered
+   */
+  CommandBus.prototype.command = function (type, data) {
+    var stack = this.handlers.get(type);
+    if (!(stack === null || stack === void 0 ? void 0 : stack.length)) {
+      throw new WirestateError(ERROR_CODE_FAILED_TO_RESOLVE_COMMAND_HANDLER, "No command handler registered in container for type: '".concat(String(type), "'."));
+    }
+    var handler = stack[stack.length - 1];
+    var descriptor = {
+      task: null,
+      status: ECommandStatus.PENDING
+    };
+    descriptor.task = Promise.resolve().then(function () {
+      return handler(data);
+    }).then(function (result) {
+      descriptor.status = ECommandStatus.SETTLED;
+      return result;
+    }).catch(function (error) {
+      descriptor.status = ECommandStatus.ERROR;
+      throw error;
+    });
+    return descriptor;
+  };
+  /**
+   * Dispatches a command to the last registered handler, returning null if no handler exists.
+   *
+   * @param type - command type
+   * @param data - command payload
+   * @returns command descriptor or null if no handler is registered
+   */
+  CommandBus.prototype.commandOptional = function (type, data) {
+    var stack = this.handlers.get(type);
+    return (stack === null || stack === void 0 ? void 0 : stack.length) ? this.command(type, data) : null;
+  };
+  /**
+   * Checks if a handler is registered for the given type.
+   *
+   * @param type - command type
+   * @returns true if handler exists
+   */
+  CommandBus.prototype.has = function (type) {
+    var _a;
+    return Boolean((_a = this.handlers.get(type)) === null || _a === void 0 ? void 0 : _a.length);
+  };
+  /**
+   * Removes all registered handlers.
+   */
+  CommandBus.prototype.clear = function () {
+    this.handlers.clear();
+  };
+  return CommandBus;
+}();
+
+export { CommandBus };
+//# sourceMappingURL=command-bus.js.map

package/esm/development/wirestate-core/commands/command-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.js","sources":["../../../../../../../../../src/wirestate-core/commands/command-bus.ts"],"sourcesContent":[null],"names":["CommandBus","handlers","Map","prototype","register","type","handler","_this","stack","get","set","push","current","index","indexOf","splice","length","delete","command","data","WirestateError","ERROR_CODE_FAILED_TO_RESOLVE_COMMAND_HANDLER","concat","String","descriptor","task","status","ECommandStatus","PENDING","Promise","resolve","then","result","SETTLED","catch","error","ERROR","commandOptional","has","Boolean","_a","clear"],"mappings":"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"}

package/esm/development/wirestate-core/commands/get-command-handler-metadata.js

@@ -0,0 +1,27 @@
+import { COMMAND_HANDLER_METADATA } from '../registry.js';
+
+/**
+ * Retrieves `@OnCommand` metadata from the class hierarchy.
+ * Returns handlers ordered from base to derived class.
+ *
+ * @param instance - service instance
+ * @returns metadata list
+ * @internal
+ */
+function getCommandHandlerMetadata(instance) {
+  var constructor = instance.constructor;
+  var chain = [];
+  // Traverse prototype chain up to Object/Function
+  while (typeof constructor === "function" && constructor !== Object && constructor !== Function.prototype) {
+    var own = COMMAND_HANDLER_METADATA.get(constructor);
+    if (own && own.length > 0) {
+      chain.push(own);
+    }
+    constructor = Object.getPrototypeOf(constructor);
+  }
+  // Reverse to ensure parent-first execution order.
+  return chain.reverse().flat();
+}
+
+export { getCommandHandlerMetadata };
+//# sourceMappingURL=get-command-handler-metadata.js.map

package/esm/development/wirestate-core/commands/get-command-handler-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-command-handler-metadata.js","sources":["../../../../../../../../../src/wirestate-core/commands/get-command-handler-metadata.ts"],"sourcesContent":[null],"names":["getCommandHandlerMetadata","instance","constructor","chain","Object","Function","prototype","own","COMMAND_HANDLER_METADATA","get","length","push","getPrototypeOf","reverse","flat"],"mappings":";;AAOA;;;;;;;AAOG;AACG,SAAUA,yBAAyBA,CAACC,QAAgB,EAAA;AAMxD,EAAA,IAAIC,WAAW,GAAYD,QAAQ,CAACC,WAAW;EAE/C,IAAMC,KAAK,GAA0C,EAAE;AAEvD;AACA,EAAA,OAAO,OAAOD,WAAW,KAAK,UAAU,IAAIA,WAAW,KAAKE,MAAM,IAAIF,WAAW,KAAKG,QAAQ,CAACC,SAAS,EAAE;AACxG,IAAA,IAAMC,GAAG,GAA0CC,wBAAwB,CAACC,GAAG,CAACP,WAAqB,CAAC;AAEtG,IAAA,IAAIK,GAAG,IAAIA,GAAG,CAACG,MAAM,GAAG,CAAC,EAAE;AACzBP,MAAAA,KAAK,CAACQ,IAAI,CAACJ,GAAG,CAAC;AACjB,IAAA;AAEAL,IAAAA,WAAW,GAAGE,MAAM,CAACQ,cAAc,CAACV,WAAW,CAAC;AAClD,EAAA;AAQA;EACA,OAAOC,KAAK,CAACU,OAAO,EAAE,CAACC,IAAI,EAAE;AAC/B;;;;"}

package/esm/development/wirestate-core/container/create-ioc-container.js

@@ -0,0 +1,35 @@
+import { Container } from 'inversify';
+import { CommandBus } from '../commands/command-bus.js';
+import { WireScope } from './wire-scope.js';
+import { EventBus } from '../events/event-bus.js';
+import { QueryBus } from '../queries/query-bus.js';
+import { SEEDS_TOKEN, SEED_TOKEN } from '../registry.js';
+
+/**
+ * Creates an IoC container with framework essentials.
+ *
+ * @param options - container configuration
+ * @returns new IoC container
+ */
+function createIocContainer(options) {
+  var _a;
+  if (options === void 0) {
+    options = {};
+  }
+  var container = new Container({
+    defaultScope: "Singleton",
+    parent: options.parent
+  });
+  container.bind(EventBus).toConstantValue(new EventBus());
+  container.bind(QueryBus).toConstantValue(new QueryBus());
+  container.bind(CommandBus).toConstantValue(new CommandBus());
+  container.bind(SEEDS_TOKEN).toConstantValue(new Map());
+  container.bind(SEED_TOKEN).toConstantValue((_a = options.seed) !== null && _a !== void 0 ? _a : {});
+  container.bind(WireScope).toResolvedValue(function () {
+    return new WireScope(container);
+  }).inTransientScope();
+  return container;
+}
+
+export { createIocContainer };
+//# sourceMappingURL=create-ioc-container.js.map

package/esm/development/wirestate-core/container/create-ioc-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-ioc-container.js","sources":["../../../../../../../../../src/wirestate-core/container/create-ioc-container.ts"],"sourcesContent":[null],"names":["createIocContainer","options","container","Container","defaultScope","parent","bind","EventBus","toConstantValue","QueryBus","CommandBus","SEEDS_TOKEN","Map","SEED_TOKEN","_a","seed","WireScope","toResolvedValue","inTransientScope"],"mappings":";;;;;;;AAwBA;;;;;AAKG;AACG,SAAUA,kBAAkBA,CAACC,OAAwC,EAAA;;AAAxC,EAAA,IAAAA,OAAA,KAAA,MAAA,EAAA;IAAAA,OAAA,GAAA,EAAwC;AAAA,EAAA;AAGzE,EAAA,IAAMC,SAAS,GAAc,IAAIC,SAAS,CAAC;AACzCC,IAAAA,YAAY,EAAE,WAAW;IACzBC,MAAM,EAAEJ,OAAO,CAACI;AACjB,GAAA,CAAC;AAEFH,EAAAA,SAAS,CAACI,IAAI,CAACC,QAAQ,CAAC,CAACC,eAAe,CAAC,IAAID,QAAQ,EAAE,CAAC;AACxDL,EAAAA,SAAS,CAACI,IAAI,CAACG,QAAQ,CAAC,CAACD,eAAe,CAAC,IAAIC,QAAQ,EAAE,CAAC;AACxDP,EAAAA,SAAS,CAACI,IAAI,CAACI,UAAU,CAAC,CAACF,eAAe,CAAC,IAAIE,UAAU,EAAE,CAAC;AAC5DR,EAAAA,SAAS,CAACI,IAAI,CAACK,WAAW,CAAC,CAACH,eAAe,CAAC,IAAII,GAAG,EAAe,CAAC;EACnEV,SAAS,CAACI,IAAI,CAACO,UAAU,CAAC,CAACL,eAAe,CAAC,CAAAM,EAAA,GAAAb,OAAO,CAACc,IAAI,MAAA,IAAA,IAAAD,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAI,EAAE,CAAC;EAE9DZ,SAAS,CACNI,IAAI,CAACU,SAAS,CAAC,CACfC,eAAe,CAAC,YAAA;AAAiB,IAAA,OAAA,IAAID,SAAS,CAACd,SAAS,CAAC;AAAxB,EAAA,CAAwB,CAAC,CAC1DgB,gBAAgB,EAAE;AAIrB,EAAA,OAAOhB,SAAS;AAClB;;;;"}

package/esm/development/wirestate-core/container/wire-scope.js

@@ -0,0 +1,151 @@
+import { __decorate, __metadata } from 'tslib';
+import { injectable } from 'inversify';
+import { CommandBus } from '../commands/command-bus.js';
+import { ERROR_CODE_ACCESS_AFTER_DISPOSAL, ERROR_CODE_ACCESS_BEFORE_ACTIVATION } from '../error/error-code.js';
+import { WirestateError } from '../error/wirestate-error.js';
+import { EventBus } from '../events/event-bus.js';
+import { QueryBus } from '../queries/query-bus.js';
+import { SEEDS_TOKEN, SEED_TOKEN } from '../registry.js';
+
+/**
+ * Injectable scope providing access to wirestate buses and seeds.
+ * Each injecting service receives its own instance (transient scope).
+ * The scope is activated and deactivated automatically alongside its owner service.
+ */
+var WireScope = /** @class */function () {
+  function WireScope(container) {
+    this.container = container;
+    /**
+     * Whether the scope was deactivated and disposed from the container.
+     */
+    this.isDisposed = false;
+  }
+  /**
+   * Access the IoC container.
+   * Available only for activated instances of scope.
+   *
+   * @returns active container
+   *
+   * @throws WirestateError if scope is not activated or already disposed
+   */
+  WireScope.prototype.getContainer = function () {
+    if (this.container) {
+      return this.container;
+    }
+    if (this.isDisposed) {
+      throw new WirestateError(ERROR_CODE_ACCESS_AFTER_DISPOSAL, "WireScope::container accessed after deactivation. Ensure service is properly disposed.");
+    } else {
+      throw new WirestateError(ERROR_CODE_ACCESS_BEFORE_ACTIVATION, "WireScope::container accessed before activation. " + "Ensure service is bound to container and is properly resolved.");
+    }
+  };
+  /**
+   * Resolves a sibling service or injected value.
+   * Use for lazy resolution or circular dependency breaking.
+   * Available only for activated containers.
+   *
+   * @param injectionId - injection identifier
+   * @returns resolved injection, service instance, or generic value
+   *
+   * @throws WirestateError if scope is not activated
+   */
+  WireScope.prototype.resolve = function (injectionId) {
+    return this.getContainer().get(injectionId);
+  };
+  /**
+   * Resolves a sibling service or injected value.
+   * Use for lazy resolution or circular dependency breaking.
+   * Available only for activated containers.
+   *
+   * @param injectionId - injection identifier
+   * @returns resolved injection, service instance, generic value, or null if it is not bound
+   *
+   * @throws WirestateError if scope is not activated
+   */
+  WireScope.prototype.resolveOptional = function (injectionId) {
+    var container = this.getContainer();
+    return container.isBound(injectionId) ? container.get(injectionId) : null;
+  };
+  /**
+   * Broadcasts an event.
+   * Available only for activated containers.
+   *
+   * @param type - type of event to emit
+   * @param payload - optional payload to send with the event
+   * @param from - optional sender of the event
+   *
+   * @throws WirestateError if scope is not activated
+   */
+  WireScope.prototype.emitEvent = function (type, payload, from) {
+    this.getContainer().get(EventBus).emit({
+      type: type,
+      payload: payload,
+      from: from === undefined ? this : from
+    });
+  };
+  /**
+   * Dispatches a query and returns the result.
+   * Available only for activated containers.
+   *
+   * @param type - query type
+   * @param data - query data
+   * @returns query result
+   *
+   * @throws WirestateError if scope is not activated
+   */
+  WireScope.prototype.queryData = function (type, data) {
+    return this.getContainer().get(QueryBus).query(type, data);
+  };
+  /**
+   * Dispatches a query and returns the result.
+   * Available only for activated containers.
+   *
+   * @param type - query type
+   * @param data - query data
+   * @returns query result or null if handler is not registered
+   */
+  WireScope.prototype.queryOptionalData = function (type, data) {
+    return this.getContainer().get(QueryBus).queryOptional(type, data);
+  };
+  /**
+   * Dispatches a command and returns the descriptor.
+   * Available only for activated containers.
+   *
+   * @param type - command type
+   * @param data - command data
+   * @returns command descriptor
+   *
+   * @throws WirestateError if scope is not activated
+   */
+  WireScope.prototype.executeCommand = function (type, data) {
+    return this.getContainer().get(CommandBus).command(type, data);
+  };
+  /**
+   * Dispatches a command and returns the descriptor.
+   * Available only for activated containers.
+   *
+   * @param type - command type
+   * @param data - command data
+   * @returns command descriptor or null if handler is not registered
+   */
+  WireScope.prototype.executeOptionalCommand = function (type, data) {
+    return this.getContainer().get(CommandBus).commandOptional(type, data);
+  };
+  /**
+   * Reads seed for the provided injection.
+   * Returns shared seed if parameters are not provided.
+   * Available only for activated containers.
+   *
+   * @param seed - lookup key
+   * @returns seed data or null if missing
+   *
+   * @throws WirestateError if context is not activated
+   */
+  WireScope.prototype.getSeed = function (seed) {
+    return seed ? this.getContainer().get(SEEDS_TOKEN).get(seed) || null : this.getContainer().get(SEED_TOKEN);
+  };
+  WireScope = __decorate([injectable(), __metadata("design:paramtypes", [Object])], WireScope);
+  return WireScope;
+}();
+
+export { WireScope };
+//# sourceMappingURL=wire-scope.js.map

package/esm/development/wirestate-core/container/wire-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-scope.js","sources":["../../../../../../../../../src/wirestate-core/container/wire-scope.ts"],"sourcesContent":[null],"names":["WireScope","container","isDisposed","prototype","getContainer","WirestateError","ERROR_CODE_ACCESS_AFTER_DISPOSAL","ERROR_CODE_ACCESS_BEFORE_ACTIVATION","resolve","injectionId","get","resolveOptional","isBound","emitEvent","type","payload","from","EventBus","emit","undefined","queryData","data","QueryBus","query","queryOptionalData","queryOptional","executeCommand","CommandBus","command","executeOptionalCommand","commandOptional","getSeed","seed","SEEDS_TOKEN","SEED_TOKEN","__decorate","injectable"],"mappings":"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"}

package/esm/development/wirestate-core/error/error-code.js

@@ -0,0 +1,10 @@
+var ERROR_CODE_GENERIC = 1;
+var ERROR_CODE_INVALID_ARGUMENTS = 51;
+var ERROR_CODE_BINDING_SCOPE = 52;
+var ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER = 101;
+var ERROR_CODE_FAILED_TO_RESOLVE_COMMAND_HANDLER = 102;
+var ERROR_CODE_ACCESS_BEFORE_ACTIVATION = 200;
+var ERROR_CODE_ACCESS_AFTER_DISPOSAL = 201;
+
+export { ERROR_CODE_ACCESS_AFTER_DISPOSAL, ERROR_CODE_ACCESS_BEFORE_ACTIVATION, ERROR_CODE_BINDING_SCOPE, ERROR_CODE_FAILED_TO_RESOLVE_COMMAND_HANDLER, ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER, ERROR_CODE_GENERIC, ERROR_CODE_INVALID_ARGUMENTS };
+//# sourceMappingURL=error-code.js.map

package/esm/development/wirestate-core/error/error-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-code.js","sources":["../../../../../../../../../src/wirestate-core/error/error-code.ts"],"sourcesContent":[null],"names":["ERROR_CODE_GENERIC","ERROR_CODE_INVALID_ARGUMENTS","ERROR_CODE_BINDING_SCOPE","ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER","ERROR_CODE_FAILED_TO_RESOLVE_COMMAND_HANDLER","ERROR_CODE_ACCESS_BEFORE_ACTIVATION","ERROR_CODE_ACCESS_AFTER_DISPOSAL"],"mappings":"AAAO,IAAMA,kBAAkB,GAAW;AAGnC,IAAMC,4BAA4B,GAAW;AAC7C,IAAMC,wBAAwB,GAAW;AAGzC,IAAMC,0CAA0C,GAAW;AAC3D,IAAMC,4CAA4C,GAAW;AAE7D,IAAMC,mCAAmC,GAAW;AACpD,IAAMC,gCAAgC,GAAW;;;;"}

package/esm/development/wirestate-core/error/wirestate-error.js

@@ -0,0 +1,29 @@
+import { __extends } from 'tslib';
+import { ERROR_CODE_GENERIC } from './error-code.js';
+
+/**
+ * A custom error class that contains generic error information for Wirestate-related issues.
+ *
+ * This class extends the native `Error` class and is used to represent errors specific
+ * to the Wirestate library, providing more structured error handling.
+ */
+var WirestateError = /** @class */function (_super) {
+  __extends(WirestateError, _super);
+  function WirestateError(code, detail) {
+    if (code === void 0) {
+      code = ERROR_CODE_GENERIC;
+    }
+    var _this = _super.call(this) || this;
+    /**
+     * Name or error class to help differentiate error class in minified environments.
+     */
+    _this.name = "WirestateError";
+    _this.code = code;
+    _this.message = detail || "Wirestate error.";
+    return _this;
+  }
+  return WirestateError;
+}(Error);
+
+export { WirestateError };
+//# sourceMappingURL=wirestate-error.js.map

package/esm/development/wirestate-core/error/wirestate-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wirestate-error.js","sources":["../../../../../../../../../src/wirestate-core/error/wirestate-error.ts"],"sourcesContent":[null],"names":["WirestateError","_super","__extends","code","detail","ERROR_CODE_GENERIC","_this","name","message","Error"],"mappings":";;;AAEA;;;;;AAKG;AACH,IAAAA,cAAA,gBAAA,UAAAC,MAAA,EAAA;AAAoCC,EAAAA,SAAA,CAAAF,cAAA,EAAAC,MAAA,CAAA;AAclC,EAAA,SAAAD,cAAAA,CAAmBG,IAAiC,EAAEC,MAAe,EAAA;AAAlD,IAAA,IAAAD,IAAA,KAAA,MAAA,EAAA;AAAAA,MAAAA,IAAA,GAAAE,kBAAiC;AAAA,IAAA;IAClD,IAAAC,KAAA,GAAAL,MAAK,WAAE,IAAA,IAAA;AAdT;;AAEG;IACaK,KAAA,CAAAC,IAAI,GAAW,gBAAgB;IAa7CD,KAAI,CAACH,IAAI,GAAGA,IAAI;AAChBG,IAAAA,KAAI,CAACE,OAAO,GAAGJ,MAAM,IAAI,kBAAkB;;AAC7C,EAAA;AACF,EAAA,OAAAJ,cAAC;AAAD,CApBA,CAAoCS,KAAK;;;;"}

package/esm/development/wirestate-core/events/build-event-dispatcher.js

@@ -0,0 +1,39 @@
+import { getEventHandlerMetadata } from './get-event-handler-metadata.js';
+
+/**
+ * Composes service event handlers into a single dispatcher.
+ *
+ * @param instance - service instance
+ * @returns event handler or null if no handlers are declared
+ * @internal
+ */
+function buildEventDispatcher(instance) {
+  var entries = [];
+  // Register methods decorated with @OnEvent.
+  for (var _i = 0, _a = getEventHandlerMetadata(instance); _i < _a.length; _i++) {
+    var meta = _a[_i];
+    var method = instance[meta.methodName];
+    if (typeof method === "function") {
+      entries.push({
+        types: meta.types,
+        handler: method.bind(instance)
+      });
+    }
+  }
+  if (entries.length) {
+    return function (event) {
+      // Fan out events to all matching handlers.
+      for (var _i = 0, entries_1 = entries; _i < entries_1.length; _i++) {
+        var entry = entries_1[_i];
+        if (entry.types === null || entry.types.includes(event.type)) {
+          entry.handler(event);
+        }
+      }
+    };
+  } else {
+    return null;
+  }
+}
+
+export { buildEventDispatcher };
+//# sourceMappingURL=build-event-dispatcher.js.map

package/esm/development/wirestate-core/events/build-event-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-event-dispatcher.js","sources":["../../../../../../../../../src/wirestate-core/events/build-event-dispatcher.ts"],"sourcesContent":[null],"names":["buildEventDispatcher","instance","entries","_i","_a","getEventHandlerMetadata","length","meta","method","methodName","push","types","handler","bind","event","entries_1","entry","includes","type"],"mappings":";;AAOA;;;;;;AAMG;AACG,SAAUA,oBAAoBA,CAAmBC,QAAW,EAAA;EAGhE,IAAMC,OAAO,GAA+B,EAAE;AAE9C;EACA,KAAmB,IAAAC,EAAA,GAAA,CAAiC,EAAjCC,EAAA,GAAAC,uBAAuB,CAACJ,QAAQ,CAAC,EAAjCE,EAAA,GAAAC,EAAA,CAAAE,MAAiC,EAAjCH,EAAA,EAAiC,EAAE;AAAjD,IAAA,IAAMI,IAAI,GAAAH,EAAA,CAAAD,EAAA,CAAA;AACb,IAAA,IAAMK,MAAM,GAAIP,QAAwD,CAACM,IAAI,CAACE,UAAU,CAAC;AAEzF,IAAA,IAAI,OAAOD,MAAM,KAAK,UAAU,EAAE;MAChCN,OAAO,CAACQ,IAAI,CAAC;QACXC,KAAK,EAAEJ,IAAI,CAACI,KAAK;AACjBC,QAAAA,OAAO,EAAGJ,MAAwB,CAACK,IAAI,CAACZ,QAAQ;AACjD,OAAA,CAAC;AACJ,IAAA;AACF,EAAA;EAEA,IAAIC,OAAO,CAACI,MAAM,EAAE;IAOlB,OAAO,UAACQ,KAAK,EAAA;AACX;AACA,MAAA,KAAoB,IAAAX,EAAA,GAAA,CAAO,EAAPY,SAAA,GAAAb,OAAO,EAAPC,qBAAO,EAAPA,EAAA,EAAO,EAAE;AAAxB,QAAA,IAAMa,KAAK,GAAAD,SAAA,CAAAZ,EAAA,CAAA;AACd,QAAA,IAAIa,KAAK,CAACL,KAAK,KAAK,IAAI,IAAIK,KAAK,CAACL,KAAK,CAACM,QAAQ,CAACH,KAAK,CAACI,IAAI,CAAC,EAAE;AAC5DF,UAAAA,KAAK,CAACJ,OAAO,CAACE,KAAK,CAAC;AACtB,QAAA;AACF,MAAA;IACF,CAAC;AACH,EAAA,CAAC,MAAM;AAOL,IAAA,OAAO,IAAI;AACb,EAAA;AACF;;;;"}

package/esm/development/wirestate-core/events/event-bus.js

@@ -0,0 +1,52 @@
+/**
+ * Dispatches events to subscribers.
+ */
+var EventBus = /** @class */function () {
+  function EventBus() {
+    this.handlers = new Set();
+  }
+  /**
+   * Broadcasts an event to all subscribers.
+   *
+   * @param event - event to emit
+   */
+  EventBus.prototype.emit = function (event) {
+    // Snapshot prevents concurrent modification errors if handlers sub/unsub during emit.
+    var snapshot = Array.from(this.handlers);
+    for (var _i = 0, snapshot_1 = snapshot; _i < snapshot_1.length; _i++) {
+      var handler = snapshot_1[_i];
+      try {
+        handler(event);
+      } catch (error) {
+        // Prevent one failing listener from stalling the entire bus.
+        console.error("[wirestate] Event handler threw:", error);
+      }
+    }
+  };
+  /**
+   * Subscribes a handler to all events.
+   * Returns an unsubscribe function.
+   *
+   * @param handler - event handler function
+   * @returns unsubscribe function
+   */
+  EventBus.prototype.subscribe = function (handler) {
+    var _this = this;
+    this.handlers.add(handler);
+    return function () {
+      _this.handlers.delete(handler);
+    };
+  };
+  /**
+   * Removes all registered handlers.
+   *
+   * @internal
+   */
+  EventBus.prototype.clear = function () {
+    this.handlers.clear();
+  };
+  return EventBus;
+}();
+
+export { EventBus };
+//# sourceMappingURL=event-bus.js.map

package/esm/development/wirestate-core/events/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sources":["../../../../../../../../../src/wirestate-core/events/event-bus.ts"],"sourcesContent":[null],"names":["EventBus","handlers","Set","prototype","emit","event","snapshot","Array","from","_i","snapshot_1","handler","error","console","subscribe","_this","add","delete","clear"],"mappings":"AAKA;;AAEG;AACH,IAAAA,QAAA,gBAAA,YAAA;EAAA,SAAAA,QAAAA,GAAA;AACmB,IAAA,IAAA,CAAAC,QAAQ,GAAuB,IAAIC,GAAG,EAAE;AAsD3D,EAAA;AApDE;;;;AAIG;AACIF,EAAAA,QAAA,CAAAG,SAAA,CAAAC,IAAI,GAAX,UAAyEC,KAAsB,EAAA;AAC7F;IACA,IAAMC,QAAQ,GAAyBC,KAAK,CAACC,IAAI,CAAC,IAAI,CAACP,QAAQ,CAAC;AAEhE,IAAA,KAAsB,IAAAQ,EAAA,GAAA,CAAQ,EAARC,UAAA,GAAAJ,QAAQ,EAARG,sBAAQ,EAARA,EAAA,EAAQ,EAAE;AAA3B,MAAA,IAAME,OAAO,GAAAD,UAAA,CAAAD,EAAA,CAAA;MAChB,IAAI;QACFE,OAAO,CAACN,KAAK,CAAC;MAChB,CAAC,CAAC,OAAOO,KAAK,EAAE;AACd;AACAC,QAAAA,OAAO,CAACD,KAAK,CAAC,kCAAkC,EAAEA,KAAK,CAAC;AAC1D,MAAA;AACF,IAAA;EACF,CAAC;AAED;;;;;;AAMG;AACIZ,EAAAA,QAAA,CAAAG,SAAA,CAAAW,SAAS,GAAhB,UAAiBH,OAAsB,EAAA;IAAvC,IAAAI,KAAA,GAAA,IAAA;AAME,IAAA,IAAI,CAACd,QAAQ,CAACe,GAAG,CAACL,OAAO,CAAC;AAE1B,IAAA,OAAO,YAAA;AAMLI,MAAAA,KAAI,CAACd,QAAQ,CAACgB,MAAM,CAACN,OAAO,CAAC;IAC/B,CAAC;EACH,CAAC;AAED;;;;AAIG;AACIX,EAAAA,QAAA,CAAAG,SAAA,CAAAe,KAAK,GAAZ,YAAA;AACE,IAAA,IAAI,CAACjB,QAAQ,CAACiB,KAAK,EAAE;EACvB,CAAC;AACH,EAAA,OAAAlB,QAAC;AAAD,CAAC;;;;"}

package/esm/development/wirestate-core/events/get-event-handler-metadata.js

@@ -0,0 +1,27 @@
+import { EVENT_HANDLER_METADATA } from '../registry.js';
+
+/**
+ * Retrieves `@OnEvent` metadata from the class hierarchy.
+ * Returns handlers ordered from base to derived class.
+ *
+ * @param instance - service instance
+ * @returns metadata list
+ * @internal
+ */
+function getEventHandlerMetadata(instance) {
+  var constructor = instance.constructor;
+  var chain = [];
+  // Traverse prototype chain up to Object/Function
+  while (typeof constructor === "function" && constructor !== Object && constructor !== Function.prototype) {
+    var own = EVENT_HANDLER_METADATA.get(constructor);
+    if (own && own.length > 0) {
+      chain.push(own);
+    }
+    constructor = Object.getPrototypeOf(constructor);
+  }
+  // Reverse to ensure parent-first execution order
+  return chain.reverse().flat();
+}
+
+export { getEventHandlerMetadata };
+//# sourceMappingURL=get-event-handler-metadata.js.map

package/esm/development/wirestate-core/events/get-event-handler-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-event-handler-metadata.js","sources":["../../../../../../../../../src/wirestate-core/events/get-event-handler-metadata.ts"],"sourcesContent":[null],"names":["getEventHandlerMetadata","instance","constructor","chain","Object","Function","prototype","own","EVENT_HANDLER_METADATA","get","length","push","getPrototypeOf","reverse","flat"],"mappings":";;AAOA;;;;;;;AAOG;AACG,SAAUA,uBAAuBA,CAACC,QAAgB,EAAA;AAGtD,EAAA,IAAIC,WAAW,GAAYD,QAAQ,CAACC,WAAW;EAE/C,IAAMC,KAAK,GAAwC,EAAE;AAErD;AACA,EAAA,OAAO,OAAOD,WAAW,KAAK,UAAU,IAAIA,WAAW,KAAKE,MAAM,IAAIF,WAAW,KAAKG,QAAQ,CAACC,SAAS,EAAE;AACxG,IAAA,IAAMC,GAAG,GAAwCC,sBAAsB,CAACC,GAAG,CAACP,WAAqB,CAAC;AAElG,IAAA,IAAIK,GAAG,IAAIA,GAAG,CAACG,MAAM,GAAG,CAAC,EAAE;AACzBP,MAAAA,KAAK,CAACQ,IAAI,CAACJ,GAAG,CAAC;AACjB,IAAA;AAEAL,IAAAA,WAAW,GAAGE,MAAM,CAACQ,cAAc,CAACV,WAAW,CAAC;AAClD,EAAA;AAQA;EACA,OAAOC,KAAK,CAACU,OAAO,EAAE,CAACC,IAAI,EAAE;AAC/B;;;;"}

package/esm/development/wirestate-core/queries/get-query-handler-metadata.js

@@ -0,0 +1,27 @@
+import { QUERY_HANDLER_METADATA } from '../registry.js';
+
+/**
+ * Retrieves `@OnQuery` metadata from the class hierarchy.
+ * Returns handlers ordered from base to derived class.
+ *
+ * @param instance - service instance
+ * @returns metadata list
+ * @internal
+ */
+function getQueryHandlerMetadata(instance) {
+  var constructor = instance.constructor;
+  var chain = [];
+  // Traverse prototype chain up to Object/Function
+  while (typeof constructor === "function" && constructor !== Object && constructor !== Function.prototype) {
+    var own = QUERY_HANDLER_METADATA.get(constructor);
+    if (own && own.length > 0) {
+      chain.push(own);
+    }
+    constructor = Object.getPrototypeOf(constructor);
+  }
+  // Reverse to ensure parent-first execution order.
+  return chain.reverse().flat();
+}
+
+export { getQueryHandlerMetadata };
+//# sourceMappingURL=get-query-handler-metadata.js.map

package/esm/development/wirestate-core/queries/get-query-handler-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-query-handler-metadata.js","sources":["../../../../../../../../../src/wirestate-core/queries/get-query-handler-metadata.ts"],"sourcesContent":[null],"names":["getQueryHandlerMetadata","instance","constructor","chain","Object","Function","prototype","own","QUERY_HANDLER_METADATA","get","length","push","getPrototypeOf","reverse","flat"],"mappings":";;AAOA;;;;;;;AAOG;AACG,SAAUA,uBAAuBA,CAACC,QAAgB,EAAA;AAGtD,EAAA,IAAIC,WAAW,GAAYD,QAAQ,CAACC,WAAW;EAE/C,IAAMC,KAAK,GAAwC,EAAE;AAErD;AACA,EAAA,OAAO,OAAOD,WAAW,KAAK,UAAU,IAAIA,WAAW,KAAKE,MAAM,IAAIF,WAAW,KAAKG,QAAQ,CAACC,SAAS,EAAE;AACxG,IAAA,IAAMC,GAAG,GAAwCC,sBAAsB,CAACC,GAAG,CAACP,WAAqB,CAAC;AAElG,IAAA,IAAIK,GAAG,IAAIA,GAAG,CAACG,MAAM,GAAG,CAAC,EAAE;AACzBP,MAAAA,KAAK,CAACQ,IAAI,CAACJ,GAAG,CAAC;AACjB,IAAA;AAEAL,IAAAA,WAAW,GAAGE,MAAM,CAACQ,cAAc,CAACV,WAAW,CAAC;AAClD,EAAA;AAQA;EACA,OAAOC,KAAK,CAACU,OAAO,EAAE,CAACC,IAAI,EAAE;AAC/B;;;;"}