@zudojs/core 0.0.1

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

@@ -0,0 +1,29 @@
+import type { RuntimeErrorOptions } from "./runtimeError.type.js";
+import type { RuntimeError as RuntimeErrorType } from "./runtimeError.base.js";
+/**
+ * Runtime Errors
+ *
+ * Error classes and utilities for runtime failures.
+ */
+export { RuntimeError } from "./runtimeError.base.js";
+export { RuntimeStateError, RuntimeStartError, RuntimeStopError, RuntimeInitializationError, RuntimeLoadError, } from "./runtimeError.lifecycle.js";
+export { RuntimeTimeoutError, RuntimeDependencyError, RuntimeNotReadyError, RuntimeUnsupportedOperationError, RuntimeCancellationError, } from "./runtimeError.specialized.js";
+export { RuntimeErrorCode } from "./runtimeError.type.js";
+export type { RuntimeOperation, RuntimeErrorPhase, RuntimeErrorMetadata, RuntimeErrorOptions, RuntimeErrorJSON, } from "./runtimeError.type.js";
+/**
+ * Creates a RuntimeError from an unknown thrown value.
+ */
+export declare function toRuntimeError(error: unknown, options?: RuntimeErrorOptions): RuntimeErrorType;
+/**
+ * Checks whether an unknown value is a RuntimeError.
+ */
+export declare function isRuntimeError(error: unknown): error is RuntimeErrorType;
+/**
+ * Checks whether an unknown error has a specific runtime code.
+ */
+export declare function hasRuntimeErrorCode(error: unknown, code: import("./runtimeError.type.js").RuntimeErrorCode): boolean;
+/**
+ * Creates a runtime error with contextual information.
+ */
+export declare function createRuntimeError(message: string, options?: RuntimeErrorOptions): RuntimeErrorType;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeError/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAgBlB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAExE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,wBAAwB,EAAE,gBAAgB,GACtD,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAElB"}

package/dist/runtime/runtimeError/index.js

