@zudojs/core 0.0.1

package/dist/runtime/runtimeOptions/runtimeOptions.type.d.ts

@@ -0,0 +1,94 @@
+import type { ApplicationContext } from "../../application/applicationContext.context.js";
+import type { ConfigurationManager } from "../../configuration/configurationManager.manager.js";
+import type { Logger } from "../../logging/core/logger.js";
+import type { ModuleLoader } from "../../modules/moduleLoader/index.js";
+import type { ModuleLifecycleManager } from "../../modules/moduleLifecycle/index.js";
+import type { ModuleRegistry } from "../../modules/moduleRegistry/index.js";
+/**
+ * Runtime execution mode.
+ */
+export type RuntimeMode = "development" | "test" | "production";
+/**
+ * Runtime role.
+ */
+export type RuntimeRole = "application" | "api" | "worker" | "scheduler" | "cli";
+/**
+ * Options controlling runtime startup behavior.
+ */
+export interface RuntimeStartupOptions {
+    readonly autoLoadModules?: boolean;
+    readonly autoInitializeModules?: boolean;
+    readonly autoStartModules?: boolean;
+    readonly continueOnInitializeError?: boolean;
+    readonly continueOnStartError?: boolean;
+    readonly timeoutMs?: number;
+}
+/**
+ * Options controlling runtime shutdown.
+ */
+export interface RuntimeShutdownOptions {
+    readonly autoStopModules?: boolean;
+    readonly autoDestroyModules?: boolean;
+    readonly continueOnStopError?: boolean;
+    readonly continueOnDestroyError?: boolean;
+    readonly timeoutMs?: number;
+}
+/**
+ * Options related to runtime process signals.
+ */
+export interface RuntimeSignalOptions {
+    readonly handleSigint?: boolean;
+    readonly handleSigterm?: boolean;
+    readonly handleSighup?: boolean;
+    readonly handleUncaughtException?: boolean;
+    readonly handleUnhandledRejection?: boolean;
+}
+/**
+ * Options controlling runtime diagnostics.
+ */
+export interface RuntimeDiagnosticsOptions {
+    readonly startupLogging?: boolean;
+    readonly shutdownLogging?: boolean;
+    readonly includeState?: boolean;
+    readonly includeModules?: boolean;
+}
+/**
+ * Dependencies that can be supplied to the runtime.
+ */
+export interface RuntimeInfrastructure {
+    readonly application: ApplicationContext;
+    readonly configuration: ConfigurationManager;
+    readonly logger: Logger;
+    readonly moduleRegistry: ModuleRegistry;
+    readonly moduleLoader: ModuleLoader;
+    readonly moduleLifecycle: ModuleLifecycleManager;
+}
+/**
+ * Complete runtime options.
+ */
+export interface RuntimeOptions {
+    readonly name?: string;
+    readonly mode?: RuntimeMode;
+    readonly role?: RuntimeRole;
+    readonly startup?: RuntimeStartupOptions;
+    readonly shutdown?: RuntimeShutdownOptions;
+    readonly signals?: RuntimeSignalOptions;
+    readonly diagnostics?: RuntimeDiagnosticsOptions;
+    readonly infrastructure?: Partial<RuntimeInfrastructure>;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Fully normalized runtime options.
+ */
+export interface ResolvedRuntimeOptions {
+    readonly name: string;
+    readonly mode: RuntimeMode;
+    readonly role: RuntimeRole;
+    readonly startup: Required<RuntimeStartupOptions>;
+    readonly shutdown: Required<RuntimeShutdownOptions>;
+    readonly signals: Required<RuntimeSignalOptions>;
+    readonly diagnostics: Required<RuntimeDiagnosticsOptions>;
+    readonly infrastructure: Partial<RuntimeInfrastructure>;
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+//# sourceMappingURL=runtimeOptions.type.d.ts.map

package/dist/runtime/runtimeOptions/runtimeOptions.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeOptions.type.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeOptions/runtimeOptions.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAEhG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,WAAW,GACrB,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;IAC1D,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD"}

package/dist/runtime/runtimeOptions/runtimeOptions.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtimeOptions.type.js.map

package/dist/runtime/runtimeOptions/runtimeOptions.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeOptions.type.js","sourceRoot":"","sources":["../../../src/runtime/runtimeOptions/runtimeOptions.type.ts"],"names":[],"mappings":""}

package/dist/runtime/runtimeOptions/runtimeOptions.validation.d.ts

@@ -0,0 +1,26 @@
+import type { RuntimeMode, RuntimeRole } from "./runtimeOptions.type.js";
+/**
+ * Validates a runtime mode.
+ */
+export declare function assertRuntimeMode(value: unknown): asserts value is RuntimeMode;
+/**
+ * Validates a runtime role.
+ */
+export declare function assertRuntimeRole(value: unknown): asserts value is RuntimeRole;
+/**
+ * Checks whether a runtime mode is valid.
+ */
+export declare function isRuntimeMode(value: unknown): value is RuntimeMode;
+/**
+ * Checks whether a runtime role is valid.
+ */
+export declare function isRuntimeRole(value: unknown): value is RuntimeRole;
+/**
+ * Validates the runtime name.
+ */
+export declare function validateRuntimeName(name: string | undefined): void;
+/**
+ * Validates a runtime timeout.
+ */
+export declare function validateRuntimeTimeout(timeout: number | undefined, field: "startup" | "shutdown"): void;
+//# sourceMappingURL=runtimeOptions.validation.d.ts.map

package/dist/runtime/runtimeOptions/runtimeOptions.validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeOptions.validation.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeOptions/runtimeOptions.validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIzE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,WAAW,CAM9B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,WAAW,CAI9B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAQlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAYlE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,SAAS,GAAG,UAAU,GAC5B,IAAI,CAUN"}

package/dist/runtime/runtimeOptions/runtimeOptions.validation.js

@@ -0,0 +1,59 @@
+import { DEFAULT_RUNTIME_OPTIONS } from "./runtimeOptions.defaults.js";
+/**
+ * Validates a runtime mode.
+ */
+export function assertRuntimeMode(value) {
+    if (!isRuntimeMode(value)) {
+        throw new TypeError(`Invalid runtime mode "${String(value)}". Expected development, test, or production.`);
+    }
+}
+/**
+ * Validates a runtime role.
+ */
+export function assertRuntimeRole(value) {
+    if (!isRuntimeRole(value)) {
+        throw new TypeError(`Invalid runtime role "${String(value)}".`);
+    }
+}
+/**
+ * Checks whether a runtime mode is valid.
+ */
+export function isRuntimeMode(value) {
+    return value === "development" || value === "test" || value === "production";
+}
+/**
+ * Checks whether a runtime role is valid.
+ */
+export function isRuntimeRole(value) {
+    return (value === "application" ||
+        value === "api" ||
+        value === "worker" ||
+        value === "scheduler" ||
+        value === "cli");
+}
+/**
+ * Validates the runtime name.
+ */
+export function validateRuntimeName(name) {
+    if (name === undefined) {
+        return;
+    }
+    if (typeof name !== "string") {
+        throw new TypeError("Runtime name must be a string.");
+    }
+    if (name.trim().length === 0) {
+        throw new TypeError("Runtime name cannot be empty.");
+    }
+}
+/**
+ * Validates a runtime timeout.
+ */
+export function validateRuntimeTimeout(timeout, field) {
+    if (timeout === undefined) {
+        return;
+    }
+    if (!Number.isFinite(timeout) || timeout < 0) {
+        throw new TypeError(`${field} timeout must be a finite number greater than or equal to 0.`);
+    }
+}
+//# sourceMappingURL=runtimeOptions.validation.js.map

package/dist/runtime/runtimeOptions/runtimeOptions.validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeOptions.validation.js","sourceRoot":"","sources":["../../../src/runtime/runtimeOptions/runtimeOptions.validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAc;IAEd,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CACjB,yBAAyB,MAAM,CAAC,KAAK,CAAC,+CAA+C,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAc;IAEd,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,YAAY,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,KAAK;QACf,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,KAAK,CAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAA2B,EAC3B,KAA6B;IAE7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,SAAS,CACjB,GAAG,KAAK,8DAA8D,CACvE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/runtime/runtimeShutdown/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runtime Shutdown
+ *
+ * Handles the shutdown pipeline for stopping and
+ * destroying runtime modules.
+ */
+export { DefaultRuntimeShutdown, RuntimeShutdownError, withShutdownTimeout, createShutdownResult, } from "./runtimeShutdown.core.js";
+export { executeShutdownPipeline } from "./pipeline/index.js";
+export type { RuntimeShutdownDependencies, RuntimeShutdownConfig, RuntimeShutdownPhase, RuntimeShutdownErrorInfo, RuntimeShutdownResult, RuntimeShutdown, ResolvedShutdownOptions, } from "./runtimeShutdown.type.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/runtimeShutdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeShutdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,YAAY,EACV,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/runtime/runtimeShutdown/index.js

@@ -0,0 +1,9 @@
+/**
+ * Runtime Shutdown
+ *
+ * Handles the shutdown pipeline for stopping and
+ * destroying runtime modules.
+ */
+export { DefaultRuntimeShutdown, RuntimeShutdownError, withShutdownTimeout, createShutdownResult, } from "./runtimeShutdown.core.js";
+export { executeShutdownPipeline } from "./pipeline/index.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/runtimeShutdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/runtimeShutdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime/runtimeShutdown/pipeline/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shutdown Pipeline
+ *
+ * Module stopping and destruction stages.
+ */
+export { executeShutdownPipeline } from "./runtimeShutdown.pipeline.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/runtimeShutdown/pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/runtimeShutdown/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime/runtimeShutdown/pipeline/index.js

@@ -0,0 +1,7 @@
+/**
+ * Shutdown Pipeline
+ *
+ * Module stopping and destruction stages.
+ */
+export { executeShutdownPipeline } from "./runtimeShutdown.pipeline.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/runtimeShutdown/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/runtimeShutdown/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime/runtimeShutdown/pipeline/runtimeShutdown.pipeline.d.ts

@@ -0,0 +1,9 @@
+import type { ModuleLifecycleManager } from "../../../modules/moduleLifecycle/index.js";
+import type { RuntimeShutdownPhase, RuntimeShutdownErrorInfo, ResolvedShutdownOptions } from "../runtimeShutdown.type.js";
+type LogFn = (level: "debug" | "info" | "warn" | "error", message: string, metadata?: Record<string, unknown>) => void;
+export declare function executeShutdownPipeline(options: ResolvedShutdownOptions, errors: RuntimeShutdownErrorInfo[], counters: {
+    incrementStopped(): void;
+    incrementDestroyed(): void;
+}, moduleLifecycle: ModuleLifecycleManager, setPhase: (phase: RuntimeShutdownPhase) => void, log: LogFn): Promise<void>;
+export {};
+//# sourceMappingURL=runtimeShutdown.pipeline.d.ts.map

package/dist/runtime/runtimeShutdown/pipeline/runtimeShutdown.pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShutdown.pipeline.d.ts","sourceRoot":"","sources":["../../../../src/runtime/runtimeShutdown/pipeline/runtimeShutdown.pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAGpC,KAAK,KAAK,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAAI,CAAC;AAwFV,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,EAChC,MAAM,EAAE,wBAAwB,EAAE,EAClC,QAAQ,EAAE;IAAE,gBAAgB,IAAI,IAAI,CAAC;IAAC,kBAAkB,IAAI,IAAI,CAAA;CAAE,EAClE,eAAe,EAAE,sBAAsB,EACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,EAC/C,GAAG,EAAE,KAAK,GACT,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/runtime/runtimeShutdown/pipeline/runtimeShutdown.pipeline.js

@@ -0,0 +1,67 @@
+import { RuntimeShutdownError } from "../runtimeShutdown.core.js";
+async function stopModules(errors, counters, continueOnError, moduleLifecycle, setPhase, log) {
+    setPhase("stopping");
+    log("debug", "Stopping runtime modules.");
+    try {
+        await invokeStopModules(moduleLifecycle);
+        setPhase("stopped");
+        counters.incrementStopped();
+        log("debug", "Runtime modules stopped.");
+    }
+    catch (error) {
+        errors.push({ phase: "stopping", error });
+        if (!continueOnError) {
+            throw new RuntimeShutdownError("Failed to stop runtime modules.", "MODULE_STOP_FAILED", error);
+        }
+        log("warn", "Runtime module shutdown reported an error. Continuing.", {
+            error,
+        });
+    }
+}
+async function destroyModules(errors, counters, continueOnError, moduleLifecycle, setPhase, log) {
+    setPhase("destroying");
+    log("debug", "Destroying runtime modules.");
+    try {
+        await invokeDestroyModules(moduleLifecycle);
+        setPhase("destroyed");
+        counters.incrementDestroyed();
+        log("debug", "Runtime modules destroyed.");
+    }
+    catch (error) {
+        errors.push({ phase: "destroying", error });
+        if (!continueOnError) {
+            throw new RuntimeShutdownError("Failed to destroy runtime modules.", "MODULE_DESTROY_FAILED", error);
+        }
+        log("warn", "Runtime module destruction reported an error. Continuing.", {
+            error,
+        });
+    }
+}
+async function invokeStopModules(moduleLifecycle) {
+    if (typeof moduleLifecycle.stop === "function") {
+        await moduleLifecycle.stop();
+        return;
+    }
+    throw new RuntimeShutdownError("ModuleLifecycleManager does not expose a supported stop method.", "MODULE_STOP_METHOD_NOT_FOUND");
+}
+async function invokeDestroyModules(moduleLifecycle) {
+    if (typeof moduleLifecycle.destroy === "function") {
+        await moduleLifecycle.destroy();
+        return;
+    }
+    throw new RuntimeShutdownError("ModuleLifecycleManager does not expose a supported destroy method.", "MODULE_DESTROY_METHOD_NOT_FOUND");
+}
+export async function executeShutdownPipeline(options, errors, counters, moduleLifecycle, setPhase, log) {
+    if (options.stopModules) {
+        await stopModules(errors, counters, options.continueOnStopError, moduleLifecycle, setPhase, log);
+    }
+    if (options.destroyModules) {
+        await destroyModules(errors, counters, options.continueOnDestroyError, moduleLifecycle, setPhase, log);
+    }
+    if (errors.length > 0 &&
+        !options.continueOnStopError &&
+        !options.continueOnDestroyError) {
+        throw new RuntimeShutdownError("Runtime shutdown completed with module errors.", "SHUTDOWN_MODULE_ERRORS", errors);
+    }
+}
+//# sourceMappingURL=runtimeShutdown.pipeline.js.map

package/dist/runtime/runtimeShutdown/pipeline/runtimeShutdown.pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShutdown.pipeline.js","sourceRoot":"","sources":["../../../../src/runtime/runtimeShutdown/pipeline/runtimeShutdown.pipeline.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtimeShutdown/runtimeShutdown.core.d.ts

@@ -0,0 +1,35 @@
+import type { ResolvedRuntimeOptions } from "../runtimeOptions/index.js";
+import type { RuntimeShutdownDependencies, RuntimeShutdownConfig, RuntimeShutdownPhase, RuntimeShutdownResult, RuntimeShutdown, RuntimeShutdownErrorInfo } from "./runtimeShutdown.type.js";
+import { Context } from "../../context/core/context.js";
+import { RuntimeError } from "@zudojs/errors";
+export type RuntimeShutdownErrorCode = "SHUTDOWN_ALREADY_RUNNING" | "SHUTDOWN_ALREADY_COMPLETED" | "SHUTDOWN_FAILED" | "SHUTDOWN_TIMEOUT" | "SHUTDOWN_MODULE_ERRORS" | "SHUTDOWN_RESET_WHILE_RUNNING" | "MODULE_STOP_FAILED" | "MODULE_DESTROY_FAILED" | "MODULE_STOP_METHOD_NOT_FOUND" | "MODULE_DESTROY_METHOD_NOT_FOUND";
+export declare class RuntimeShutdownError extends RuntimeError {
+    readonly name = "RuntimeShutdownError";
+    readonly shutdownCode: RuntimeShutdownErrorCode;
+    constructor(message: string, code: RuntimeShutdownErrorCode, cause?: unknown);
+}
+export declare function withShutdownTimeout(operation: Promise<void>, timeoutMs: number): Promise<void>;
+export declare function createShutdownResult(success: boolean, phase: RuntimeShutdownPhase, stoppedModules: number, destroyedModules: number, errors: readonly RuntimeShutdownErrorInfo[], startedAt: Date, completedAt: Date): RuntimeShutdownResult;
+export declare class DefaultRuntimeShutdown implements RuntimeShutdown {
+    private readonly _context;
+    private readonly _environment;
+    private readonly _application;
+    private readonly _moduleRegistry;
+    private readonly _moduleLifecycle;
+    private readonly _logger;
+    private readonly _runtimeOptions;
+    private _running;
+    private _phase;
+    private _lastResult;
+    private _shutdownContext?;
+    constructor(dependencies: RuntimeShutdownDependencies, runtimeOptions: ResolvedRuntimeOptions);
+    get running(): boolean;
+    get phase(): RuntimeShutdownPhase;
+    shutdown(options?: RuntimeShutdownConfig): Promise<RuntimeShutdownResult>;
+    private resolveOptions;
+    getLastResult(): RuntimeShutdownResult | undefined;
+    getShutdownContext(): Context | undefined;
+    reset(): void;
+    private log;
+}
+//# sourceMappingURL=runtimeShutdown.core.d.ts.map

package/dist/runtime/runtimeShutdown/runtimeShutdown.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShutdown.core.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeShutdown/runtimeShutdown.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EAEf,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAiB,MAAM,+BAA+B,CAAC;AAIvE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,MAAM,wBAAwB,GAChC,0BAA0B,GAC1B,4BAA4B,GAC5B,iBAAiB,GACjB,kBAAkB,GAClB,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,GACpB,uBAAuB,GACvB,8BAA8B,GAC9B,iCAAiC,CAAC;AAEtC,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,SAAyB,IAAI,0BAA0B;IACvD,SAAgB,YAAY,EAAE,wBAAwB,CAAC;IACvD,YACE,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,wBAAwB,EAC9B,KAAK,CAAC,EAAE,OAAO,EAQhB;CACF;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,oBAAoB,EAC3B,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,wBAAwB,EAAE,EAC3C,SAAS,EAAE,IAAI,EACf,WAAW,EAAE,IAAI,GAChB,qBAAqB,CAWvB;AAED,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;IAC/E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8D;IAC3F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+E;IAC5G,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiE;IACjG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0E;IAC3G,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,gBAAgB,CAAC,CAAU;IAEnC,YACE,YAAY,EAAE,2BAA2B,EACzC,cAAc,EAAE,sBAAsB,EASvC;IAED,IAAW,OAAO,IAAI,OAAO,CAE5B;IACD,IAAW,KAAK,IAAI,oBAAoB,CAEvC;IAEY,QAAQ,CACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAgGhC;IAED,OAAO,CAAC,cAAc;IAmBf,aAAa,IAAI,qBAAqB,GAAG,SAAS,CAExD;IACM,kBAAkB,IAAI,OAAO,GAAG,SAAS,CAE/C;IACM,KAAK,IAAI,IAAI,CASnB;IAED,OAAO,CAAC,GAAG;CAcZ"}

package/dist/runtime/runtimeShutdown/runtimeShutdown.core.js

@@ -0,0 +1,147 @@
+import { Context, createContext } from "../../context/core/context.js";
+import { executeShutdownPipeline } from "./pipeline/index.js";
+import { logRuntimeEvent } from "../runtimeLogger.js";
+import { RuntimeError } from "@zudojs/errors";
+export class RuntimeShutdownError extends RuntimeError {
+    name = "RuntimeShutdownError";
+    shutdownCode;
+    constructor(message, code, cause) {
+        super(message, {
+            code: "RUNTIME_SHUTDOWN",
+            phase: "shutdown",
+            cause,
+        });
+        this.shutdownCode = code;
+    }
+}
+export async function withShutdownTimeout(operation, timeoutMs) {
+    if (timeoutMs <= 0) {
+        await operation;
+        return;
+    }
+    let timer;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            reject(new RuntimeShutdownError(`Runtime shutdown exceeded the configured timeout of ${timeoutMs}ms.`, "SHUTDOWN_TIMEOUT"));
+        }, timeoutMs);
+    });
+    try {
+        await Promise.race([operation, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function createShutdownResult(success, phase, stoppedModules, destroyedModules, errors, startedAt, completedAt) {
+    return Object.freeze({
+        success,
+        phase,
+        stoppedModules,
+        destroyedModules,
+        errors: Object.freeze([...errors]),
+        startedAt,
+        completedAt,
+        durationMs: completedAt.getTime() - startedAt.getTime(),
+    });
+}
+export class DefaultRuntimeShutdown {
+    _context;
+    _environment;
+    _application;
+    _moduleRegistry;
+    _moduleLifecycle;
+    _logger;
+    _runtimeOptions;
+    _running = false;
+    _phase = "created";
+    _lastResult;
+    _shutdownContext;
+    constructor(dependencies, runtimeOptions) {
+        this._context = dependencies.context;
+        this._environment = dependencies.environment;
+        this._application = dependencies.application;
+        this._moduleRegistry = dependencies.moduleRegistry;
+        this._moduleLifecycle = dependencies.moduleLifecycle;
+        this._logger = dependencies.logger;
+        this._runtimeOptions = runtimeOptions;
+    }
+    get running() {
+        return this._running;
+    }
+    get phase() {
+        return this._phase;
+    }
+    async shutdown(options = {}) {
+        if (this._running) {
+            throw new RuntimeShutdownError("Runtime shutdown is already running.", "SHUTDOWN_ALREADY_RUNNING");
+        }
+        if (this._phase === "completed") {
+            throw new RuntimeShutdownError("Runtime has already been shut down.", "SHUTDOWN_ALREADY_COMPLETED");
+        }
+        this._running = true;
+        this._phase = "created";
+        const configuration = this.resolveOptions(options);
+        const errors = [];
+        this._shutdownContext = createContext({
+            application: this._application,
+            type: "worker",
+            id: `${this._context.identity.id}-shutdown`,
+        });
+        try {
+            logRuntimeEvent(this._logger, this._context, this._environment, "info", "Runtime shutdown started.");
+            const operation = executeShutdownPipeline(configuration, errors, { incrementStopped: () => { }, incrementDestroyed: () => { } }, this._moduleLifecycle, (phase) => {
+                this._phase = phase;
+            }, this.log.bind(this));
+            await withShutdownTimeout(operation, configuration.timeoutMs);
+            this._phase = "completed";
+            const completedAt = new Date();
+            const result = createShutdownResult(true, "completed", 0, 0, [], new Date(), completedAt);
+            this._lastResult = result;
+            logRuntimeEvent(this._logger, this._context, this._environment, "info", "Runtime shutdown completed.", { durationMs: result.durationMs });
+            return result;
+        }
+        catch (error) {
+            this._phase = "failed";
+            const shutdownError = error instanceof RuntimeShutdownError
+                ? error
+                : new RuntimeShutdownError("Runtime shutdown failed.", "SHUTDOWN_FAILED", error);
+            const completedAt = new Date();
+            const result = createShutdownResult(false, "failed", 0, 0, [], new Date(), completedAt);
+            this._lastResult = result;
+            logRuntimeEvent(this._logger, this._context, this._environment, "error", "Runtime shutdown failed.", { error: shutdownError });
+            throw shutdownError;
+        }
+        finally {
+            this._running = false;
+        }
+    }
+    resolveOptions(options) {
+        return {
+            stopModules: options.stopModules ?? this._runtimeOptions.shutdown.autoStopModules,
+            destroyModules: options.destroyModules ??
+                this._runtimeOptions.shutdown.autoDestroyModules,
+            continueOnStopError: options.continueOnStopError ??
+                this._runtimeOptions.shutdown.continueOnStopError,
+            continueOnDestroyError: options.continueOnDestroyError ??
+                this._runtimeOptions.shutdown.continueOnDestroyError,
+            timeoutMs: options.timeoutMs ?? this._runtimeOptions.shutdown.timeoutMs,
+        };
+    }
+    getLastResult() {
+        return this._lastResult;
+    }
+    getShutdownContext() {
+        return this._shutdownContext;
+    }
+    reset() {
+        if (this._running) {
+            throw new RuntimeShutdownError("Cannot reset runtime shutdown while it is running.", "SHUTDOWN_RESET_WHILE_RUNNING");
+        }
+        this._phase = "created";
+        this._lastResult = undefined;
+    }
+    log(level, message, metadata) {
+        logRuntimeEvent(this._logger, this._context, this._environment, level, message, metadata);
+    }
+}
+//# sourceMappingURL=runtimeShutdown.core.js.map

package/dist/runtime/runtimeShutdown/runtimeShutdown.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShutdown.core.js","sourceRoot":"","sources":["../../../src/runtime/runtimeShutdown/runtimeShutdown.core.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtimeShutdown/runtimeShutdown.type.d.ts

@@ -0,0 +1,74 @@
+import type { Logger } from "../../logging/core/logger.js";
+import type { ApplicationContext } from "../../application/applicationContext.context.js";
+import type { ModuleLifecycleManager } from "../../modules/moduleLifecycle/index.js";
+import type { ModuleRegistry } from "../../modules/moduleRegistry/index.js";
+import type { RuntimeContext } from "../runtimeContext/index.js";
+import type { RuntimeEnvironment } from "../runtimeEnvironment/index.js";
+/**
+ * Dependencies required by RuntimeShutdown.
+ */
+export interface RuntimeShutdownDependencies {
+    readonly context: RuntimeContext;
+    readonly environment: RuntimeEnvironment;
+    readonly application: ApplicationContext;
+    readonly moduleRegistry: ModuleRegistry;
+    readonly moduleLifecycle: ModuleLifecycleManager;
+    readonly logger: Logger;
+}
+/**
+ * Options for a shutdown operation.
+ */
+export interface RuntimeShutdownConfig {
+    readonly stopModules?: boolean;
+    readonly destroyModules?: boolean;
+    readonly continueOnStopError?: boolean;
+    readonly continueOnDestroyError?: boolean;
+    readonly timeoutMs?: number;
+}
+/**
+ * Individual shutdown phase.
+ */
+export type RuntimeShutdownPhase = "created" | "stopping" | "stopped" | "destroying" | "destroyed" | "completed" | "failed";
+/**
+ * Error captured during shutdown.
+ */
+export interface RuntimeShutdownErrorInfo {
+    readonly phase: RuntimeShutdownPhase;
+    readonly error: unknown;
+    readonly moduleName?: string;
+}
+/**
+ * Result of a shutdown operation.
+ */
+export interface RuntimeShutdownResult {
+    readonly success: boolean;
+    readonly phase: RuntimeShutdownPhase;
+    readonly stoppedModules: number;
+    readonly destroyedModules: number;
+    readonly errors: readonly RuntimeShutdownErrorInfo[];
+    readonly startedAt: Date;
+    readonly completedAt: Date;
+    readonly durationMs: number;
+}
+/**
+ * Runtime shutdown contract.
+ */
+export interface RuntimeShutdown {
+    readonly running: boolean;
+    readonly phase: RuntimeShutdownPhase;
+    shutdown(options?: RuntimeShutdownConfig): Promise<RuntimeShutdownResult>;
+    getLastResult(): RuntimeShutdownResult | undefined;
+    getShutdownContext(): import("../../context/core/context.js").Context | undefined;
+    reset(): void;
+}
+/**
+ * Internal resolved shutdown configuration.
+ */
+export interface ResolvedShutdownOptions {
+    readonly stopModules: boolean;
+    readonly destroyModules: boolean;
+    readonly continueOnStopError: boolean;
+    readonly continueOnDestroyError: boolean;
+    readonly timeoutMs: number;
+}
+//# sourceMappingURL=runtimeShutdown.type.d.ts.map

package/dist/runtime/runtimeShutdown/runtimeShutdown.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShutdown.type.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeShutdown/runtimeShutdown.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1E,aAAa,IAAI,qBAAqB,GAAG,SAAS,CAAC;IACnD,kBAAkB,IAChB,OAAO,+BAA+B,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9D,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/runtime/runtimeShutdown/runtimeShutdown.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtimeShutdown.type.js.map

package/dist/runtime/runtimeShutdown/runtimeShutdown.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShutdown.type.js","sourceRoot":"","sources":["../../../src/runtime/runtimeShutdown/runtimeShutdown.type.ts"],"names":[],"mappings":""}