@connexia/infrastructure 1.0.1

package/dist/runtime/provider-registry.js

@@ -0,0 +1,52 @@
+/**
+ * Provider Registry
+ *
+ * Stores ProviderDescriptors and their instantiated implementations.
+ * Provides typed resolution of provider implementations.
+ */
+export class ProviderRegistry {
+    providers = new Map();
+    // ─── Registration ──────────────────────────────────────────
+    register(descriptor, implementation) {
+        const key = descriptor.id;
+        this.providers.set(key, { descriptor, implementation });
+    }
+    // ─── Resolution ────────────────────────────────────────────
+    get(providerId) {
+        const entry = this.providers.get(providerId);
+        if (!entry)
+            return undefined;
+        return entry.implementation;
+    }
+    getRequired(providerId) {
+        const impl = this.get(providerId);
+        if (impl === undefined) {
+            throw new Error(`Provider implementation not found: ${providerId}`);
+        }
+        return impl;
+    }
+    getDescriptor(providerId) {
+        return this.providers.get(providerId)?.descriptor;
+    }
+    // ─── Query ─────────────────────────────────────────────────
+    getAll() {
+        return Array.from(this.providers.values()).map((p) => p.descriptor);
+    }
+    getAllRegistered() {
+        return Array.from(this.providers.values());
+    }
+    has(providerId) {
+        return this.providers.has(providerId);
+    }
+    getCount() {
+        return this.providers.size;
+    }
+    // ─── Removal ───────────────────────────────────────────────
+    remove(providerId) {
+        return this.providers.delete(providerId);
+    }
+    clear() {
+        this.providers.clear();
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/runtime/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/runtime/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE1D,8DAA8D;IAE9D,QAAQ,CAAC,UAA8B,EAAE,cAAwB;QAC/D,MAAM,GAAG,GAAG,UAAU,CAAC,EAAY,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,8DAA8D;IAE9D,GAAG,CAAc,UAAkB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,OAAO,KAAK,CAAC,cAAmB,CAAC;IACnC,CAAC;IAED,WAAW,CAAc,UAAkB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAI,UAAU,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACpD,CAAC;IAED,8DAA8D;IAE9D,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,8DAA8D;IAE9D,MAAM,CAAC,UAAkB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/runtime/recovery-runtime.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Recovery Runtime
+ *
+ * Automatic retry, circuit breaker, dependency-aware restart.
+ * No failed provider may remain permanently failed unless recovery policy declares it terminal.
+ */
+import type { CircuitState } from "../recovery/circuit-breaker.js";
+import type { ProviderLifecycleManager } from "./provider-lifecycle.js";
+import type { RuntimeLifecycle } from "./runtime-lifecycle.js";
+export interface RecoveryPolicy {
+    readonly maxRetries: number;
+    readonly baseDelayMs: number;
+    readonly maxDelayMs: number;
+    readonly backoffMultiplier: number;
+    readonly circuitBreaker?: {
+        readonly failureThreshold: number;
+        readonly recoveryTimeoutMs: number;
+    };
+    readonly terminal?: boolean;
+}
+export declare const DEFAULT_RECOVERY_POLICY: RecoveryPolicy;
+export interface RecoveryState {
+    readonly providerId: string;
+    readonly retryCount: number;
+    readonly lastRetryAt: string | null;
+    readonly nextRetryAt: string | null;
+    readonly circuitState: CircuitState;
+    readonly exhausted: boolean;
+}
+export interface RecoveryEvent {
+    readonly providerId: string;
+    readonly attempt: number;
+    readonly success: boolean;
+    readonly durationMs: number;
+    readonly error?: string;
+}
+export declare class RecoveryRuntime {
+    private providerLifecycle;
+    private lifecycleRuntime?;
+    private policies;
+    private states;
+    private circuitBreakers;
+    private reconnectHandlers;
+    private listeners;
+    constructor(providerLifecycle: ProviderLifecycleManager, lifecycleRuntime?: RuntimeLifecycle | undefined);
+    setPolicy(providerId: string, policy: RecoveryPolicy): void;
+    getPolicy(providerId: string): RecoveryPolicy | undefined;
+    attemptRecovery(providerId: string, connect: () => Promise<void>): Promise<boolean>;
+    recoverAll(providers: Array<{
+        id: string;
+        connect: () => Promise<void>;
+    }>): Promise<{
+        recovered: string[];
+        failed: string[];
+    }>;
+    getState(providerId: string): RecoveryState | undefined;
+    getAllStates(): RecoveryState[];
+    isCircuitOpen(providerId: string): boolean;
+    resetCircuit(providerId: string): void;
+    getCircuitState(providerId: string): CircuitState;
+    onRecovery(listener: (event: RecoveryEvent) => void): void;
+    private updateState;
+    private emitEvent;
+    private calculateDelay;
+}
+//# sourceMappingURL=recovery-runtime.d.ts.map

package/dist/runtime/recovery-runtime.d.ts.map

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

package/dist/runtime/recovery-runtime.js

@@ -0,0 +1,177 @@
+/**
+ * Recovery Runtime
+ *
+ * Automatic retry, circuit breaker, dependency-aware restart.
+ * No failed provider may remain permanently failed unless recovery policy declares it terminal.
+ */
+import { CircuitBreaker } from "../recovery/circuit-breaker.js";
+import { ReconnectHandler } from "../recovery/reconnect-handler.js";
+export const DEFAULT_RECOVERY_POLICY = {
+    maxRetries: 3,
+    baseDelayMs: 1_000,
+    maxDelayMs: 30_000,
+    backoffMultiplier: 2,
+    circuitBreaker: {
+        failureThreshold: 5,
+        recoveryTimeoutMs: 30_000,
+    },
+};
+export class RecoveryRuntime {
+    providerLifecycle;
+    lifecycleRuntime;
+    policies = new Map();
+    states = new Map();
+    circuitBreakers = new Map();
+    reconnectHandlers = new Map();
+    listeners = [];
+    constructor(providerLifecycle, lifecycleRuntime) {
+        this.providerLifecycle = providerLifecycle;
+        this.lifecycleRuntime = lifecycleRuntime;
+    }
+    // ─── Configuration ─────────────────────────────────────────
+    setPolicy(providerId, policy) {
+        this.policies.set(providerId, policy);
+        // Create circuit breaker if configured
+        if (policy.circuitBreaker) {
+            this.circuitBreakers.set(providerId, new CircuitBreaker({
+                failureThreshold: policy.circuitBreaker.failureThreshold,
+                recoveryTimeoutMs: policy.circuitBreaker.recoveryTimeoutMs,
+            }));
+        }
+        // Create reconnect handler
+        this.reconnectHandlers.set(providerId, new ReconnectHandler({
+            maxAttempts: policy.maxRetries,
+            initialDelayMs: policy.baseDelayMs,
+            maxDelayMs: policy.maxDelayMs,
+            backoffMultiplier: policy.backoffMultiplier,
+        }));
+    }
+    getPolicy(providerId) {
+        return this.policies.get(providerId);
+    }
+    // ─── Recovery Operations ───────────────────────────────────
+    async attemptRecovery(providerId, connect) {
+        const policy = this.policies.get(providerId) ?? DEFAULT_RECOVERY_POLICY;
+        if (policy.terminal) {
+            this.updateState(providerId, { exhausted: true });
+            return false;
+        }
+        const circuitBreaker = this.circuitBreakers.get(providerId);
+        const reconnectHandler = this.reconnectHandlers.get(providerId);
+        const startTime = Date.now();
+        let success = false;
+        let lastError;
+        try {
+            if (circuitBreaker) {
+                await circuitBreaker.execute(async () => {
+                    if (reconnectHandler) {
+                        await reconnectHandler.execute(connect);
+                    }
+                    else {
+                        await connect();
+                    }
+                });
+            }
+            else if (reconnectHandler) {
+                await reconnectHandler.execute(connect);
+            }
+            else {
+                await connect();
+            }
+            success = true;
+            this.updateState(providerId, {
+                retryCount: 0,
+                lastRetryAt: new Date().toISOString(),
+                nextRetryAt: null,
+                exhausted: false,
+            });
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+            const retryCount = (this.states.get(providerId)?.retryCount ?? 0) + 1;
+            // When reconnect handler throws, all its internal attempts are exhausted
+            const handlerExhausted = reconnectHandler?.getState().exhausted ?? false;
+            const isExhausted = handlerExhausted || retryCount >= policy.maxRetries;
+            this.updateState(providerId, {
+                retryCount,
+                lastRetryAt: new Date().toISOString(),
+                nextRetryAt: isExhausted ? null : new Date(Date.now() + this.calculateDelay(retryCount, policy)).toISOString(),
+                exhausted: isExhausted,
+            });
+        }
+        this.emitEvent({
+            providerId,
+            attempt: (this.states.get(providerId)?.retryCount ?? 0),
+            success,
+            durationMs: Date.now() - startTime,
+            error: lastError,
+        });
+        return success;
+    }
+    async recoverAll(providers) {
+        const recovered = [];
+        const failed = [];
+        for (const provider of providers) {
+            const success = await this.attemptRecovery(provider.id, provider.connect);
+            if (success) {
+                recovered.push(provider.id);
+            }
+            else {
+                failed.push(provider.id);
+            }
+        }
+        return { recovered, failed };
+    }
+    getState(providerId) {
+        return this.states.get(providerId);
+    }
+    getAllStates() {
+        return Array.from(this.states.values());
+    }
+    // ─── Circuit Breaker ───────────────────────────────────────
+    isCircuitOpen(providerId) {
+        const cb = this.circuitBreakers.get(providerId);
+        return cb ? cb.getState().state === "open" : false;
+    }
+    resetCircuit(providerId) {
+        const cb = this.circuitBreakers.get(providerId);
+        if (cb)
+            cb.reset();
+    }
+    getCircuitState(providerId) {
+        const cb = this.circuitBreakers.get(providerId);
+        return cb ? cb.getState().state : "closed";
+    }
+    // ─── Events ────────────────────────────────────────────────
+    onRecovery(listener) {
+        this.listeners.push(listener);
+    }
+    // ─── Internal ──────────────────────────────────────────────
+    updateState(providerId, partial) {
+        const current = this.states.get(providerId);
+        const state = {
+            providerId,
+            retryCount: partial.retryCount ?? current?.retryCount ?? 0,
+            lastRetryAt: partial.lastRetryAt ?? current?.lastRetryAt ?? null,
+            nextRetryAt: partial.nextRetryAt ?? current?.nextRetryAt ?? null,
+            circuitState: partial.circuitState ?? this.getCircuitState(providerId),
+            exhausted: partial.exhausted ?? current?.exhausted ?? false,
+        };
+        this.states.set(providerId, state);
+    }
+    emitEvent(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // listener errors must not crash recovery
+            }
+        }
+    }
+    calculateDelay(attempt, policy) {
+        const delay = policy.baseDelayMs * Math.pow(policy.backoffMultiplier, attempt);
+        return Math.min(delay, policy.maxDelayMs);
+    }
+}
+//# sourceMappingURL=recovery-runtime.js.map