@@ -0,0 +1,47 @@
+import { RuntimeError } from "./runtimeError.base.js";
+/**
+ * Runtime Errors
+ *
+ * Error classes and utilities for runtime failures.
+ */
+export { RuntimeError } from "./runtimeError.base.js";
+export { RuntimeStateError, RuntimeStartError, RuntimeStopError, RuntimeInitializationError, RuntimeLoadError, } from "./runtimeError.lifecycle.js";
+export { RuntimeTimeoutError, RuntimeDependencyError, RuntimeNotReadyError, RuntimeUnsupportedOperationError, RuntimeCancellationError, } from "./runtimeError.specialized.js";
+export { RuntimeErrorCode } from "./runtimeError.type.js";
+/**
+ * Creates a RuntimeError from an unknown thrown value.
+ */
+export function toRuntimeError(error, options = {}) {
+    if (error instanceof RuntimeError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new RuntimeError(error.message, {
+            ...options,
+            cause: error,
+        });
+    }
+    return new RuntimeError(String(error), {
+        ...options,
+        cause: error,
+    });
+}
+/**
+ * Checks whether an unknown value is a RuntimeError.
+ */
+export function isRuntimeError(error) {
+    return error instanceof RuntimeError;
+}
+/**
+ * Checks whether an unknown error has a specific runtime code.
+ */
+export function hasRuntimeErrorCode(error, code) {
+    return isRuntimeError(error) && error.code === code;
+}
+/**
+ * Creates a runtime error with contextual information.
+ */
+export function createRuntimeError(message, options = {}) {
+    return new RuntimeError(message, options);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/runtimeError/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMtD;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU1D;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAO,GAAwB,EAAE;IAEjC,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE;YACrC,GAAG,OAAO;YACV,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACrC,GAAG,OAAO;QACV,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,IAAuD;IAEvD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,OAAO,GAAwB,EAAE;IAEjC,OAAO,IAAI,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/runtime/runtimeError/runtimeError.base.d.ts

@@ -0,0 +1,30 @@
+import { FrameworkError } from "../../errors/frameworkError.error.js";
+import type { SerializedBaseError } from "@zudojs/errors";
+import type { RuntimeErrorOptions, RuntimeErrorMetadata } from "./runtimeError.type.js";
+/**
+ * Base error for all runtime failures.
+ *
+ * Extends FrameworkError so runtime errors can be caught
+ * uniformly with other framework errors.
+ */
+export declare class RuntimeError extends FrameworkError {
+    readonly operation?: import("./runtimeError.type.js").RuntimeOperation;
+    readonly phase?: import("./runtimeError.type.js").RuntimeErrorPhase;
+    readonly runtimeId?: string;
+    readonly runtimeName?: string;
+    readonly moduleName?: string;
+    readonly errorMetadata: RuntimeErrorMetadata;
+    readonly recoverable: boolean;
+    constructor(message: string, options?: RuntimeErrorOptions);
+    getCause(): Error | undefined;
+    toJSON(): SerializedBaseError & {
+        readonly operation?: string;
+        readonly phase?: string;
+        readonly runtimeId?: string;
+        readonly runtimeName?: string;
+        readonly moduleName?: string;
+        readonly errorMetadata: RuntimeErrorMetadata;
+        readonly recoverable: boolean;
+    };
+}
+//# sourceMappingURL=runtimeError.base.d.ts.map

package/dist/runtime/runtimeError/runtimeError.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.base.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EACV,mBAAmB,EAEnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAIhC;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,cAAc;IAC9C,SAAgB,SAAS,CAAC,EAAE,OAAO,wBAAwB,EAAE,gBAAgB,CAAC;IAC9E,SAAgB,KAAK,CAAC,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,CAAC;IAC3E,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,aAAa,EAAE,oBAAoB,CAAC;IACpD,SAAgB,WAAW,EAAE,OAAO,CAAC;IAErC,YAAmB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,EA+CpE;IAEM,QAAQ,IAAI,KAAK,GAAG,SAAS,CAEnC;IAEe,MAAM,IAAI,mBAAmB,GAAG;QAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;QAC7C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;KAC/B,CAWA;CACF"}

package/dist/runtime/runtimeError/runtimeError.base.js

@@ -0,0 +1,81 @@
+import { FrameworkError } from "../../errors/frameworkError.error.js";
+import { RuntimeErrorCode } from "./runtimeError.type.js";
+/**
+ * Base error for all runtime failures.
+ *
+ * Extends FrameworkError so runtime errors can be caught
+ * uniformly with other framework errors.
+ */
+export class RuntimeError extends FrameworkError {
+    operation;
+    phase;
+    runtimeId;
+    runtimeName;
+    moduleName;
+    errorMetadata;
+    recoverable;
+    constructor(message, options = {}) {
+        const details = {};
+        if (options.operation !== undefined) {
+            details.operation = options.operation;
+        }
+        if (options.phase !== undefined) {
+            details.phase = options.phase;
+        }
+        if (options.runtimeId !== undefined) {
+            details.runtimeId = options.runtimeId;
+        }
+        if (options.runtimeName !== undefined) {
+            details.runtimeName = options.runtimeName;
+        }
+        if (options.moduleName !== undefined) {
+            details.moduleName = options.moduleName;
+        }
+        if (options.metadata !== undefined) {
+            details.metadata = options.metadata;
+        }
+        if (options.recoverable !== undefined) {
+            details.recoverable = options.recoverable;
+        }
+        super(message, {
+            code: options.code ?? RuntimeErrorCode.RUNTIME_FAILURE,
+            details,
+            cause: options.cause,
+        });
+        this.name = "RuntimeError";
+        this.operation = options.operation;
+        this.phase = options.phase;
+        this.runtimeId = options.runtimeId;
+        this.runtimeName = options.runtimeName;
+        this.moduleName = options.moduleName;
+        this.errorMetadata = Object.freeze({
+            ...(options.metadata ?? {}),
+        });
+        this.recoverable = options.recoverable ?? false;
+    }
+    getCause() {
+        return normalizeError(this.cause);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            operation: this.operation,
+            phase: this.phase,
+            runtimeId: this.runtimeId,
+            runtimeName: this.runtimeName,
+            moduleName: this.moduleName,
+            errorMetadata: this.errorMetadata,
+            recoverable: this.recoverable,
+        };
+    }
+}
+/**
+ * Normalizes an unknown value into an Error.
+ */
+function normalizeError(value) {
+    if (value instanceof Error) {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=runtimeError.base.js.map

package/dist/runtime/runtimeError/runtimeError.base.js.map

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

package/dist/runtime/runtimeError/runtimeError.lifecycle.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeErrorOptions } from "./runtimeError.type.js";
+import { RuntimeError } from "./runtimeError.base.js";
+/**
+ * Error thrown when runtime state transitions are invalid.
+ */
+export declare class RuntimeStateError extends RuntimeError {
+    readonly from: import("./runtimeError.type.js").RuntimeErrorPhase | string;
+    readonly to: import("./runtimeError.type.js").RuntimeErrorPhase | string;
+    constructor(from: import("./runtimeError.type.js").RuntimeErrorPhase | string, to: import("./runtimeError.type.js").RuntimeErrorPhase | string, options?: Omit<RuntimeErrorOptions, "code">);
+}
+/**
+ * Error thrown when runtime startup fails.
+ */
+export declare class RuntimeStartError extends RuntimeError {
+    constructor(message: string, options?: Omit<RuntimeErrorOptions, "operation">);
+}
+/**
+ * Error thrown when runtime shutdown fails.
+ */
+export declare class RuntimeStopError extends RuntimeError {
+    constructor(message: string, options?: Omit<RuntimeErrorOptions, "operation">);
+}
+/**
+ * Error thrown when runtime initialization fails.
+ */
+export declare class RuntimeInitializationError extends RuntimeError {
+    constructor(message: string, options?: Omit<RuntimeErrorOptions, "operation">);
+}
+/**
+ * Error thrown when runtime loading fails.
+ */
+export declare class RuntimeLoadError extends RuntimeError {
+    constructor(message: string, options?: Omit<RuntimeErrorOptions, "operation">);
+}
+//# sourceMappingURL=runtimeError.lifecycle.d.ts.map

package/dist/runtime/runtimeError/runtimeError.lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.lifecycle.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,SAAgB,IAAI,EAClB,OAAO,wBAAwB,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAC9D,SAAgB,EAAE,EAChB,OAAO,wBAAwB,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAE9D,YACE,IAAI,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,GAAG,MAAM,EACjE,EAAE,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,GAAG,MAAM,EAC/D,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAM,EAgBhD;CACF;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAM,EASrD;CACF;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAM,EASrD;CACF;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAM,EASrD;CACF;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAM,EASrD;CACF"}

package/dist/runtime/runtimeError/runtimeError.lifecycle.js

@@ -0,0 +1,77 @@
+import { RuntimeErrorCode } from "./runtimeError.type.js";
+import { RuntimeError } from "./runtimeError.base.js";
+/**
+ * Error thrown when runtime state transitions are invalid.
+ */
+export class RuntimeStateError extends RuntimeError {
+    from;
+    to;
+    constructor(from, to, options = {}) {
+        super(`Invalid runtime state transition from "${from}" to "${to}".`, {
+            ...options,
+            code: RuntimeErrorCode.INVALID_STATE_TRANSITION,
+            operation: options.operation ?? "run",
+            metadata: {
+                ...(options.metadata ?? {}),
+                from,
+                to,
+            },
+        });
+        this.name = "RuntimeStateError";
+        this.from = from;
+        this.to = to;
+    }
+}
+/**
+ * Error thrown when runtime startup fails.
+ */
+export class RuntimeStartError extends RuntimeError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            operation: "start",
+            code: options.code ?? RuntimeErrorCode.BOOTSTRAP_FAILED,
+        });
+        this.name = "RuntimeStartError";
+    }
+}
+/**
+ * Error thrown when runtime shutdown fails.
+ */
+export class RuntimeStopError extends RuntimeError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            operation: "stop",
+            code: options.code ?? RuntimeErrorCode.SHUTDOWN_FAILED,
+        });
+        this.name = "RuntimeStopError";
+    }
+}
+/**
+ * Error thrown when runtime initialization fails.
+ */
+export class RuntimeInitializationError extends RuntimeError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            operation: "initialize",
+            code: options.code ?? RuntimeErrorCode.MODULE_INITIALIZATION_FAILED,
+        });
+        this.name = "RuntimeInitializationError";
+    }
+}
+/**
+ * Error thrown when runtime loading fails.
+ */
+export class RuntimeLoadError extends RuntimeError {
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            operation: "load",
+            code: options.code ?? RuntimeErrorCode.MODULE_LOAD_FAILED,
+        });
+        this.name = "RuntimeLoadError";
+    }
+}
+//# sourceMappingURL=runtimeError.lifecycle.js.map

