@tachybase/utils 0.23.8

package/lib/requireModule.js

@@ -0,0 +1,64 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var requireModule_exports = {};
+__export(requireModule_exports, {
+  default: () => requireModule_default,
+  importModule: () => importModule,
+  requireModule: () => requireModule
+});
+module.exports = __toCommonJS(requireModule_exports);
+var import_path = __toESM(require("path"));
+var import_url = require("url");
+function requireModule(m) {
+  if (typeof m === "string") {
+    m = require(m);
+  }
+  if (typeof m !== "object") {
+    return m;
+  }
+  return m.__esModule ? m.default : m;
+}
+__name(requireModule, "requireModule");
+var requireModule_default = requireModule;
+async function importModule(m) {
+  if (!process.env.VITEST) {
+    return requireModule(m);
+  }
+  if (import_path.default.isAbsolute(m)) {
+    m = (0, import_url.pathToFileURL)(m).href;
+  }
+  const r = (await import(m)).default;
+  return r.__esModule ? r.default : r;
+}
+__name(importModule, "importModule");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  importModule,
+  requireModule
+});

package/lib/toposort.d.ts

@@ -0,0 +1,13 @@
+import Topo from '@hapi/topo';
+export interface ToposortOptions extends Topo.Options {
+    tag?: string;
+    group?: string;
+    unique?: boolean;
+}
+export declare class Toposort<T> extends Topo.Sorter<T> {
+    #private;
+    unshift(...items: any[]): void;
+    push(...items: any[]): void;
+    add(nodes: T | T[], options?: ToposortOptions): T[];
+}
+export default Toposort;

package/lib/toposort.js

@@ -0,0 +1,90 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var toposort_exports = {};
+__export(toposort_exports, {
+  Toposort: () => Toposort,
+  default: () => toposort_default
+});
+module.exports = __toCommonJS(toposort_exports);
+var import_topo = __toESM(require("@hapi/topo"));
+var _tags;
+const _Toposort = class _Toposort extends import_topo.default.Sorter {
+  constructor() {
+    super(...arguments);
+    __privateAdd(this, _tags, /* @__PURE__ */ new Set());
+  }
+  unshift(...items) {
+    this._items.unshift(
+      ...items.map((node) => ({
+        node,
+        seq: this._items.length,
+        sort: 0,
+        before: [],
+        after: [],
+        group: "?"
+      }))
+    );
+  }
+  push(...items) {
+    this._items.push(
+      ...items.map((node) => ({
+        node,
+        seq: this._items.length,
+        sort: 0,
+        before: [],
+        after: [],
+        group: "?"
+      }))
+    );
+  }
+  add(nodes, options) {
+    if (options == null ? void 0 : options.tag) {
+      options.group = options.tag;
+      if (__privateGet(this, _tags).has(options.tag) && options.unique) {
+        return;
+      }
+      __privateGet(this, _tags).add(options.tag);
+    }
+    return super.add(nodes, options);
+  }
+};
+_tags = new WeakMap();
+__name(_Toposort, "Toposort");
+let Toposort = _Toposort;
+var toposort_default = Toposort;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Toposort
+});

package/lib/typedi/container-instance.class.d.ts

