juxscript 1.0.102 → 1.0.103

package/lib/componentsv2/plugins/LocalStoragePlugin.ts

@@ -1,86 +0,0 @@
-import { JuxServiceContract, BaseEngine } from '../base/BaseEngine.js';
-
-export interface LocalStorageConfig {
-    /** Unique key for storage (e.g. 'my-app-list-v1') */
-    key: string;
-
-    /** 
-     * State Binding: The property key on the Engine's state to persist.
-     * e.g., 'items' for a ListEngine.
-     */
-    bindTo: string;
-
-    /** If true, clears storage on install (fresh start) */
-    clearOnInstall?: boolean;
-
-    /** If true, automatically saves to storage when state changes */
-    autoSave?: boolean;
-}
-
-/**
- * LocalStorage Plugin
- * Persists a slice of Engine State to Browser LocalStorage.
- */
-export const LocalStoragePlugin = (config: LocalStorageConfig): JuxServiceContract<BaseEngine<any>> => ({
-    name: 'local-storage-persist',
-    version: '1.0.0',
-    targetEnv: 'client',
-
-    install: (engine) => {
-
-        // @ts-ignore
-        const initialState = engine.state[config.bindTo];
-        if (initialState !== undefined && !Array.isArray(initialState)) {
-            console.error(`[LocalStoragePlugin] 🛑 Configuration Error: bindTo='${config.bindTo}' is not an Array. This plugin is designed for List/Collection data.`);
-            return;
-        }
-
-        const storageKey = `jux:${config.key}`;
-
-        // 1. Hydrate (Load from Storage)
-        const load = () => {
-            try {
-                const raw = localStorage.getItem(storageKey);
-                if (raw) {
-                    const data = JSON.parse(raw);
-                    // @ts-ignore - Generic update
-                    engine.updateState({ [config.bindTo]: data });
-                    // @ts-ignore
-                    if (engine.emit) engine.emit('plugin:hydrated', { source: 'localStorage', count: Array.isArray(data) ? data.length : 1 });
-                }
-            } catch (e) {
-                console.error('[LocalStoragePlugin] Load Failed', e);
-            }
-        };
-
-        // 2. Persist (Save to Storage)
-        const save = (state: any) => {
-            try {
-                const value = state[config.bindTo];
-                localStorage.setItem(storageKey, JSON.stringify(value));
-            } catch (e) {
-                console.error('[LocalStoragePlugin] Save Failed', e);
-            }
-        };
-
-        // Logic
-        if (config.clearOnInstall) {
-            localStorage.removeItem(storageKey);
-        } else {
-            load();
-        }
-
-        if (config.autoSave !== false) {
-            engine.subscribe((state) => save(state));
-        }
-
-        // Expose manual triggers
-        engine.on('storage:save', () => save(engine.state));
-        engine.on('storage:load', load);
-        engine.on('storage:clear', () => {
-            localStorage.removeItem(storageKey);
-            // @ts-ignore
-            if (engine.emit) engine.emit('plugin:cleared', { source: 'localStorage' });
-        });
-    }
-});

package/lib/componentsv2/plugins/ServerSQLitePlugin.ts

@@ -1,99 +0,0 @@
-import { JuxServiceContract, BaseEngine } from '../base/BaseEngine.js';
-
-export interface ServerSQLiteConfig {
-    /** The Database Driver Instance (e.g. better-sqlite3) */
-    database: any;
-
-    /** Optional: SQL Query to fetch data automatically */
-    query?: string;
-
-    /** 
-     * State Binding: The property key on the Engine's state to populate.
-     * e.g., 'items' for a ListEngine, or 'rows' for a GridEngine.
-     */
-    bindTo?: string;
-
-    /**
-     * Transformation Strategy:
-     * Converts a raw DB row into the shape expected by the Engine's state.
-     */
-    mapRow?: (row: any) => any;
-
-    /** If true, runs the query immediately on install */
-    autoLoad?: boolean;
-}
-
-/**
- * Server-Side SQLite Plugin
- * Decoupled Service that injects SQL capabilities and binds data to ANY Engine state.
- */
-export const ServerSQLitePlugin = (config: ServerSQLiteConfig): JuxServiceContract<BaseEngine<any>> => ({
-    name: 'server-sqlite-driver',
-    version: '2.0.0',
-    targetEnv: 'server',
-
-    install: (engine) => {
-        // 1. Expose SQL Capability (Mixin)
-        // Adds a .query() method to the engine instance
-        Object.assign(engine, {
-            query: (sql: string, params: any[] = []) => {
-                if (!config.database || typeof config.database.prepare !== 'function') {
-                    throw new Error('Invalid Database Driver provided to ServerSQLitePlugin.');
-                }
-                const stmt = config.database.prepare(sql);
-                const rows = stmt.all(params);
-
-                // Emit audit event for queries
-                // @ts-ignore - access protected emit
-                if (typeof engine.emit === 'function') engine.emit('sql:query', { sql, rows: rows.length });
-
-                return rows;
-            }
-        });
-
-        // 2. Hydration Logic
-        const hydrate = () => {
-            if (!config.query) return;
-
-            try {
-                // Use the newly injected capability
-                // @ts-ignore
-                const rows = engine.query(config.query);
-
-                if (config.bindTo) {
-                    const data = config.mapRow ? rows.map(config.mapRow) : rows;
-
-                    // Generic State Update (Decoupled from ListEngine)
-                    // @ts-ignore - access protected updateState
-                    if (typeof engine.updateState === 'function') {
-                        // @ts-ignore
-                        engine.updateState({ [config.bindTo]: data });
-                    }
-
-                    // Optional: Update loading state if the engine supports it
-                    // @ts-ignore
-                    if (typeof engine.loading === 'function') engine.loading(false);
-
-                    // Emit data event for loose coupling
-                    // @ts-ignore
-                    if (typeof engine.emit === 'function') engine.emit('plugin:data', { source: 'sqlite', count: data.length });
-                }
-
-            } catch (err: any) {
-                console.error('[ServerSQLitePlugin] Hydration Error:', err.message);
-                // @ts-ignore
-                if (typeof engine.loading === 'function') engine.loading(false);
-            }
-        };
-
-        // 3. Auto-Start
-        if (config.autoLoad) {
-            // @ts-ignore
-            if (typeof engine.loading === 'function') engine.loading(true);
-            hydrate();
-        }
-
-        // 4. Listen for Reload Signal
-        engine.on('db:reload', hydrate);
-    }
-});