1.0.1

bun.lock

@@ -5,6 +5,7 @@
     "": {
       "name": "core",
       "dependencies": {
+        "@alveojs/common": "^1.0.0",
         "reflect-metadata": "^0.2.2",
       },
       "devDependencies": {
@@ -12,11 +13,13 @@
         "@types/bun": "latest",
       },
       "peerDependencies": {
-        "typescript": "^5",
+        "typescript": "^5.9.3",
       },
     },
   },
   "packages": {
+    "@alveojs/common": ["@alveojs/common@1.0.0", "", { "dependencies": { "reflect-metadata": "^0.2.2" }, "peerDependencies": { "typescript": "^5" } }, "sha512-yXGGQQWhdJ70ZYnNCP3PL403xzxDKV+sQJ+FzKvW04hk5sM2aj27uWLTdlpDSqcszm/8+3apOWlL8FZXXZUbxg=="],
+
     "@biomejs/biome": ["@biomejs/biome@2.3.11", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.11", "@biomejs/cli-darwin-x64": "2.3.11", "@biomejs/cli-linux-arm64": "2.3.11", "@biomejs/cli-linux-arm64-musl": "2.3.11", "@biomejs/cli-linux-x64": "2.3.11", "@biomejs/cli-linux-x64-musl": "2.3.11", "@biomejs/cli-win32-arm64": "2.3.11", "@biomejs/cli-win32-x64": "2.3.11" }, "bin": { "biome": "bin/biome" } }, "sha512-/zt+6qazBWguPG6+eWmiELqO+9jRsMZ/DBU3lfuU2ngtIQYzymocHhKiZRyrbra4aCOoyTg/BmY+6WH5mv9xmQ=="],
 
     "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.11", "", { "os": "darwin", "cpu": "arm64" }, "sha512-/uXXkBcPKVQY7rc9Ys2CrlirBJYbpESEDme7RKiBD6MmqR2w3j0+ZZXRIL2xiaNPsIMMNhP1YnA+jRRxoOAFrA=="],

package.json

@@ -1,16 +1,20 @@
 {
 	"name": "@alveojs/core",
-	"module": "index.ts",
+	"version": "1.0.1",
+	"description": "Core engine for Alveo DI container",
+	"module": "src/index.ts",
+	"types": "src/index.ts",
 	"type": "module",
-	"private": true,
+	"private": false,
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.11",
 		"@types/bun": "latest"
 	},
 	"peerDependencies": {
-		"typescript": "^5"
+		"typescript": "^5.9.3"
 	},
 	"dependencies": {
+		"@alveojs/common": "^1.0.0",
 		"reflect-metadata": "^0.2.2"
 	},
 	"scripts": {

src/container/Container.ts

@@ -1,19 +1,21 @@
 import "reflect-metadata";
-import { CircularDependencyError, ProviderNotFoundError } from "../errors";
-import { ContextualModuleRef, ModuleRef } from "../module/ModuleRef";
-import type { Constructor } from "../types";
-import type { ForwardRefFn } from "./forwardRef";
 import {
 	type BaseProvider,
+	CircularDependencyError,
+	type Constructor,
 	type DynamicModule,
+	type ForwardReference,
 	INJECT_METADATA_KEY,
 	INJECTABLE_METADATA_KEY,
 	MODULE_METADATA_KEY,
 	type ModuleOptions,
+	PARAMTYPES_METADATA_KEY,
 	type Provider,
+	ProviderNotFoundError,
 	type ProviderToken,
 	type ResolvedProvider,
-} from "./types";
+} from "@alveojs/common";
+import { ContextualModuleRef, ModuleRef } from "../module/ModuleRef";
 
 interface ParamType {
 	name?: string;
@@ -64,13 +66,13 @@ export class Container {
 			| Constructor
 			| DynamicModule
 			| Promise<DynamicModule>
-			| ForwardRefFn<Constructor>,
+			| ForwardReference<Constructor>,
 	): Promise<void> {
 		const unwrappedModule = (await (typeof module === "object" &&
 		module !== null &&
 		"forwardRef" in (module as object)
 			? (
-					module as { forwardRef: () => Constructor | DynamicModule }
+					module as ForwardReference<Constructor | DynamicModule>
 				).forwardRef()
 			: module)) as Constructor | DynamicModule;
 
@@ -104,9 +106,7 @@ export class Container {
 				imp !== null &&
 				"forwardRef" in (imp as object)
 					? (
-							imp as {
+							imp as ForwardReference<Constructor | DynamicModule>
-								forwardRef: () => Constructor | DynamicModule;
-							}
 						).forwardRef()
 					: imp);
 			}),
@@ -290,8 +290,10 @@ export class Container {
 				} else if (provider.useClass) {
 					const targetClass = provider.useClass;
 					const paramTypes: ParamType[] =
-						Reflect.getMetadata("design:paramtypes", targetClass) ||
+						Reflect.getMetadata(
-						[];
+							PARAMTYPES_METADATA_KEY,
+							targetClass,
+						) || [];
 					const injectTokens: ProviderToken[] =
 						Reflect.getMetadata(INJECT_METADATA_KEY, targetClass) ||
 						[];

src/container/forwardRef.ts

@@ -1,21 +0,0 @@
-/**
- * Interface for a function that returns a type.
- */
-export type ForwardReference<T = unknown> = () => T;
-
-/**
- * Interface for the object returned by forwardRef.
- */
-export interface ForwardRefFn<T = unknown> {
-	forwardRef: ForwardReference<T>;
-}
-
-/**
- * Allows to refer to a reference which is not yet defined.
- * Useful for circular dependencies between classes or modules.
- *
- * @param fn A function that returns the reference
- */
-export function forwardRef<T>(fn: ForwardReference<T>): ForwardRefFn<T> {
-	return { forwardRef: fn };
-}

src/container/types.ts

@@ -1,74 +1,21 @@
-import type { Constructor, Type } from "../types";
+export type {
-import type { ForwardRefFn } from "./forwardRef";
+	BaseProvider,
+	ClassProvider,
+	DynamicModule,
+	ExistingProvider,
+	FactoryProvider,
+	InjectableOptions,
+	ModuleOptions,
+	Provider,
+	ProviderScope,
+	ProviderToken,
+	ResolvedProvider,
+	ValueProvider,
+} from "@alveojs/common";
 
-export type ProviderScope = "singleton" | "transient";
+export {
-
+	INJECT_METADATA_KEY,
-export type ProviderToken<T = unknown> =
+	INJECTABLE_METADATA_KEY,
-	| Type<T>
+	MODULE_METADATA_KEY,
-	| string
+	PARAMTYPES_METADATA_KEY,
-	| symbol
+} from "@alveojs/common";
-	| ForwardRefFn<Type<T>>;
-
-export interface BaseProvider<T = unknown> {
-	provide: ProviderToken<T>;
-	scope?: ProviderScope;
-}
-
-export interface ClassProvider<T = unknown> extends BaseProvider<T> {
-	useClass: Constructor<T>;
-}
-
-export interface ValueProvider<T = unknown> extends BaseProvider<T> {
-	useValue: T;
-}
-
-export interface FactoryProvider<T = unknown> extends BaseProvider<T> {
-	useFactory: (...args: unknown[]) => T | Promise<T>;
-	inject?: ProviderToken[];
-}
-
-export interface ExistingProvider<T = unknown> extends BaseProvider<T> {
-	useExisting: ProviderToken<T>;
-}
-
-export type Provider<T = unknown> =
-	| Constructor<T>
-	| ClassProvider<T>
-	| ValueProvider<T>
-	| FactoryProvider<T>
-	| ExistingProvider<T>;
-
-export interface ResolvedProvider<T = unknown> {
-	token: ProviderToken<T>;
-	scope: ProviderScope;
-	useClass?: Constructor<T>;
-	useValue?: T;
-	useFactory?: (...args: unknown[]) => T | Promise<T>;
-	useExisting?: ProviderToken<T>;
-	inject?: ProviderToken[];
-	moduleName?: string;
-}
-
-export interface InjectableOptions {
-	scope?: ProviderScope;
-}
-
-export interface DynamicModule extends ModuleOptions {
-	module: Constructor;
-}
-
-export interface ModuleOptions {
-	imports?: (
-		| Constructor
-		| DynamicModule
-		| Promise<DynamicModule>
-		| ForwardRefFn<Constructor>
-	)[];
-	providers?: Provider[];
-	exports?: ProviderToken[];
-}
-
-export const INJECTABLE_METADATA_KEY = "alveo:injectable";
-export const INJECT_METADATA_KEY = "alveo:inject";
-export const MODULE_METADATA_KEY = "alveo:module";
-export const PARAMTYPES_METADATA_KEY = "design:paramtypes";

src/decorators/index.ts

@@ -1,3 +0,0 @@
-export * from "./inject.decorator";
-export * from "./injectable.decorator";
-export * from "./module.decorator";

src/decorators/inject.decorator.ts

@@ -1,22 +0,0 @@
-import "reflect-metadata";
-import { INJECT_METADATA_KEY, type ProviderToken } from "../container/types";
-
-/**
- * Decorator that explicitly specifies a token for dependency injection.
- * Useful when injecting interfaces (via symbols or strings) or when multiple
- * providers are available for the same type.
- *
- * @param token The token to inject
- */
-export function Inject(token: ProviderToken): ParameterDecorator {
-	return (
-		target: object,
-		_propertyKey: string | symbol | undefined,
-		parameterIndex: number,
-	) => {
-		const existingInjections =
-			Reflect.getMetadata(INJECT_METADATA_KEY, target) || [];
-		existingInjections[parameterIndex] = token;
-		Reflect.defineMetadata(INJECT_METADATA_KEY, existingInjections, target);
-	};
-}

src/decorators/injectable.decorator.ts

@@ -1,16 +0,0 @@
-import "reflect-metadata";
-import {
-	INJECTABLE_METADATA_KEY,
-	type InjectableOptions,
-} from "../container/types";
-
-/**
- * Decorator that marks a class as available to be provided and injected as a dependency.
- *
- * @param options Options for the injectable (e.g., scope)
- */
-export function Injectable(options?: InjectableOptions): ClassDecorator {
-	return (target: object) => {
-		Reflect.defineMetadata(INJECTABLE_METADATA_KEY, options || {}, target);
-	};
-}

src/decorators/module.decorator.ts

@@ -1,14 +0,0 @@
-import "reflect-metadata";
-import { MODULE_METADATA_KEY, type ModuleOptions } from "../container/types";
-
-/**
- * Decorator that marks a class as an Alveo module.
- * Modules are used to organize the application structure and define providers, imports, and exports.
- *
- * @param options Module configuration options
- */
-export function Module(options: ModuleOptions): ClassDecorator {
-	return (target: object) => {
-		Reflect.defineMetadata(MODULE_METADATA_KEY, options, target);
-	};
-}

src/errors/index.ts

@@ -1,47 +0,0 @@
-export class AlveoError extends Error {
-	constructor(message: string) {
-		super(message);
-		this.name = this.constructor.name;
-	}
-}
-
-export class ProviderNotFoundError extends AlveoError {
-	constructor(token: string, context?: string) {
-		const contextMsg = context ? ` in the "${context}" context` : "";
-		super(
-			`Alveo can't resolve dependencies of the ${token}${contextMsg}. Please make sure that it is available in the current module scope.`,
-		);
-	}
-}
-
-export class CircularDependencyError extends AlveoError {
-	constructor(stack: string[]) {
-		super(`Circular dependency detected: ${stack.join(" -> ")}`);
-	}
-}
-
-export class InvalidModuleError extends AlveoError {
-	constructor(target: string) {
-		super(
-			`The class "${target}" is not a valid Alveo module. Did you forget the @Module() decorator?`,
-		);
-	}
-}
-
-export class InvalidProviderError extends AlveoError {
-	constructor(provider: unknown) {
-		super(`Invalid provider definition: ${JSON.stringify(provider)}`);
-	}
-}
-
-export class LifecycleError extends AlveoError {
-	constructor(hook: string, error: Error) {
-		super(`Error during lifecycle hook "${hook}": ${error.message}`);
-	}
-}
-
-export class BootstrapError extends AlveoError {
-	constructor(message: string) {
-		super(`Application bootstrap failed: ${message}`);
-	}
-}

src/factory/AlveoApplication.ts

@@ -1,5 +1,5 @@
+import type { ProviderToken } from "@alveojs/common";
 import type { Container } from "../container/Container";
-import type { ProviderToken } from "../container/types";
 
 /**
  * AlveoApplication is the main class representing an Alveo application instance.

src/factory/AlveoFactory.ts

@@ -1,6 +1,5 @@
+import type { Constructor, DynamicModule } from "@alveojs/common";
 import { Container } from "../container/Container";
-import type { DynamicModule } from "../container/types";
-import type { Constructor } from "../types";
 import { AlveoApplication } from "./AlveoApplication";
 
 /**

src/index.ts

@@ -1,21 +1,5 @@
+export * from "@alveojs/common";
 export { Container } from "./container/Container";
-export type { ForwardReference, ForwardRefFn } from "./container/forwardRef";
-export { forwardRef } from "./container/forwardRef";
-export type {
-	ClassProvider,
-	ExistingProvider,
-	FactoryProvider,
-	InjectableOptions,
-	ModuleOptions,
-	Provider,
-	ProviderScope as Scope,
-	ProviderToken,
-	ValueProvider,
-} from "./container/types";
-export * from "./decorators";
-export * from "./errors";
 export { AlveoApplication } from "./factory/AlveoApplication";
 export { AlveoFactory } from "./factory/AlveoFactory";
-export * from "./lifecycle";
 export { ModuleRef } from "./module/ModuleRef";
-export type { Abstract, Constructor, Type } from "./types";

src/lifecycle/index.ts

@@ -1,37 +0,0 @@
-/**
- * Interface defining a lifecycle hook that is called once the module has been initialized.
- * All dependencies have been resolved and instantiated at this point.
- */
-export interface OnModuleInit {
-	onModuleInit(): void | Promise<void>;
-}
-
-/**
- * Interface defining a lifecycle hook that is called once all modules have been initialized,
- * but before the application starts listening for connections.
- */
-export interface OnApplicationBootstrap {
-	onApplicationBootstrap(): void | Promise<void>;
-}
-
-/**
- * Interface defining a lifecycle hook that is called when the application is shutting down.
- * Useful for cleanup logic like closing database connections or stopping intervals.
- */
-export interface OnModuleDestroy {
-	onModuleDestroy(): void | Promise<void>;
-}
-
-/**
- * Interface defining a lifecycle hook that is called after all onModuleDestroy() handlers have completed.
- */
-export interface BeforeApplicationShutdown {
-	beforeApplicationShutdown(signal?: string): void | Promise<void>;
-}
-
-/**
- * Interface defining a lifecycle hook that is called after connections close (app.close() resolves).
- */
-export interface OnApplicationShutdown {
-	onApplicationShutdown(signal?: string): void | Promise<void>;
-}

src/module/ModuleRef.ts

@@ -1,5 +1,5 @@
+import type { ProviderToken } from "@alveojs/common";
 import type { Container } from "../container/Container";
-import type { ProviderToken } from "../container/types";
 
 /**
  * ModuleRef is an abstraction that allows for dynamic resolution of providers.

src/types.ts

@@ -1,10 +0,0 @@
-// biome-ignore lint/suspicious/noExplicitAny: Required for constructor variance compatibility
-export type ConstructorArgs = any[];
-
-export type Constructor<T = unknown> = new (...args: ConstructorArgs) => T;
-
-export type Abstract<T = unknown> = abstract new (
-	...args: ConstructorArgs
-) => T;
-
-export type Type<T = unknown> = Constructor<T> | Abstract<T>;

tsconfig.json

@@ -1,6 +1,5 @@
 {
 	"compilerOptions": {
-		// Environment setup & latest features
 		"lib": ["ESNext"],
 		"target": "ESNext",
 		"module": "Preserve",
@@ -10,22 +9,20 @@
 		"experimentalDecorators": true,
 		"emitDecoratorMetadata": true,
 
-		// Bundler mode
 		"moduleResolution": "bundler",
 		"allowImportingTsExtensions": true,
 		"verbatimModuleSyntax": true,
 		"noEmit": true,
 
-		// Best practices
 		"strict": true,
 		"skipLibCheck": true,
 		"noFallthroughCasesInSwitch": true,
 		"noUncheckedIndexedAccess": true,
 		"noImplicitOverride": true,
 
-		// Some stricter flags (disabled by default)
 		"noUnusedLocals": false,
 		"noUnusedParameters": false,
 		"noPropertyAccessFromIndexSignature": false
-	}
+	},
+	"include": ["src/**/*", "test/**/*", "index.ts"]
 }