@noego/ioc 0.0.5 → 0.0.7

package/dist/cjs/framework/decorators/Component.d.ts

@@ -0,0 +1,10 @@
+import 'reflect-metadata';
+import { LoadAs } from '../implementation/LoadAs';
+export interface ComponentOptions {
+    scope?: LoadAs;
+}
+/**
+ * Marks a class as a component managed by the IOC container.
+ * @param options Configuration options, primarily the scope (lifetime). Defaults to Transient.
+ */
+export declare function Component(options?: ComponentOptions): ClassDecorator;

package/dist/cjs/framework/decorators/Component.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Component = Component;
+// framework/decorators/Component.ts
+require("reflect-metadata");
+const metadataKeys_1 = require("./metadataKeys");
+const LoadAs_1 = require("../implementation/LoadAs");
+/**
+ * Marks a class as a component managed by the IOC container.
+ * @param options Configuration options, primarily the scope (lifetime). Defaults to Transient.
+ */
+function Component(options = {}) {
+    return (target) => {
+        var _a;
+        // Ensure default scope if not provided
+        const finalOptions = {
+            scope: (_a = options.scope) !== null && _a !== void 0 ? _a : LoadAs_1.LoadAs.Transient, // Default to Transient
+        };
+        // Define metadata on the class constructor - use both Symbol and string versions
+        Reflect.defineMetadata(metadataKeys_1.COMPONENT_OPTIONS_METADATA_KEY, finalOptions, target);
+        // Also define with string key for easier debugging
+        Reflect.defineMetadata('ComponentOptions', finalOptions, target);
+    };
+}
+//# sourceMappingURL=Component.js.map

package/dist/cjs/framework/decorators/Component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.js","sourceRoot":"","sources":["../../../../framework/decorators/Component.ts"],"names":[],"mappings":";;AAaA,8BAaC;AA1BD,oCAAoC;AACpC,4BAA0B;AAC1B,iDAAgE;AAChE,qDAAkD;AAMlD;;;GAGG;AACH,SAAgB,SAAS,CAAC,UAA4B,EAAE;IACpD,OAAO,CAAC,MAAgB,EAAE,EAAE;;QACxB,uCAAuC;QACvC,MAAM,YAAY,GAA+B;YAC7C,KAAK,EAAE,MAAA,OAAO,CAAC,KAAK,mCAAI,eAAM,CAAC,SAAS,EAAE,uBAAuB;SACpE,CAAC;QAEF,iFAAiF;QACjF,OAAO,CAAC,cAAc,CAAC,6CAA8B,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAE7E,mDAAmD;QACnD,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/framework/decorators/Inject.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+/**
+ * Decorator to explicitly specify the token/identifier for a constructor parameter dependency.
+ * Necessary for interfaces or when multiple implementations exist for a type.
+ * @param token The identifier (Symbol, string, or class) to inject.
+ */
+export declare function Inject(token: any): ParameterDecorator;

package/dist/cjs/framework/decorators/Inject.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inject = Inject;
+// framework/decorators/Inject.ts
+require("reflect-metadata");
+const metadataKeys_1 = require("./metadataKeys");
+/**
+ * Decorator to explicitly specify the token/identifier for a constructor parameter dependency.
+ * Necessary for interfaces or when multiple implementations exist for a type.
+ * @param token The identifier (Symbol, string, or class) to inject.
+ */
+function Inject(token) {
+    return (target, propertyKey, parameterIndex) => {
+        // Get existing injection tokens array or initialize if not present
+        const injectionTokens = Reflect.getOwnMetadata(metadataKeys_1.INJECT_TOKEN_METADATA_KEY, target) || new Map();
+        // Store the token at the specific parameter index
+        injectionTokens.set(parameterIndex, token);
+        // Define the metadata on the target (class constructor)
+        Reflect.defineMetadata(metadataKeys_1.INJECT_TOKEN_METADATA_KEY, injectionTokens, target);
+    };
+}
+//# sourceMappingURL=Inject.js.map

