@objectstack/core 1.0.2 → 1.0.5

package/dist/kernel-base.js

@@ -1,219 +0,0 @@
-/**
- * ObjectKernelBase - Abstract Base Class for Microkernel
- *
- * Provides common functionality for ObjectKernel and LiteKernel:
- * - Plugin management (Map storage)
- * - Dependency resolution (topological sort)
- * - Hook/Event system
- * - Context creation
- * - State validation
- *
- * This eliminates code duplication between the implementations.
- */
-export class ObjectKernelBase {
-    constructor(logger) {
-        this.plugins = new Map();
-        this.services = new Map();
-        this.hooks = new Map();
-        this.state = 'idle';
-        this.logger = logger;
-    }
-    /**
-     * Validate kernel state
-     * @param requiredState - Required state for the operation
-     * @throws Error if current state doesn't match
-     */
-    validateState(requiredState) {
-        if (this.state !== requiredState) {
-            throw new Error(`[Kernel] Invalid state: expected '${requiredState}', got '${this.state}'`);
-        }
-    }
-    /**
-     * Validate kernel is in idle state (for plugin registration)
-     */
-    validateIdle() {
-        if (this.state !== 'idle') {
-            throw new Error('[Kernel] Cannot register plugins after bootstrap has started');
-        }
-    }
-    /**
-     * Create the plugin context
-     * Subclasses can override to customize context creation
-     */
-    createContext() {
-        return {
-            registerService: (name, service) => {
-                if (this.services instanceof Map) {
-                    if (this.services.has(name)) {
-                        throw new Error(`[Kernel] Service '${name}' already registered`);
-                    }
-                    this.services.set(name, service);
-                }
-                else {
-                    // IServiceRegistry implementation
-                    this.services.register(name, service);
-                }
-                this.logger.info(`Service '${name}' registered`, { service: name });
-            },
-            getService: (name) => {
-                if (this.services instanceof Map) {
-                    const service = this.services.get(name);
-                    if (!service) {
-                        throw new Error(`[Kernel] Service '${name}' not found`);
-                    }
-                    return service;
-                }
-                else {
-                    // IServiceRegistry implementation
-                    return this.services.get(name);
-                }
-            },
-            hook: (name, handler) => {
-                if (!this.hooks.has(name)) {
-                    this.hooks.set(name, []);
-                }
-                this.hooks.get(name).push(handler);
-            },
-            trigger: async (name, ...args) => {
-                const handlers = this.hooks.get(name) || [];
-                for (const handler of handlers) {
-                    await handler(...args);
-                }
-            },
-            getServices: () => {
-                if (this.services instanceof Map) {
-                    return new Map(this.services);
-                }
-                else {
-                    // For IServiceRegistry, we need to return the underlying Map
-                    // This is a compatibility method
-                    return new Map();
-                }
-            },
-            logger: this.logger,
-            getKernel: () => this,
-        };
-    }
-    /**
-     * Resolve plugin dependencies using topological sort
-     * @returns Ordered list of plugins (dependencies first)
-     */
-    resolveDependencies() {
-        const resolved = [];
-        const visited = new Set();
-        const visiting = new Set();
-        const visit = (pluginName) => {
-            if (visited.has(pluginName))
-                return;
-            if (visiting.has(pluginName)) {
-                throw new Error(`[Kernel] Circular dependency detected: ${pluginName}`);
-            }
-            const plugin = this.plugins.get(pluginName);
-            if (!plugin) {
-                throw new Error(`[Kernel] Plugin '${pluginName}' not found`);
-            }
-            visiting.add(pluginName);
-            // Visit dependencies first
-            const deps = plugin.dependencies || [];
-            for (const dep of deps) {
-                if (!this.plugins.has(dep)) {
-                    throw new Error(`[Kernel] Dependency '${dep}' not found for plugin '${pluginName}'`);
-                }
-                visit(dep);
-            }
-            visiting.delete(pluginName);
-            visited.add(pluginName);
-            resolved.push(plugin);
-        };
-        // Visit all plugins
-        for (const pluginName of this.plugins.keys()) {
-            visit(pluginName);
-        }
-        return resolved;
-    }
-    /**
-     * Run plugin init phase
-     * @param plugin - Plugin to initialize
-     */
-    async runPluginInit(plugin) {
-        const pluginName = plugin.name;
-        this.logger.info(`Initializing plugin: ${pluginName}`);
-        try {
-            await plugin.init(this.context);
-            this.logger.info(`Plugin initialized: ${pluginName}`);
-        }
-        catch (error) {
-            this.logger.error(`Plugin init failed: ${pluginName}`, error);
-            throw error;
-        }
-    }
-    /**
-     * Run plugin start phase
-     * @param plugin - Plugin to start
-     */
-    async runPluginStart(plugin) {
-        if (!plugin.start)
-            return;
-        const pluginName = plugin.name;
-        this.logger.info(`Starting plugin: ${pluginName}`);
-        try {
-            await plugin.start(this.context);
-            this.logger.info(`Plugin started: ${pluginName}`);
-        }
-        catch (error) {
-            this.logger.error(`Plugin start failed: ${pluginName}`, error);
-            throw error;
-        }
-    }
-    /**
-     * Run plugin destroy phase
-     * @param plugin - Plugin to destroy
-     */
-    async runPluginDestroy(plugin) {
-        if (!plugin.destroy)
-            return;
-        const pluginName = plugin.name;
-        this.logger.info(`Destroying plugin: ${pluginName}`);
-        try {
-            await plugin.destroy();
-            this.logger.info(`Plugin destroyed: ${pluginName}`);
-        }
-        catch (error) {
-            this.logger.error(`Plugin destroy failed: ${pluginName}`, error);
-            throw error;
-        }
-    }
-    /**
-     * Trigger a hook with all registered handlers
-     * @param name - Hook name
-     * @param args - Arguments to pass to handlers
-     */
-    async triggerHook(name, ...args) {
-        const handlers = this.hooks.get(name) || [];
-        this.logger.debug(`Triggering hook: ${name}`, {
-            hook: name,
-            handlerCount: handlers.length
-        });
-        for (const handler of handlers) {
-            try {
-                await handler(...args);
-            }
-            catch (error) {
-                this.logger.error(`Hook handler failed: ${name}`, error);
-                // Continue with other handlers even if one fails
-            }
-        }
-    }
-    /**
-     * Get current kernel state
-     */
-    getState() {
-        return this.state;
-    }
-    /**
-     * Get all registered plugins
-     */
-    getPlugins() {
-        return new Map(this.plugins);
-    }
-}

