@wirestate/core 0.6.0

package/esm/development/bind/bind-service.js

@@ -0,0 +1,253 @@
+import { CommandBus } from '../commands/command-bus.js';
+import { getCommandHandlerMetadata } from '../commands/get-command-handler-metadata.js';
+import { WireScope } from '../container/wire-scope.js';
+import { buildEventDispatcher } from '../events/build-event-dispatcher.js';
+import { EventBus } from '../events/event-bus.js';
+import { getQueryHandlerMetadata } from '../queries/get-query-handler-metadata.js';
+import { QueryBus } from '../queries/query-bus.js';
+import { CONTAINER_REFS_BY_SERVICE, WIRE_SCOPES_BY_SERVICE, EVENT_UNSUBSCRIBERS_BY_SERVICE, QUERY_UNREGISTERS_BY_SERVICE, COMMAND_UNREGISTERS_BY_SERVICE } from '../registry.js';
+import { getActivatedHandlerMetadata } from '../service/get-activated-handler-metadata.js';
+import { getDeactivationHandlerMetadata } from '../service/get-deactivation-handler-metadata.js';
+
+/**
+ * Registers a service class in the container with activation/deactivation logic.
+ * Ensures container references, event subscriptions, command and query handlers are managed correctly.
+ *
+ * @param container - target Inversify container
+ * @param entry - service constructor
+ * @param options - options object to control binding flow
+ */
+function bindService(container, entry, options) {
+  // Inversify's fluent binding API only allows a single `.onActivation` /
+  // `.onDeactivation` call per chain, so we register them on the container
+  // itself instead — this also works correctly if a later call rebinds the
+  // same token.
+  var whenBind = container.bind(entry).to(entry).inSingletonScope();
+  whenBind.onActivation(function (context, instance) {
+    // Ensure flag is initialized on activation.
+    instance.IS_DISPOSED = false;
+    CONTAINER_REFS_BY_SERVICE.set(instance, container);
+    attachWireScopes(instance, entry);
+    // Compose all events listeners into a single bus subscription so we only
+    // pay one Set lookup per emitted event.
+    var dispatcher = buildEventDispatcher(instance);
+    if (dispatcher) {
+      attachEventsSubscription(instance, dispatcher);
+    }
+    // Register every `@OnQuery` handler on the container's QueryBus, and
+    // remember the unregister functions so we can roll them back when the
+    // service is deactivated.
+    var queryBus = container.get(QueryBus);
+    for (var _i = 0, _a = getQueryHandlerMetadata(instance); _i < _a.length; _i++) {
+      var meta = _a[_i];
+      var method = instance[meta.methodName];
+      if (typeof method !== "function") {
+        continue;
+      }
+      var unregister = queryBus.register(meta.type, method.bind(instance));
+      attachQueryUnregister(instance, unregister);
+    }
+    // Register every `@OnCommand` handler on the container's CommandBus, and
+    // remember the unregister functions so we can roll them back when the
+    // service is deactivated.
+    var commandBus = container.get(CommandBus);
+    for (var _b = 0, _c = getCommandHandlerMetadata(instance); _b < _c.length; _b++) {
+      var meta = _c[_b];
+      var method = instance[meta.methodName];
+      if (typeof method !== "function") {
+        continue;
+      }
+      var unregister = commandBus.register(meta.type, method.bind(instance));
+      attachCommandUnregister(instance, unregister);
+    }
+    if (options === null || options === void 0 ? void 0 : options.isWithIgnoreLifecycle) ; else {
+      var _loop_1 = function (methodName) {
+        var method = instance[methodName];
+        if (typeof method !== "function") {
+          return "continue";
+        }
+        var result = method.call(instance);
+        if (result && typeof result.then === "function") {
+          result.catch(function (error) {
+            console.error("[wirestate] @OnActivated rejected for:", entry.name, String(methodName), error);
+          });
+        }
+      };
+      // Call every `@OnActivated`-decorated method in base-to-derived order.
+      // Fire-and-forget any async init so we stay synchronous from the
+      // container's point of view.
+      for (var _d = 0, _e = getActivatedHandlerMetadata(instance); _d < _e.length; _d++) {
+        var methodName = _e[_d];
+        _loop_1(methodName);
+      }
+    }
+    return instance;
+  });
+  whenBind.onDeactivation(function (instance) {
+    if (options === null || options === void 0 ? void 0 : options.isWithIgnoreLifecycle) ; else {
+      // Call every `@OnDeactivation`-decorated method in base-to-derived order.
+      for (var _i = 0, _a = getDeactivationHandlerMetadata(instance); _i < _a.length; _i++) {
+        var methodName = _a[_i];
+        var method = instance[methodName];
+        if (typeof method === "function") {
+          method.call(instance);
+        }
+      }
+    }
+    // Flip the public disposal flag first so any async work already in
+    // flight (fetches awaiting in @Action methods, scheduled reactions,
+    // etc.) can short-circuit before it mutates the about-to-die instance.
+    // The cast is the only write-site for this `readonly` field.
+    instance.IS_DISPOSED = true;
+    detachWireScopes(instance);
+    detachCommandUnregister(instance);
+    detachQueryUnregister(instance);
+    detachEventSubscription(instance);
+    CONTAINER_REFS_BY_SERVICE.delete(instance);
+  });
+}
+/**
+ * Attaches a event subscription to a service.
+ *
+ * @param service - service instance
+ * @param handler - event handler
+ * @internal
+ */
+function attachEventsSubscription(service, handler) {
+  var _a;
+  var bus = (_a = CONTAINER_REFS_BY_SERVICE.get(service)) === null || _a === void 0 ? void 0 : _a.get(EventBus);
+  if (bus) {
+    EVENT_UNSUBSCRIBERS_BY_SERVICE.set(service, bus.subscribe(handler));
+  }
+}
+/**
+ * Detaches the event subscription from a service.
+ *
+ * @param service - service instance
+ * @internal
+ */
+function detachEventSubscription(service) {
+  var unsubscribe = EVENT_UNSUBSCRIBERS_BY_SERVICE.get(service);
+  if (unsubscribe) {
+    unsubscribe();
+    EVENT_UNSUBSCRIBERS_BY_SERVICE.delete(service);
+  }
+}
+/**
+ * Registers a query unregister function for a service.
+ *
+ * @param service - service instance
+ * @param unregister - query unregister function
+ * @internal
+ */
+function attachQueryUnregister(service, unregister) {
+  var list = QUERY_UNREGISTERS_BY_SERVICE.get(service);
+  if (!list) {
+    list = [];
+    QUERY_UNREGISTERS_BY_SERVICE.set(service, list);
+  }
+  list.push(unregister);
+}
+/**
+ * Executes and removes all query unregister functions for a service.
+ *
+ * @param service - service instance
+ * @internal
+ */
+function detachQueryUnregister(service) {
+  var list = QUERY_UNREGISTERS_BY_SERVICE.get(service);
+  if (!list) {
+    return;
+  }
+  for (var _i = 0, list_1 = list; _i < list_1.length; _i++) {
+    var unregister = list_1[_i];
+    unregister();
+  }
+  QUERY_UNREGISTERS_BY_SERVICE.delete(service);
+}
+/**
+ * Registers a command unregister function for a service.
+ *
+ * @param service - service instance
+ * @param unregister - command unregister function
+ * @internal
+ */
+function attachCommandUnregister(service, unregister) {
+  var list = COMMAND_UNREGISTERS_BY_SERVICE.get(service);
+  if (!list) {
+    list = [];
+    COMMAND_UNREGISTERS_BY_SERVICE.set(service, list);
+  }
+  list.push(unregister);
+}
+/**
+ * Executes and removes all command unregister functions for a service.
+ *
+ * @param service - service instance
+ * @internal
+ */
+function detachCommandUnregister(service) {
+  var list = COMMAND_UNREGISTERS_BY_SERVICE.get(service);
+  if (!list) {
+    return;
+  }
+  for (var _i = 0, list_2 = list; _i < list_2.length; _i++) {
+    var unregister = list_2[_i];
+    unregister();
+  }
+  COMMAND_UNREGISTERS_BY_SERVICE.delete(service);
+}
+/**
+ * Reads `design:paramtypes` from the service constructor to find parameters typed as WireScope.
+ * Property iteration happens only when the constructor metadata declares a WireScope
+ * parameter, avoiding false positives from manually created or subclassed scopes.
+ *
+ * todo: Simplify this part.
+ *
+ * @param service - service instance
+ * @param Service - service constructor
+ * @internal
+ */
+function attachWireScopes(service, Service) {
+  var paramTypes = Reflect.getMetadata("design:paramtypes", Service);
+  if (!(paramTypes === null || paramTypes === void 0 ? void 0 : paramTypes.some(function (type) {
+    return type === WireScope;
+  }))) {
+    return;
+  }
+  var scopes = [];
+  for (var _i = 0, _a = Object.getOwnPropertyNames(service); _i < _a.length; _i++) {
+    var key = _a[_i];
+    var value = service[key];
+    if ((value === null || value === void 0 ? void 0 : value.constructor) === WireScope) {
+      scopes.push(value);
+    }
+  }
+  if (scopes.length > 0) {
+    WIRE_SCOPES_BY_SERVICE.set(service, scopes);
+  }
+}
+/**
+ * Marks all injected WireScope instances for this service as disposed and removes
+ * the stored references.
+ *
+ * todo: Simplify this part.
+ *
+ * @param service - service instance
+ * @internal
+ */
+function detachWireScopes(service) {
+  var scopes = WIRE_SCOPES_BY_SERVICE.get(service);
+  if (!scopes) {
+    return;
+  }
+  for (var _i = 0, scopes_1 = scopes; _i < scopes_1.length; _i++) {
+    var scope = scopes_1[_i];
+    scope.isDisposed = true;
+    scope.container = null;
+  }
+  WIRE_SCOPES_BY_SERVICE.delete(service);
+}
+
+export { bindService };
+//# sourceMappingURL=bind-service.js.map