@@ -0,0 +1,109 @@
+import { Handler } from './interfaces/handler.interface';
+import { ServiceOptions } from './interfaces/service-options.interface';
+import { ContainerIdentifier } from './types/container-identifier.type';
+import { ServiceIdentifier } from './types/service-identifier.type';
+/**
+ * TypeDI can have multiple containers.
+ * One container is ContainerInstance.
+ */
+export declare class ContainerInstance {
+    /** Container instance id. */
+    readonly id: ContainerIdentifier;
+    /** Metadata for all registered services in this container. */
+    private metadataMap;
+    /**
+     * Services registered with 'multiple: true' are saved as simple services
+     * with a generated token and the mapping between the original ID and the
+     * generated one is stored here. This is handled like this to allow simplifying
+     * the inner workings of the service instance.
+     */
+    private multiServiceIds;
+    /**
+     * All registered handlers. The @Inject() decorator uses handlers internally to mark a property for injection.
+     **/
+    private readonly handlers;
+    /**
+     * The default global container. By default services are registered into this
+     * container when registered via `Container.set()` or `@Service` decorator.
+     */
+    private static _default;
+    static get default(): ContainerInstance;
+    /**
+     * Indicates if the container has been disposed or not.
+     * Any function call should fail when called after being disposed.
+     *
+     * NOTE: Currently not in used
+     */
+    private disposed;
+    constructor(id: ContainerIdentifier);
+    /**
+     * Checks if the service with given name or type is registered service container.
+     * Optionally, parameters can be passed in case if instance is initialized in the container for the first time.
+     */
+    has<T = unknown>(identifier: ServiceIdentifier<T>): boolean;
+    /**
+     * Retrieves the service with given name or type from the service container.
+     * Optionally, parameters can be passed in case if instance is initialized in the container for the first time.
+     */
+    get<T = unknown>(identifier: ServiceIdentifier<T>): T;
+    /**
+     * Gets all instances registered in the container of the given service identifier.
+     * Used when service defined with multiple: true flag.
+     */
+    getMany<T = unknown>(identifier: ServiceIdentifier<T>): T[];
+    /**
+     * Sets a value for the given type or service name in the container.
+     */
+    set<T = unknown>(serviceOptions: ServiceOptions<T>): this;
+    /**
+     * Removes services with a given service identifiers.
+     */
+    remove(identifierOrIdentifierArray: ServiceIdentifier | ServiceIdentifier[]): this;
+    /**
+     * Gets a separate container instance for the given instance id.
+     */
+    of(containerId?: ContainerIdentifier): ContainerInstance;
+    /**
+     * Registers a new handler.
+     */
+    registerHandler(handler: Handler): ContainerInstance;
+    /**
+     * Helper method that imports given services.
+     */
+    import(services: Function[]): ContainerInstance;
+    /**
+     * Completely resets the container by removing all previously registered services from it.
+     */
+    reset(options?: {
+        strategy: 'resetValue' | 'resetServices';
+    }): this;
+    dispose(): Promise<void>;
+    private throwIfDisposed;
+    /**
+     * Gets the value belonging to passed in `ServiceMetadata` instance.
+     *
+     * - if `serviceMetadata.value` is already set it is immediately returned
+     * - otherwise the requested type is resolved to the value saved to `serviceMetadata.value` and returned
+     */
+    private getServiceValue;
+    /**
+     * Initializes all parameter types for a given target service class.
+     */
+    private initializeParams;
+    /**
+     * Checks if given parameter type is primitive type or not.
+     */
+    private isPrimitiveParamType;
+    /**
+     * Applies all registered handlers on a given target class.
+     */
+    private applyPropertyHandlers;
+    /**
+     * Checks if the given service metadata contains a destroyable service instance and destroys it in place. If the service
+     * contains a callable function named `destroy` it is called but not awaited and the return value is ignored..
+     *
+     * @param serviceMetadata the service metadata containing the instance to destroy
+     * @param force when true the service will be always destroyed even if it's cannot be re-created
+     */
+    private disposeServiceInstance;
+}

package/lib/typedi/container-instance.class.js

