@connexia/infrastructure 1.0.1

package/dist/runtime/index.d.ts

@@ -0,0 +1,9 @@
+export { ProviderLifecycleManager, type ProviderHandle, type ProviderState } from "./provider-lifecycle.js";
+export { InfrastructureRuntime, type InfrastructureConfig, type InfrastructureState } from "./infrastructure-runtime.js";
+export { ResourceManager, type ManagedTimer, type ManagedResource, type DisposalResult, type ResourceManagerStats, } from "./resource-manager.js";
+export { RuntimeLifecycle, DEFAULT_LIFECYCLE_CONFIG, type LifecycleConfig, type ProviderLifecycleEvent, type RuntimeLifecycleMetrics, type LifecycleEventEmitter, } from "./runtime-lifecycle.js";
+export { HealthRuntime, DEFAULT_HEALTH_CONFIG, type HealthRuntimeConfig, type ProviderHealthState, type ReadinessResult, type LivenessResult, type HealthChangeHandler, } from "./health-runtime.js";
+export { RecoveryRuntime, DEFAULT_RECOVERY_POLICY, type RecoveryPolicy, type RecoveryState, type RecoveryEvent, } from "./recovery-runtime.js";
+export { ProviderFactory, type ProviderFactoryConfig, type ProviderImplementation, type ProviderCreationResult, } from "./provider-factory.js";
+export { ProviderRegistry, type RegisteredProvider, } from "./provider-registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACzH,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,9 @@
+export { ProviderLifecycleManager } from "./provider-lifecycle.js";
+export { InfrastructureRuntime } from "./infrastructure-runtime.js";
+export { ResourceManager, } from "./resource-manager.js";
+export { RuntimeLifecycle, DEFAULT_LIFECYCLE_CONFIG, } from "./runtime-lifecycle.js";
+export { HealthRuntime, DEFAULT_HEALTH_CONFIG, } from "./health-runtime.js";
+export { RecoveryRuntime, DEFAULT_RECOVERY_POLICY, } from "./recovery-runtime.js";
+export { ProviderFactory, } from "./provider-factory.js";
+export { ProviderRegistry, } from "./provider-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAA2C,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAuD,MAAM,6BAA6B,CAAC;AACzH,OAAO,EACL,eAAe,GAKhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GAKzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,qBAAqB,GAMtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,uBAAuB,GAIxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,eAAe,GAIhB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { ProviderId, ProviderDescriptor } from "../shared/types.js";
+import type { HealthStatus, LifecycleStage } from "../shared/constants.js";
+import { type ProviderHandle } from "./provider-lifecycle.js";
+export interface InfrastructureConfig {
+    readonly name: string;
+    readonly version: string;
+    readonly environment: "development" | "staging" | "production" | "test";
+    readonly startupTimeoutMs: number;
+    readonly shutdownTimeoutMs: number;
+    readonly healthCheckIntervalMs: number;
+}
+export interface InfrastructureState {
+    readonly stage: LifecycleStage;
+    readonly startedAt: string | null;
+    readonly providers: ReadonlyArray<{
+        readonly id: string;
+        readonly stage: LifecycleStage;
+        readonly health: HealthStatus;
+    }>;
+}
+export declare class InfrastructureRuntime {
+    private config;
+    private state;
+    private providerLifecycle;
+    private healthCheckTimer;
+    constructor(config?: Partial<InfrastructureConfig>);
+    getConfig(): Readonly<InfrastructureConfig>;
+    getState(): InfrastructureState;
+    registerProvider(descriptor: ProviderDescriptor): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<ReadonlyArray<{
+        id: string;
+        health: HealthStatus;
+    }>>;
+    readiness(): Promise<boolean>;
+    liveness(): Promise<boolean>;
+    getProvider(id: ProviderId): ProviderHandle | undefined;
+    getAllProviders(): readonly ProviderHandle[];
+    private startHealthChecks;
+    private stopHealthChecks;
+    private updateStage;
+    private updateProviderStates;
+}
+//# sourceMappingURL=infrastructure-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/infrastructure-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGxF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;IACxE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;QAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;KAC/B,CAAC,CAAC;CACJ;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,gBAAgB,CAA+C;gBAE3D,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAmBlD,SAAS,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAI3C,QAAQ,IAAI,mBAAmB;IAI/B,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAKhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBrB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAW3E,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAW7B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS;IAIvD,eAAe,IAAI,SAAS,cAAc,EAAE;IAI5C,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,oBAAoB;CAW7B"}

package/dist/runtime/infrastructure-runtime.js

