@objectstack/core 1.0.2 → 1.0.5

package/dist/hot-reload.d.ts

@@ -1,79 +0,0 @@
-import type { HotReloadConfig } from '@objectstack/spec/kernel';
-import type { ObjectLogger } from './logger.js';
-import type { Plugin } from './types.js';
-/**
- * Plugin State Manager
- *
- * Handles state persistence and restoration during hot reloads
- */
-declare class PluginStateManager {
-    private logger;
-    private stateSnapshots;
-    private memoryStore;
-    constructor(logger: ObjectLogger);
-    /**
-     * Save plugin state before reload
-     */
-    saveState(pluginId: string, version: string, state: Record<string, any>, config: HotReloadConfig): Promise<string>;
-    /**
-     * Restore plugin state after reload
-     */
-    restoreState(pluginId: string, snapshotId?: string): Promise<Record<string, any> | undefined>;
-    /**
-     * Clear state for a plugin
-     */
-    clearState(pluginId: string): void;
-    /**
-     * Calculate simple checksum for state verification
-     * WARNING: This is a simple hash for demo purposes.
-     * In production, use a cryptographic hash like SHA-256.
-     */
-    private calculateChecksum;
-    /**
-     * Shutdown state manager
-     */
-    shutdown(): void;
-}
-/**
- * Hot Reload Manager
- *
- * Manages hot reloading of plugins with state preservation
- */
-export declare class HotReloadManager {
-    private logger;
-    private stateManager;
-    private reloadConfigs;
-    private watchHandles;
-    private reloadTimers;
-    constructor(logger: ObjectLogger);
-    /**
-     * Register a plugin for hot reload
-     */
-    registerPlugin(pluginName: string, config: HotReloadConfig): void;
-    /**
-     * Start watching for changes (requires file system integration)
-     */
-    startWatching(pluginName: string): void;
-    /**
-     * Stop watching for changes
-     */
-    stopWatching(pluginName: string): void;
-    /**
-     * Trigger hot reload for a plugin
-     */
-    reloadPlugin(pluginName: string, plugin: Plugin, version: string, getPluginState: () => Record<string, any>, restorePluginState: (state: Record<string, any>) => void): Promise<boolean>;
-    /**
-     * Schedule a reload with debouncing
-     */
-    scheduleReload(pluginName: string, reloadFn: () => Promise<void>): void;
-    /**
-     * Get state manager for direct access
-     */
-    getStateManager(): PluginStateManager;
-    /**
-     * Shutdown hot reload manager
-     */
-    shutdown(): void;
-}
-export {};
-//# sourceMappingURL=hot-reload.d.ts.map

package/dist/hot-reload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hot-reload.d.ts","sourceRoot":"","sources":["../src/hot-reload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAezC;;;;GAIG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,WAAW,CAA0B;gBAEjC,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC;IA8ClB;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;IAgC3C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMlC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKjB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAqC;gBAE7C,MAAM,EAAE,YAAY;IAKhC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAcjE;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAcvC;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAgBtC;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GACvD,OAAO,CAAC,OAAO,CAAC;IA8EnB;;OAEG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC5B,IAAI;IAiCP;;OAEG;IACH,eAAe,IAAI,kBAAkB;IAIrC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAkBjB"}

package/dist/hot-reload.js

