@agelum/backend 0.1.0

package/dist/client/manager.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * Client-side reactive manager
+ * Coordinates storage, session recovery, and real-time synchronization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactiveClientManager = void 0;
+exports.createReactiveClientManager = createReactiveClientManager;
+const storage_1 = require("./storage");
+const session_1 = require("./session");
+const revalidation_1 = require("./revalidation");
+const sse_client_1 = require("./sse-client");
+class ReactiveClientManager {
+    storage;
+    sessionManager;
+    revalidationEngine;
+    sseClient = null;
+    config;
+    organizationId;
+    onInvalidation;
+    onRevalidate;
+    // Event listeners
+    visibilityListener;
+    beforeUnloadListener;
+    constructor(options) {
+        this.organizationId = options.organizationId;
+        this.config = options.config;
+        this.onInvalidation = options.onInvalidation;
+        this.onRevalidate = options.onRevalidate;
+        // Initialize storage, session management, and smart revalidation
+        this.storage = (0, storage_1.createReactiveStorage)(this.organizationId);
+        this.sessionManager = (0, session_1.createSimpleSessionManager)(this.organizationId);
+        this.revalidationEngine = (0, revalidation_1.createSmartRevalidationEngine)(this.storage, this.config);
+        // Set up event listeners
+        this.setupEventListeners();
+        // Initialize SSE connection if real-time is enabled
+        if (this.config.realtime?.enabled !== false) {
+            this.initializeSSEConnection(options.sseOptions);
+        }
+        // Initial session gap check (simple revalidation on page load)
+        this.checkInitialSession();
+    }
+    /**
+     * Get organization ID
+     */
+    get currentOrganizationId() {
+        return this.organizationId;
+    }
+    /**
+     * Register a query execution
+     */
+    registerQuery(queryKey, dependencies, data, ttl) {
+        this.storage.registerQuery(queryKey, dependencies, data, ttl);
+    }
+    /**
+     * Register an active React hook
+     */
+    registerActiveHook(queryKey, dependencies) {
+        this.storage.registerActiveHook(queryKey, dependencies, this.organizationId);
+        // Return cleanup function
+        return () => {
+            this.storage.unregisterActiveHook(queryKey);
+        };
+    }
+    /**
+     * Get cached data for a query
+     */
+    getCachedData(queryKey) {
+        return this.storage.getCachedData(queryKey);
+    }
+    /**
+     * Handle invalidation event from server
+     */
+    handleInvalidation(event) {
+        console.log(`[ReactiveClient] Handling invalidation for table: ${event.table}`);
+        // Notify external handler if provided
+        if (this.onInvalidation) {
+            this.onInvalidation(event);
+        }
+        // Mark affected queries as invalidated in session manager
+        const affectedQueries = this.findAffectedQueries(event.table);
+        affectedQueries.forEach((queryKey) => {
+            this.sessionManager.markQueryInvalidated(queryKey);
+        });
+        // Trigger revalidation for affected queries
+        if (this.onRevalidate) {
+            affectedQueries.forEach((queryKey) => {
+                this.revalidateQuery(queryKey);
+            });
+        }
+    }
+    /**
+     * Find queries affected by table changes
+     */
+    findAffectedQueries(table) {
+        const registry = this.storage.getRegistry();
+        if (!registry)
+            return [];
+        const relatedTables = this.config.relations[table] || [];
+        const tablesToCheck = [table, ...relatedTables];
+        return Object.keys(registry.queries).filter((queryKey) => {
+            // Simple heuristic: check if query key contains table name
+            return tablesToCheck.some((tableName) => queryKey.toLowerCase().includes(tableName.toLowerCase()));
+        });
+    }
+    /**
+     * Handle connection status changes
+     */
+    handleConnectionStatus(connected) {
+        console.log(`[ReactiveClient] Real-time connection: ${connected}`);
+        // Update session manager with connection status
+        const registry = this.storage.getRegistry();
+        if (registry) {
+            registry.session.realtimeConnected = connected;
+            this.storage['saveRegistry'](registry);
+        }
+    }
+    /**
+     * Revalidate a specific query
+     */
+    async revalidateQuery(queryKey) {
+        if (this.onRevalidate) {
+            try {
+                const result = await this.onRevalidate(queryKey);
+                // Update cache with fresh data
+                if (result !== undefined) {
+                    this.storage.registerQuery(queryKey, [], result);
+                }
+                return result;
+            }
+            catch (error) {
+                console.error(`[ReactiveClient] Revalidation failed for ${queryKey}:`, error);
+                // Do not overwrite cache on error; keep existing data intact
+                throw error;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Initialize SSE connection for real-time updates
+     */
+    initializeSSEConnection(sseOptions) {
+        console.log('[ReactiveClient] Initializing SSE connection');
+        // Build SSE URL with organization ID
+        const sseUrl = `/api/events?organizationId=${this.organizationId}`;
+        this.sseClient = new sse_client_1.SSEClient({
+            url: sseUrl,
+            onInvalidation: (event) => this.handleInvalidation(event),
+            onError: (error) => {
+                console.error('[ReactiveClient] SSE error:', error);
+            },
+            ...sseOptions,
+        });
+        // Connect immediately
+        this.sseClient.connect();
+    }
+    /**
+     * Get SSE connection statistics
+     */
+    getSSEStats() {
+        return this.sseClient?.getStats() || null;
+    }
+    /**
+     * Manually reconnect SSE
+     */
+    reconnectSSE() {
+        if (this.sseClient) {
+            console.log('[ReactiveClient] Manual SSE reconnection');
+            this.sseClient.disconnect();
+            setTimeout(() => {
+                this.sseClient?.connect();
+            }, 1000);
+        }
+    }
+    /**
+     * Set up browser event listeners
+     */
+    setupEventListeners() {
+        // Page visibility change (user switches tabs)
+        this.visibilityListener = () => {
+            if (document.visibilityState === 'visible') {
+                this.handleVisibilityChange();
+            }
+        };
+        document.addEventListener('visibilitychange', this.visibilityListener);
+        // Before page unload (save state)
+        this.beforeUnloadListener = () => {
+            // Update last sync time before unload
+            const registry = this.storage.getRegistry();
+            if (registry) {
+                registry.session.lastSync = Date.now();
+                this.storage['saveRegistry'](registry);
+            }
+        };
+        window.addEventListener('beforeunload', this.beforeUnloadListener);
+    }
+    /**
+     * Remove event listeners
+     */
+    removeEventListeners() {
+        if (this.visibilityListener) {
+            document.removeEventListener('visibilitychange', this.visibilityListener);
+        }
+        if (this.beforeUnloadListener) {
+            window.removeEventListener('beforeunload', this.beforeUnloadListener);
+        }
+    }
+    /**
+     * Check for session gap on initial load (simple approach as per spec)
+     */
+    async checkInitialSession() {
+        const activeHookQueries = this.storage
+            .getActiveHooks()
+            .map((hook) => hook.queryKey);
+        await (0, session_1.revalidateOnPageLoad)(this.sessionManager, activeHookQueries, this.revalidateQuery.bind(this));
+    }
+    /**
+     * Handle page visibility change
+     */
+    async handleVisibilityChange() {
+        if (document.visibilityState === 'visible') {
+            // Check for stale data when page becomes visible
+            await this.checkInitialSession();
+        }
+    }
+    /**
+     * Get current connection status
+     */
+    getConnectionStatus() {
+        if (!this.sseClient)
+            return 'disconnected';
+        const state = this.sseClient.getConnectionState();
+        return state === 'open'
+            ? 'connected'
+            : state === 'connecting'
+                ? 'connecting'
+                : 'disconnected';
+    }
+    /**
+     * Check if real-time is enabled and connected
+     */
+    isRealtimeEnabled() {
+        return (this.config.realtime?.enabled !== false &&
+            this.sseClient?.isConnected() === true);
+    }
+    /**
+     * Get storage statistics
+     */
+    getStorageStats() {
+        return this.storage.exportRegistry();
+    }
+    /**
+     * Get session statistics
+     */
+    getSessionStats() {
+        return this.sessionManager.getSessionStats();
+    }
+    /**
+     * Get revalidation statistics
+     */
+    getRevalidationStats() {
+        return this.revalidationEngine.getRevalidationStats();
+    }
+    /**
+     * Mark a query as stale for testing purposes
+     */
+    markQueryStaleForTesting(queryKey) {
+        this.storage.markQueryStaleForTesting(queryKey);
+    }
+    /**
+     * Cleanup resources
+     */
+    cleanup() {
+        // Remove event listeners
+        this.removeEventListeners();
+        // Disconnect SSE
+        if (this.sseClient) {
+            this.sseClient.disconnect();
+            this.sseClient = null;
+        }
+        // Clear storage
+        this.storage.clearRegistry();
+    }
+}
+exports.ReactiveClientManager = ReactiveClientManager;
+/**
+ * Create reactive client manager
+ */
+function createReactiveClientManager(options) {
+    return new ReactiveClientManager(options);
+}
+//# sourceMappingURL=manager.js.map

package/dist/client/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/client/manager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA8WH,kEAIC;AAhXD,uCAAkE;AAClE,uCAIkB;AAClB,iDAIuB;AACvB,6CAA+D;AAW/D,MAAa,qBAAqB;IACxB,OAAO,CAAiB;IACxB,cAAc,CAAsB;IACpC,kBAAkB,CAAyB;IAC3C,SAAS,GAAqB,IAAI,CAAA;IAClC,MAAM,CAAgB;IACtB,cAAc,CAAQ;IACtB,cAAc,CAAqC;IACnD,YAAY,CAAqC;IAEzD,kBAAkB;IACV,kBAAkB,CAAa;IAC/B,oBAAoB,CAAa;IAEzC,YAAY,OAA+B;QACzC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAA;QAC5C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAA;QAC5C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QAExC,iEAAiE;QACjE,IAAI,CAAC,OAAO,GAAG,IAAA,+BAAqB,EAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QACzD,IAAI,CAAC,cAAc,GAAG,IAAA,oCAA0B,EAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QACrE,IAAI,CAAC,kBAAkB,GAAG,IAAA,4CAA6B,EACrD,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,MAAM,CACZ,CAAA;QAED,yBAAyB;QACzB,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAE1B,oDAAoD;QACpD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAClD,CAAC;QAED,+DAA+D;QAC/D,IAAI,CAAC,mBAAmB,EAAE,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,qBAAqB;QACvB,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,aAAa,CACX,QAAgB,EAChB,YAAsB,EACtB,IAAU,EACV,GAAY;QAEZ,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;IAC/D,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,QAAgB,EAAE,YAAsB;QACzD,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QAE5E,0BAA0B;QAC1B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAA;QAC7C,CAAC,CAAA;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC7C,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAAwB;QACjD,OAAO,CAAC,GAAG,CACT,qDAAqD,KAAK,CAAC,KAAK,EAAE,CACnE,CAAA;QAED,sCAAsC;QACtC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QAC5B,CAAC;QAED,0DAA0D;QAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC7D,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YACnC,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;QAEF,4CAA4C;QAC5C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACnC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;YAChC,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,KAAa;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;QAC3C,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAA;QAExB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QACxD,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,GAAG,aAAa,CAAC,CAAA;QAE/C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;YACvD,2DAA2D;YAC3D,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CACtC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CACzD,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,SAAkB;QAC/C,OAAO,CAAC,GAAG,CAAC,0CAA0C,SAAS,EAAE,CAAC,CAAA;QAElE,gDAAgD;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAA;YAC9C,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;gBAEhD,+BAA+B;gBAC/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CAAA;gBAClD,CAAC;gBAED,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CACX,4CAA4C,QAAQ,GAAG,EACvD,KAAK,CACN,CAAA;gBACD,6DAA6D;gBAC7D,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;OAEG;IACK,uBAAuB,CAC7B,UAAsC;QAEtC,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAA;QAE3D,qCAAqC;QACrC,MAAM,MAAM,GAAG,8BAA8B,IAAI,CAAC,cAAc,EAAE,CAAA;QAElE,IAAI,CAAC,SAAS,GAAG,IAAI,sBAAS,CAAC;YAC7B,GAAG,EAAE,MAAM;YACX,cAAc,EAAE,CAAC,KAAwB,EAAE,EAAE,CAC3C,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;YAChC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;gBACxB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAA;YACrD,CAAC;YACD,GAAG,UAAU;SACd,CAAC,CAAA;QAEF,sBAAsB;QACtB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAA;YACvD,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAA;YAC3B,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAA;YAC3B,CAAC,EAAE,IAAI,CAAC,CAAA;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,8CAA8C;QAC9C,IAAI,CAAC,kBAAkB,GAAG,GAAG,EAAE;YAC7B,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC3C,IAAI,CAAC,sBAAsB,EAAE,CAAA;YAC/B,CAAC;QACH,CAAC,CAAA;QACD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAEtE,kCAAkC;QAClC,IAAI,CAAC,oBAAoB,GAAG,GAAG,EAAE;YAC/B,sCAAsC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;YAC3C,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACtC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAA;YACxC,CAAC;QACH,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAA;IACpE,CAAC;IAED;;OAEG;IACK,oBAAoB;QAC1B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC3E,CAAC;QACD,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB;QAC/B,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO;aACnC,cAAc,EAAE;aAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE/B,MAAM,IAAA,8BAAoB,EACxB,IAAI,CAAC,cAAc,EACnB,iBAAiB,EACjB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAChC,CAAA;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,sBAAsB;QAClC,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC3C,iDAAiD;YACjD,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,cAAc,CAAA;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAA;QACjD,OAAO,KAAK,KAAK,MAAM;YACrB,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,KAAK,KAAK,YAAY;gBACxB,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,cAAc,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,CACL,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,KAAK,KAAK;YACvC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,IAAI,CACvC,CAAA;IACH,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAA;IAC9C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,CAAA;IACvD,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,QAAgB;QACvC,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAA;IACjD,CAAC;IAED;;OAEG;IACH,OAAO;QACL,yBAAyB;QACzB,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAE3B,iBAAiB;QACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAA;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACvB,CAAC;QAED,gBAAgB;QAChB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAA;IAC9B,CAAC;CACF;AAjVD,sDAiVC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CACzC,OAA+B;IAE/B,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAA;AAC3C,CAAC"}

package/dist/client/provider.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ReactiveConfig } from '../core/types';
+interface ReactiveProviderConfig {
+    relations: Record<string, string[]>;
+    organizationId: string;
+    revalidateFn?: (queryKey: string) => Promise<any>;
+}
+interface ReactiveContextValue {
+    organizationId: string;
+    config: ReactiveConfig;
+    isInitialized: boolean;
+}
+/**
+ * React context provider for reactive features
+ */
+export declare function ReactiveProvider({ children, config, }: {
+    children: React.ReactNode;
+    config: ReactiveProviderConfig;
+}): React.FunctionComponentElement<React.ProviderProps<ReactiveContextValue | null>>;
+/**
+ * Hook to access reactive context
+ */
+export declare function useReactiveContext(): ReactiveContextValue;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/client/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/client/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,UAAU,sBAAsB;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;CAClD;AAED,UAAU,oBAAoB;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,cAAc,CAAA;IACtB,aAAa,EAAE,OAAO,CAAA;CACvB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,MAAM,EAAE,sBAAsB,CAAA;CAC/B,oFA2GA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,yBAMjC"}

package/dist/client/provider.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactiveProvider = ReactiveProvider;
+exports.useReactiveContext = useReactiveContext;
+const react_1 = __importStar(require("react"));
+const hooks_1 = require("./hooks");
+const ReactiveContext = (0, react_1.createContext)(null);
+/**
+ * React context provider for reactive features
+ */
+function ReactiveProvider({ children, config, }) {
+    const [isInitialized, setIsInitialized] = (0, react_1.useState)(false);
+    const { organizationId } = config;
+    const reactiveConfig = {
+        relations: config.relations,
+        realtime: {
+            enabled: true,
+            transport: 'sse',
+        },
+    };
+    // Default revalidation function that returns mock data
+    // The ReactiveStorage system handles persistence automatically
+    const defaultRevalidateFn = async (queryKey) => {
+        console.log('🔄 Default revalidating query:', queryKey);
+        // Return mock data based on query key
+        if (queryKey.includes('agents.getAll')) {
+            const mockData = [
+                {
+                    id: '1',
+                    name: 'Test Agent 1',
+                    role: 'assistant',
+                    organizationId: organizationId,
+                    isActive: true,
+                    createdAt: new Date().toISOString(),
+                },
+                {
+                    id: '2',
+                    name: 'Test Agent 2',
+                    role: 'researcher',
+                    organizationId: organizationId,
+                    isActive: true,
+                    createdAt: new Date().toISOString(),
+                },
+            ];
+            // Note: ReactiveStorage will automatically persist this data
+            // No need for manual localStorage handling
+            console.log('💾 Mock data generated, ReactiveStorage will persist automatically');
+            return mockData;
+        }
+        return [];
+    };
+    const revalidateFn = config.revalidateFn || defaultRevalidateFn;
+    (0, react_1.useEffect)(() => {
+        console.log('🚀 ReactiveProvider: Initializing reactive client for org:', organizationId);
+        try {
+            // Initialize the client immediately
+            (0, hooks_1.initializeReactiveClient)(organizationId, reactiveConfig, revalidateFn);
+            setIsInitialized(true);
+            console.log('✅ ReactiveProvider: Client initialized successfully for org:', organizationId);
+        }
+        catch (error) {
+            console.error('❌ ReactiveProvider: Failed to initialize client:', error);
+        }
+    }, [organizationId, revalidateFn]);
+    const contextValue = {
+        organizationId,
+        config: reactiveConfig,
+        isInitialized,
+    };
+    // Don't render children until client is initialized
+    if (!isInitialized) {
+        return react_1.default.createElement(ReactiveContext.Provider, { value: contextValue }, react_1.default.createElement('div', { className: 'flex items-center justify-center p-8' }, react_1.default.createElement('div', { className: 'text-center' }, react_1.default.createElement('div', {
+            className: 'animate-spin rounded-full h-8 w-8 border-b-2 border-blue-600 mx-auto mb-4',
+        }), react_1.default.createElement('p', { className: 'text-gray-600' }, 'Initializing reactive client...'))));
+    }
+    return react_1.default.createElement(ReactiveContext.Provider, { value: contextValue }, children);
+}
+/**
+ * Hook to access reactive context
+ */
+function useReactiveContext() {
+    const context = (0, react_1.useContext)(ReactiveContext);
+    if (!context) {
+        throw new Error('useReactiveContext must be used within a ReactiveProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=provider.js.map

package/dist/client/provider.js.map

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

package/dist/client/revalidation.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Smart revalidation system with active hooks priority
+ * Provides intelligent query revalidation based on user interaction patterns
+ */
+import type { ReactiveStorage } from './storage';
+import type { ReactiveConfig } from '../core/types';
+export interface RevalidationStrategy {
+    immediate: string[];
+    delayed: string[];
+    background: string[];
+    estimatedTime: number;
+}
+export interface RevalidationOptions {
+    maxConcurrent?: number;
+    delayBetweenBatches?: number;
+    priorityFirst?: boolean;
+    backgroundDelay?: number;
+}
+export interface RevalidationResult {
+    immediate: {
+        successful: number;
+        failed: number;
+        duration: number;
+    };
+    delayed: {
+        successful: number;
+        failed: number;
+        duration: number;
+    };
+    background: {
+        successful: number;
+        failed: number;
+        duration: number;
+    };
+    totalDuration: number;
+    overallSuccess: boolean;
+}
+export declare class SmartRevalidationEngine {
+    private storage;
+    private config;
+    private activeRevalidations;
+    private revalidationQueue;
+    constructor(storage: ReactiveStorage, config: ReactiveConfig);
+    /**
+     * Create an intelligent revalidation strategy
+     */
+    createRevalidationStrategy(invalidatedQueries: string[], options?: RevalidationOptions): RevalidationStrategy;
+    /**
+     * Execute the revalidation strategy
+     */
+    executeRevalidationStrategy(strategy: RevalidationStrategy, revalidateFn: (queryKey: string) => Promise<any>, options?: RevalidationOptions): Promise<RevalidationResult>;
+    /**
+     * Add queries to revalidation queue with priority
+     */
+    queueRevalidation(queryKey: string, priority?: number): void;
+    /**
+     * Process revalidation queue
+     */
+    processRevalidationQueue(revalidateFn: (queryKey: string) => Promise<any>, options?: RevalidationOptions): Promise<void>;
+    /**
+     * Smart invalidation with automatic revalidation
+     */
+    smartInvalidateAndRevalidate(table: string, revalidateFn: (queryKey: string) => Promise<any>, options?: RevalidationOptions): Promise<RevalidationResult>;
+    /**
+     * Execute a batch of queries with concurrency control
+     */
+    private executeQueryBatch;
+    /**
+     * Execute background revalidation with rate limiting
+     */
+    private executeBackgroundRevalidation;
+    /**
+     * Find queries affected by table changes
+     */
+    private findAffectedQueries;
+    /**
+     * Estimate total revalidation time
+     */
+    private estimateRevalidationTime;
+    /**
+     * Utility to wait for a specified time
+     */
+    private wait;
+    /**
+     * Get current revalidation statistics
+     */
+    getRevalidationStats(): {
+        activeRevalidations: number;
+        queuedQueries: number;
+        activeHooks: number;
+        recentActivity: {
+            queryKey: string;
+            timestamp: number;
+        }[];
+    };
+}
+/**
+ * Create a smart revalidation engine
+ */
+export declare function createSmartRevalidationEngine(storage: ReactiveStorage, config: ReactiveConfig): SmartRevalidationEngine;
+//# sourceMappingURL=revalidation.d.ts.map

package/dist/client/revalidation.d.ts.map

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