@@ -0,0 +1,133 @@
+import { ProviderLifecycleManager } from "./provider-lifecycle.js";
+import { InfrastructureError, ERROR_CODES } from "../shared/errors.js";
+export class InfrastructureRuntime {
+    config;
+    state;
+    providerLifecycle;
+    healthCheckTimer = null;
+    constructor(config) {
+        this.config = {
+            name: config?.name ?? "connexia-infrastructure",
+            version: config?.version ?? "1.0.0",
+            environment: config?.environment ?? "development",
+            startupTimeoutMs: config?.startupTimeoutMs ?? 30_000,
+            shutdownTimeoutMs: config?.shutdownTimeoutMs ?? 30_000,
+            healthCheckIntervalMs: config?.healthCheckIntervalMs ?? 30_000,
+        };
+        this.state = {
+            stage: "created",
+            startedAt: null,
+            providers: [],
+        };
+        this.providerLifecycle = new ProviderLifecycleManager();
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getState() {
+        return { ...this.state };
+    }
+    registerProvider(descriptor) {
+        this.providerLifecycle.register(descriptor);
+        this.updateProviderStates();
+    }
+    async start() {
+        this.updateStage("starting");
+        const startupOrder = this.providerLifecycle.getStartupOrder();
+        const timeout = this.config.startupTimeoutMs;
+        const startupPromise = (async () => {
+            for (const providerId of startupOrder) {
+                await this.providerLifecycle.connect(providerId);
+            }
+        })();
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new InfrastructureError("Startup timeout", {
+                code: ERROR_CODES.CONNECTION_TIMEOUT,
+                category: "connection",
+                severity: "critical",
+            })), timeout);
+        });
+        await Promise.race([startupPromise, timeoutPromise]);
+        this.updateStage("running");
+        this.state = {
+            ...this.state,
+            stage: "running",
+            startedAt: new Date().toISOString(),
+        };
+        this.startHealthChecks();
+    }
+    async stop() {
+        this.stopHealthChecks();
+        this.updateStage("stopping");
+        const shutdownPromise = (async () => {
+            const handles = this.providerLifecycle.getAll();
+            for (const handle of [...handles].reverse()) {
+                await this.providerLifecycle.disconnect(handle.descriptor.id);
+            }
+        })();
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new InfrastructureError("Shutdown timeout", {
+                code: ERROR_CODES.CONNECTION_TIMEOUT,
+                category: "connection",
+                severity: "high",
+            })), this.config.shutdownTimeoutMs);
+        });
+        await Promise.race([shutdownPromise, timeoutPromise]);
+        this.updateStage("stopped");
+    }
+    async healthCheck() {
+        const handles = this.providerLifecycle.getAll();
+        const results = await Promise.all(handles.map(async (handle) => ({
+            id: handle.descriptor.id,
+            health: await this.providerLifecycle.healthCheck(handle.descriptor.id),
+        })));
+        return results;
+    }
+    async readiness() {
+        if (this.state.stage !== "running")
+            return false;
+        const handles = this.providerLifecycle.getAll();
+        for (const handle of handles) {
+            const health = await this.providerLifecycle.healthCheck(handle.descriptor.id);
+            if (health === "unhealthy")
+                return false;
+        }
+        return true;
+    }
+    async liveness() {
+        return this.state.stage === "running" || this.state.stage === "starting";
+    }
+    getProvider(id) {
+        return this.providerLifecycle.getHandle(id);
+    }
+    getAllProviders() {
+        return this.providerLifecycle.getAll();
+    }
+    startHealthChecks() {
+        this.healthCheckTimer = setInterval(async () => {
+            await this.healthCheck();
+            this.updateProviderStates();
+        }, this.config.healthCheckIntervalMs);
+    }
+    stopHealthChecks() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = null;
+        }
+    }
+    updateStage(stage) {
+        this.state = { ...this.state, stage };
+    }
+    updateProviderStates() {
+        const handles = this.providerLifecycle.getAll();
+        this.state = {
+            ...this.state,
+            providers: handles.map((h) => ({
+                id: h.descriptor.id,
+                stage: h.state.stage,
+                health: "unknown",
+            })),
+        };
+    }
+}
+//# sourceMappingURL=infrastructure-runtime.js.map

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

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

