@nexus-ioc/core 0.6.2 → 0.7.0

package/dist/types/interfaces/scope.interface.d.ts

@@ -1,54 +1 @@
-/**
- * Defines the lifecycle scope of a provider.
- *
- * The scope determines how instances are created and cached:
- *
- * - **Singleton**: One instance is created and shared across the entire application.
- *   The instance is cached globally and reused for all requests.
- *
- * - **Request**: A new instance is created for each `container.get()` call, but
- *   the same instance is reused within that call's dependency tree. This is useful
- *   for request-scoped data in web applications.
- *
- * - **Transient**: A new instance is created every time the provider is injected,
- *   even within the same dependency tree. No caching is performed.
- *
- * @example
- * ```typescript
- * // Singleton - shared across the application
- * @Injectable({ scope: Scope.Singleton })
- * class DatabaseConnection {
- *   // Only one instance exists
- * }
- *
- * // Request - new instance per request
- * @Injectable({ scope: Scope.Request })
- * class RequestContext {
- *   requestId = Math.random();
- *   // Different requestId for each container.get() call
- * }
- *
- * // Transient - new instance every time
- * @Injectable({ scope: Scope.Transient })
- * class Logger {
- *   timestamp = Date.now();
- *   // Different timestamp for each injection
- * }
- * ```
- */
-export declare enum Scope {
-    /**
-     * Singleton scope - one instance shared across the entire application.
-     * This is the default scope.
-     */
-    Singleton = 0,
-    /**
-     * Request scope - new instance for each container.get() call,
-     * but shared within that call's dependency tree.
-     */
-    Request = 1,
-    /**
-     * Transient scope - new instance every time, no caching.
-     */
-    Transient = 2
-}
+export { Scope } from "@nexus-ioc/shared";

package/dist/types/interfaces/validate-module-keys.d.ts

@@ -2,6 +2,7 @@ export declare const MODULE_METADATA: {
     IMPORTS: string;
     PROVIDERS: string;
     EXPORTS: string;
+    CHILDREN: string;
 };
 export declare const INVALID_MODULE_CONFIG_MESSAGE: (_text: TemplateStringsArray, property: string) => string;
 export declare function validateModuleKeys(keys: string[]): void;

package/dist/types/internal.d.ts

@@ -0,0 +1,3 @@
+export { createInternalModule, LazyModuleLoader, } from "./core/lazy-module-loader";
+export { Container } from "./core/modules/container";
+export type { ContainerInterface } from "./interfaces/modules/container.interface";

package/dist/types/server.d.ts

@@ -1 +1 @@
-export { NexusApplicationsServer } from "./core/nexus-applications.server";
+export { NexusApplicationServer } from "./core/nexus-applications.server";

package/dist/types/utils/forward-ref.d.ts

@@ -0,0 +1,5 @@
+export interface ForwardRef<T = unknown> {
+    forwardRef: () => T;
+}
+export declare function forwardRef<T = unknown>(fn: () => T): ForwardRef<T>;
+export declare function isForwardRef(token: unknown): token is ForwardRef;

package/dist/types/utils/helpers.d.ts

@@ -1,15 +1,15 @@
 import "reflect-metadata";
-import { type ClassProvider, type DynamicModule, type FactoryProvider, type InjectionToken, type Module, type Provider, Scope, type Type, type ValueProvider } from "../interfaces";
+import { type ClassProvider, type DynamicModule, type FactoryProvider, type Provider, type ProviderToken, Scope, type Type, type ValueProvider } from "../interfaces";
 export declare function isFunctionProvider(target: Provider): target is Type;
-export declare function isModule(target: Module | InjectionToken): target is Module;
-export declare function isFunctionToken(target: InjectionToken): target is Type;
+export declare function isModule(target: Type | ProviderToken): target is Type;
+export declare function isFunctionToken(target: ProviderToken): target is Type;
 export declare function isClassProvider(target: Provider): target is ClassProvider;
 export declare function isValueProvider(target: Provider): target is ValueProvider;
 export declare function isFactoryProvider(target: Provider): target is FactoryProvider;
-export declare function getProviderToken(target: Provider): InjectionToken;
+export declare function getProviderToken(target: Provider): ProviderToken;
 export declare function isProvider(provider: Provider): provider is Provider;
-export declare function getDependencyToken(target: Provider): InjectionToken;
-export declare function isDynamicModule(module: Module | DynamicModule): module is DynamicModule;
-export declare function isGlobalModule(target: Module): boolean;
-export declare function getModuleLabel(module: Module | DynamicModule): string;
+export declare function getDependencyToken(target: Provider): ProviderToken;
+export declare function isDynamicModule(module: Type | DynamicModule): module is DynamicModule;
+export declare function isGlobalModule(target: Type): boolean;
+export declare function getModuleLabel(module: Type | DynamicModule): string;
 export declare function getProviderScope(target: Provider): Scope;