@@ -1,313 +0,0 @@
-// Polyfill for UUID generation to support both Node.js and Browser
-const generateUUID = () => {
-    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
-        return crypto.randomUUID();
-    }
-    // Basic UUID v4 fallback
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
-        const r = Math.random() * 16 | 0;
-        const v = c === 'x' ? r : (r & 0x3 | 0x8);
-        return v.toString(16);
-    });
-};
-/**
- * Plugin State Manager
- *
- * Handles state persistence and restoration during hot reloads
- */
-class PluginStateManager {
-    constructor(logger) {
-        this.stateSnapshots = new Map();
-        this.memoryStore = new Map();
-        this.logger = logger.child({ component: 'StateManager' });
-    }
-    /**
-     * Save plugin state before reload
-     */
-    async saveState(pluginId, version, state, config) {
-        const snapshot = {
-            pluginId,
-            version,
-            timestamp: new Date().toISOString(),
-            state,
-            metadata: {
-                checksum: this.calculateChecksum(state),
-                compressed: false,
-            },
-        };
-        const snapshotId = generateUUID();
-        switch (config.stateStrategy) {
-            case 'memory':
-                this.memoryStore.set(snapshotId, snapshot);
-                this.logger.debug('State saved to memory', { pluginId, snapshotId });
-                break;
-            case 'disk':
-                // For disk storage, we would write to file system
-                // For now, store in memory as fallback
-                this.memoryStore.set(snapshotId, snapshot);
-                this.logger.debug('State saved to disk (memory fallback)', { pluginId, snapshotId });
-                break;
-            case 'distributed':
-                // For distributed storage, would use Redis/etcd
-                // For now, store in memory as fallback
-                this.memoryStore.set(snapshotId, snapshot);
-                this.logger.debug('State saved to distributed store (memory fallback)', {
-                    pluginId,
-                    snapshotId
-                });
-                break;
-            case 'none':
-                this.logger.debug('State persistence disabled', { pluginId });
-                break;
-        }
-        this.stateSnapshots.set(pluginId, snapshot);
-        return snapshotId;
-    }
-    /**
-     * Restore plugin state after reload
-     */
-    async restoreState(pluginId, snapshotId) {
-        // Try to get from snapshot ID first, otherwise use latest for plugin
-        let snapshot;
-        if (snapshotId) {
-            snapshot = this.memoryStore.get(snapshotId);
-        }
-        else {
-            snapshot = this.stateSnapshots.get(pluginId);
-        }
-        if (!snapshot) {
-            this.logger.warn('No state snapshot found', { pluginId, snapshotId });
-            return undefined;
-        }
-        // Verify checksum if available
-        if (snapshot.metadata?.checksum) {
-            const currentChecksum = this.calculateChecksum(snapshot.state);
-            if (currentChecksum !== snapshot.metadata.checksum) {
-                this.logger.error('State checksum mismatch - data may be corrupted', {
-                    pluginId,
-                    expected: snapshot.metadata.checksum,
-                    actual: currentChecksum
-                });
-                return undefined;
-            }
-        }
-        this.logger.debug('State restored', { pluginId, version: snapshot.version });
-        return snapshot.state;
-    }
-    /**
-     * Clear state for a plugin
-     */
-    clearState(pluginId) {
-        this.stateSnapshots.delete(pluginId);
-        // Note: We don't clear memory store as it might have multiple snapshots
-        this.logger.debug('State cleared', { pluginId });
-    }
-    /**
-     * Calculate simple checksum for state verification
-     * WARNING: This is a simple hash for demo purposes.
-     * In production, use a cryptographic hash like SHA-256.
-     */
-    calculateChecksum(state) {
-        // Simple checksum using JSON serialization
-        // TODO: Replace with crypto.createHash('sha256') for production
-        const stateStr = JSON.stringify(state);
-        let hash = 0;
-        for (let i = 0; i < stateStr.length; i++) {
-            const char = stateStr.charCodeAt(i);
-            hash = ((hash << 5) - hash) + char;
-            hash = hash & hash; // Convert to 32-bit integer
-        }
-        return hash.toString(16);
-    }
-    /**
-     * Shutdown state manager
-     */
-    shutdown() {
-        this.stateSnapshots.clear();
-        this.memoryStore.clear();
-        this.logger.info('State manager shutdown complete');
-    }
-}
-/**
- * Hot Reload Manager
- *
- * Manages hot reloading of plugins with state preservation
- */
-export class HotReloadManager {
-    constructor(logger) {
-        this.reloadConfigs = new Map();
-        this.watchHandles = new Map();
-        this.reloadTimers = new Map();
-        this.logger = logger.child({ component: 'HotReload' });
-        this.stateManager = new PluginStateManager(logger);
-    }
-    /**
-     * Register a plugin for hot reload
-     */
-    registerPlugin(pluginName, config) {
-        if (!config.enabled) {
-            this.logger.debug('Hot reload disabled for plugin', { plugin: pluginName });
-            return;
-        }
-        this.reloadConfigs.set(pluginName, config);
-        this.logger.info('Plugin registered for hot reload', {
-            plugin: pluginName,
-            watchPatterns: config.watchPatterns,
-            stateStrategy: config.stateStrategy
-        });
-    }
-    /**
-     * Start watching for changes (requires file system integration)
-     */
-    startWatching(pluginName) {
-        const config = this.reloadConfigs.get(pluginName);
-        if (!config || !config.enabled) {
-            return;
-        }
-        // Note: Actual file watching would require chokidar or similar
-        // This is a placeholder for the integration point
-        this.logger.info('File watching started', {
-            plugin: pluginName,
-            patterns: config.watchPatterns
-        });
-    }
-    /**
-     * Stop watching for changes
-     */
-    stopWatching(pluginName) {
-        const handle = this.watchHandles.get(pluginName);
-        if (handle) {
-            // Stop watching (would call chokidar close())
-            this.watchHandles.delete(pluginName);
-            this.logger.info('File watching stopped', { plugin: pluginName });
-        }
-        // Clear any pending reload timers
-        const timer = this.reloadTimers.get(pluginName);
-        if (timer) {
-            clearTimeout(timer);
-            this.reloadTimers.delete(pluginName);
-        }
-    }
-    /**
-     * Trigger hot reload for a plugin
-     */
-    async reloadPlugin(pluginName, plugin, version, getPluginState, restorePluginState) {
-        const config = this.reloadConfigs.get(pluginName);
-        if (!config) {
-            this.logger.warn('Cannot reload - plugin not registered', { plugin: pluginName });
-            return false;
-        }
-        this.logger.info('Starting hot reload', { plugin: pluginName });
-        try {
-            // Call before reload hooks
-            if (config.beforeReload) {
-                this.logger.debug('Executing before reload hooks', {
-                    plugin: pluginName,
-                    hooks: config.beforeReload
-                });
-                // Hook execution would be done through kernel's hook system
-            }
-            // Save state if configured
-            let snapshotId;
-            if (config.preserveState && config.stateStrategy !== 'none') {
-                const state = getPluginState();
-                snapshotId = await this.stateManager.saveState(pluginName, version, state, config);
-                this.logger.debug('Plugin state saved', { plugin: pluginName, snapshotId });
-            }
-            // Gracefully shutdown the plugin
-            if (plugin.destroy) {
-                this.logger.debug('Destroying plugin', { plugin: pluginName });
-                const shutdownPromise = plugin.destroy();
-                const timeoutPromise = new Promise((_, reject) => {
-                    setTimeout(() => reject(new Error('Shutdown timeout')), config.shutdownTimeout);
-                });
-                await Promise.race([shutdownPromise, timeoutPromise]);
-                this.logger.debug('Plugin destroyed successfully', { plugin: pluginName });
-            }
-            // At this point, the kernel would reload the plugin module
-            // This would be handled by the plugin loader
-            this.logger.debug('Plugin module would be reloaded here', { plugin: pluginName });
-            // Restore state if we saved it
-            if (snapshotId && config.preserveState) {
-                const restoredState = await this.stateManager.restoreState(pluginName, snapshotId);
-                if (restoredState) {
-                    restorePluginState(restoredState);
-                    this.logger.debug('Plugin state restored', { plugin: pluginName });
-                }
-            }
-            // Call after reload hooks
-            if (config.afterReload) {
-                this.logger.debug('Executing after reload hooks', {
-                    plugin: pluginName,
-                    hooks: config.afterReload
-                });
-                // Hook execution would be done through kernel's hook system
-            }
-            this.logger.info('Hot reload completed successfully', { plugin: pluginName });
-            return true;
-        }
-        catch (error) {
-            this.logger.error('Hot reload failed', {
-                plugin: pluginName,
-                error
-            });
-            return false;
-        }
-    }
-    /**
-     * Schedule a reload with debouncing
-     */
-    scheduleReload(pluginName, reloadFn) {
-        const config = this.reloadConfigs.get(pluginName);
-        if (!config) {
-            return;
-        }
-        // Clear existing timer
-        const existingTimer = this.reloadTimers.get(pluginName);
-        if (existingTimer) {
-            clearTimeout(existingTimer);
-        }
-        // Schedule new reload with debounce
-        const timer = setTimeout(() => {
-            this.logger.debug('Debounce period elapsed, executing reload', {
-                plugin: pluginName
-            });
-            reloadFn().catch(error => {
-                this.logger.error('Scheduled reload failed', {
-                    plugin: pluginName,
-                    error
-                });
-            });
-            this.reloadTimers.delete(pluginName);
-        }, config.debounceDelay);
-        this.reloadTimers.set(pluginName, timer);
-        this.logger.debug('Reload scheduled with debounce', {
-            plugin: pluginName,
-            delay: config.debounceDelay
-        });
-    }
-    /**
-     * Get state manager for direct access
-     */
-    getStateManager() {
-        return this.stateManager;
-    }
-    /**
-     * Shutdown hot reload manager
-     */
-    shutdown() {
-        // Stop all watching
-        for (const pluginName of this.watchHandles.keys()) {
-            this.stopWatching(pluginName);
-        }
-        // Clear all timers
-        for (const timer of this.reloadTimers.values()) {
-            clearTimeout(timer);
-        }
-        this.reloadConfigs.clear();
-        this.watchHandles.clear();
-        this.reloadTimers.clear();
-        this.stateManager.shutdown();
-        this.logger.info('Hot reload manager shutdown complete');
-    }
-}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AAGzC,YAAY,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EAClB,MAAM,6BAA6B,CAAC"}