@@ -0,0 +1,349 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var container_instance_class_exports = {};
+__export(container_instance_class_exports, {
+  ContainerInstance: () => ContainerInstance
+});
+module.exports = __toCommonJS(container_instance_class_exports);
+var import_container_registry = require("./container-registry.class");
+var import_empty = require("./empty.const");
+var import_cannot_instantiate_value = require("./error/cannot-instantiate-value.error");
+var import_service_not_found = require("./error/service-not-found.error");
+var import_token = require("./token.class");
+const _ContainerInstance = class _ContainerInstance {
+  /** Container instance id. */
+  id;
+  /** Metadata for all registered services in this container. */
+  metadataMap = /* @__PURE__ */ new Map();
+  /**
+   * Services registered with 'multiple: true' are saved as simple services
+   * with a generated token and the mapping between the original ID and the
+   * generated one is stored here. This is handled like this to allow simplifying
+   * the inner workings of the service instance.
+   */
+  multiServiceIds = /* @__PURE__ */ new Map();
+  /**
+   * All registered handlers. The @Inject() decorator uses handlers internally to mark a property for injection.
+   **/
+  handlers = [];
+  static get default() {
+    if (!this._default) {
+      this._default = new _ContainerInstance("default");
+      import_container_registry.ContainerRegistry.registerContainer(this._default);
+    }
+    return this._default;
+  }
+  /**
+   * Indicates if the container has been disposed or not.
+   * Any function call should fail when called after being disposed.
+   *
+   * NOTE: Currently not in used
+   */
+  disposed = false;
+  constructor(id) {
+    this.id = id;
+    if (id !== "default") {
+      import_container_registry.ContainerRegistry.registerContainer(this);
+      this.handlers = _ContainerInstance.default.handlers || [];
+    }
+  }
+  /**
+   * Checks if the service with given name or type is registered service container.
+   * Optionally, parameters can be passed in case if instance is initialized in the container for the first time.
+   */
+  has(identifier) {
+    this.throwIfDisposed();
+    return !!this.metadataMap.has(identifier) || !!this.multiServiceIds.has(identifier);
+  }
+  /**
+   * Retrieves the service with given name or type from the service container.
+   * Optionally, parameters can be passed in case if instance is initialized in the container for the first time.
+   */
+  get(identifier) {
+    this.throwIfDisposed();
+    const global = _ContainerInstance.default.metadataMap.get(identifier);
+    const local = this.metadataMap.get(identifier);
+    const metadata = (global == null ? void 0 : global.scope) === "singleton" ? global : local;
+    if (metadata && metadata.multiple === true) {
+      throw new Error(`Cannot resolve multiple values for ${identifier.toString()} service!`);
+    }
+    if (metadata) {
+      return this.getServiceValue(metadata);
+    }
+    if (global && this !== _ContainerInstance.default) {
+      const clonedService = { ...global };
+      clonedService.value = import_empty.EMPTY_VALUE;
+      this.set(clonedService);
+      const value = this.getServiceValue(clonedService);
+      this.set({ ...clonedService, value });
+      return value;
+    }
+    throw new import_service_not_found.ServiceNotFoundError(identifier);
+  }
+  /**
+   * Gets all instances registered in the container of the given service identifier.
+   * Used when service defined with multiple: true flag.
+   */
+  getMany(identifier) {
+    this.throwIfDisposed();
+    const globalIdMap = _ContainerInstance.default.multiServiceIds.get(identifier);
+    const localIdMap = this.multiServiceIds.get(identifier);
+    if ((globalIdMap == null ? void 0 : globalIdMap.scope) === "singleton") {
+      return globalIdMap.tokens.map((generatedId) => _ContainerInstance.default.get(generatedId));
+    }
+    if (localIdMap) {
+      return localIdMap.tokens.map((generatedId) => this.get(generatedId));
+    }
+    throw new import_service_not_found.ServiceNotFoundError(identifier);
+  }
+  /**
+   * Sets a value for the given type or service name in the container.
+   */
+  set(serviceOptions) {
+    this.throwIfDisposed();
+    if (serviceOptions.scope === "singleton" && _ContainerInstance.default !== this) {
+      _ContainerInstance.default.set(serviceOptions);
+      return this;
+    }
+    const newMetadata = {
+      /**
+       * Typescript cannot understand that if ID doesn't exists then type must exists based on the
+       * typing so we need to explicitly cast this to a `ServiceIdentifier`
+       */
+      id: serviceOptions.id || serviceOptions.type,
+      type: serviceOptions.type || null,
+      factory: serviceOptions.factory,
+      value: serviceOptions.value || import_empty.EMPTY_VALUE,
+      multiple: serviceOptions.multiple || false,
+      eager: serviceOptions.eager || false,
+      scope: serviceOptions.scope || "container",
+      /** We allow overriding the above options via the received config object. */
+      ...serviceOptions,
+      referencedBy: (/* @__PURE__ */ new Map()).set(this.id, this)
+    };
+    if (serviceOptions.multiple) {
+      const maskedToken = new import_token.Token(`MultiMaskToken-${newMetadata.id.toString()}`);
+      const existingMultiGroup = this.multiServiceIds.get(newMetadata.id);
+      if (existingMultiGroup) {
+        existingMultiGroup.tokens.push(maskedToken);
+      } else {
+        this.multiServiceIds.set(newMetadata.id, { scope: newMetadata.scope, tokens: [maskedToken] });
+      }
+      newMetadata.id = maskedToken;
+      newMetadata.multiple = false;
+    }
+    const existingMetadata = this.metadataMap.get(newMetadata.id);
+    if (existingMetadata) {
+      Object.assign(existingMetadata, newMetadata);
+    } else {
+      this.metadataMap.set(newMetadata.id, newMetadata);
+    }
+    if (newMetadata.eager && newMetadata.scope !== "transient") {
+      this.get(newMetadata.id);
+    }
+    return this;
+  }
+  /**
+   * Removes services with a given service identifiers.
+   */
+  remove(identifierOrIdentifierArray) {
+    this.throwIfDisposed();
+    if (Array.isArray(identifierOrIdentifierArray)) {
+      identifierOrIdentifierArray.forEach((id) => this.remove(id));
+    } else {
+      const serviceMetadata = this.metadataMap.get(identifierOrIdentifierArray);
+      if (serviceMetadata) {
+        this.disposeServiceInstance(serviceMetadata);
+        this.metadataMap.delete(identifierOrIdentifierArray);
+      }
+    }
+    return this;
+  }
+  /**
+   * Gets a separate container instance for the given instance id.
+   */
+  of(containerId = "default") {
+    this.throwIfDisposed();
+    if (containerId === "default") {
+      return _ContainerInstance.default;
+    }
+    let container;
+    if (import_container_registry.ContainerRegistry.hasContainer(containerId)) {
+      container = import_container_registry.ContainerRegistry.getContainer(containerId);
+    } else {
+      container = new _ContainerInstance(containerId);
+    }
+    return container;
+  }
+  /**
+   * Registers a new handler.
+   */
+  registerHandler(handler) {
+    this.handlers.push(handler);
+    return this;
+  }
+  /**
+   * Helper method that imports given services.
+   */
+  import(services) {
+    this.throwIfDisposed();
+    return this;
+  }
+  /**
+   * Completely resets the container by removing all previously registered services from it.
+   */
+  reset(options = { strategy: "resetValue" }) {
+    this.throwIfDisposed();
+    switch (options.strategy) {
+      case "resetValue":
+        this.metadataMap.forEach((service) => this.disposeServiceInstance(service));
+        break;
+      case "resetServices":
+        this.metadataMap.forEach((service) => this.disposeServiceInstance(service));
+        this.metadataMap.clear();
+        this.multiServiceIds.clear();
+        break;
+      default:
+        throw new Error("Received invalid reset strategy.");
+    }
+    return this;
+  }
+  async dispose() {
+    this.reset({ strategy: "resetServices" });
+    this.disposed = true;
+    await Promise.resolve();
+  }
+  throwIfDisposed() {
+    if (this.disposed) {
+      throw new Error("Cannot use container after it has been disposed.");
+    }
+  }
+  /**
+   * Gets the value belonging to passed in `ServiceMetadata` instance.
+   *
+   * - if `serviceMetadata.value` is already set it is immediately returned
+   * - otherwise the requested type is resolved to the value saved to `serviceMetadata.value` and returned
+   */
+  getServiceValue(serviceMetadata) {
+    let value = import_empty.EMPTY_VALUE;
+    if (serviceMetadata.value !== import_empty.EMPTY_VALUE) {
+      return serviceMetadata.value;
+    }
+    if (!serviceMetadata.factory && typeof serviceMetadata.type === "undefined") {
+      throw new import_cannot_instantiate_value.CannotInstantiateValueError(serviceMetadata.id);
+    }
+    if (serviceMetadata.factory) {
+      if (serviceMetadata.factory instanceof Array) {
+        let factoryInstance;
+        try {
+          factoryInstance = this.get(serviceMetadata.factory[0]);
+        } catch (error) {
+          if (error instanceof import_service_not_found.ServiceNotFoundError) {
+            factoryInstance = new serviceMetadata.factory[0]();
+          } else {
+            throw error;
+          }
+        }
+        value = factoryInstance[serviceMetadata.factory[1]](this, serviceMetadata.id);
+      } else {
+        value = serviceMetadata.factory(this, serviceMetadata.id);
+      }
+    } else if (typeof serviceMetadata.type === "function") {
+      value = new serviceMetadata.type();
+    }
+    if (serviceMetadata.scope !== "transient" && value !== import_empty.EMPTY_VALUE) {
+      serviceMetadata.value = value;
+    }
+    if (value === import_empty.EMPTY_VALUE) {
+      throw new import_cannot_instantiate_value.CannotInstantiateValueError(serviceMetadata.id);
+    }
+    if (serviceMetadata.type) {
+      this.applyPropertyHandlers(serviceMetadata.type, value);
+    }
+    return value;
+  }
+  /**
+   * Initializes all parameter types for a given target service class.
+   */
+  initializeParams(target, paramTypes) {
+    return paramTypes.map((paramType, index) => {
+      const paramHandler = this.handlers.find((handler) => {
+        return handler.object === target && handler.index === index;
+      }) || this.handlers.find((handler) => {
+        return handler.object === Object.getPrototypeOf(target) && handler.index === index;
+      });
+      if (paramHandler) return paramHandler.value(this);
+      if (paramType && paramType.name && !this.isPrimitiveParamType(paramType.name)) {
+        return this.get(paramType);
+      }
+      return void 0;
+    });
+  }
+  /**
+   * Checks if given parameter type is primitive type or not.
+   */
+  isPrimitiveParamType(paramTypeName) {
+    return ["string", "boolean", "number", "object"].includes(paramTypeName.toLowerCase());
+  }
+  /**
+   * Applies all registered handlers on a given target class.
+   */
+  applyPropertyHandlers(target, instance) {
+    this.handlers.forEach((handler) => {
+      if (typeof handler.index === "number") return;
+      if (handler.object !== target && !(target.prototype instanceof handler.object)) return;
+      if (handler.propertyName) {
+        instance[handler.propertyName] = handler.value(this);
+      }
+    });
+  }
+  /**
+   * Checks if the given service metadata contains a destroyable service instance and destroys it in place. If the service
+   * contains a callable function named `destroy` it is called but not awaited and the return value is ignored..
+   *
+   * @param serviceMetadata the service metadata containing the instance to destroy
+   * @param force when true the service will be always destroyed even if it's cannot be re-created
+   */
+  disposeServiceInstance(serviceMetadata, force = false) {
+    this.throwIfDisposed();
+    const shouldResetValue = force || !!serviceMetadata.type || !!serviceMetadata.factory;
+    if (shouldResetValue) {
+      if (typeof (serviceMetadata == null ? void 0 : serviceMetadata.value)["dispose"] === "function") {
+        try {
+          serviceMetadata.value.dispose();
+        } catch (error) {
+        }
+      }
+      serviceMetadata.value = import_empty.EMPTY_VALUE;
+    }
+  }
+};
+__name(_ContainerInstance, "ContainerInstance");
+/**
+ * The default global container. By default services are registered into this
+ * container when registered via `Container.set()` or `@Service` decorator.
+ */
+__publicField(_ContainerInstance, "_default");
+let ContainerInstance = _ContainerInstance;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContainerInstance
+});