package/dist/kernel.d.ts

@@ -1,113 +0,0 @@
-import { Plugin } from './types.js';
-import type { LoggerConfig } from '@objectstack/spec/system';
-import { ServiceLifecycle, ServiceFactory } from './plugin-loader.js';
-/**
- * Enhanced Kernel Configuration
- */
-export interface ObjectKernelConfig {
-    logger?: Partial<LoggerConfig>;
-    /** Default plugin startup timeout in milliseconds */
-    defaultStartupTimeout?: number;
-    /** Whether to enable graceful shutdown */
-    gracefulShutdown?: boolean;
-    /** Graceful shutdown timeout in milliseconds */
-    shutdownTimeout?: number;
-    /** Whether to rollback on startup failure */
-    rollbackOnFailure?: boolean;
-    /** Whether to skip strict system requirement validation (Critical for testing) */
-    skipSystemValidation?: boolean;
-}
-/**
- * Enhanced ObjectKernel with Advanced Plugin Management
- *
- * Extends the basic ObjectKernel with:
- * - Async plugin loading with validation
- * - Version compatibility checking
- * - Plugin signature verification
- * - Configuration validation (Zod)
- * - Factory-based dependency injection
- * - Service lifecycle management (singleton/transient/scoped)
- * - Circular dependency detection
- * - Lazy loading services
- * - Graceful shutdown
- * - Plugin startup timeout control
- * - Startup failure rollback
- * - Plugin health checks
- */
-export declare class ObjectKernel {
-    private plugins;
-    private services;
-    private hooks;
-    private state;
-    private logger;
-    private context;
-    private pluginLoader;
-    private config;
-    private startedPlugins;
-    private pluginStartTimes;
-    private shutdownHandlers;
-    constructor(config?: ObjectKernelConfig);
-    /**
-     * Register a plugin with enhanced validation
-     */
-    use(plugin: Plugin): Promise<this>;
-    /**
-     * Register a service instance directly
-     */
-    registerService<T>(name: string, service: T): this;
-    /**
-     * Register a service factory with lifecycle management
-     */
-    registerServiceFactory<T>(name: string, factory: ServiceFactory<T>, lifecycle?: ServiceLifecycle, dependencies?: string[]): this;
-    /**
-     * Validate Critical System Requirements
-     */
-    private validateSystemRequirements;
-    /**
-     * Bootstrap the kernel with enhanced features
-     */
-    bootstrap(): Promise<void>;
-    /**
-     * Graceful shutdown with timeout
-     */
-    shutdown(): Promise<void>;
-    /**
-     * Check health of a specific plugin
-     */
-    checkPluginHealth(pluginName: string): Promise<any>;
-    /**
-     * Check health of all plugins
-     */
-    checkAllPluginsHealth(): Promise<Map<string, any>>;
-    /**
-     * Get plugin startup metrics
-     */
-    getPluginMetrics(): Map<string, number>;
-    /**
-     * Get a service (sync helper)
-     */
-    getService<T>(name: string): T;
-    /**
-     * Get a service asynchronously (supports factories)
-     */
-    getServiceAsync<T>(name: string, scopeId?: string): Promise<T>;
-    /**
-     * Check if kernel is running
-     */
-    isRunning(): boolean;
-    /**
-     * Get kernel state
-     */
-    getState(): string;
-    private initPluginWithTimeout;
-    private startPluginWithTimeout;
-    private rollbackStartedPlugins;
-    private performShutdown;
-    private resolveDependencies;
-    private registerShutdownSignals;
-    /**
-     * Register a custom shutdown handler
-     */
-    onShutdown(handler: () => Promise<void>): void;
-}
-//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAgC,gBAAgB,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAGzH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B,qDAAqD;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,KAAK,CAA2E;IACxF,OAAO,CAAC,KAAK,CAAwE;IACrF,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,MAAM,GAAE,kBAAuB;IAoF3C;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxC;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAUlD;;OAEG;IACH,sBAAsB,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,SAAS,GAAE,gBAA6C,EACxD,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,IAAI;IAUP;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwClC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC/B;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIzD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWxD;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvC;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAI9B;;OAEG;IACG,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,MAAM;YAMJ,qBAAqB;YAerB,sBAAsB;YA6CtB,sBAAsB;YAkBtB,eAAe;IA2B7B,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGjD"}