package/esm/development/bind/bind-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-service.js","sources":["../../../../../../../../src/wirestate-core/bind/bind-service.ts"],"sourcesContent":[null],"names":["bindService","container","entry","options","whenBind","bind","to","inSingletonScope","onActivation","context","instance","IS_DISPOSED","CONTAINER_REFS_BY_SERVICE","set","attachWireScopes","dispatcher","buildEventDispatcher","attachEventsSubscription","queryBus","get","QueryBus","_i","_a","getQueryHandlerMetadata","length","meta","method","methodName","unregister","register","type","attachQueryUnregister","commandBus","CommandBus","_b","_c","getCommandHandlerMetadata","attachCommandUnregister","isWithIgnoreLifecycle","result","call","then","catch","error","console","name","String","_d","_e","getActivatedHandlerMetadata","onDeactivation","getDeactivationHandlerMetadata","detachWireScopes","detachCommandUnregister","detachQueryUnregister","detachEventSubscription","delete","service","handler","bus","EventBus","EVENT_UNSUBSCRIBERS_BY_SERVICE","subscribe","unsubscribe","list","QUERY_UNREGISTERS_BY_SERVICE","push","list_1","COMMAND_UNREGISTERS_BY_SERVICE","list_2","Service","paramTypes","Reflect","getMetadata","some","WireScope","scopes","Object","getOwnPropertyNames","key","value","constructor","WIRE_SCOPES_BY_SERVICE","scopes_1","scope","isDisposed"],"mappings":"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"}

