@jems/di/dist/buildInContainerizedKernel.js

An implementation of IoC pattern based on dependency injection that allows you to granulate and decouple your libraries or applications. Wrote using SOLID principles and a variety OOP patterns implementations.

"use strict";
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
    return new (P || (P = Promise))(function (resolve, reject) {
        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
        step((generator = generator.apply(thisArg, _arguments || [])).next());
    });
};
var __generator = (this && this.__generator) || function (thisArg, body) {
    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
    function verb(n) { return function (v) { return step([n, v]); }; }
    function step(op) {
        if (f) throw new TypeError("Generator is already executing.");
        while (_) try {
            if (f = 1, y && (t = y[op[0] & 2 ? "return" : op[0] ? "throw" : "next"]) && !(t = t.call(y, op[1])).done) return t;
            if (y = 0, t) op = [0, t.value];
            switch (op[0]) {
                case 0: case 1: t = op; break;
                case 4: _.label++; return { value: op[1], done: false };
                case 5: _.label++; y = op[1]; op = [0]; continue;
                case 7: op = _.ops.pop(); _.trys.pop(); continue;
                default:
                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
                    if (t[2]) _.ops.pop();
                    _.trys.pop(); continue;
            }
            op = body.call(thisArg, _);
        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
    }
};
Object.defineProperty(exports, "__esModule", { value: true });
var relationSyntax_1 = require("./fluent-syntaxes/relationSyntax");
/**
 * Represents a fluent extension that allows resolving dependencies with a container from the kernel fluently.
 */
var BuildInContainerizedKernel = /** @class */ (function () {
    /**
     * Created a new instace of a containerized resolution syntax
     * @param contaier
     */
    function BuildInContainerizedKernel(contaier) {
        this._container = contaier;
    }
    /**
     * Returns a boolean value specifying if the given alias can be resolved.
     * @param {string} alias Represents the alias to look for.
     * @return {boolean} True if the given alias can be resolved.
     */
    BuildInContainerizedKernel.prototype.canResolve = function (alias) {
        return this._container.canResolve(alias);
    };
    /**
     * Return an resolved instance using the given reference that could be a class, function or alias.
     * @param {{ new ():any } | Function | string} reference Represents the reference that must be resolved, it could be a class, function or alias.
     * @param {ResolutionOption} resolutionOption Represents the options to resolve the the reference.
     * @return {any} The resolved object.
     */
    BuildInContainerizedKernel.prototype.resolve = function (reference, resolutionOption) {
        var resolutionContext = {
            kernel: this._container.getKernel(),
            originContainerAlias: this._container.getName(),
            currentContainerAlias: this._container.getName(),
            containerSupportingStack: [],
            aliasResolutionStack: [],
            targetResolutionStack: typeof reference !== 'string' ? [reference] : [],
            steps: ['The kernel creates the resolution context and start to resolve the given reference.'],
            resolutionOption: resolutionOption
        };
        var resolutionResult = this._container.resolve(reference, resolutionContext);
        return resolutionResult;
    };
    /**
     * Return a promise that provided a resolved instance using the given reference that could be a class, function or alias.
     * @param {{ new ():any } | Function | string} reference Represents the reference that must be resolved, it could be a class, function or alias.
     * @param {ResolutionOption} resolutionOption Represents the options to resolve the the reference.
     * @return {Promise<any>} A promise that resolve the objects.
     */
    BuildInContainerizedKernel.prototype.resolveAsync = function (reference, resolutionOption) {
        return __awaiter(this, void 0, void 0, function () {
            return __generator(this, function (_a) {
                return [2 /*return*/, this.resolve(reference, resolutionOption)];
            });
        });
    };
    /**
     * Return an resolved instance using the given reference that could be a class, function or alias.
     * @param {{ new ():any } | Function | string} reference Represents the reference that must be resolved, it could be a class, function or alias.
     * @param {ResolutionContext} resolutionContext Represents the context of the resolution.
     * @return {any} The resolved object.
     */
    BuildInContainerizedKernel.prototype.resolveWithContext = function (reference, resolutionContext) {
        return this._container.resolve(reference, resolutionContext);
    };
    /**
     * Return a promise that provided a resolved instance using the given reference that could be a class, function or alias.
     * @param {{ new ():any } | Function | string} reference Represents the reference that must be resolved, it could be a class, function or alias.
     * @param {ResolutionContext} resolutionContext Represents the context of the resolution.
     * @return {Promise<any>} A promise that resolve the objects.
     */
    BuildInContainerizedKernel.prototype.resolveWithContextAsync = function (reference, resolutionContext) {
        return __awaiter(this, void 0, void 0, function () {
            return __generator(this, function (_a) {
                return [2 /*return*/, this.resolveWithContext(reference, resolutionContext)];
            });
        });
    };
    /**
     * Return an alias bind fluent syntax that allow register dependencies metadata in a fluent api syntax.
     * @param {string} alias Represents the alias to look for.
     * @return {InsideAndToSytax} A fluent bind.
     */
    BuildInContainerizedKernel.prototype.bind = function (alias) {
        return new relationSyntax_1.RelationSyntax(this).bind(alias);
    };
    /**
     * Unbind all dependencies metadata with the given alias from the container.
     * @param {string} alias Represents the alias to look for.
     */
    BuildInContainerizedKernel.prototype.unbindWithAlias = function (alias) {
        this.unregisterDependenciesMetadataWithAlias(alias);
    };
    /**
     * Unbind the dependency metadata with the given identifier from the container.
     * @param {string} identifier Represents the identifier to look for.
     */
    BuildInContainerizedKernel.prototype.unbindWithIdentifier = function (identifier) {
        this.unregisterDependencyMetadataWithIdentifier(identifier);
    };
    /**
     * Returns the registered dependency metadata with the given alias and identifier.
     * @param {string} identifier Represents the identifier to look for.
     * @returns {string} Return dependency metadata with the given identifier.
     */
    BuildInContainerizedKernel.prototype.getDependencyMetadataWithIdentifier = function (identifier) {
        return this._container.getDependencyMetadataWithIdentifier(identifier);
    };
    /**
     * Returns the generated identifier and register the given metadata with the given alias for his future activation.
     * @param {string} alias Represents the alias.
     * @param {DependencyMetadata} dependencyMetadata Represents the dependency metadata.
     * @returns {string} Returns the dependency metadata generated identifier.
     */
    BuildInContainerizedKernel.prototype.registerDependencyMetadata = function (alias, dependencyMetadata) {
        return this._container.registerDependencyMetadata(alias, dependencyMetadata);
    };
    /**
     * Unregister all registered dependencies metadata with the given alias.
     * @param {string} alias Represents the alias to to look for.
     */
    BuildInContainerizedKernel.prototype.unregisterDependenciesMetadataWithAlias = function (alias) {
        this._container.unregisterDependenciesMetadataWithAlias(alias);
    };
    /**
     * Unregister the dependency metadata with the given alias and identifier.
     * @param {string} identifier Represents the identifier to look for.
     */
    BuildInContainerizedKernel.prototype.unregisterDependencyMetadataWithIdentifier = function (identifier) {
        this._container.unregisterDependencyMetadataWithIdentifier(identifier);
    };
    return BuildInContainerizedKernel;
}());
exports.BuildInContainerizedKernel = BuildInContainerizedKernel;