package/dist/cjs/framework/decorators/Inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Inject.js","sourceRoot":"","sources":["../../../../framework/decorators/Inject.ts"],"names":[],"mappings":";;AASA,wBAWC;AApBD,iCAAiC;AACjC,4BAA0B;AAC1B,iDAA2D;AAE3D;;;;GAIG;AACH,SAAgB,MAAM,CAAC,KAAU;IAC7B,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QACxF,mEAAmE;QACnE,MAAM,eAAe,GAAqB,OAAO,CAAC,cAAc,CAAC,wCAAyB,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,EAAe,CAAC;QAE9H,kDAAkD;QAClD,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAE3C,wDAAwD;QACxD,OAAO,CAAC,cAAc,CAAC,wCAAyB,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC,CAAC;AACN,CAAC"}

package/dist/cjs/framework/decorators/index.d.ts

@@ -0,0 +1,3 @@
+export { Component } from './Component';
+export { Inject } from './Inject';
+export * from './metadataKeys';

package/dist/cjs/framework/decorators/index.js

@@ -0,0 +1,24 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inject = exports.Component = void 0;
+// Export decorators
+var Component_1 = require("./Component");
+Object.defineProperty(exports, "Component", { enumerable: true, get: function () { return Component_1.Component; } });
+var Inject_1 = require("./Inject");
+Object.defineProperty(exports, "Inject", { enumerable: true, get: function () { return Inject_1.Inject; } });
+__exportStar(require("./metadataKeys"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/framework/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../framework/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oBAAoB;AACpB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,iDAA+B"}

package/dist/cjs/framework/decorators/metadataKeys.d.ts

@@ -0,0 +1,3 @@
+export declare const COMPONENT_OPTIONS_METADATA_KEY: unique symbol;
+export declare const PARAM_TYPES_METADATA_KEY = "design:paramtypes";
+export declare const INJECT_TOKEN_METADATA_KEY: unique symbol;

package/dist/cjs/framework/decorators/metadataKeys.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INJECT_TOKEN_METADATA_KEY = exports.PARAM_TYPES_METADATA_KEY = exports.COMPONENT_OPTIONS_METADATA_KEY = void 0;
+// framework/decorators/metadataKeys.ts
+exports.COMPONENT_OPTIONS_METADATA_KEY = Symbol.for("ioc:component:options");
+exports.PARAM_TYPES_METADATA_KEY = "design:paramtypes"; // Standard key
+exports.INJECT_TOKEN_METADATA_KEY = Symbol.for("ioc:inject:tokens");
+//# sourceMappingURL=metadataKeys.js.map

package/dist/cjs/framework/decorators/metadataKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataKeys.js","sourceRoot":"","sources":["../../../../framework/decorators/metadataKeys.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AAC1B,QAAA,8BAA8B,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AACrE,QAAA,wBAAwB,GAAG,mBAAmB,CAAC,CAAC,eAAe;AAC/D,QAAA,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/cjs/framework/errors/ContainerErrors.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Error types for the IOC container
+ */
+/**
+ * Thrown when a class definition is expected but not provided
+ */
+export declare class NotAClassDefinitionError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Thrown when a parameter value is required but not provided
+ */
+export declare class ParameterNotFoundError extends Error {
+    constructor(paramName?: string);
+}
+/**
+ * Thrown when trying to resolve a dependency that is not registered
+ */
+export declare class DependencyNotFoundError extends Error {
+    constructor(label: any);
+}
+/**
+ * Thrown when an instance has not been created but is being retrieved
+ */
+export declare class InstanceNotCreatedError extends Error {
+    constructor();
+}
+/**
+ * Thrown when circular dependencies are detected
+ */
+export declare class CircularDependencyError extends Error {
+    constructor(dependencyChain: string[]);
+}

package/dist/cjs/framework/errors/ContainerErrors.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Error types for the IOC container
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircularDependencyError = exports.InstanceNotCreatedError = exports.DependencyNotFoundError = exports.ParameterNotFoundError = exports.NotAClassDefinitionError = void 0;
+/**
+ * Thrown when a class definition is expected but not provided
+ */
+class NotAClassDefinitionError extends Error {
+    constructor(message = "Not a class definition") {
+        super(message);
+    }
+}
+exports.NotAClassDefinitionError = NotAClassDefinitionError;
+/**
+ * Thrown when a parameter value is required but not provided
+ */
+class ParameterNotFoundError extends Error {
+    constructor(paramName = "parameter") {
+        super(`No value found for ${paramName}`);
+    }
+}
+exports.ParameterNotFoundError = ParameterNotFoundError;
+/**
+ * Thrown when trying to resolve a dependency that is not registered
+ */
+class DependencyNotFoundError extends Error {
+    constructor(label) {
+        super(`Dependency not found: ${label}`);
+    }
+}
+exports.DependencyNotFoundError = DependencyNotFoundError;
+/**
+ * Thrown when an instance has not been created but is being retrieved
+ */
+class InstanceNotCreatedError extends Error {
+    constructor() {
+        super("Instance has not been created and therefore cannot be retrieved");
+    }
+}
+exports.InstanceNotCreatedError = InstanceNotCreatedError;
+/**
+ * Thrown when circular dependencies are detected
+ */
+class CircularDependencyError extends Error {
+    constructor(dependencyChain) {
+        super(`Circular dependency detected: ${dependencyChain.join(' -> ')}`);
+    }
+}
+exports.CircularDependencyError = CircularDependencyError;
+//# sourceMappingURL=ContainerErrors.js.map

package/dist/cjs/framework/errors/ContainerErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContainerErrors.js","sourceRoot":"","sources":["../../../../framework/errors/ContainerErrors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,MAAa,wBAAyB,SAAQ,KAAK;IAC/C,YAAY,OAAO,GAAG,wBAAwB;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;CACJ;AAJD,4DAIC;AAED;;GAEG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAC7C,YAAY,SAAS,GAAG,WAAW;QAC/B,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC;CACJ;AAJD,wDAIC;AAED;;GAEG;AACH,MAAa,uBAAwB,SAAQ,KAAK;IAC9C,YAAY,KAAU;QAClB,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;CACJ;AAJD,0DAIC;AAED;;GAEG;AACH,MAAa,uBAAwB,SAAQ,KAAK;IAC9C;QACI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAC7E,CAAC;CACJ;AAJD,0DAIC;AAED;;GAEG;AACH,MAAa,uBAAwB,SAAQ,KAAK;IAC9C,YAAY,eAAyB;QACjC,KAAK,CAAC,iCAAiC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;CACJ;AAJD,0DAIC"}

package/dist/cjs/framework/implementation/Container.d.ts

@@ -0,0 +1,31 @@
+import 'reflect-metadata';
+import { ContainerOptions, IContainerClient, IContainerSetup } from "../interface/Container";
+import { ParameterValue } from "./Parameter";
+export declare class Container implements IContainerClient, IContainerSetup {
+    private _routing;
+    private _functionDefinition;
+    private _classDefinition;
+    private _functionStorageSingleton;
+    private _functionStorageScoped;
+    private _classStorageSingleton;
+    private _classStorageScoped;
+    registerClass<T>(classDefinition: new (...args: any[]) => T, options?: Partial<ContainerOptions>): void;
+    registerFunction<T extends (...arg: any[]) => any>(label: any, func: T, options?: Partial<ContainerOptions>): void;
+    instance<T, Args extends any[]>(classDefinition: new (...args: Args) => T, params?: ParameterValue<any>[]): Promise<T>;
+    get<T>(label: any, param?: ParameterValue<any>[]): Promise<T> | T;
+    extend(): IContainerClient & IContainerSetup;
+    private clearDefinitions;
+    private isRegisteredAsClass;
+    private isRegisteredAsFunction;
+    private hasInstance;
+    private isClassType;
+    private getInstance;
+    private setInstance;
+    private getStorageType;
+    protected loadInstance(label: any, params?: ParameterValue<any>[], resolutionChain?: string[]): Promise<any>;
+    private resolveParameterValue;
+    private loadClassInstance;
+    private loadFunctionInstance;
+}
+export declare function isPromise(obj: any): obj is Promise<any>;
+export declare function createContainer(): IContainerClient & IContainerSetup;