package/esm/development/bind/get-entry-token.js

@@ -0,0 +1,14 @@
+/**
+ * Returns the container token for a service entry.
+ * For plain service classes the class itself is the token;
+ * for descriptors the `id` field is used.
+ *
+ * @param entry - entry descriptor to get service identifier for
+ * @returns injectable identifier token
+ */
+function getEntryToken(entry) {
+  return typeof entry === "function" ? entry : entry.id;
+}
+
+export { getEntryToken };
+//# sourceMappingURL=get-entry-token.js.map

package/esm/development/bind/get-entry-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entry-token.js","sources":["../../../../../../../../src/wirestate-core/bind/get-entry-token.ts"],"sourcesContent":[null],"names":["getEntryToken","entry","id"],"mappings":"AAIA;;;;;;;AAOG;AACG,SAAUA,aAAaA,CAA4BC,KAAyC,EAAA;EAChG,OAAO,OAAOA,KAAK,KAAK,UAAU,GAAGA,KAAK,GAAGA,KAAK,CAACC,EAAE;AACvD;;;;"}

package/esm/development/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/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/commands/command-optional.js

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

package/esm/development/commands/command-optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-optional.js","sources":["../../../../../../../../src/wirestate-core/commands/command-optional.ts"],"sourcesContent":[null],"names":["commandOptional","container","type","data","get","CommandBus"],"mappings":";;AASA;;;;;;;AAOG;SACaA,eAAeA,CAC7BC,SAAoB,EACpBC,IAAO,EACPC,IAAQ,EAAA;AAIR,EAAA,OAAOF,SAAS,CAACG,GAAG,CAACC,UAAU,CAAC,CAACL,eAAe,CAAOE,IAAI,EAAEC,IAAI,CAAC;AACpE;;;;"}

package/esm/development/commands/command.js

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

package/esm/development/commands/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sources":["../../../../../../../../src/wirestate-core/commands/command.ts"],"sourcesContent":[null],"names":["command","container","type","data","get","CommandBus"],"mappings":";;AAQA;;;;;;;AAOG;SACaA,OAAOA,CACrBC,SAAoB,EACpBC,IAAO,EACPC,IAAQ,EAAA;AAIR,EAAA,OAAOF,SAAS,CAACG,GAAG,CAACC,UAAU,CAAC,CAACL,OAAO,CAAOE,IAAI,EAAEC,IAAI,CAAC;AAC5D;;;;"}

package/esm/development/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/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/commands/on-command.js

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

package/esm/development/commands/on-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-command.js","sources":["../../../../../../../../src/wirestate-core/commands/on-command.ts"],"sourcesContent":[null],"names":["OnCommand","type","target","propertyKey","constructor","list","COMMAND_HANDLER_METADATA","get","set","push","methodName"],"mappings":";;AAOA;;;;;AAKG;AACG,SAAUA,SAASA,CAACC,IAAkB,EAAA;AAC1C,EAAA,OAAO,UAACC,MAAM,EAAEC,WAAW,EAAA;AASzB,IAAA,IAAMC,WAAW,GAAGF,MAAM,CAACE,WAAW;AAEtC,IAAA,IAAIC,IAAI,GAA0CC,wBAAwB,CAACC,GAAG,CAACH,WAAW,CAAC;IAE3F,IAAI,CAACC,IAAI,EAAE;AACTA,MAAAA,IAAI,GAAG,EAAE;AACTC,MAAAA,wBAAwB,CAACE,GAAG,CAACJ,WAAW,EAAEC,IAAI,CAAC;AACjD,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/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/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;;;;"}