@chidchanun/bcp 0.3.0 → 0.3.1

package/packages/server/src/application.ts

@@ -1,3 +1,12 @@
+import {
+    createServiceContainer,
+
+    type ServiceContainer,
+    type ServiceProvider,
+    type ServiceScope,
+    type ServiceScopeOptions,
+} from "./container.js";
+
 import {
     createDeploymentRuntime,
 
@@ -52,6 +61,7 @@ export interface ApplicationContext<TConfig = unknown> {
     readonly name: string;
     readonly version?: string;
     readonly config: TConfig;
+    readonly container: ServiceContainer;
     readonly services: PluginServiceRegistry;
     readonly hooks: PluginHookBus;
     readonly plugins: PluginHost;
@@ -65,6 +75,7 @@ export interface ApplicationDefinition<TConfig = unknown> {
     version?: string;
     config?: unknown;
     schema?: ApplicationConfigParser<TConfig>;
+    providers?: readonly ServiceProvider<unknown>[];
     plugins?: readonly PluginDefinition<any>[];
     modules?: readonly PluginModule[];
     pluginConfigs?: Record<string, unknown>;
@@ -96,6 +107,7 @@ export interface Application<TConfig = unknown> {
     readonly state: ApplicationState;
     readonly config: TConfig;
     readonly context: ApplicationContext<TConfig>;
+    readonly container: ServiceContainer;
     readonly services: PluginServiceRegistry;
     readonly hooks: PluginHookBus;
     readonly plugins: PluginHost;
@@ -112,6 +124,15 @@ export interface Application<TConfig = unknown> {
             replace?: boolean;
         }
     ): Application<TConfig>;
+    register<T>(
+        provider: ServiceProvider<T>,
+        options?: {
+            replace?: boolean;
+        }
+    ): Application<TConfig>;
+    createScope(
+        options?: ServiceScopeOptions
+    ): ServiceScope;
     addResource(
         resource: DeploymentResource
     ): Application<TConfig>;
@@ -180,6 +201,13 @@ export function createApp<TConfig = unknown>(
             definition.schema,
             definition.config
         );
+    const container =
+        createServiceContainer({
+            name:
+                `${name}:container`,
+            providers:
+                definition.providers,
+        });
     const plugins =
         createPluginHost({
             plugins:
@@ -229,6 +257,7 @@ export function createApp<TConfig = unknown>(
             }
             : {}),
         config,
+        container,
         services:
             plugins.services,
         hooks:
@@ -243,6 +272,38 @@ export function createApp<TConfig = unknown>(
         },
     };
 
+    deployment.addResource({
+        name:
+            "bcp:container",
+        ready() {
+            return {
+                ok:
+                    container.state ===
+                    "active",
+                detail:
+                    `Service container is ${container.state}.`,
+            };
+        },
+        async stop() {
+            await container.dispose();
+        },
+        diagnostics() {
+            return {
+                state:
+                    container.state,
+                providers:
+                    container.graph().map(
+                        node => ({
+                            token:
+                                node.description,
+                            lifetime:
+                                node.lifetime,
+                        })
+                    ),
+            };
+        },
+    });
+
     deployment.addResource({
         name:
             "bcp:plugins",
@@ -284,11 +345,12 @@ export function createApp<TConfig = unknown>(
         name,
         ...(version
             ? {
-                    version,
-                }
+                version,
+            }
             : {}),
         config,
         context,
+        container,
         services:
             plugins.services,
         hooks:
@@ -322,6 +384,26 @@ export function createApp<TConfig = unknown>(
             return app;
         },
 
+        register<T>(
+            provider: ServiceProvider<T>,
+            options: {
+                replace?: boolean;
+            } = {}
+        ) {
+            assertMutable();
+            container.register(
+                provider,
+                options
+            );
+            return app;
+        },
+
+        createScope(options = {}) {
+            return container.createScope(
+                options
+            );
+        },
+
         addResource(resource) {
             assertMutable();
             deployment.addResource(
@@ -562,6 +644,14 @@ export function createApp<TConfig = unknown>(
                 }
             }
 
+            if (container.state !== "disposed") {
+                try {
+                    await container.dispose();
+                } catch (error) {
+                    errors.push(error);
+                }
+            }
+
             try {
                 await disposeApplication();
             } catch (error) {
@@ -612,8 +702,8 @@ export function createApp<TConfig = unknown>(
                     name,
                     ...(version
                         ? {
-                                version,
-                            }
+                            version,
+                        }
                         : {}),
                     state,
                     services:
@@ -622,6 +712,11 @@ export function createApp<TConfig = unknown>(
                             .map(
                                 formatServiceKey
                             ),
+                    containerProviders:
+                        container.graph().map(
+                            node =>
+                                node.description
+                        ),
                     pluginCount:
                         plugins.plugins().length,
                 };
@@ -654,6 +749,14 @@ export function createApp<TConfig = unknown>(
             // Preserve the original startup failure.
         }
 
+        if (container.state !== "disposed") {
+            try {
+                await container.dispose();
+            } catch {
+                // Preserve the original startup failure.
+            }
+        }
+
         try {
             await disposeApplication();
         } catch {
@@ -697,7 +800,7 @@ export function createApp<TConfig = unknown>(
     function assertMutable(): void {
         if (state !== "created") {
             throw new Error(
-                "BCP Application: plugins, services and resources must be registered before start()."
+                "BCP Application: plugins, services, providers and resources must be registered before start()."
             );
         }
     }
@@ -747,6 +850,14 @@ function validateDefinition<TConfig>(
         definition.version
     );
 
+    if (
+        definition.providers !== undefined &&
+        !Array.isArray(definition.providers)
+    ) {
+        throw new TypeError(
+            "BCP Application: providers must be an array."
+        );
+    }
     if (
         definition.plugins !== undefined &&
         !Array.isArray(definition.plugins)