package/dist/runtime/runtimeError/runtimeError.lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.lifecycle.js","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjC,IAAI,CAC0C;IAC9C,EAAE,CAC4C;IAE9D,YACE,IAAiE,EACjE,EAA+D,EAC/D,OAAO,GAAsC,EAAE;QAE/C,KAAK,CAAC,0CAA0C,IAAI,SAAS,EAAE,IAAI,EAAE;YACnE,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB,CAAC,wBAAwB;YAC/C,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;YACrC,QAAQ,EAAE;gBACR,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAC3B,IAAI;gBACJ,EAAE;aACH;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD,YACE,OAAe,EACf,OAAO,GAA2C,EAAE;QAEpD,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,SAAS,EAAE,OAAO;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,gBAAgB;SACxD,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,YACE,OAAe,EACf,OAAO,GAA2C,EAAE;QAEpD,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,SAAS,EAAE,MAAM;YACjB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,eAAe;SACvD,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YACE,OAAe,EACf,OAAO,GAA2C,EAAE;QAEpD,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,SAAS,EAAE,YAAY;YACvB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,4BAA4B;SACpE,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,YACE,OAAe,EACf,OAAO,GAA2C,EAAE;QAEpD,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,SAAS,EAAE,MAAM;YACjB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC,kBAAkB;SAC1D,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/runtime/runtimeError/runtimeError.specialized.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeErrorOptions } from "./runtimeError.type.js";
+import { RuntimeError } from "./runtimeError.base.js";
+/**
+ * Error thrown when a runtime operation times out.
+ */
+export declare class RuntimeTimeoutError extends RuntimeError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, options?: Omit<RuntimeErrorOptions, "code">);
+}
+/**
+ * Error thrown when a runtime dependency is unavailable.
+ */
+export declare class RuntimeDependencyError extends RuntimeError {
+    readonly dependency: string;
+    constructor(dependency: string, options?: Omit<RuntimeErrorOptions, "code">);
+}
+/**
+ * Error thrown when the runtime is not ready.
+ */
+export declare class RuntimeNotReadyError extends RuntimeError {
+    constructor(message?: string, options?: Omit<RuntimeErrorOptions, "code">);
+}
+/**
+ * Error thrown when a runtime operation is unsupported.
+ */
+export declare class RuntimeUnsupportedOperationError extends RuntimeError {
+    constructor(operation: string, options?: Omit<RuntimeErrorOptions, "code">);
+}
+/**
+ * Error thrown when a runtime operation is cancelled.
+ */
+export declare class RuntimeCancellationError extends RuntimeError {
+    constructor(message?: string, options?: Omit<RuntimeErrorOptions, "code">);
+}
+//# sourceMappingURL=runtimeError.specialized.d.ts.map

