@expressots/core 2.16.2 → 3.0.0-beta.1

package/lib/README.md

@@ -91,7 +91,7 @@ ExpressoTS is an independent open source project with ongoing development made p
 
 ## License
 
-Distributed under the MIT License. See [`LICENSE.txt`](https://github.com/expressots/expressots/blob/main/LICENSE) for more information.
+Distributed under the MIT License. See [`LICENSE.md`](https://github.com/expressots/expressots/blob/main/LICENSE.md) for more information.
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
@@ -112,7 +112,7 @@ Distributed under the MIT License. See [`LICENSE.txt`](https://github.com/expres
 [issues-shield]: https://img.shields.io/github/issues/expressots/expressots?style=for-the-badge
 [issues-url]: https://github.com/expressots/expressots/issues
 [license-shield]: https://img.shields.io/github/license/expressots/expressots?style=for-the-badge
-[license-url]: https://github.com/expressots/expressots/blob/main/LICENSE
+[license-url]: https://github.com/expressots/expressots/blob/main/LICENSE.md
 [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
 [linkedin-url]: https://www.linkedin.com/company/expresso-ts/
 [product-screenshot]: images/screenshot.png

package/lib/cjs/application/application-container.js

@@ -1,18 +1,10 @@
 "use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppContainer = void 0;
 require("reflect-metadata");
-const inversify_1 = require("inversify");
-const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+const inversify_1 = require("../di/inversify");
+const binding_decorator_1 = require("../di/binding-decorator");
+const provider_1 = require("../provider");
 /**
  * The AppContainer class provides a container for managing dependency injection.
  * It allows the creation of a container with custom options, including default binding scope
@@ -23,8 +15,10 @@ const inversify_binding_decorators_1 = require("inversify-binding-decorators");
  * ```typescript
  * const container = new AppContainer();
  * container.create([new MyModule()]);
+ * ```
+ * @public API
  */
-let AppContainer = class AppContainer {
+class AppContainer {
     /**
      * Constructs the AppContainer instance.
      * @param options - The options for creating the container with default request scope.
@@ -52,12 +46,12 @@ let AppContainer = class AppContainer {
         };
         this.container = new inversify_1.Container(containerOptions);
         this.container.bind(inversify_1.Container).toConstantValue(this.container);
-        this.container.load((0, inversify_binding_decorators_1.buildProviderModule)(), ...modules);
-        return this.container;
+        this.container.load((0, binding_decorator_1.buildProviderModule)(), ...modules);
     }
     /**
      * Retrieves the binding dictionary of the container.
      * @returns(void) Print table of the binding dictionary of the container.
+     * @public API
      */
     viewContainerBindings() {
         const dictionary = this.container["_bindingDictionary"]._map;
@@ -77,20 +71,23 @@ let AppContainer = class AppContainer {
     /**
      * Retrieves the container options.
      * @returns The container options.
+     * @public API
      */
     getContainerOptions() {
+        this.logger = new provider_1.Logger();
+        if (!this.container) {
+            this.logger.error("Container not created yet.", "app-container");
+            return;
+        }
         return this.container.options;
     }
     /**
-     * Retrieves the container.
-     * @returns The container.
+     * Retrieves the container instance.
+     * @returns The container instance.
+     * @public API
      */
     get Container() {
         return this.container;
     }
-};
+}
 exports.AppContainer = AppContainer;
-exports.AppContainer = AppContainer = __decorate([
-    (0, inversify_binding_decorators_1.provide)(AppContainer),
-    __metadata("design:paramtypes", [Object])
-], AppContainer);

package/lib/cjs/application/application-factory.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppFactory = void 0;
+exports.isWebServerConstructor = isWebServerConstructor;
 const logger_provider_1 = require("../provider/logger/logger.provider");
 /**
  * Type guard to check if input is a constructor type of IWebServer.
@@ -14,23 +15,21 @@ function isWebServerConstructor(input) {
  * AppFactory Class
  *
  * Responsible for creating an instance of the IWebServer implementation using a custom application type.
+ * @public API
  */
 class AppFactory {
     /**
      * Create an instance of a web server.
-     * @param container - Dependency injection container.
      * @param webServerType - Constructor of a class that implements IWebServer.
      * @returns A promise that resolves to an instance of IWebServer.
      */
-    static async create(container, webServerType) {
-        AppFactory.container = container;
+    static async create(webServerType) {
         if (isWebServerConstructor(webServerType)) {
             const webServerInstance = new webServerType();
-            await webServerInstance.configure(container);
             return webServerInstance;
         }
         else {
-            this.logger.error("Invalid web server type.", "app-factory:create");
+            AppFactory.logger.error("Invalid web server type.", "app-factory:create");
             throw new Error("Invalid web server type.");
         }
     }

package/lib/cjs/{common/server-env.types.js → application/application.types.js}

@@ -5,6 +5,7 @@ exports.ServerEnvironment = void 0;
  * Enum representing possible server environments.
  * @options Development - Development environment.
  * @options Production - Production environment.
+ * @public API
  */
 var ServerEnvironment;
 (function (ServerEnvironment) {

package/lib/cjs/application/index.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppFactory = exports.AppContainer = void 0;
+exports.ServerEnvironment = exports.AppFactory = exports.AppContainer = void 0;
 var application_container_1 = require("./application-container");
 Object.defineProperty(exports, "AppContainer", { enumerable: true, get: function () { return application_container_1.AppContainer; } });
 var application_factory_1 = require("./application-factory");
 Object.defineProperty(exports, "AppFactory", { enumerable: true, get: function () { return application_factory_1.AppFactory; } });
+var application_types_1 = require("./application.types");
+Object.defineProperty(exports, "ServerEnvironment", { enumerable: true, get: function () { return application_types_1.ServerEnvironment; } });

package/lib/cjs/console/console.js

@@ -1,19 +1,13 @@
 "use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Console = void 0;
-const inversify_binding_decorators_1 = require("inversify-binding-decorators");
-const color_codes_1 = require("../common/color-codes");
+const process_1 = require("process");
+const color_codes_1 = require("./color-codes");
 /**
  * The Console class provides methods for displaying styled messages in the console.
  * @provide Console
  */
-let Console = class Console {
+class Console {
     /**
      * Print a message to the console with the specified color style.
      * @param message - The message to be printed.
@@ -22,7 +16,7 @@ let Console = class Console {
     async printColor(message, colorStyle) {
         const textColor = "black";
         const bgColor = colorStyle;
-        console.log(`${color_codes_1.bgColorCodes[bgColor]}${color_codes_1.colorCodes[textColor]}${message}\x1b[0m`);
+        process_1.stdout.write(`${color_codes_1.bgColorCodes[bgColor]}${color_codes_1.colorCodes[textColor]}${message}\x1b[0m\n`);
     }
     /**
      * Display a message in the console with details about the running server.
@@ -32,7 +26,7 @@ let Console = class Console {
      */
     async messageServer(port, environment, consoleMessage) {
         const appConsoleMessage = {
-            appName: consoleMessage?.appName || "Application",
+            appName: consoleMessage?.appName || "App",
             appVersion: consoleMessage?.appVersion || "not provided",
         };
         let terminalColor = color_codes_1.ColorStyle.None;
@@ -40,9 +34,6 @@ let Console = class Console {
             case "development":
                 terminalColor = color_codes_1.ColorStyle.Yellow;
                 break;
-            case "staging":
-                terminalColor = color_codes_1.ColorStyle.Blue;
-                break;
             case "production":
                 terminalColor = color_codes_1.ColorStyle.Green;
                 break;
@@ -50,11 +41,8 @@ let Console = class Console {
                 terminalColor = color_codes_1.ColorStyle.Red;
                 break;
         }
-        this.printColor(`${appConsoleMessage.appName} version ${appConsoleMessage.appVersion} is running on ` +
-            `port ${port} - Environment: ${environment}`, terminalColor);
+        this.printColor(`[${appConsoleMessage.appName}] version [${appConsoleMessage.appVersion}] is running on ` +
+            `port [${port}] - Environment: [${environment}]`, terminalColor);
     }
-};
+}
 exports.Console = Console;
-exports.Console = Console = __decorate([
-    (0, inversify_binding_decorators_1.provide)(Console)
-], Console);

package/lib/cjs/container-module/container-module.js

@@ -1,18 +1,11 @@
 "use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var BaseModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scope = exports.CreateModule = exports.BaseModule = exports.BINDING_TYPE_METADATA_KEY = void 0;
 /* eslint-disable @typescript-eslint/explicit-function-return-type */
 /* eslint-disable @typescript-eslint/no-explicit-any */
-const inversify_1 = require("inversify");
-const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+const inversify_1 = require("../di/inversify");
 const decorator_1 = require("../decorator");
+const binding_decorator_1 = require("../di/binding-decorator");
 /**
  * Key to be used for storing and retrieving binding type metadata.
  */
@@ -21,6 +14,7 @@ exports.BINDING_TYPE_METADATA_KEY = "binding-type";
  * The scope decorator is a higher order function that can be used to decorate a class with a binding type.
  * @param binding An instance of interfaces.BindingScope which represents the binding type.
  * @returns A decorator function that can be used to decorate a class with a binding type.
+ * @public API
  */
 const scope = (binding) => {
     return function (target) {
@@ -34,7 +28,7 @@ const scope = (binding) => {
                     (0, decorator_1.provideTransient)(target);
                     break;
                 default:
-                    (0, inversify_binding_decorators_1.provide)(target);
+                    (0, binding_decorator_1.provide)(target);
                     break;
             }
         }
@@ -45,7 +39,7 @@ exports.scope = scope;
  * The BaseModule class provides methods for creating InversifyJS container modules.
  * @provide BaseModule
  */
-let BaseModule = BaseModule_1 = class BaseModule {
+class BaseModule {
     /**
      * Create a map of symbols for the provided controllers.
      * @param controllers - An array of controller classes.
@@ -82,25 +76,23 @@ let BaseModule = BaseModule_1 = class BaseModule {
      * @param controllers - An array of controller classes.
      * @param scope - An optional binding scope to be used for all controllers.
      * @returns A ContainerModule with the controller bindings.
+     * @public API
      */
     static createContainerModule(controllers, scope) {
-        const symbols = BaseModule_1.createSymbols(controllers);
+        const symbols = BaseModule.createSymbols(controllers);
         return new inversify_1.ContainerModule((bind) => {
             for (const [symbol, target] of symbols) {
                 if (scope) {
-                    BaseModule_1.bindToScope(symbol, target, scope, bind);
+                    BaseModule.bindToScope(symbol, target, scope, bind);
                 }
                 else {
                     const bindingType = Reflect.getMetadata(exports.BINDING_TYPE_METADATA_KEY, target);
-                    BaseModule_1.bindToScope(symbol, target, bindingType, bind);
+                    BaseModule.bindToScope(symbol, target, bindingType, bind);
                 }
             }
         });
     }
-};
+}
 exports.BaseModule = BaseModule;
-exports.BaseModule = BaseModule = BaseModule_1 = __decorate([
-    (0, inversify_binding_decorators_1.provide)(BaseModule)
-], BaseModule);
 const CreateModule = BaseModule.createContainerModule;
 exports.CreateModule = CreateModule;

package/lib/cjs/decorator/scope-binding.js

@@ -1,9 +1,9 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.provideTransient = exports.provideSingleton = exports.provide = void 0;
 /* eslint-disable @typescript-eslint/explicit-function-return-type */
 /* eslint-disable @typescript-eslint/no-explicit-any */
-const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provideTransient = exports.provideSingleton = exports.provide = void 0;
+const binding_decorator_1 = require("../di/binding-decorator");
 /**
  * Provides a binding for the given identifier.
  *
@@ -12,18 +12,18 @@ const inversify_binding_decorators_1 = require("inversify-binding-decorators");
  *
  * @example
  * ```typescript
- * @provide(ServiceIdentifier)
+ * provide(ServiceIdentifier)
  * class MyService {}
  * ```
+ * @public API
  */
 const provide = (identifier) => {
-    return (0, inversify_binding_decorators_1.fluentProvide)(identifier).done();
+    return (0, binding_decorator_1.fluentProvide)(identifier).done();
 };
 exports.provide = provide;
 /**
  * Provides a singleton binding for the given identifier.
  *
- * @remarks
  * Singleton binding ensures that the same instance of a dependency is reused within the entire container.
  *
  * @param identifier - The identifier (e.g., symbol, string, class) for the dependency being registered.
@@ -31,18 +31,18 @@ exports.provide = provide;
  *
  * @example
  * ```typescript
- * @provideSingleton(ServiceIdentifier)
+ * provideSingleton(ServiceIdentifier)
  * class MyService {}
  * ```
+ * @public API
  */
 const provideSingleton = (identifier) => {
-    return (0, inversify_binding_decorators_1.fluentProvide)(identifier).inSingletonScope().done();
+    return (0, binding_decorator_1.fluentProvide)(identifier).inSingletonScope().done();
 };
 exports.provideSingleton = provideSingleton;
 /**
  * Provides a transient binding for the given identifier.
  *
- * @remarks
  * Transient binding ensures that a new instance of a dependency is created every time it is resolved.
  *
  * @param identifier - The identifier (e.g., symbol, string, class) for the dependency being registered.
@@ -50,11 +50,12 @@ exports.provideSingleton = provideSingleton;
  *
  * @example
  * ```typescript
- * @provideTransient(ServiceIdentifier)
+ * provideTransient(ServiceIdentifier)
  * class MyService {}
  * ```
+ * @public API
  */
 const provideTransient = (identifier) => {
-    return (0, inversify_binding_decorators_1.fluentProvide)(identifier).inTransientScope().done();
+    return (0, binding_decorator_1.fluentProvide)(identifier).inTransientScope().done();
 };
 exports.provideTransient = provideTransient;

package/lib/cjs/di/annotation/decorator_utils.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decorate = decorate;
+exports.tagParameter = tagParameter;
+exports.tagProperty = tagProperty;
+exports.createTaggedDecorator = createTaggedDecorator;
+const ERROR_MSGS = __importStar(require("../constants/error_msgs"));
+const METADATA_KEY = __importStar(require("../constants/metadata_keys"));
+const js_1 = require("../utils/js");
+function targetIsConstructorFunction(target) {
+    return target.prototype !== undefined;
+}
+function _throwIfMethodParameter(parameterName) {
+    if (parameterName !== undefined) {
+        throw new Error(ERROR_MSGS.INVALID_DECORATOR_OPERATION);
+    }
+}
+function tagParameter(annotationTarget, parameterName, parameterIndex, metadata) {
+    _throwIfMethodParameter(parameterName);
+    _tagParameterOrProperty(METADATA_KEY.TAGGED, annotationTarget, parameterIndex.toString(), metadata);
+}
+function tagProperty(annotationTarget, propertyName, metadata) {
+    if (targetIsConstructorFunction(annotationTarget)) {
+        throw new Error(ERROR_MSGS.INVALID_DECORATOR_OPERATION);
+    }
+    _tagParameterOrProperty(METADATA_KEY.TAGGED_PROP, annotationTarget.constructor, propertyName, metadata);
+}
+function _ensureNoMetadataKeyDuplicates(metadata) {
+    let metadatas = [];
+    if (Array.isArray(metadata)) {
+        metadatas = metadata;
+        const duplicate = (0, js_1.getFirstArrayDuplicate)(metadatas.map((md) => md.key));
+        if (duplicate !== undefined) {
+            throw new Error(`${ERROR_MSGS.DUPLICATED_METADATA} ${duplicate.toString()}`);
+        }
+    }
+    else {
+        metadatas = [metadata];
+    }
+    return metadatas;
+}
+function _tagParameterOrProperty(metadataKey, annotationTarget, key, metadata) {
+    const metadatas = _ensureNoMetadataKeyDuplicates(metadata);
+    let paramsOrPropertiesMetadata = {};
+    // read metadata if available
+    if (Reflect.hasOwnMetadata(metadataKey, annotationTarget)) {
+        paramsOrPropertiesMetadata = Reflect.getMetadata(metadataKey, annotationTarget);
+    }
+    let paramOrPropertyMetadata = paramsOrPropertiesMetadata[key];
+    if (paramOrPropertyMetadata === undefined) {
+        paramOrPropertyMetadata = [];
+    }
+    else {
+        for (const m of paramOrPropertyMetadata) {
+            if (metadatas.some((md) => md.key === m.key)) {
+                throw new Error(`${ERROR_MSGS.DUPLICATED_METADATA} ${m.key.toString()}`);
+            }
+        }
+    }
+    // set metadata
+    paramOrPropertyMetadata.push(...metadatas);
+    paramsOrPropertiesMetadata[key] = paramOrPropertyMetadata;
+    Reflect.defineMetadata(metadataKey, paramsOrPropertiesMetadata, annotationTarget);
+}
+function createTaggedDecorator(metadata) {
+    return (target, targetKey, indexOrPropertyDescriptor) => {
+        if (typeof indexOrPropertyDescriptor === "number") {
+            tagParameter(target, targetKey, indexOrPropertyDescriptor, metadata);
+        }
+        else {
+            tagProperty(target, targetKey, metadata);
+        }
+    };
+}
+function _decorate(decorators, target) {
+    Reflect.decorate(decorators, target);
+}
+function _param(paramIndex, decorator) {
+    return function (target, key) {
+        decorator(target, key, paramIndex);
+    };
+}
+// Allows VanillaJS developers to use decorators:
+// decorate(injectable(), FooBar);
+// decorate(targetName('foo', 'bar'), FooBar);
+// decorate(named('foo'), FooBar, 0);
+// decorate(tagged('bar'), FooBar, 1);
+function decorate(decorator, target, parameterIndexOrProperty) {
+    if (typeof parameterIndexOrProperty === "number") {
+        _decorate([_param(parameterIndexOrProperty, decorator)], target);
+    }
+    else if (typeof parameterIndexOrProperty === "string") {
+        Reflect.decorate([decorator], target, parameterIndexOrProperty);
+    }
+    else {
+        _decorate([decorator], target);
+    }
+}

package/lib/cjs/di/annotation/inject.js

@@ -0,0 +1,44 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inject = void 0;
+const METADATA_KEY = __importStar(require("../constants/metadata_keys"));
+const inject_base_1 = require("./inject_base");
+/**
+ * Marks a constructor parameter for injection.
+ * @param serviceIdentifier The service identifier
+ * @return The decorator function
+ * @example
+ * ```typescript
+ * class Engine {}
+ *
+ * class Car {
+ *  constructor(@inject(Engine) engine: Engine) {}
+ * }
+ * ```
+ * @public API
+ */
+const inject = (0, inject_base_1.injectBase)(METADATA_KEY.INJECT_TAG);
+exports.inject = inject;

package/lib/cjs/di/annotation/inject_base.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectBase = injectBase;
+const error_msgs_1 = require("../constants/error_msgs");
+const metadata_1 = require("../planning/metadata");
+const decorator_utils_1 = require("./decorator_utils");
+function injectBase(metadataKey) {
+    return (serviceIdentifier) => {
+        return (target, targetKey, indexOrPropertyDescriptor) => {
+            if (serviceIdentifier === undefined) {
+                const className = typeof target === "function" ? target.name : target.constructor.name;
+                throw new Error((0, error_msgs_1.UNDEFINED_INJECT_ANNOTATION)(className));
+            }
+            return (0, decorator_utils_1.createTaggedDecorator)(new metadata_1.Metadata(metadataKey, serviceIdentifier))(target, targetKey, indexOrPropertyDescriptor);
+        };
+    };
+}

package/lib/cjs/di/annotation/injectable.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectable = injectable;
+const ERRORS_MSGS = __importStar(require("../constants/error_msgs"));
+const METADATA_KEY = __importStar(require("../constants/metadata_keys"));
+/**
+ * Marks a class as injectable.
+ * @returns A decorator function
+ * @public API
+ */
+function injectable() {
+    return function (target) {
+        if (Reflect.hasOwnMetadata(METADATA_KEY.PARAM_TYPES, target)) {
+            throw new Error(ERRORS_MSGS.DUPLICATED_INJECTABLE_DECORATOR);
+        }
+        const types = Reflect.getMetadata(METADATA_KEY.DESIGN_PARAM_TYPES, target) || [];
+        Reflect.defineMetadata(METADATA_KEY.PARAM_TYPES, types, target);
+        return target;
+    };
+}

package/lib/cjs/di/annotation/lazy_service_identifier.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyServiceIdentifier = void 0;
+class LazyServiceIdentifier {
+    constructor(cb) {
+        this._cb = cb;
+    }
+    unwrap() {
+        return this._cb();
+    }
+}
+exports.LazyServiceIdentifier = LazyServiceIdentifier;

package/lib/cjs/di/annotation/multi_inject.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.multiInject = void 0;
+const METADATA_KEY = __importStar(require("../constants/metadata_keys"));
+const inject_base_1 = require("./inject_base");
+const multiInject = (0, inject_base_1.injectBase)(METADATA_KEY.MULTI_INJECT_TAG);
+exports.multiInject = multiInject;