@wirestate/core 0.6.0

package/esm/development/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/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/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/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/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/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/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/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/events/emit-event.js

@@ -0,0 +1,20 @@
+import { EventBus } from './event-bus.js';
+
+/**
+ * Emits events for container from outside scope.
+ *
+ * @param container - inversify container
+ * @param type - event type ot emit
+ * @param payload - event payload
+ * @param from - optional indicator of the event source
+ */
+function emitEvent(container, type, payload, from) {
+  container.get(EventBus).emit({
+    type: type,
+    payload: payload,
+    from: from
+  });
+}
+
+export { emitEvent };
+//# sourceMappingURL=emit-event.js.map

package/esm/development/events/emit-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-event.js","sources":["../../../../../../../../src/wirestate-core/events/emit-event.ts"],"sourcesContent":[null],"names":["emitEvent","container","type","payload","from","get","EventBus","emit"],"mappings":";;AAQA;;;;;;;AAOG;AACG,SAAUA,SAASA,CAA0BC,SAAoB,EAAEC,IAAO,EAAEC,OAAW,EAAEC,IAAc,EAAA;AAG3GH,EAAAA,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,IAAI,CAAC;AAAEL,IAAAA,IAAI,EAAAA,IAAA;AAAEC,IAAAA,OAAO,EAAAA,OAAA;AAAEC,IAAAA,IAAI,EAAAA;AAAA,GAAE,CAAC;AACvD;;;;"}

package/esm/development/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/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/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/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/events/on-event.js

@@ -0,0 +1,29 @@
+import { __spreadArray } from 'tslib';
+import { EVENT_HANDLER_METADATA } from '../registry.js';
+
+/**
+ * Decorator for service methods that respond to events.
+ *
+ * @param types - event type(s) to handle. If omitted, handles all events
+ * @returns decorator function
+ */
+function OnEvent(types) {
+  // Normalize types to an array or null for catch-all.
+  var normalized = types === undefined ? null : Array.isArray(types) ? __spreadArray([], types, true) : [types];
+  return function (target, propertyKey) {
+    var constructor = target.constructor;
+    var list = EVENT_HANDLER_METADATA.get(constructor);
+    if (!list) {
+      list = [];
+      EVENT_HANDLER_METADATA.set(constructor, list);
+    }
+    // Register handler metadata for prototype-based retrieval.
+    list.push({
+      methodName: propertyKey,
+      types: normalized
+    });
+  };
+}
+
+export { OnEvent };
+//# sourceMappingURL=on-event.js.map

package/esm/development/events/on-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-event.js","sources":["../../../../../../../../src/wirestate-core/events/on-event.ts"],"sourcesContent":[null],"names":["OnEvent","types","normalized","undefined","Array","isArray","__spreadArray","target","propertyKey","constructor","list","EVENT_HANDLER_METADATA","get","set","push","methodName"],"mappings":";;;AAOA;;;;;AAKG;AACG,SAAUA,OAAOA,CAACC,KAA8C,EAAA;AACpE;EACA,IAAMC,UAAU,GACdD,KAAK,KAAKE,SAAS,GACf,IAAI,GACJC,KAAK,CAACC,OAAO,CAACJ,KAAK,CAAC,GACnBK,aAAA,CAAA,EAAA,EAAML,KAAmC,EAAA,IAAA,CAAA,GACxC,CAACA,KAAmB,CAAC;AAE7B,EAAA,OAAO,UAACM,MAAM,EAAEC,WAAW,EAAA;AASzB,IAAA,IAAMC,WAAW,GAAGF,MAAM,CAACE,WAAW;AAEtC,IAAA,IAAIC,IAAI,GAAwCC,sBAAsB,CAACC,GAAG,CAACH,WAAW,CAAC;IAEvF,IAAI,CAACC,IAAI,EAAE;AACTA,MAAAA,IAAI,GAAG,EAAE;AACTC,MAAAA,sBAAsB,CAACE,GAAG,CAACJ,WAAW,EAAEC,IAAI,CAAC;AAC/C,IAAA;AAEA;IACAA,IAAI,CAACI,IAAI,CAAC;AAAEC,MAAAA,UAAU,EAAEP,WAAW;AAAEP,MAAAA,KAAK,EAAEC;AAAU,KAAE,CAAC;EAC3D,CAAC;AACH;;;;"}

package/esm/development/index.js