package/dist/types/utils/lazy-module.d.ts

@@ -0,0 +1,20 @@
+import type { DynamicModule, LazyModule, Type } from "../interfaces";
+export interface LazyModuleOptions {
+    /** Name used in diagnostics and, by the Vite plugin, for chunk naming. */
+    name?: string;
+}
+/**
+ * Declares a lazily loaded module import.
+ *
+ * @example
+ * ```typescript
+ * export const FeatureLazy = lazy(() =>
+ *   import("./feature/feature.module").then((m) => m.FeatureModule),
+ * );
+ *
+ * @Module({ imports: [CoreModule, FeatureLazy] })
+ * class AppModule {}
+ * ```
+ */
+export declare function lazy<T extends Type = Type>(loader: () => Promise<T | DynamicModule>, options?: LazyModuleOptions): LazyModule<T>;
+export declare function isLazyModule(value: unknown): value is LazyModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-ioc/core",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "A powerful IoC container for TypeScript applications",
   "author": "Isqanderm <aleksandr.melnik.personal@gmail.com> (https://www.linkedin.com/in/isqander-melnik)",
   "homepage": "https://github.com/Isqanderm/ioc#readme",
@@ -25,6 +25,7 @@
   },
   "files": [
     "dist",
+    "!dist/**/*.tsbuildinfo",
     "package.json",
     "LICENSE",
     "README.md"
@@ -42,6 +43,24 @@
         "types": "./dist/types/index.d.ts",
         "default": "./dist/cjs/index.js"
       }
+    },
+    "./internal": {
+      "source": "./src/internal.ts",
+      "import": {
+        "types": "./dist/types/internal.d.ts",
+        "default": "./dist/esm/internal.js"
+      },
+      "require": {
+        "types": "./dist/types/internal.d.ts",
+        "default": "./dist/cjs/internal.js"
+      }
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "internal": [
+        "./dist/types/internal.d.ts"
+      ]
     }
   },
   "sideEffects": false,
@@ -50,17 +69,15 @@
     "reflect-metadata": "^0.1.12 || ^0.2.0"
   },
   "devDependencies": {
-    "@nexus-ioc/testing": "^0.6.1",
     "@types/node": "^24.8.1",
     "@vitest/coverage-v8": "^3.0.0",
     "reflect-metadata": "^0.1.12 || ^0.2.0",
-    "sinon": "^21.0.0",
     "typescript": "^5.9.3",
     "vite": "^7.0.0",
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@nexus-ioc/shared": "^0.6.1",
+    "@nexus-ioc/shared": "^0.7.0",
     "tslib": "^2.6.3"
   },
   "scripts": {

package/dist/cjs/decorators/nsModule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nsModule.js","sourceRoot":"","sources":["../../../src/decorators/nsModule.ts"],"names":[],"mappings":";;AAiDA,4BAsBC;AAvED,4BAA0B;AAE1B,8CAIuB;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,SAAgB,QAAQ,CAAC,QAAwB;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAA,+BAAkB,EAAC,SAAS,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,EAAE,EAAE;QACjB,OAAO,CAAC,cAAc,CAAC,6BAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,CAAC,cAAc,CACrB,4BAAe,CAAC,OAAO,EACvB,QAAQ,CAAC,OAAO,IAAI,EAAE,EACtB,MAAM,CACN,CAAC;QACF,OAAO,CAAC,cAAc,CACrB,4BAAe,CAAC,OAAO,EACvB,QAAQ,CAAC,OAAO,IAAI,EAAE,EACtB,MAAM,CACN,CAAC;QACF,OAAO,CAAC,cAAc,CACrB,4BAAe,CAAC,SAAS,EACzB,QAAQ,CAAC,SAAS,IAAI,EAAE,EACxB,MAAM,CACN,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}

package/dist/esm/decorators/nsModule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nsModule.js","sourceRoot":"","sources":["../../../src/decorators/nsModule.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAwB;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAE9B,OAAO,CAAC,MAAM,EAAE,EAAE;QACjB,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,CAAC,cAAc,CACrB,eAAe,CAAC,OAAO,EACvB,QAAQ,CAAC,OAAO,IAAI,EAAE,EACtB,MAAM,CACN,CAAC;QACF,OAAO,CAAC,cAAc,CACrB,eAAe,CAAC,OAAO,EACvB,QAAQ,CAAC,OAAO,IAAI,EAAE,EACtB,MAAM,CACN,CAAC;QACF,OAAO,CAAC,cAAc,CACrB,eAAe,CAAC,SAAS,EACzB,QAAQ,CAAC,SAAS,IAAI,EAAE,EACxB,MAAM,CACN,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}