package/dist/runtime/provider-factory.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Provider Factory
+ *
+ * Creates ProviderDescriptors from configuration.
+ * Supports config-driven provider selection.
+ * Validates dependencies before creation.
+ */
+import type { ProviderDescriptor } from "../shared/types.js";
+import type { ProviderType, HealthStatus } from "../shared/constants.js";
+export type ProviderImplementation = "in-memory" | "postgres" | "valkey" | "bullmq" | "filesystem";
+export interface ProviderFactoryConfig {
+    readonly id: string;
+    readonly type: ProviderType;
+    readonly implementation: ProviderImplementation;
+    readonly config: Record<string, unknown>;
+    readonly dependencies?: readonly string[];
+    readonly capabilities?: readonly string[];
+    readonly optional?: boolean;
+}
+export interface ProviderCreationResult {
+    readonly descriptor: ProviderDescriptor;
+    readonly config: ProviderFactoryConfig;
+}
+type ProviderCreator = (config: Record<string, unknown>) => {
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    healthCheck: () => Promise<HealthStatus>;
+};
+export declare class ProviderFactory {
+    private creators;
+    registerCreator(type: ProviderType, implementation: ProviderImplementation, creator: ProviderCreator): void;
+    create(config: ProviderFactoryConfig): ProviderCreationResult;
+    createAll(configs: ProviderFactoryConfig[]): ProviderCreationResult[];
+    validateDependencies(configs: ProviderFactoryConfig[]): {
+        valid: boolean;
+        errors: string[];
+    };
+    getAvailableImplementations(type: ProviderType): ProviderImplementation[];
+    hasCreator(type: ProviderType, implementation: ProviderImplementation): boolean;
+}
+export {};
+//# sourceMappingURL=provider-factory.d.ts.map

package/dist/runtime/provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-factory.d.ts","sourceRoot":"","sources":["../../src/runtime/provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAIzE,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEnG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED,KAAK,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK;IAC1D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1C,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IAItD,eAAe,CACb,IAAI,EAAE,YAAY,EAClB,cAAc,EAAE,sBAAsB,EACtC,OAAO,EAAE,eAAe,GACvB,IAAI;IAOP,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB;IAkC7D,SAAS,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,sBAAsB,EAAE;IAoBrE,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG;QACtD,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;IA+CD,2BAA2B,CAAC,IAAI,EAAE,YAAY,GAAG,sBAAsB,EAAE;IAazE,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,sBAAsB,GAAG,OAAO;CAGhF"}

package/dist/runtime/provider-factory.js

