feat: init project

src/factory/AlveoApplication.ts

@@ -0,0 +1,36 @@
+import type { Container } from "../container/Container";
+import type { ProviderToken } from "../container/types";
+
+/**
+ * AlveoApplication is the main class representing an Alveo application instance.
+ * It provides methods to interact with the dependency injection container and manage the application lifecycle.
+ */
+export class AlveoApplication {
+	constructor(private readonly container: Container) {}
+
+	/**
+	 * Retrieves an instance of a provider from the application container.
+	 *
+	 * @param token The provider token (Class, String, or Symbol)
+	 * @returns A promise resolving to the instance of the provider
+	 */
+	public async get<T>(token: ProviderToken<T>): Promise<T> {
+		return this.container.get(token);
+	}
+
+	/**
+	 * Initializes the application by calling onModuleInit hooks on all providers.
+	 * This is called automatically by AlveoFactory.create().
+	 */
+	public async init(): Promise<this> {
+		await this.container.callLifecycleHook("onModuleInit");
+		return this;
+	}
+
+	/**
+	 * Gracefully shuts down the application by calling onModuleDestroy hooks.
+	 */
+	public async close(): Promise<void> {
+		await this.container.callLifecycleHook("onModuleDestroy");
+	}
+}