package/lib/typedi/container-registry.class.d.ts

@@ -0,0 +1,51 @@
+import { ContainerInstance } from './container-instance.class';
+import { ContainerIdentifier } from './types/container-identifier.type';
+/**
+ * The container registry is responsible for holding the default and every
+ * created container instance for later access.
+ *
+ * _Note: This class is for internal use and it's API may break in minor or
+ * patch releases without warning._
+ */
+export declare class ContainerRegistry {
+    /**
+     * The list of all known container. Created containers are automatically added
+     * to this list. Two container cannot be registered with the same ID.
+     *
+     * This map doesn't contains the default container.
+     */
+    private static readonly containerMap;
+    /**
+     * Registers the given container instance or throws an error.
+     *
+     * _Note: This function is auto-called when a Container instance is created,
+     * it doesn't need to be called manually!_
+     *
+     * @param container the container to add to the registry
+     */
+    static registerContainer(container: ContainerInstance): void;
+    /**
+     * Returns true if a container exists with the given ID or false otherwise.
+     *
+     * @param container the ID of the container
+     */
+    static hasContainer(id: ContainerIdentifier): boolean;
+    /**
+     * Returns the container for requested ID or throws an error if no container
+     * is registered with the given ID.
+     *
+     * @param container the ID of the container
+     */
+    static getContainer(id: ContainerIdentifier): ContainerInstance;
+    /**
+     * Removes the given container from the registry and disposes all services
+     * registered only in this container.
+     *
+     * This function throws an error if no
+     *   - container exists with the given ID
+     *   - any of the registered services threw an error during it's disposal
+     *
+     * @param container the container to remove from the registry
+     */
+    static removeContainer(container: ContainerInstance): Promise<void>;
+}