@@ -0,0 +1,111 @@
+/**
+ * Provider Factory
+ *
+ * Creates ProviderDescriptors from configuration.
+ * Supports config-driven provider selection.
+ * Validates dependencies before creation.
+ */
+import { brand } from "../shared/branding.js";
+import { InfrastructureError, ERROR_CODES } from "../shared/errors.js";
+export class ProviderFactory {
+    creators = new Map();
+    // ─── Registration ──────────────────────────────────────────
+    registerCreator(type, implementation, creator) {
+        const key = `${type}:${implementation}`;
+        this.creators.set(key, creator);
+    }
+    // ─── Creation ──────────────────────────────────────────────
+    create(config) {
+        const key = `${config.type}:${config.implementation}`;
+        const creator = this.creators.get(key);
+        if (!creator) {
+            throw new InfrastructureError(`No creator registered for ${config.type}:${config.implementation}`, {
+                code: ERROR_CODES.CONFIG_INVALID,
+                category: "configuration",
+                severity: "high",
+                details: { type: config.type, implementation: config.implementation },
+            });
+        }
+        const impl = creator(config.config);
+        const descriptor = {
+            id: brand(config.id),
+            type: config.type,
+            name: `${config.type}-${config.implementation}`,
+            version: "1.0.0",
+            capabilities: config.capabilities ?? [],
+            dependencies: (config.dependencies ?? []).map((d) => brand(d)),
+            config: config.config,
+            connect: impl.connect,
+            disconnect: impl.disconnect,
+            healthCheck: impl.healthCheck,
+        };
+        return { descriptor, config };
+    }
+    createAll(configs) {
+        // Validate dependencies first
+        const validation = this.validateDependencies(configs);
+        if (!validation.valid) {
+            throw new InfrastructureError(`Dependency validation failed: ${validation.errors.join(", ")}`, {
+                code: ERROR_CODES.CONFIG_INVALID,
+                category: "configuration",
+                severity: "high",
+                details: { errors: validation.errors },
+            });
+        }
+        return configs.map((config) => this.create(config));
+    }
+    // ─── Validation ────────────────────────────────────────────
+    validateDependencies(configs) {
+        const errors = [];
+        const ids = new Set(configs.map((c) => c.id));
+        for (const config of configs) {
+            for (const dep of config.dependencies ?? []) {
+                if (!ids.has(dep)) {
+                    errors.push(`Provider "${config.id}" depends on "${dep}" which is not configured`);
+                }
+            }
+        }
+        // Check for cycles using DFS
+        const adjacency = new Map();
+        for (const config of configs) {
+            adjacency.set(config.id, [...(config.dependencies ?? [])]);
+        }
+        const visited = new Set();
+        const inStack = new Set();
+        const hasCycle = (node) => {
+            visited.add(node);
+            inStack.add(node);
+            for (const dep of adjacency.get(node) ?? []) {
+                if (inStack.has(dep))
+                    return true;
+                if (!visited.has(dep) && hasCycle(dep))
+                    return true;
+            }
+            inStack.delete(node);
+            return false;
+        };
+        for (const config of configs) {
+            if (!visited.has(config.id)) {
+                if (hasCycle(config.id)) {
+                    errors.push(`Circular dependency detected involving "${config.id}"`);
+                }
+            }
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    // ─── Query ─────────────────────────────────────────────────
+    getAvailableImplementations(type) {
+        const impls = [];
+        const implementations = ["in-memory", "postgres", "valkey", "bullmq", "filesystem"];
+        for (const impl of implementations) {
+            if (this.creators.has(`${type}:${impl}`)) {
+                impls.push(impl);
+            }
+        }
+        return impls;
+    }
+    hasCreator(type, implementation) {
+        return this.creators.has(`${type}:${implementation}`);
+    }
+}
+//# sourceMappingURL=provider-factory.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { ProviderId, ProviderDescriptor, ProviderManifest } from "../shared/types.js";
+import type { HealthStatus, LifecycleStage } from "../shared/constants.js";
+import { InfrastructureError } from "../shared/errors.js";
+export interface ProviderState {
+    readonly stage: LifecycleStage;
+    readonly startedAt: string | null;
+    readonly lastHealthCheck: string | null;
+    readonly error: InfrastructureError | null;
+    readonly configChecksum: string;
+}
+export interface ProviderHandle {
+    readonly descriptor: ProviderDescriptor;
+    readonly state: ProviderState;
+    readonly manifest: ProviderManifest;
+}
+export declare class ProviderLifecycleManager {
+    private providers;
+    private startupOrder;
+    register(descriptor: ProviderDescriptor): void;
+    connect(id: ProviderId): Promise<void>;
+    disconnect(id: ProviderId): Promise<void>;
+    healthCheck(id: ProviderId): Promise<HealthStatus>;
+    getHandle(id: ProviderId): ProviderHandle | undefined;
+    getAll(): readonly ProviderHandle[];
+    getStartupOrder(): readonly string[];
+    private updateState;
+    private createManifest;
+    private updateStartupOrder;
+}
+//# sourceMappingURL=provider-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-lifecycle.d.ts","sourceRoot":"","sources":["../../src/runtime/provider-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAe,MAAM,qBAAqB,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,YAAY,CAAgB;IAEpC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAuBxC,OAAO,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BtC,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzC,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBxD,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS;IAIrD,MAAM,IAAI,SAAS,cAAc,EAAE;IAInC,eAAe,IAAI,SAAS,MAAM,EAAE;IAIpC,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,kBAAkB;CAwB3B"}

package/dist/runtime/provider-lifecycle.js

@@ -0,0 +1,149 @@
+import { sha256Object } from "../shared/hashing.js";
+import { InfrastructureError, ERROR_CODES } from "../shared/errors.js";
+export class ProviderLifecycleManager {
+    providers = new Map();
+    startupOrder = [];
+    register(descriptor) {
+        const key = descriptor.id;
+        if (this.providers.has(key)) {
+            throw new InfrastructureError(`Provider already registered: ${key}`, {
+                code: ERROR_CODES.INTERNAL_ERROR,
+                category: "internal",
+                details: { providerId: key },
+            });
+        }
+        const manifest = this.createManifest(descriptor);
+        const state = {
+            stage: "created",
+            startedAt: null,
+            lastHealthCheck: null,
+            error: null,
+            configChecksum: manifest.configChecksum,
+        };
+        this.providers.set(key, { descriptor, state, manifest });
+        this.updateStartupOrder();
+    }
+    async connect(id) {
+        const handle = this.providers.get(id);
+        if (!handle) {
+            throw new InfrastructureError(`Provider not found: ${id}`, {
+                code: ERROR_CODES.DB_CONNECTION_FAILED,
+                category: "connection",
+                details: { providerId: id },
+            });
+        }
+        try {
+            if (handle.descriptor.connect) {
+                await handle.descriptor.connect();
+            }
+            this.updateState(id, { stage: "running", startedAt: new Date().toISOString() });
+        }
+        catch (error) {
+            this.updateState(id, {
+                stage: "failed",
+                error: error instanceof InfrastructureError ? error : new InfrastructureError(String(error), {
+                    code: ERROR_CODES.CONNECTION_TIMEOUT,
+                    category: "connection",
+                }),
+            });
+            throw error;
+        }
+    }
+    async disconnect(id) {
+        const handle = this.providers.get(id);
+        if (!handle)
+            return;
+        try {
+            if (handle.descriptor.disconnect) {
+                await handle.descriptor.disconnect();
+            }
+            this.updateState(id, { stage: "stopped" });
+        }
+        catch (error) {
+            this.updateState(id, {
+                stage: "failed",
+                error: error instanceof InfrastructureError ? error : new InfrastructureError(String(error), {
+                    code: ERROR_CODES.CONNECTION_TIMEOUT,
+                    category: "connection",
+                }),
+            });
+        }
+    }
+    async healthCheck(id) {
+        const handle = this.providers.get(id);
+        if (!handle)
+            return "unknown";
+        try {
+            if (handle.descriptor.healthCheck) {
+                const status = await handle.descriptor.healthCheck();
+                this.updateState(id, { lastHealthCheck: new Date().toISOString() });
+                return status;
+            }
+            this.updateState(id, { lastHealthCheck: new Date().toISOString() });
+            return "unknown";
+        }
+        catch {
+            return "unhealthy";
+        }
+    }
+    getHandle(id) {
+        return this.providers.get(id);
+    }
+    getAll() {
+        return Array.from(this.providers.values());
+    }
+    getStartupOrder() {
+        return [...this.startupOrder];
+    }
+    updateState(id, partial) {
+        const handle = this.providers.get(id);
+        if (!handle)
+            return;
+        const currentState = handle.state;
+        const newState = {
+            stage: partial.stage ?? currentState.stage,
+            startedAt: partial.startedAt ?? currentState.startedAt,
+            lastHealthCheck: partial.lastHealthCheck ?? currentState.lastHealthCheck,
+            error: partial.error ?? currentState.error,
+            configChecksum: currentState.configChecksum,
+        };
+        this.providers.set(id, {
+            ...handle,
+            state: newState,
+        });
+    }
+    createManifest(descriptor) {
+        const configChecksum = sha256Object(descriptor.config);
+        return {
+            id: descriptor.id,
+            type: descriptor.type,
+            name: descriptor.name,
+            version: descriptor.version,
+            capabilities: descriptor.capabilities,
+            dependencies: descriptor.dependencies,
+            configChecksum,
+            startupTime: new Date().toISOString(),
+        };
+    }
+    updateStartupOrder() {
+        const visited = new Set();
+        const order = [];
+        const visit = (id) => {
+            if (visited.has(id))
+                return;
+            visited.add(id);
+            const handle = this.providers.get(id);
+            if (handle) {
+                for (const dep of handle.descriptor.dependencies) {
+                    visit(dep);
+                }
+            }
+            order.push(id);
+        };
+        for (const key of this.providers.keys()) {
+            visit(key);
+        }
+        this.startupOrder = order;
+    }
+}
+//# sourceMappingURL=provider-lifecycle.js.map

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

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

package/dist/runtime/provider-registry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Provider Registry
+ *
+ * Stores ProviderDescriptors and their instantiated implementations.
+ * Provides typed resolution of provider implementations.
+ */
+import type { ProviderDescriptor } from "../shared/types.js";
+export interface RegisteredProvider {
+    readonly descriptor: ProviderDescriptor;
+    readonly implementation?: unknown;
+}
+export declare class ProviderRegistry {
+    private providers;
+    register(descriptor: ProviderDescriptor, implementation?: unknown): void;
+    get<T = unknown>(providerId: string): T | undefined;
+    getRequired<T = unknown>(providerId: string): T;
+    getDescriptor(providerId: string): ProviderDescriptor | undefined;
+    getAll(): ProviderDescriptor[];
+    getAllRegistered(): RegisteredProvider[];
+    has(providerId: string): boolean;
+    getCount(): number;
+    remove(providerId: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/runtime/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAyC;IAI1D,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI;IAOxE,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAMnD,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;IAQ/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAMjE,MAAM,IAAI,kBAAkB,EAAE;IAI9B,gBAAgB,IAAI,kBAAkB,EAAE;IAIxC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC,QAAQ,IAAI,MAAM;IAMlB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInC,KAAK,IAAI,IAAI;CAGd"}