package/dist/runtime/recovery-runtime.js.map

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

package/dist/runtime/resource-manager.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Resource Manager
+ *
+ * Tracks all timers, intervals, connections, subscriptions, and disposable resources.
+ * Ensures deterministic cleanup on shutdown. No resource leaks.
+ */
+export interface ManagedTimer {
+    readonly id: string;
+    readonly type: "timeout" | "interval";
+    readonly createdAt: string;
+    readonly description: string;
+}
+export interface ManagedResource {
+    readonly id: string;
+    readonly type: "connection" | "subscription" | "worker" | "stream" | "custom";
+    readonly description: string;
+    readonly dispose: () => Promise<void> | void;
+    readonly createdAt: string;
+}
+export interface DisposalResult {
+    readonly disposed: number;
+    readonly failed: number;
+    readonly errors: string[];
+}
+export interface ResourceManagerStats {
+    readonly activeTimers: number;
+    readonly activeResources: number;
+    readonly totalDisposed: number;
+    readonly totalCreated: number;
+}
+export declare class ResourceManager {
+    private timers;
+    private timerHandles;
+    private resources;
+    private disposedCount;
+    private createdCount;
+    createTimeout(fn: () => void, delayMs: number, description: string): string;
+    createInterval(fn: () => void, intervalMs: number, description: string): string;
+    clearTimer(id: string): boolean;
+    clearAllTimers(): void;
+    trackResource(resource: ManagedResource): void;
+    untrackResource(id: string): boolean;
+    disposeAll(): Promise<DisposalResult>;
+    getActiveTimers(): ManagedTimer[];
+    getActiveResources(): ManagedResource[];
+    getTimerCount(): number;
+    getResourceCount(): number;
+    getStats(): ResourceManagerStats;
+    reset(): void;
+}
+//# sourceMappingURL=resource-manager.d.ts.map

