@zudojs/core 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeBootstrap.pipeline.d.ts","sourceRoot":"","sources":["../../../../src/runtime/runtimeBootstrap/pipeline/runtimeBootstrap.pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAOrC,MAAM,MAAM,yBAAyB,GACjC,2BAA2B,GAC3B,6BAA6B,GAC7B,kBAAkB,GAClB,mBAAmB,GACnB,yBAAyB,GACzB,+BAA+B,GAC/B,oBAAoB,GACpB,8BAA8B,GAC9B,qBAAqB,GACrB,gCAAgC,GAChC,oCAAoC,GACpC,+BAA+B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEpF,qBAAa,qBAAsB,SAAQ,yBAAyB;IAClE,SAAgB,aAAa,EAAE,yBAAyB,CAAC;IACzD,YACE,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,yBAAyB,EAC/B,KAAK,CAAC,EAAE,OAAO,EAIhB;CACF;AAED,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,wBAAwB,CAC5C,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,yBAAyB,EAAE,EACnC,QAAQ,EAAE;IACR,eAAe,IAAI,IAAI,CAAC;IACxB,oBAAoB,IAAI,IAAI,CAAC;IAC7B,gBAAgB,IAAI,IAAI,CAAC;CAC1B,EACD,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,sBAAsB,EACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,EAChD,GAAG,EAAE,KAAK,GACT,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,qBAAqB,EAC5B,aAAa,EAAE,MAAM,EACrB,kBAAkB,EAAE,MAAM,EAC1B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,SAAS,yBAAyB,EAAE,EAC5C,SAAS,EAAE,IAAI,EACf,WAAW,EAAE,IAAI,GAChB,OAAO,6BAA6B,EAAE,sBAAsB,CAY9D"}

package/dist/runtime/runtimeBootstrap/pipeline/runtimeBootstrap.pipeline.js