@@ -0,0 +1,28 @@
+export { forwardRef } from './alias.js';
+export { bindEntry } from './bind/bind-entry.js';
+export { bindConstant } from './bind/bind-constant.js';
+export { bindService } from './bind/bind-service.js';
+export { getEntryToken } from './bind/get-entry-token.js';
+export { command } from './commands/command.js';
+export { commandOptional } from './commands/command-optional.js';
+export { OnCommand } from './commands/on-command.js';
+export { CommandBus } from './commands/command-bus.js';
+export { createIocContainer } from './container/create-ioc-container.js';
+export { WireScope } from './container/wire-scope.js';
+export { WirestateError } from './error/wirestate-error.js';
+export { emitEvent } from './events/emit-event.js';
+export { OnEvent } from './events/on-event.js';
+export { EventBus } from './events/event-bus.js';
+export { query } from './queries/query.js';
+export { queryOptional } from './queries/query-optional.js';
+export { QueryBus } from './queries/query-bus.js';
+export { OnQuery } from './queries/on-query.js';
+export { SEED_TOKEN as SEED, SEEDS_TOKEN as SEEDS } from './registry.js';
+export { applySeeds } from './seeds/apply-seeds.js';
+export { applySharedSeed } from './seeds/apply-shared-seed.js';
+export { unapplySeeds } from './seeds/unapply-seeds.js';
+export { OnActivated } from './service/on-activated.js';
+export { OnDeactivation } from './service/on-deactivation.js';
+export { ECommandStatus as CommandStatus } from './types/commands.js';
+export { bindingTypeValues as BindingType, Container, ContainerModule, inject as Inject, injectable as Injectable, LazyServiceIdentifier, multiInject as MultiInject, named as Named, optional as Optional, postConstruct as PostConstruct, preDestroy as PreDestroy, bindingScopeValues as ScopeBindingType, tagged as Tagged } from 'inversify';
+//# sourceMappingURL=index.js.map

package/esm/development/index.js.map

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

package/esm/development/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/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;;;;"}

package/esm/development/queries/on-query.js

@@ -0,0 +1,26 @@
+import { QUERY_HANDLER_METADATA } from '../registry.js';
+
+/**
+ * Decorator for service methods that respond to a query.
+ *
+ * @param type - query type identifier
+ * @returns decorator function
+ */
+function OnQuery(type) {
+  return function (target, propertyKey) {
+    var constructor = target.constructor;
+    var list = QUERY_HANDLER_METADATA.get(constructor);
+    if (!list) {
+      list = [];
+      QUERY_HANDLER_METADATA.set(constructor, list);
+    }
+    // Register handler metadata for prototype-based retrieval.
+    list.push({
+      methodName: propertyKey,
+      type: type
+    });
+  };
+}
+
+export { OnQuery };
+//# sourceMappingURL=on-query.js.map

package/esm/development/queries/on-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-query.js","sources":["../../../../../../../../src/wirestate-core/queries/on-query.ts"],"sourcesContent":[null],"names":["OnQuery","type","target","propertyKey","constructor","list","QUERY_HANDLER_METADATA","get","set","push","methodName"],"mappings":";;AAOA;;;;;AAKG;AACG,SAAUA,OAAOA,CAACC,IAAgB,EAAA;AACtC,EAAA,OAAO,UAACC,MAAM,EAAEC,WAAW,EAAA;AASzB,IAAA,IAAMC,WAAW,GAAGF,MAAM,CAACE,WAAW;AAEtC,IAAA,IAAIC,IAAI,GAAwCC,sBAAsB,CAACC,GAAG,CAACH,WAAW,CAAC;IAEvF,IAAI,CAACC,IAAI,EAAE;AACTA,MAAAA,IAAI,GAAG,EAAE;AACTC,MAAAA,sBAAsB,CAACE,GAAG,CAACJ,WAAW,EAAEC,IAAI,CAAC;AAC/C,IAAA;AAEA;IACAA,IAAI,CAACI,IAAI,CAAC;AAAEC,MAAAA,UAAU,EAAEP,WAAW;AAAEF,MAAAA,IAAI,EAAAA;AAAA,KAAE,CAAC;EAC9C,CAAC;AACH;;;;"}

package/esm/development/queries/query-bus.js

