@objectstack/spec 0.9.1 → 0.9.2

package/dist/system/plugin-lifecycle-advanced.zod.d.ts

@@ -0,0 +1,357 @@
+import { z } from 'zod';
+/**
+ * # Advanced Plugin Lifecycle Protocol
+ *
+ * Defines advanced lifecycle management capabilities including:
+ * - Hot reload and live updates
+ * - Graceful degradation and fallback mechanisms
+ * - Health monitoring and auto-recovery
+ * - State preservation during updates
+ *
+ * This protocol extends the basic plugin lifecycle with enterprise-grade
+ * features for production environments.
+ */
+/**
+ * Plugin Health Status
+ * Represents the current operational state of a plugin
+ */
+export declare const PluginHealthStatusSchema: z.ZodEnum<{
+    unknown: "unknown";
+    failed: "failed";
+    healthy: "healthy";
+    degraded: "degraded";
+    unhealthy: "unhealthy";
+    recovering: "recovering";
+}>;
+/**
+ * Plugin Health Check Configuration
+ * Defines how to check plugin health
+ */
+export declare const PluginHealthCheckSchema: z.ZodObject<{
+    interval: z.ZodDefault<z.ZodNumber>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    failureThreshold: z.ZodDefault<z.ZodNumber>;
+    successThreshold: z.ZodDefault<z.ZodNumber>;
+    checkMethod: z.ZodOptional<z.ZodString>;
+    autoRestart: z.ZodDefault<z.ZodBoolean>;
+    maxRestartAttempts: z.ZodDefault<z.ZodNumber>;
+    restartBackoff: z.ZodDefault<z.ZodEnum<{
+        fixed: "fixed";
+        linear: "linear";
+        exponential: "exponential";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Plugin Health Report
+ * Detailed health information from a plugin
+ */
+export declare const PluginHealthReportSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+        healthy: "healthy";
+        degraded: "degraded";
+        unhealthy: "unhealthy";
+        recovering: "recovering";
+    }>;
+    timestamp: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodObject<{
+        uptime: z.ZodOptional<z.ZodNumber>;
+        memoryUsage: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        cpuUsage: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        activeConnections: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        errorRate: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        responseTime: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<{
+            warning: "warning";
+            failed: "failed";
+            passed: "passed";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>>>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pluginId: z.ZodString;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            failed: "failed";
+            healthy: "healthy";
+            degraded: "degraded";
+            unhealthy: "unhealthy";
+            recovering: "recovering";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * Distributed State Configuration
+ * Configuration for distributed state management in cluster environments
+ */
+export declare const DistributedStateConfigSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        custom: "custom";
+        redis: "redis";
+        etcd: "etcd";
+    }>;
+    endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    auth: z.ZodOptional<z.ZodObject<{
+        username: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+        token: z.ZodOptional<z.ZodString>;
+        certificate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    replication: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        minReplicas: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    customConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Hot Reload Configuration
+ * Controls how plugins handle live updates
+ */
+export declare const HotReloadConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    watchPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    debounceDelay: z.ZodDefault<z.ZodNumber>;
+    preserveState: z.ZodDefault<z.ZodBoolean>;
+    stateStrategy: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        memory: "memory";
+        disk: "disk";
+        distributed: "distributed";
+    }>>;
+    distributedConfig: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodEnum<{
+            custom: "custom";
+            redis: "redis";
+            etcd: "etcd";
+        }>;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        keyPrefix: z.ZodOptional<z.ZodString>;
+        ttl: z.ZodOptional<z.ZodNumber>;
+        auth: z.ZodOptional<z.ZodObject<{
+            username: z.ZodOptional<z.ZodString>;
+            password: z.ZodOptional<z.ZodString>;
+            token: z.ZodOptional<z.ZodString>;
+            certificate: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        replication: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            minReplicas: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        customConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strip>>;
+    shutdownTimeout: z.ZodDefault<z.ZodNumber>;
+    beforeReload: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    afterReload: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Graceful Degradation Configuration
+ * Defines how plugin degrades when dependencies fail
+ */
+export declare const GracefulDegradationSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    fallbackMode: z.ZodDefault<z.ZodEnum<{
+        readonly: "readonly";
+        cached: "cached";
+        disabled: "disabled";
+        minimal: "minimal";
+        offline: "offline";
+    }>>;
+    criticalDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    degradedFeatures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        feature: z.ZodString;
+        enabled: z.ZodBoolean;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    autoRecovery: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        retryInterval: z.ZodDefault<z.ZodNumber>;
+        maxAttempts: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Plugin Update Strategy
+ * Defines how plugin handles version updates
+ */
+export declare const PluginUpdateStrategySchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        manual: "manual";
+        rolling: "rolling";
+        automatic: "automatic";
+        scheduled: "scheduled";
+    }>>;
+    autoUpdateConstraints: z.ZodOptional<z.ZodObject<{
+        major: z.ZodDefault<z.ZodBoolean>;
+        minor: z.ZodDefault<z.ZodBoolean>;
+        patch: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    schedule: z.ZodOptional<z.ZodObject<{
+        cron: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodDefault<z.ZodString>;
+        maintenanceWindow: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    rollback: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        automatic: z.ZodDefault<z.ZodBoolean>;
+        keepVersions: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    validation: z.ZodOptional<z.ZodObject<{
+        checkCompatibility: z.ZodDefault<z.ZodBoolean>;
+        runTests: z.ZodDefault<z.ZodBoolean>;
+        testSuite: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Plugin State Snapshot
+ * Captures plugin state for preservation during updates/reloads
+ */
+export declare const PluginStateSnapshotSchema: z.ZodObject<{
+    pluginId: z.ZodString;
+    version: z.ZodString;
+    timestamp: z.ZodString;
+    state: z.ZodRecord<z.ZodString, z.ZodAny>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        checksum: z.ZodOptional<z.ZodString>;
+        compressed: z.ZodDefault<z.ZodBoolean>;
+        encryption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Advanced Plugin Lifecycle Configuration
+ * Complete configuration for advanced lifecycle management
+ */
+export declare const AdvancedPluginLifecycleConfigSchema: z.ZodObject<{
+    health: z.ZodOptional<z.ZodObject<{
+        interval: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+        failureThreshold: z.ZodDefault<z.ZodNumber>;
+        successThreshold: z.ZodDefault<z.ZodNumber>;
+        checkMethod: z.ZodOptional<z.ZodString>;
+        autoRestart: z.ZodDefault<z.ZodBoolean>;
+        maxRestartAttempts: z.ZodDefault<z.ZodNumber>;
+        restartBackoff: z.ZodDefault<z.ZodEnum<{
+            fixed: "fixed";
+            linear: "linear";
+            exponential: "exponential";
+        }>>;
+    }, z.core.$strip>>;
+    hotReload: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        watchPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        debounceDelay: z.ZodDefault<z.ZodNumber>;
+        preserveState: z.ZodDefault<z.ZodBoolean>;
+        stateStrategy: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            memory: "memory";
+            disk: "disk";
+            distributed: "distributed";
+        }>>;
+        distributedConfig: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodEnum<{
+                custom: "custom";
+                redis: "redis";
+                etcd: "etcd";
+            }>;
+            endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            keyPrefix: z.ZodOptional<z.ZodString>;
+            ttl: z.ZodOptional<z.ZodNumber>;
+            auth: z.ZodOptional<z.ZodObject<{
+                username: z.ZodOptional<z.ZodString>;
+                password: z.ZodOptional<z.ZodString>;
+                token: z.ZodOptional<z.ZodString>;
+                certificate: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            replication: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                minReplicas: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>;
+            customConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>;
+        shutdownTimeout: z.ZodDefault<z.ZodNumber>;
+        beforeReload: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        afterReload: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    degradation: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        fallbackMode: z.ZodDefault<z.ZodEnum<{
+            readonly: "readonly";
+            cached: "cached";
+            disabled: "disabled";
+            minimal: "minimal";
+            offline: "offline";
+        }>>;
+        criticalDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        optionalDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        degradedFeatures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            feature: z.ZodString;
+            enabled: z.ZodBoolean;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        autoRecovery: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            retryInterval: z.ZodDefault<z.ZodNumber>;
+            maxAttempts: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    updates: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            manual: "manual";
+            rolling: "rolling";
+            automatic: "automatic";
+            scheduled: "scheduled";
+        }>>;
+        autoUpdateConstraints: z.ZodOptional<z.ZodObject<{
+            major: z.ZodDefault<z.ZodBoolean>;
+            minor: z.ZodDefault<z.ZodBoolean>;
+            patch: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        schedule: z.ZodOptional<z.ZodObject<{
+            cron: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodDefault<z.ZodString>;
+            maintenanceWindow: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rollback: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            automatic: z.ZodDefault<z.ZodBoolean>;
+            keepVersions: z.ZodDefault<z.ZodNumber>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        validation: z.ZodOptional<z.ZodObject<{
+            checkCompatibility: z.ZodDefault<z.ZodBoolean>;
+            runTests: z.ZodDefault<z.ZodBoolean>;
+            testSuite: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    resources: z.ZodOptional<z.ZodObject<{
+        maxMemory: z.ZodOptional<z.ZodNumber>;
+        maxCpu: z.ZodOptional<z.ZodNumber>;
+        maxConnections: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    observability: z.ZodOptional<z.ZodObject<{
+        enableMetrics: z.ZodDefault<z.ZodBoolean>;
+        enableTracing: z.ZodDefault<z.ZodBoolean>;
+        enableProfiling: z.ZodDefault<z.ZodBoolean>;
+        metricsInterval: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginHealthStatus = z.infer<typeof PluginHealthStatusSchema>;
+export type PluginHealthCheck = z.infer<typeof PluginHealthCheckSchema>;
+export type PluginHealthReport = z.infer<typeof PluginHealthReportSchema>;
+export type DistributedStateConfig = z.infer<typeof DistributedStateConfigSchema>;
+export type HotReloadConfig = z.infer<typeof HotReloadConfigSchema>;
+export type GracefulDegradation = z.infer<typeof GracefulDegradationSchema>;
+export type PluginUpdateStrategy = z.infer<typeof PluginUpdateStrategySchema>;
+export type PluginStateSnapshot = z.infer<typeof PluginStateSnapshotSchema>;
+export type AdvancedPluginLifecycleConfig = z.infer<typeof AdvancedPluginLifecycleConfigSchema>;
+//# sourceMappingURL=plugin-lifecycle-advanced.zod.d.ts.map

package/dist/system/plugin-lifecycle-advanced.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-lifecycle-advanced.zod.d.ts","sourceRoot":"","sources":["../../src/system/plugin-lifecycle-advanced.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;EAOa,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAgDlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;iBAgDvC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqDhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBAgDpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiFrC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;iBA6BpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyC9C,CAAC;AAGH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}