package/dist/kernel-base.d.ts

@@ -1,84 +0,0 @@
-import type { Plugin, PluginContext } from './types.js';
-import type { Logger } from '@objectstack/spec/contracts';
-import type { IServiceRegistry } from '@objectstack/spec/contracts';
-/**
- * Kernel state machine
- */
-export type KernelState = 'idle' | 'initializing' | 'running' | 'stopping' | 'stopped';
-/**
- * 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 declare abstract class ObjectKernelBase {
-    protected plugins: Map<string, Plugin>;
-    protected services: IServiceRegistry | Map<string, any>;
-    protected hooks: Map<string, Array<(...args: any[]) => void | Promise<void>>>;
-    protected state: KernelState;
-    protected logger: Logger;
-    protected context: PluginContext;
-    constructor(logger: Logger);
-    /**
-     * Validate kernel state
-     * @param requiredState - Required state for the operation
-     * @throws Error if current state doesn't match
-     */
-    protected validateState(requiredState: KernelState): void;
-    /**
-     * Validate kernel is in idle state (for plugin registration)
-     */
-    protected validateIdle(): void;
-    /**
-     * Create the plugin context
-     * Subclasses can override to customize context creation
-     */
-    protected createContext(): PluginContext;
-    /**
-     * Resolve plugin dependencies using topological sort
-     * @returns Ordered list of plugins (dependencies first)
-     */
-    protected resolveDependencies(): Plugin[];
-    /**
-     * Run plugin init phase
-     * @param plugin - Plugin to initialize
-     */
-    protected runPluginInit(plugin: Plugin): Promise<void>;
-    /**
-     * Run plugin start phase
-     * @param plugin - Plugin to start
-     */
-    protected runPluginStart(plugin: Plugin): Promise<void>;
-    /**
-     * Run plugin destroy phase
-     * @param plugin - Plugin to destroy
-     */
-    protected runPluginDestroy(plugin: Plugin): Promise<void>;
-    /**
-     * Trigger a hook with all registered handlers
-     * @param name - Hook name
-     * @param args - Arguments to pass to handlers
-     */
-    protected triggerHook(name: string, ...args: any[]): Promise<void>;
-    /**
-     * Get current kernel state
-     */
-    getState(): KernelState;
-    /**
-     * Get all registered plugins
-     */
-    getPlugins(): Map<string, Plugin>;
-    /**
-     * Abstract methods to be implemented by subclasses
-     */
-    abstract use(plugin: Plugin): this | Promise<this>;
-    abstract bootstrap(): Promise<void>;
-    abstract destroy(): Promise<void>;
-}
-//# sourceMappingURL=kernel-base.d.ts.map

package/dist/kernel-base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kernel-base.d.ts","sourceRoot":"","sources":["../src/kernel-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvF;;;;;;;;;;;GAWG;AACH,8BAAsB,gBAAgB;IAClC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACnD,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa;IACpE,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAa;IAC1F,SAAS,CAAC,KAAK,EAAE,WAAW,CAAU;IACtC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,OAAO,EAAG,aAAa,CAAC;gBAEtB,MAAM,EAAE,MAAM;IAI1B;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,aAAa,EAAE,WAAW,GAAG,IAAI;IAQzD;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAM9B;;;OAGG;IACH,SAAS,CAAC,aAAa,IAAI,aAAa;IAoDxC;;;OAGG;IACH,SAAS,CAAC,mBAAmB,IAAI,MAAM,EAAE;IA2CzC;;;OAGG;cACa,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D;;;OAGG;cACa,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7D;;;OAGG;cACa,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/D;;;;OAIG;cACa,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIjC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CACpC"}