package/dist/runtime/resource-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/resource-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAQD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,YAAY,CAAqF;IACzG,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IAIzB,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAqB3E,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAmB/E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiB/B,cAAc,IAAI,IAAI;IAgBtB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAK9C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ9B,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IA6B3C,eAAe,IAAI,YAAY,EAAE;IAIjC,kBAAkB,IAAI,eAAe,EAAE;IAIvC,aAAa,IAAI,MAAM;IAIvB,gBAAgB,IAAI,MAAM;IAI1B,QAAQ,IAAI,oBAAoB;IAWhC,KAAK,IAAI,IAAI;CAad"}

package/dist/runtime/resource-manager.js

@@ -0,0 +1,156 @@
+/**
+ * Resource Manager
+ *
+ * Tracks all timers, intervals, connections, subscriptions, and disposable resources.
+ * Ensures deterministic cleanup on shutdown. No resource leaks.
+ */
+let resourceCounter = 0;
+function nextId(prefix) {
+    resourceCounter++;
+    return `${prefix}-${resourceCounter}`;
+}
+export class ResourceManager {
+    timers = new Map();
+    timerHandles = new Map();
+    resources = new Map();
+    disposedCount = 0;
+    createdCount = 0;
+    // ─── Timer Management ──────────────────────────────────────
+    createTimeout(fn, delayMs, description) {
+        const id = nextId("timer");
+        const handle = setTimeout(() => {
+            this.timers.delete(id);
+            this.timerHandles.delete(id);
+            fn();
+        }, delayMs);
+        const timer = {
+            id,
+            type: "timeout",
+            createdAt: new Date().toISOString(),
+            description,
+        };
+        this.timers.set(id, timer);
+        this.timerHandles.set(id, handle);
+        this.createdCount++;
+        return id;
+    }
+    createInterval(fn, intervalMs, description) {
+        const id = nextId("interval");
+        const handle = setInterval(() => {
+            fn();
+        }, intervalMs);
+        const timer = {
+            id,
+            type: "interval",
+            createdAt: new Date().toISOString(),
+            description,
+        };
+        this.timers.set(id, timer);
+        this.timerHandles.set(id, handle);
+        this.createdCount++;
+        return id;
+    }
+    clearTimer(id) {
+        const handle = this.timerHandles.get(id);
+        if (!handle)
+            return false;
+        const timer = this.timers.get(id);
+        if (timer?.type === "timeout") {
+            clearTimeout(handle);
+        }
+        else {
+            clearInterval(handle);
+        }
+        this.timers.delete(id);
+        this.timerHandles.delete(id);
+        this.disposedCount++;
+        return true;
+    }
+    clearAllTimers() {
+        for (const [id, handle] of this.timerHandles) {
+            const timer = this.timers.get(id);
+            if (timer?.type === "timeout") {
+                clearTimeout(handle);
+            }
+            else {
+                clearInterval(handle);
+            }
+            this.disposedCount++;
+        }
+        this.timers.clear();
+        this.timerHandles.clear();
+    }
+    // ─── Resource Management ───────────────────────────────────
+    trackResource(resource) {
+        this.resources.set(resource.id, resource);
+        this.createdCount++;
+    }
+    untrackResource(id) {
+        const existed = this.resources.delete(id);
+        if (existed)
+            this.disposedCount++;
+        return existed;
+    }
+    // ─── Disposal ──────────────────────────────────────────────
+    async disposeAll() {
+        const errors = [];
+        let disposed = 0;
+        let failed = 0;
+        // 1. Clear all timers (does not touch resources)
+        const timerCount = this.timers.size;
+        this.clearAllTimers();
+        disposed += timerCount;
+        // 2. Dispose all resources in reverse creation order
+        const resourceList = Array.from(this.resources.values()).reverse();
+        for (const resource of resourceList) {
+            try {
+                await resource.dispose();
+                this.resources.delete(resource.id);
+                this.disposedCount++;
+                disposed++;
+            }
+            catch (error) {
+                failed++;
+                errors.push(`Failed to dispose resource ${resource.id} (${resource.description}): ${String(error)}`);
+            }
+        }
+        return { disposed, failed, errors };
+    }
+    // ─── Query ─────────────────────────────────────────────────
+    getActiveTimers() {
+        return Array.from(this.timers.values());
+    }
+    getActiveResources() {
+        return Array.from(this.resources.values());
+    }
+    getTimerCount() {
+        return this.timers.size;
+    }
+    getResourceCount() {
+        return this.resources.size;
+    }
+    getStats() {
+        return {
+            activeTimers: this.timers.size,
+            activeResources: this.resources.size,
+            totalDisposed: this.disposedCount,
+            totalCreated: this.createdCount,
+        };
+    }
+    // ─── Reset (for testing) ──────────────────────────────────
+    reset() {
+        this.clearAllTimers();
+        for (const resource of this.resources.values()) {
+            try {
+                resource.dispose();
+            }
+            catch {
+                // ignore during reset
+            }
+        }
+        this.resources.clear();
+        this.disposedCount = 0;
+        this.createdCount = 0;
+    }
+}
+//# sourceMappingURL=resource-manager.js.map