@@ -0,0 +1,99 @@
+import { ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER } from '../error/error-code.js';
+import { WirestateError } from '../error/wirestate-error.js';
+
+/**
+ * Dispatches queries to handlers.
+ */
+var QueryBus = /** @class */function () {
+  function QueryBus() {
+    /**
+     * Internal handler storage.
+     * Uses a stack for each query type to support shadowing (e.g., component-level vs service-level).
+     */
+    this.handlers = new Map();
+  }
+  /**
+   * Registers a query handler.
+   * Returns an unregister function.
+   *
+   * @param type - query type
+   * @param handler - handler function
+   * @returns unregister function
+   */
+  QueryBus.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 query to the last registered handler.
+   *
+   * @param type - query type
+   * @param data - query payload
+   * @returns query result
+   *
+   * @throws if no handler is registered
+   */
+  QueryBus.prototype.query = function (type, data) {
+    var stack = this.handlers.get(type);
+    // Always use the top of the stack (most recent registration) if handlers are available.
+    if (stack === null || stack === void 0 ? void 0 : stack.length) {
+      return stack[stack.length - 1](data);
+    }
+    throw new WirestateError(ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER, "No query handler registered in container for type: '".concat(String(type), "'."));
+  };
+  /**
+   * Dispatches a query to the last registered handler, returning null if no handler exists.
+   *
+   * @param type - query type
+   * @param data - query payload
+   * @returns query result or null if no handler is registered
+   */
+  QueryBus.prototype.queryOptional = function (type, data) {
+    var stack = this.handlers.get(type);
+    if (stack === null || stack === void 0 ? void 0 : stack.length) {
+      return stack[stack.length - 1](data);
+    }
+    return null;
+  };
+  /**
+   * Checks if a handler is registered for the given type.
+   *
+   * @param type - query type
+   * @returns true if handler exists
+   */
+  QueryBus.prototype.has = function (type) {
+    var stack = this.handlers.get(type);
+    return Boolean(stack && stack.length);
+  };
+  /**
+   * Removes all registered handlers.
+   *
+   * @internal
+   */
+  QueryBus.prototype.clear = function () {
+    this.handlers.clear();
+  };
+  return QueryBus;
+}();
+
+export { QueryBus };
+//# sourceMappingURL=query-bus.js.map

package/esm/development/queries/query-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-bus.js","sources":["../../../../../../../../src/wirestate-core/queries/query-bus.ts"],"sourcesContent":[null],"names":["QueryBus","handlers","Map","prototype","register","type","handler","_this","stack","get","set","push","current","index","indexOf","splice","length","delete","query","data","WirestateError","ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER","concat","String","queryOptional","has","Boolean","clear"],"mappings":"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"}

package/esm/development/queries/query-optional.js

@@ -0,0 +1,16 @@
+import { QueryBus } from './query-bus.js';
+
+/**
+ * Dispatches a query on the provided container, returning null if no handler is registered.
+ *
+ * @param container - inversify container
+ * @param type - query type
+ * @param data - query data
+ * @returns query result or null
+ */
+function queryOptional(container, type, data) {
+  return container.get(QueryBus).queryOptional(type, data);
+}
+
+export { queryOptional };
+//# sourceMappingURL=query-optional.js.map

package/esm/development/queries/query-optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-optional.js","sources":["../../../../../../../../src/wirestate-core/queries/query-optional.ts"],"sourcesContent":[null],"names":["queryOptional","container","type","data","get","QueryBus"],"mappings":";;AASA;;;;;;;AAOG;SACaA,aAAaA,CAC3BC,SAAoB,EACpBC,IAAgB,EAChBC,IAAQ,EAAA;AAIR,EAAA,OAAOF,SAAS,CAACG,GAAG,CAACC,QAAQ,CAAC,CAACL,aAAa,CAAOE,IAAI,EAAEC,IAAI,CAAC;AAChE;;;;"}

package/esm/development/queries/query.js

@@ -0,0 +1,16 @@
+import { QueryBus } from './query-bus.js';
+
+/**
+ * Dispatches a query on the provided container.
+ *
+ * @param container - inversify container
+ * @param type - query type
+ * @param data - query data
+ * @returns query result
+ */
+function query(container, type, data) {
+  return container.get(QueryBus).query(type, data);
+}
+
+export { query };
+//# sourceMappingURL=query.js.map

package/esm/development/queries/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sources":["../../../../../../../../src/wirestate-core/queries/query.ts"],"sourcesContent":[null],"names":["query","container","type","data","get","QueryBus"],"mappings":";;AASA;;;;;;;AAOG;SACaA,KAAKA,CAA2BC,SAAoB,EAAEC,IAAgB,EAAEC,IAAQ,EAAA;AAG9F,EAAA,OAAOF,SAAS,CAACG,GAAG,CAACC,QAAQ,CAAC,CAACL,KAAK,CAAOE,IAAI,EAAEC,IAAI,CAAC;AACxD;;;;"}