package/dist/runtime/runtimeError/runtimeError.specialized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.specialized.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.specialized.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAIlE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YACE,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAM,EAahD;CACF;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,YACE,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAM,EAahD;CACF;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,YACE,OAAO,GAAE,MAAgC,EACzC,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAM,EAQhD;CACF;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,YAAY;IAChE,YACE,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAM,EAYhD;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,YAAY;IACxD,YACE,OAAO,GAAE,MAA2C,EACpD,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAM,EAQhD;CACF"}

package/dist/runtime/runtimeError/runtimeError.specialized.js

@@ -0,0 +1,79 @@
+import { RuntimeErrorCode } from "./runtimeError.type.js";
+import { RuntimeError } from "./runtimeError.base.js";
+/**
+ * Error thrown when a runtime operation times out.
+ */
+export class RuntimeTimeoutError extends RuntimeError {
+    timeoutMs;
+    constructor(message, timeoutMs, options = {}) {
+        super(message, {
+            ...options,
+            code: RuntimeErrorCode.OPERATION_TIMEOUT,
+            metadata: {
+                ...(options.metadata ?? {}),
+                timeoutMs,
+            },
+        });
+        this.name = "RuntimeTimeoutError";
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Error thrown when a runtime dependency is unavailable.
+ */
+export class RuntimeDependencyError extends RuntimeError {
+    dependency;
+    constructor(dependency, options = {}) {
+        super(`Required runtime dependency "${dependency}" is not available.`, {
+            ...options,
+            code: RuntimeErrorCode.MISSING_DEPENDENCY,
+            metadata: {
+                ...(options.metadata ?? {}),
+                dependency,
+            },
+        });
+        this.name = "RuntimeDependencyError";
+        this.dependency = dependency;
+    }
+}
+/**
+ * Error thrown when the runtime is not ready.
+ */
+export class RuntimeNotReadyError extends RuntimeError {
+    constructor(message = "Runtime is not ready.", options = {}) {
+        super(message, {
+            ...options,
+            code: RuntimeErrorCode.RUNTIME_NOT_READY,
+        });
+        this.name = "RuntimeNotReadyError";
+    }
+}
+/**
+ * Error thrown when a runtime operation is unsupported.
+ */
+export class RuntimeUnsupportedOperationError extends RuntimeError {
+    constructor(operation, options = {}) {
+        super(`Runtime operation "${operation}" is not supported.`, {
+            ...options,
+            code: RuntimeErrorCode.UNSUPPORTED_OPERATION,
+            metadata: {
+                ...(options.metadata ?? {}),
+                operation,
+            },
+        });
+        this.name = "RuntimeUnsupportedOperationError";
+    }
+}
+/**
+ * Error thrown when a runtime operation is cancelled.
+ */
+export class RuntimeCancellationError extends RuntimeError {
+    constructor(message = "Runtime operation was cancelled.", options = {}) {
+        super(message, {
+            ...options,
+            code: RuntimeErrorCode.OPERATION_CANCELLED,
+        });
+        this.name = "RuntimeCancellationError";
+    }
+}
+//# sourceMappingURL=runtimeError.specialized.js.map

package/dist/runtime/runtimeError/runtimeError.specialized.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.specialized.js","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.specialized.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnC,SAAS,CAAS;IAElC,YACE,OAAe,EACf,SAAiB,EACjB,OAAO,GAAsC,EAAE;QAE/C,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB,CAAC,iBAAiB;YACxC,QAAQ,EAAE;gBACR,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAC3B,SAAS;aACV;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IACtC,UAAU,CAAS;IAEnC,YACE,UAAkB,EAClB,OAAO,GAAsC,EAAE;QAE/C,KAAK,CAAC,gCAAgC,UAAU,qBAAqB,EAAE;YACrE,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,QAAQ,EAAE;gBACR,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAC3B,UAAU;aACX;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YACE,OAAO,GAAW,uBAAuB,EACzC,OAAO,GAAsC,EAAE;QAE/C,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB,CAAC,iBAAiB;SACzC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gCAAiC,SAAQ,YAAY;IAChE,YACE,SAAiB,EACjB,OAAO,GAAsC,EAAE;QAE/C,KAAK,CAAC,sBAAsB,SAAS,qBAAqB,EAAE;YAC1D,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB,CAAC,qBAAqB;YAC5C,QAAQ,EAAE;gBACR,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAC3B,SAAS;aACV;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,YAAY;IACxD,YACE,OAAO,GAAW,kCAAkC,EACpD,OAAO,GAAsC,EAAE;QAE/C,KAAK,CAAC,OAAO,EAAE;YACb,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB,CAAC,mBAAmB;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

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

@@ -0,0 +1,74 @@
+/**
+ * Runtime lifecycle operations.
+ */
+export type RuntimeOperation = "create" | "start" | "bootstrap" | "load" | "initialize" | "run" | "stop" | "shutdown" | "destroy" | "restart" | "dispose";
+/**
+ * Runtime lifecycle phases.
+ */
+export type RuntimeErrorPhase = "created" | "bootstrapping" | "loading" | "loaded" | "initializing" | "initialized" | "starting" | "ready" | "stopping" | "stopped" | "destroying" | "destroyed" | "failed";
+/**
+ * Stable runtime error codes.
+ */
+export declare const RuntimeErrorCode: {
+    readonly RUNTIME_FAILURE: "CORE_RUNTIME_FAILURE";
+    readonly RUNTIME_ALREADY_STARTED: "CORE_RUNTIME_ALREADY_STARTED";
+    readonly RUNTIME_ALREADY_STOPPED: "CORE_RUNTIME_ALREADY_STOPPED";
+    readonly RUNTIME_FAILED: "CORE_RUNTIME_FAILED";
+    readonly INVALID_STATE_TRANSITION: "CORE_RUNTIME_INVALID_TRANSITION";
+    readonly BOOTSTRAP_FAILED: "CORE_RUNTIME_BOOTSTRAP_FAILED";
+    readonly BOOTSTRAP_TIMEOUT: "CORE_RUNTIME_BOOTSTRAP_TIMEOUT";
+    readonly MODULE_LOAD_FAILED: "CORE_MODULE_LOAD_FAILED";
+    readonly MODULE_INITIALIZATION_FAILED: "CORE_MODULE_INITIALIZATION_FAILED";
+    readonly MODULE_START_FAILED: "CORE_MODULE_START_FAILED";
+    readonly SHUTDOWN_FAILED: "CORE_RUNTIME_SHUTDOWN_FAILED";
+    readonly SHUTDOWN_TIMEOUT: "CORE_RUNTIME_SHUTDOWN_TIMEOUT";
+    readonly MODULE_STOP_FAILED: "CORE_MODULE_STOP_FAILED";
+    readonly MODULE_DESTROY_FAILED: "CORE_MODULE_DESTROY_FAILED";
+    readonly OPERATION_TIMEOUT: "CORE_RUNTIME_OPERATION_TIMEOUT";
+    readonly INVALID_CONFIGURATION: "CORE_RUNTIME_INVALID_CONFIGURATION";
+    readonly MISSING_DEPENDENCY: "CORE_RUNTIME_MISSING_DEPENDENCY";
+    readonly INVALID_ENVIRONMENT: "CORE_RUNTIME_INVALID_ENVIRONMENT";
+    readonly RUNTIME_NOT_READY: "CORE_RUNTIME_NOT_READY";
+    readonly UNSUPPORTED_OPERATION: "CORE_RUNTIME_UNSUPPORTED_OPERATION";
+    readonly OPERATION_CANCELLED: "CORE_RUNTIME_OPERATION_CANCELLED";
+};
+/**
+ * Union type of all runtime error code values.
+ */
+export type RuntimeErrorCode = (typeof RuntimeErrorCode)[keyof typeof RuntimeErrorCode];
+/**
+ * Metadata attached to a runtime error.
+ */
+export type RuntimeErrorMetadata = Readonly<Record<string, unknown>>;
+/**
+ * Options for constructing a RuntimeError.
+ */
+export interface RuntimeErrorOptions {
+    readonly code?: RuntimeErrorCode;
+    readonly operation?: RuntimeOperation;
+    readonly phase?: RuntimeErrorPhase;
+    readonly runtimeId?: string;
+    readonly runtimeName?: string;
+    readonly moduleName?: string;
+    readonly metadata?: RuntimeErrorMetadata;
+    readonly cause?: unknown;
+    readonly recoverable?: boolean;
+}
+/**
+ * Serializable representation of RuntimeError.
+ */
+export interface RuntimeErrorJSON {
+    readonly name: string;
+    readonly message: string;
+    readonly code: string;
+    readonly operation?: RuntimeOperation;
+    readonly phase?: RuntimeErrorPhase;
+    readonly runtimeId?: string;
+    readonly runtimeName?: string;
+    readonly moduleName?: string;
+    readonly errorMetadata: RuntimeErrorMetadata;
+    readonly recoverable: boolean;
+    readonly details?: unknown;
+    readonly status?: number;
+}
+//# sourceMappingURL=runtimeError.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.type.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.type.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,OAAO,GACP,WAAW,GACX,MAAM,GACN,YAAY,GACZ,KAAK,GACL,MAAM,GACN,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,eAAe,GACf,SAAS,GACT,QAAQ,GACR,cAAc,GACd,aAAa,GACb,UAAU,GACV,OAAO,GACP,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,eAAO,MAAM,gBAAgB;aAC3B,eAAe;aACf,uBAAuB;aACvB,uBAAuB;aACvB,cAAc;aACd,wBAAwB;aACxB,gBAAgB;aAChB,iBAAiB;aACjB,kBAAkB;aAClB,4BAA4B;aAC5B,mBAAmB;aACnB,eAAe;aACf,gBAAgB;aAChB,kBAAkB;aAClB,qBAAqB;aACrB,iBAAiB;aACjB,qBAAqB;aACrB,kBAAkB;aAClB,mBAAmB;aACnB,iBAAiB;aACjB,qBAAqB;aACrB,mBAAmB;CACX,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/runtime/runtimeError/runtimeError.type.js

@@ -0,0 +1,28 @@
+import { ErrorCode } from "../../errors/errorCode.code.js";
+/**
+ * Stable runtime error codes.
+ */
+export const RuntimeErrorCode = {
+    RUNTIME_FAILURE: ErrorCode.RUNTIME_FAILURE,
+    RUNTIME_ALREADY_STARTED: ErrorCode.RUNTIME_ALREADY_STARTED,
+    RUNTIME_ALREADY_STOPPED: ErrorCode.RUNTIME_ALREADY_STOPPED,
+    RUNTIME_FAILED: ErrorCode.RUNTIME_FAILED,
+    INVALID_STATE_TRANSITION: ErrorCode.RUNTIME_INVALID_TRANSITION,
+    BOOTSTRAP_FAILED: ErrorCode.RUNTIME_BOOTSTRAP_FAILED,
+    BOOTSTRAP_TIMEOUT: ErrorCode.RUNTIME_BOOTSTRAP_TIMEOUT,
+    MODULE_LOAD_FAILED: ErrorCode.MODULE_LOAD_FAILED,
+    MODULE_INITIALIZATION_FAILED: ErrorCode.MODULE_INITIALIZATION_FAILED,
+    MODULE_START_FAILED: ErrorCode.MODULE_START_FAILED,
+    SHUTDOWN_FAILED: ErrorCode.RUNTIME_SHUTDOWN_FAILED,
+    SHUTDOWN_TIMEOUT: ErrorCode.RUNTIME_SHUTDOWN_TIMEOUT,
+    MODULE_STOP_FAILED: ErrorCode.MODULE_STOP_FAILED,
+    MODULE_DESTROY_FAILED: ErrorCode.MODULE_DESTROY_FAILED,
+    OPERATION_TIMEOUT: ErrorCode.RUNTIME_OPERATION_TIMEOUT,
+    INVALID_CONFIGURATION: ErrorCode.RUNTIME_INVALID_CONFIGURATION,
+    MISSING_DEPENDENCY: ErrorCode.RUNTIME_MISSING_DEPENDENCY,
+    INVALID_ENVIRONMENT: ErrorCode.RUNTIME_INVALID_ENVIRONMENT,
+    RUNTIME_NOT_READY: ErrorCode.RUNTIME_NOT_READY,
+    UNSUPPORTED_OPERATION: ErrorCode.RUNTIME_UNSUPPORTED_OPERATION,
+    OPERATION_CANCELLED: ErrorCode.RUNTIME_OPERATION_CANCELLED,
+};
+//# sourceMappingURL=runtimeError.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeError.type.js","sourceRoot":"","sources":["../../../src/runtime/runtimeError/runtimeError.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAoC3D;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe,EAAE,SAAS,CAAC,eAAe;IAC1C,uBAAuB,EAAE,SAAS,CAAC,uBAAuB;IAC1D,uBAAuB,EAAE,SAAS,CAAC,uBAAuB;IAC1D,cAAc,EAAE,SAAS,CAAC,cAAc;IACxC,wBAAwB,EAAE,SAAS,CAAC,0BAA0B;IAC9D,gBAAgB,EAAE,SAAS,CAAC,wBAAwB;IACpD,iBAAiB,EAAE,SAAS,CAAC,yBAAyB;IACtD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,4BAA4B,EAAE,SAAS,CAAC,4BAA4B;IACpE,mBAAmB,EAAE,SAAS,CAAC,mBAAmB;IAClD,eAAe,EAAE,SAAS,CAAC,uBAAuB;IAClD,gBAAgB,EAAE,SAAS,CAAC,wBAAwB;IACpD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;IAChD,qBAAqB,EAAE,SAAS,CAAC,qBAAqB;IACtD,iBAAiB,EAAE,SAAS,CAAC,yBAAyB;IACtD,qBAAqB,EAAE,SAAS,CAAC,6BAA6B;IAC9D,kBAAkB,EAAE,SAAS,CAAC,0BAA0B;IACxD,mBAAmB,EAAE,SAAS,CAAC,2BAA2B;IAC1D,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;IAC9C,qBAAqB,EAAE,SAAS,CAAC,6BAA6B;IAC9D,mBAAmB,EAAE,SAAS,CAAC,2BAA2B;CAClD,CAAC"}

package/dist/runtime/runtimeLogger.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeContext } from "./runtimeContext/index.js";
+import type { RuntimeEnvironment } from "./runtimeEnvironment/index.js";
+import type { Logger } from "../logging/core/logger.js";
+export declare function logRuntimeEvent(logger: Logger, context: RuntimeContext, environment: RuntimeEnvironment, level: "debug" | "info" | "warn" | "error", message: string, metadata?: Record<string, unknown>): void;
+//# sourceMappingURL=runtimeLogger.d.ts.map

package/dist/runtime/runtimeLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogger.d.ts","sourceRoot":"","sources":["../../src/runtime/runtimeLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAkBN"}

package/dist/runtime/runtimeLogger.js

@@ -0,0 +1,18 @@
+export function logRuntimeEvent(logger, context, environment, level, message, metadata) {
+    try {
+        const log = logger;
+        const method = log[level];
+        if (typeof method === "function") {
+            method.call(logger, message, {
+                runtimeId: context.identity.id,
+                runtimeName: context.identity.name,
+                environment: environment.engine,
+                ...metadata,
+            });
+        }
+    }
+    catch {
+        /* Logging must never break runtime operations. */
+    }
+}
+//# sourceMappingURL=runtimeLogger.js.map

package/dist/runtime/runtimeLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeLogger.js","sourceRoot":"","sources":["../../src/runtime/runtimeLogger.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,OAAuB,EACvB,WAA+B,EAC/B,KAA0C,EAC1C,OAAe,EACf,QAAkC;IAElC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAA4C,CAAC;QACzD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAE/B,MACD,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE;gBACtB,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAC9B,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAClC,WAAW,EAAE,WAAW,CAAC,MAAM;gBAC/B,GAAG,QAAQ;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Runtime Manager
+ *
+ * Top-level runtime lifecycle coordinator that owns the
+ * runtime state and delegates to bootstrap/shutdown services.
+ */
+export { DefaultRuntimeManager } from "./runtimeManager.core.js";
+export { RuntimeManagerError } from "./runtimeManager.error.js";
+export { createRuntimeManager } from "./runtimeManager.factory.js";
+export { performStart, performStop } from "./runtimeManager.lifecycle.js";
+export type { RuntimeManagerDependencies, RuntimeManager, RuntimeManagerState, } from "./runtimeManager.type.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/runtimeManager/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE1E,YAAY,EACV,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,GACpB,MAAM,0BAA0B,CAAC"}

package/dist/runtime/runtimeManager/index.js

@@ -0,0 +1,11 @@
+/**
+ * Runtime Manager
+ *
+ * Top-level runtime lifecycle coordinator that owns the
+ * runtime state and delegates to bootstrap/shutdown services.
+ */
+export { DefaultRuntimeManager } from "./runtimeManager.core.js";
+export { RuntimeManagerError } from "./runtimeManager.error.js";
+export { createRuntimeManager } from "./runtimeManager.factory.js";
+export { performStart, performStop } from "./runtimeManager.lifecycle.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/runtimeManager/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}