package/dist/runtime/resource-manager.js.map

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

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

@@ -0,0 +1,77 @@
+/**
+ * Runtime Lifecycle
+ *
+ * Shared lifecycle service for Kernel and InfrastructureRuntime.
+ * Provides deterministic startup, shutdown, retry, timeout, and events.
+ * One state machine, no duplication.
+ */
+import type { LifecycleStage } from "../shared/constants.js";
+import { ResourceManager } from "./resource-manager.js";
+export interface LifecycleConfig {
+    readonly startupTimeoutMs: number;
+    readonly shutdownTimeoutMs: number;
+    readonly providerStartupTimeoutMs: number;
+    readonly providerShutdownTimeoutMs: number;
+    readonly maxRetries: number;
+    readonly retryBaseDelayMs: number;
+    readonly retryMaxDelayMs: number;
+}
+export declare const DEFAULT_LIFECYCLE_CONFIG: LifecycleConfig;
+export interface ProviderLifecycleEvent {
+    readonly providerId: string;
+    readonly from: LifecycleStage;
+    readonly to: LifecycleStage;
+    readonly timestamp: string;
+    readonly durationMs?: number;
+    readonly error?: string;
+    readonly attempt?: number;
+}
+export interface RuntimeLifecycleMetrics {
+    readonly totalStarts: number;
+    readonly totalFailures: number;
+    readonly totalRestarts: number;
+    readonly averageStartupMs: number;
+    readonly currentStage: LifecycleStage;
+}
+export interface LifecycleEventEmitter {
+    emit(event: string, data: Record<string, unknown>): void;
+}
+export declare class RuntimeLifecycle {
+    private config;
+    private eventEmitter?;
+    private resourceManager?;
+    private stage;
+    private eventHistory;
+    private listeners;
+    private providerStages;
+    private providerStartTimes;
+    private providerAttempts;
+    private totalStarts;
+    private totalFailures;
+    private totalRestarts;
+    private startupDurations;
+    constructor(config?: LifecycleConfig, eventEmitter?: LifecycleEventEmitter | undefined, resourceManager?: ResourceManager | undefined);
+    getStage(): LifecycleStage;
+    isRunning(): boolean;
+    isTerminated(): boolean;
+    canAcceptWork(): boolean;
+    getProviderStage(providerId: string): LifecycleStage;
+    startSystem(providers: Array<{
+        id: string;
+        connect: () => Promise<void>;
+        optional?: boolean;
+    }>): Promise<void>;
+    stopSystem(disconnectors?: Map<string, () => Promise<void>>): Promise<void>;
+    startProvider(providerId: string, connect: () => Promise<void>, optional?: boolean): Promise<void>;
+    stopProvider(providerId: string, disconnect: () => Promise<void>): Promise<void>;
+    restartProvider(providerId: string, disconnect: () => Promise<void>, connect: () => Promise<void>): Promise<void>;
+    onEvent(listener: (event: ProviderLifecycleEvent) => void): void;
+    getEventHistory(): readonly ProviderLifecycleEvent[];
+    getMetrics(): RuntimeLifecycleMetrics;
+    private updateStage;
+    private emitEvent;
+    private calculateRetryDelay;
+    private withTimeout;
+    private sleep;
+}
+//# sourceMappingURL=runtime-lifecycle.d.ts.map

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

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