@@ -0,0 +1,107 @@
+import { invokeModuleLoader, invokeInitializeModules, invokeStartModules, } from "./runtimeBootstrap.invoke.js";
+import { RuntimeBootstrapError as BaseRuntimeBootstrapError } from "@zudojs/errors";
+export class RuntimeBootstrapError extends BaseRuntimeBootstrapError {
+    bootstrapCode;
+    constructor(message, code, cause) {
+        super(message, { cause });
+        this.bootstrapCode = code;
+    }
+}
+async function loadModules(errors, counters, moduleLoader, setPhase, log) {
+    setPhase("loading");
+    log("debug", "Loading runtime modules.");
+    try {
+        await invokeModuleLoader(moduleLoader);
+        setPhase("loaded");
+        counters.incrementLoaded();
+        log("debug", "Runtime modules loaded.");
+    }
+    catch (error) {
+        errors.push({ phase: "loading", error });
+        throw new RuntimeBootstrapError("Failed to load runtime modules.", "MODULE_LOAD_FAILED", error);
+    }
+}
+async function initializeModules(errors, counters, continueOnError, moduleLifecycle, setPhase, log) {
+    setPhase("initializing");
+    log("debug", "Initializing runtime modules.");
+    try {
+        await invokeInitializeModules(moduleLifecycle);
+        setPhase("initialized");
+        counters.incrementInitialized();
+        log("debug", "Runtime modules initialized.");
+    }
+    catch (error) {
+        errors.push({ phase: "initializing", error });
+        if (!continueOnError) {
+            throw new RuntimeBootstrapError("Failed to initialize runtime modules.", "MODULE_INITIALIZATION_FAILED", error);
+        }
+        log("warn", "Runtime module initialization reported an error. Continuing.", { error });
+    }
+}
+async function startModules(errors, counters, continueOnError, moduleLifecycle, setPhase, log) {
+    setPhase("starting");
+    log("debug", "Starting runtime modules.");
+    try {
+        await invokeStartModules(moduleLifecycle);
+        setPhase("started");
+        counters.incrementStarted();
+        log("debug", "Runtime modules started.");
+    }
+    catch (error) {
+        errors.push({ phase: "starting", error });
+        if (!continueOnError) {
+            throw new RuntimeBootstrapError("Failed to start runtime modules.", "MODULE_START_FAILED", error);
+        }
+        log("warn", "Runtime module startup reported an error. Continuing.", {
+            error,
+        });
+    }
+}
+export async function executeBootstrapPipeline(options, errors, counters, moduleLoader, moduleLifecycle, setPhase, log) {
+    if (options.loadModules) {
+        await loadModules(errors, counters, moduleLoader, setPhase, log);
+    }
+    if (options.initializeModules) {
+        await initializeModules(errors, counters, options.continueOnInitializeError, moduleLifecycle, setPhase, log);
+    }
+    if (options.startModules) {
+        await startModules(errors, counters, options.continueOnStartError, moduleLifecycle, setPhase, log);
+    }
+    if (errors.length > 0 &&
+        !options.continueOnInitializeError &&
+        !options.continueOnStartError) {
+        throw new RuntimeBootstrapError("Runtime bootstrap completed with module errors.", "BOOTSTRAP_MODULE_ERRORS", errors);
+    }
+}
+export async function withTimeout(operation, timeoutMs) {
+    if (timeoutMs <= 0) {
+        await operation;
+        return;
+    }
+    let timer;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            reject(new RuntimeBootstrapError(`Runtime bootstrap exceeded the configured timeout of ${timeoutMs}ms.`, "BOOTSTRAP_TIMEOUT"));
+        }, timeoutMs);
+    });
+    try {
+        await Promise.race([operation, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function createBootstrapResult(success, phase, loadedModules, initializedModules, startedModules, errors, startedAt, completedAt) {
+    return Object.freeze({
+        success,
+        phase,
+        loadedModules,
+        initializedModules,
+        startedModules,
+        errors: Object.freeze([...errors]),
+        startedAt,
+        completedAt,
+        durationMs: completedAt.getTime() - startedAt.getTime(),
+    });
+}
+//# sourceMappingURL=runtimeBootstrap.pipeline.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { ResolvedRuntimeOptions } from "../runtimeOptions/index.js";
+import type { RuntimeBootstrapDependencies, RuntimeBootstrapOptions, RuntimeBootstrapPhase, RuntimeBootstrapResult, RuntimeBootstrap } from "./runtimeBootstrap.type.js";
+export declare class DefaultRuntimeBootstrap implements RuntimeBootstrap {
+    private readonly _context;
+    private readonly _environment;
+    private readonly _application;
+    private readonly _moduleLoader;
+    private readonly _moduleRegistry;
+    private readonly _moduleLifecycle;
+    private readonly _logger;
+    private readonly _runtimeOptions;
+    private _running;
+    private _phase;
+    private _lastResult;
+    private _bootstrapContext?;
+    constructor(dependencies: RuntimeBootstrapDependencies, runtimeOptions: ResolvedRuntimeOptions);
+    get running(): boolean;
+    get phase(): RuntimeBootstrapPhase;
+    bootstrap(options?: RuntimeBootstrapOptions): Promise<RuntimeBootstrapResult>;
+    private resolveOptions;
+    getLastResult(): RuntimeBootstrapResult | undefined;
+    reset(): void;
+    private log;
+}
+//# sourceMappingURL=runtimeBootstrap.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeBootstrap.core.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeBootstrap/runtimeBootstrap.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAGjB,MAAM,4BAA4B,CAAC;AAUpC,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,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,aAAa,CAA6D;IAC3F,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,CAAoC;IAClD,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,iBAAiB,CAAC,CAAU;IAEpC,YACE,YAAY,EAAE,4BAA4B,EAC1C,cAAc,EAAE,sBAAsB,EAUvC;IAED,IAAW,OAAO,IAAI,OAAO,CAE5B;IACD,IAAW,KAAK,IAAI,qBAAqB,CAExC;IAEY,SAAS,CACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAuHjC;IAED,OAAO,CAAC,cAAc;IAqBf,aAAa,IAAI,sBAAsB,GAAG,SAAS,CAEzD;IACM,KAAK,IAAI,IAAI,CASnB;IAED,OAAO,CAAC,GAAG;CAcZ"}

package/dist/runtime/runtimeBootstrap/runtimeBootstrap.core.js

@@ -0,0 +1,122 @@
+import { Context, createContext } from "../../context/core/context.js";
+import { executeBootstrapPipeline, RuntimeBootstrapError, withTimeout, createBootstrapResult, } from "./pipeline/index.js";
+import { logRuntimeEvent } from "../runtimeLogger.js";
+export class DefaultRuntimeBootstrap {
+    _context;
+    _environment;
+    _application;
+    _moduleLoader;
+    _moduleRegistry;
+    _moduleLifecycle;
+    _logger;
+    _runtimeOptions;
+    _running = false;
+    _phase = "created";
+    _lastResult;
+    _bootstrapContext;
+    constructor(dependencies, runtimeOptions) {
+        this._context = dependencies.context;
+        this._environment = dependencies.environment;
+        this._application = dependencies.application;
+        this._moduleLoader = dependencies.moduleLoader;
+        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 bootstrap(options = {}) {
+        if (this._running) {
+            throw new RuntimeBootstrapError("Runtime bootstrap is already running.", "BOOTSTRAP_ALREADY_RUNNING");
+        }
+        if (this._phase === "completed") {
+            throw new RuntimeBootstrapError("Runtime has already been bootstrapped.", "BOOTSTRAP_ALREADY_COMPLETED");
+        }
+        this._running = true;
+        this._phase = "created";
+        const startedAt = new Date();
+        const errors = [];
+        let loadedModules = 0, initializedModules = 0, startedModules = 0;
+        const configuration = this.resolveOptions(options);
+        this._bootstrapContext = createContext({
+            application: this._application,
+            type: "worker",
+            id: this._context.identity.id,
+        });
+        try {
+            logRuntimeEvent(this._logger, this._context, this._environment, "info", "Runtime bootstrap started.");
+            const operation = executeBootstrapPipeline(configuration, errors, {
+                incrementLoaded: () => {
+                    loadedModules += 1;
+                },
+                incrementInitialized: () => {
+                    initializedModules += 1;
+                },
+                incrementStarted: () => {
+                    startedModules += 1;
+                },
+            }, this._moduleLoader, this._moduleLifecycle, (phase) => {
+                this._phase = phase;
+            }, this.log.bind(this));
+            await withTimeout(operation, configuration.timeoutMs);
+            this._phase = "completed";
+            const completedAt = new Date();
+            const result = createBootstrapResult(true, "completed", loadedModules, initializedModules, startedModules, errors, startedAt, completedAt);
+            this._lastResult = result;
+            logRuntimeEvent(this._logger, this._context, this._environment, "info", "Runtime bootstrap completed.", {
+                durationMs: result.durationMs,
+                loadedModules,
+                initializedModules,
+                startedModules,
+            });
+            return result;
+        }
+        catch (error) {
+            this._phase = "failed";
+            const bootstrapError = error instanceof RuntimeBootstrapError
+                ? error
+                : new RuntimeBootstrapError("Runtime bootstrap failed.", "BOOTSTRAP_FAILED", error);
+            errors.push({ phase: this._phase, error: bootstrapError });
+            const completedAt = new Date();
+            const result = createBootstrapResult(false, "failed", loadedModules, initializedModules, startedModules, errors, startedAt, completedAt);
+            this._lastResult = result;
+            logRuntimeEvent(this._logger, this._context, this._environment, "error", "Runtime bootstrap failed.", { error: bootstrapError });
+            throw bootstrapError;
+        }
+        finally {
+            this._running = false;
+        }
+    }
+    resolveOptions(options) {
+        return {
+            loadModules: options.loadModules ?? this._runtimeOptions.startup.autoLoadModules,
+            initializeModules: options.initializeModules ??
+                this._runtimeOptions.startup.autoInitializeModules,
+            startModules: options.startModules ?? this._runtimeOptions.startup.autoStartModules,
+            continueOnInitializeError: options.continueOnInitializeError ??
+                this._runtimeOptions.startup.continueOnInitializeError,
+            continueOnStartError: options.continueOnStartError ??
+                this._runtimeOptions.startup.continueOnStartError,
+            timeoutMs: options.timeoutMs ?? this._runtimeOptions.startup.timeoutMs,
+        };
+    }
+    getLastResult() {
+        return this._lastResult;
+    }
+    reset() {
+        if (this._running) {
+            throw new RuntimeBootstrapError("Cannot reset runtime bootstrap while it is running.", "BOOTSTRAP_RESET_WHILE_RUNNING");
+        }
+        this._phase = "created";
+        this._lastResult = undefined;
+    }
+    log(level, message, metadata) {
+        logRuntimeEvent(this._logger, this._context, this._environment, level, message, metadata);
+    }
+}
+//# sourceMappingURL=runtimeBootstrap.core.js.map

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

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

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

@@ -0,0 +1,78 @@
+import type { Logger } from "../../logging/core/logger.js";
+import type { ApplicationContext } from "../../application/applicationContext.context.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";
+import type { RuntimeContext } from "../runtimeContext/index.js";
+import type { RuntimeEnvironment } from "../runtimeEnvironment/index.js";
+/**
+ * Dependencies required by RuntimeBootstrap.
+ */
+export interface RuntimeBootstrapDependencies {
+    readonly context: RuntimeContext;
+    readonly environment: RuntimeEnvironment;
+    readonly application: ApplicationContext;
+    readonly moduleLoader: ModuleLoader;
+    readonly moduleRegistry: ModuleRegistry;
+    readonly moduleLifecycle: ModuleLifecycleManager;
+    readonly logger: Logger;
+}
+/**
+ * Options for a bootstrap operation.
+ */
+export interface RuntimeBootstrapOptions {
+    readonly loadModules?: boolean;
+    readonly initializeModules?: boolean;
+    readonly startModules?: boolean;
+    readonly continueOnInitializeError?: boolean;
+    readonly continueOnStartError?: boolean;
+    readonly timeoutMs?: number;
+}
+/**
+ * Individual bootstrap phase.
+ */
+export type RuntimeBootstrapPhase = "created" | "loading" | "loaded" | "initializing" | "initialized" | "starting" | "started" | "completed" | "failed";
+/**
+ * Represents an error produced by a bootstrap phase.
+ */
+export interface RuntimeBootstrapErrorInfo {
+    readonly phase: RuntimeBootstrapPhase;
+    readonly error: unknown;
+    readonly moduleName?: string;
+}
+/**
+ * Result of a bootstrap operation.
+ */
+export interface RuntimeBootstrapResult {
+    readonly success: boolean;
+    readonly phase: RuntimeBootstrapPhase;
+    readonly loadedModules: number;
+    readonly initializedModules: number;
+    readonly startedModules: number;
+    readonly errors: readonly RuntimeBootstrapErrorInfo[];
+    readonly startedAt: Date;
+    readonly completedAt: Date;
+    readonly durationMs: number;
+}
+/**
+ * Runtime bootstrap contract.
+ */
+export interface RuntimeBootstrap {
+    readonly running: boolean;
+    readonly phase: RuntimeBootstrapPhase;
+    bootstrap(options?: RuntimeBootstrapOptions): Promise<RuntimeBootstrapResult>;
+    getLastResult(): RuntimeBootstrapResult | undefined;
+    reset(): void;
+}
+/**
+ * Internal resolved bootstrap configuration.
+ */
+export interface ResolvedBootstrapOptions {
+    readonly loadModules: boolean;
+    readonly initializeModules: boolean;
+    readonly startModules: boolean;
+    readonly continueOnInitializeError: boolean;
+    readonly continueOnStartError: boolean;
+    readonly timeoutMs: number;
+}
+//# sourceMappingURL=runtimeBootstrap.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeBootstrap.type.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeBootstrap/runtimeBootstrap.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,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,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,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,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,uBAAuB;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,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,MAAM,qBAAqB,GAC7B,SAAS,GACT,SAAS,GACT,QAAQ,GACR,cAAc,GACd,aAAa,GACb,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACtD,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,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,SAAS,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC9E,aAAa,IAAI,sBAAsB,GAAG,SAAS,CAAC;IACpD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/runtime/runtimeBootstrap/runtimeBootstrap.type.js

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

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Runtime Context
+ *
+ * Provides read-only access to the runtime environment and
+ * runtime-owned infrastructure.
+ */
+export { DefaultRuntimeContext } from "./runtimeContext.core.js";
+export { createRuntimeId, createRuntimeIdentity, createRuntimeContext, } from "./runtimeContext.factory.js";
+export type { RuntimeIdentity, RuntimeTiming, RuntimeContextDependencies, RuntimeContext, RuntimeContextState, } from "./runtimeContext.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeContext/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,eAAe,EACf,aAAa,EACb,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,GACpB,MAAM,0BAA0B,CAAC"}

package/dist/runtime/runtimeContext/index.js

@@ -0,0 +1,9 @@
+/**
+ * Runtime Context
+ *
+ * Provides read-only access to the runtime environment and
+ * runtime-owned infrastructure.
+ */
+export { DefaultRuntimeContext } from "./runtimeContext.core.js";
+export { createRuntimeId, createRuntimeIdentity, createRuntimeContext, } from "./runtimeContext.factory.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/runtimeContext/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,38 @@
+import { RuntimeState } from "../runtimeState.state.js";
+import type { RuntimeStateSnapshot } from "../runtimeState.state.js";
+import type { RuntimeIdentity, RuntimeTiming, RuntimeContextDependencies, RuntimeContext } from "./runtimeContext.type.js";
+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";
+export declare class DefaultRuntimeContext implements RuntimeContext {
+    private readonly _identity;
+    private readonly _metadata;
+    private readonly _application;
+    private readonly _configuration;
+    private readonly _logger;
+    private readonly _moduleRegistry;
+    private readonly _moduleLoader;
+    private readonly _moduleLifecycle;
+    private readonly _state;
+    constructor(identity: RuntimeIdentity, dependencies: RuntimeContextDependencies, metadata?: Readonly<Record<string, unknown>>);
+    get identity(): RuntimeIdentity;
+    get state(): RuntimeState;
+    get timing(): RuntimeTiming;
+    get metadata(): Readonly<Record<string, unknown>>;
+    get application(): ApplicationContext;
+    get configuration(): ConfigurationManager;
+    get logger(): Logger;
+    get moduleRegistry(): ModuleRegistry;
+    get moduleLoader(): ModuleLoader;
+    get moduleLifecycle(): ModuleLifecycleManager;
+    getStateSnapshot(): RuntimeStateSnapshot;
+    get<T = unknown>(key: string): T | undefined;
+    has(key: string): boolean;
+    getUptime(): number;
+    setState(state: RuntimeState): void;
+    private updateTimingForState;
+}
+//# sourceMappingURL=runtimeContext.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeContext.core.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeContext/runtimeContext.core.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEb,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,0BAA0B,EAC1B,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,YACE,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,0BAA0B,EACxC,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,EAcjD;IAED,IAAW,QAAQ,IAAI,eAAe,CAErC;IACD,IAAW,KAAK,IAAI,YAAY,CAE/B;IACD,IAAW,MAAM,IAAI,aAAa,CAEjC;IACD,IAAW,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEvD;IACD,IAAW,WAAW,IAAI,kBAAkB,CAE3C;IACD,IAAW,aAAa,IAAI,oBAAoB,CAE/C;IACD,IAAW,MAAM,IAAI,MAAM,CAE1B;IACD,IAAW,cAAc,IAAI,cAAc,CAE1C;IACD,IAAW,YAAY,IAAI,YAAY,CAEtC;IACD,IAAW,eAAe,IAAI,sBAAsB,CAEnD;IAEM,gBAAgB,IAAI,oBAAoB,CAE9C;IAEM,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAElD;IAEM,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/B;IAEM,SAAS,IAAI,MAAM,CAEzB;IAEM,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAGzC;IAED,OAAO,CAAC,oBAAoB;CA2B7B"}

package/dist/runtime/runtimeContext/runtimeContext.core.js

@@ -0,0 +1,99 @@
+import { RuntimeState, createRuntimeStateSnapshot, } from "../runtimeState.state.js";
+export class DefaultRuntimeContext {
+    _identity;
+    _metadata;
+    _application;
+    _configuration;
+    _logger;
+    _moduleRegistry;
+    _moduleLoader;
+    _moduleLifecycle;
+    _state;
+    constructor(identity, dependencies, metadata = {}) {
+        this._identity = Object.freeze({ ...identity });
+        this._metadata = Object.freeze({ ...metadata });
+        this._application = dependencies.application;
+        this._configuration = dependencies.configuration;
+        this._logger = dependencies.logger;
+        this._moduleRegistry = dependencies.moduleRegistry;
+        this._moduleLoader = dependencies.moduleLoader;
+        this._moduleLifecycle = dependencies.moduleLifecycle;
+        this._state = {
+            state: RuntimeState.CREATED,
+            timing: { createdAt: identity.createdAt },
+        };
+    }
+    get identity() {
+        return this._identity;
+    }
+    get state() {
+        return this._state.state;
+    }
+    get timing() {
+        return Object.freeze({ ...this._state.timing });
+    }
+    get metadata() {
+        return this._metadata;
+    }
+    get application() {
+        return this._application;
+    }
+    get configuration() {
+        return this._configuration;
+    }
+    get logger() {
+        return this._logger;
+    }
+    get moduleRegistry() {
+        return this._moduleRegistry;
+    }
+    get moduleLoader() {
+        return this._moduleLoader;
+    }
+    get moduleLifecycle() {
+        return this._moduleLifecycle;
+    }
+    getStateSnapshot() {
+        return createRuntimeStateSnapshot(this._state.state);
+    }
+    get(key) {
+        return this._metadata[key];
+    }
+    has(key) {
+        return Object.prototype.hasOwnProperty.call(this._metadata, key);
+    }
+    getUptime() {
+        return Date.now() - this._identity.createdAt.getTime();
+    }
+    setState(state) {
+        this._state.state = state;
+        this.updateTimingForState(state);
+    }
+    updateTimingForState(state) {
+        const now = new Date();
+        const t = this._state.timing;
+        switch (state) {
+            case RuntimeState.BOOTSTRAPPING:
+                this._state.timing = {
+                    ...t,
+                    startupStartedAt: t.startupStartedAt ?? now,
+                };
+                break;
+            case RuntimeState.READY:
+                this._state.timing = { ...t, readyAt: t.readyAt ?? now };
+                break;
+            case RuntimeState.STOPPING:
+                this._state.timing = {
+                    ...t,
+                    shutdownStartedAt: t.shutdownStartedAt ?? now,
+                };
+                break;
+            case RuntimeState.STOPPED:
+                this._state.timing = { ...t, stoppedAt: t.stoppedAt ?? now };
+                break;
+            default:
+                break;
+        }
+    }
+}
+//# sourceMappingURL=runtimeContext.core.js.map

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

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

package/dist/runtime/runtimeContext/runtimeContext.factory.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeMode, RuntimeRole } from "../runtimeOptions/index.js";
+import type { RuntimeIdentity, RuntimeContextDependencies } from "./runtimeContext.type.js";
+import { DefaultRuntimeContext } from "./runtimeContext.core.js";
+/**
+ * Creates a unique runtime identifier.
+ */
+export declare function createRuntimeId(name: string): string;
+/**
+ * Creates a RuntimeIdentity.
+ */
+export declare function createRuntimeIdentity(options: {
+    readonly name: string;
+    readonly mode: RuntimeMode;
+    readonly role: RuntimeRole;
+    readonly id?: string;
+    readonly processId?: number;
+}): RuntimeIdentity;
+/**
+ * Creates a RuntimeContext.
+ */
+export declare function createRuntimeContext(identity: RuntimeIdentity, dependencies: RuntimeContextDependencies, metadata?: Readonly<Record<string, unknown>>): DefaultRuntimeContext;
+//# sourceMappingURL=runtimeContext.factory.d.ts.map

package/dist/runtime/runtimeContext/runtimeContext.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeContext.factory.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeContext/runtimeContext.factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,KAAK,EACV,eAAe,EACf,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,eAAe,CAWlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,0BAA0B,EACxC,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC/C,qBAAqB,CAEvB"}

package/dist/runtime/runtimeContext/runtimeContext.factory.js

@@ -0,0 +1,43 @@
+import { DefaultRuntimeContext } from "./runtimeContext.core.js";
+/**
+ * Creates a unique runtime identifier.
+ */
+export function createRuntimeId(name) {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 10);
+    const normalizedName = name
+        .slice(0, 100)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return [normalizedName || "runtime", timestamp, random].join("-");
+}
+/**
+ * Creates a RuntimeIdentity.
+ */
+export function createRuntimeIdentity(options) {
+    const createdAt = new Date();
+    return Object.freeze({
+        id: options.id ?? createRuntimeId(options.name),
+        name: options.name,
+        mode: options.mode,
+        role: options.role,
+        createdAt,
+        processId: options.processId ?? getProcessId(),
+    });
+}
+/**
+ * Creates a RuntimeContext.
+ */
+export function createRuntimeContext(identity, dependencies, metadata = {}) {
+    return new DefaultRuntimeContext(identity, dependencies, metadata);
+}
+/**
+ * Attempts to retrieve the current process ID.
+ */
+function getProcessId() {
+    const runtimeProcess = globalThis.process;
+    return runtimeProcess?.pid;
+}
+//# sourceMappingURL=runtimeContext.factory.js.map

package/dist/runtime/runtimeContext/runtimeContext.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeContext.factory.js","sourceRoot":"","sources":["../../../src/runtime/runtimeContext/runtimeContext.factory.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvD,MAAM,cAAc,GAAG,IAAI;SACxB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACb,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE3B,OAAO,CAAC,cAAc,IAAI,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAMrC;IACC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,YAAY,EAAE;KAC/C,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAyB,EACzB,YAAwC,EACxC,QAAQ,GAAsC,EAAE;IAEhD,OAAO,IAAI,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,YAAY;IACnB,MAAM,cAAc,GAClB,UAGD,CAAC,OAAO,CAAC;IAEV,OAAO,cAAc,EAAE,GAAG,CAAC;AAC7B,CAAC"}