@agelum/backend 0.1.0

package/dist/client/sse-client.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Client-side SSE client for real-time cache invalidation
+ * NO HEARTBEATS - relies on event acknowledgments and connection health
+ */
+import type { InvalidationEvent } from '../core/types';
+export interface SSEClientOptions {
+    url: string;
+    onInvalidation: (event: InvalidationEvent) => void;
+    onError: (error: Error) => void;
+    onReconnect?: () => void;
+    maxReconnectAttempts?: number;
+    reconnectDelay?: number;
+}
+export interface SSEClientStats {
+    connectionAttempts: number;
+    successfulConnections: number;
+    failedConnections: number;
+    reconnectAttempts: number;
+    eventsReceived: number;
+    eventsAcknowledged: number;
+    lastEventTime: number;
+    connectionStartTime?: number;
+    totalUptime: number;
+}
+/**
+ * SSE Client for real-time cache invalidation
+ * Uses event acknowledgments instead of heartbeats for reliability
+ */
+export declare class SSEClient {
+    private eventSource;
+    private reconnectTimer;
+    private isIntentionallyClosed;
+    private stats;
+    private options;
+    constructor(options: SSEClientOptions);
+    /**
+     * Connect to SSE stream
+     */
+    connect(): void;
+    /**
+     * Disconnect from SSE stream
+     */
+    disconnect(): void;
+    /**
+     * Handle incoming SSE messages
+     */
+    private handleMessage;
+    /**
+     * Handle invalidation events
+     */
+    private handleInvalidationEvent;
+    /**
+     * Send event acknowledgment to server
+     */
+    private acknowledgeEvent;
+    /**
+     * Schedule reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Handle connection errors and schedule reconnection
+     */
+    private handleConnectionError;
+    /**
+     * Clear reconnection timer
+     */
+    private clearReconnectTimer;
+    /**
+     * Get connection statistics
+     */
+    getStats(): SSEClientStats;
+    /**
+     * Check if currently connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get connection state
+     */
+    getConnectionState(): 'connecting' | 'open' | 'closed';
+}
+//# sourceMappingURL=sse-client.d.ts.map

package/dist/client/sse-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/client/sse-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CAExB;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,qBAAqB,CAAQ;IACrC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,EAAE,gBAAgB;IAoBrC;;OAEG;IACH,OAAO,IAAI,IAAI;IAgCf;;OAEG;IACH,UAAU,IAAI,IAAI;IAkBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,QAAQ,IAAI,cAAc;IAI1B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,kBAAkB,IAAI,YAAY,GAAG,MAAM,GAAG,QAAQ;CAcvD"}

package/dist/client/sse-client.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Client-side SSE client for real-time cache invalidation
+ * NO HEARTBEATS - relies on event acknowledgments and connection health
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSEClient = void 0;
+/**
+ * SSE Client for real-time cache invalidation
+ * Uses event acknowledgments instead of heartbeats for reliability
+ */
+class SSEClient {
+    eventSource = null;
+    reconnectTimer = null;
+    isIntentionallyClosed = false;
+    stats;
+    options;
+    constructor(options) {
+        this.options = {
+            maxReconnectAttempts: 5,
+            reconnectDelay: 1000,
+            onReconnect: () => { },
+            ...options,
+        };
+        this.stats = {
+            connectionAttempts: 0,
+            successfulConnections: 0,
+            failedConnections: 0,
+            reconnectAttempts: 0,
+            eventsReceived: 0,
+            eventsAcknowledged: 0,
+            lastEventTime: 0,
+            totalUptime: 0,
+        };
+    }
+    /**
+     * Connect to SSE stream
+     */
+    connect() {
+        if (this.eventSource) {
+            this.disconnect();
+        }
+        this.stats.connectionAttempts++;
+        this.stats.connectionStartTime = Date.now();
+        try {
+            this.eventSource = new EventSource(this.options.url);
+            this.eventSource.onopen = () => {
+                this.stats.successfulConnections++;
+                console.log('[SSEClient] Connection opened');
+            };
+            this.eventSource.onmessage = (event) => {
+                this.handleMessage(event);
+            };
+            this.eventSource.onerror = (error) => {
+                this.stats.failedConnections++;
+                console.warn('[SSEClient] Connection error:', error);
+                this.handleConnectionError();
+            };
+        }
+        catch (error) {
+            this.stats.failedConnections++;
+            console.error('[SSEClient] Failed to create connection:', error);
+            this.handleConnectionError();
+        }
+    }
+    /**
+     * Disconnect from SSE stream
+     */
+    disconnect() {
+        this.isIntentionallyClosed = true;
+        this.clearReconnectTimer();
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = null;
+        }
+        // Update uptime stats
+        if (this.stats.connectionStartTime) {
+            this.stats.totalUptime += Date.now() - this.stats.connectionStartTime;
+            this.stats.connectionStartTime = undefined;
+        }
+        console.log('[SSEClient] Connection closed');
+    }
+    /**
+     * Handle incoming SSE messages
+     */
+    handleMessage(event) {
+        this.stats.lastEventTime = Date.now();
+        this.stats.eventsReceived++;
+        try {
+            const data = JSON.parse(event.data);
+            switch (data.type) {
+                case 'connected':
+                    console.log('[SSEClient] Connection confirmed');
+                    break;
+                // Removed heartbeat case - no heartbeats sent by server
+                case 'invalidation':
+                    console.log(`[SSEClient] Invalidation received for table: ${data.table}`);
+                    this.handleInvalidationEvent(data);
+                    break;
+                default:
+                    console.log('[SSEClient] Unknown event type:', data.type);
+            }
+        }
+        catch (error) {
+            console.warn('[SSEClient] Failed to parse event data:', error);
+            this.options.onError(error);
+        }
+    }
+    /**
+     * Handle invalidation events
+     */
+    handleInvalidationEvent(event) {
+        // Notify the invalidation handler
+        this.options.onInvalidation(event);
+        // Send acknowledgment if required
+        if (event.requiresAck && event.eventId) {
+            this.acknowledgeEvent(event.eventId);
+        }
+    }
+    /**
+     * Send event acknowledgment to server
+     */
+    async acknowledgeEvent(eventId) {
+        try {
+            const response = await fetch('/api/events/ack', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ eventId }),
+            });
+            if (response.ok) {
+                this.stats.eventsAcknowledged++;
+                console.log(`[SSEClient] Event acknowledged: ${eventId}`);
+            }
+            else {
+                console.warn(`[SSEClient] Failed to acknowledge event: ${eventId}`);
+            }
+        }
+        catch (error) {
+            console.warn(`[SSEClient] Acknowledgment failed: ${eventId}`, error);
+            // Silent fail - server will retry if needed
+        }
+    }
+    /**
+     * Schedule reconnection attempt
+     */
+    scheduleReconnect() {
+        if (this.isIntentionallyClosed)
+            return;
+        if (this.stats.reconnectAttempts >= this.options.maxReconnectAttempts) {
+            console.error(`[SSEClient] Max reconnect attempts (${this.options.maxReconnectAttempts}) reached`);
+            this.options.onError(new Error('Max reconnection attempts exceeded'));
+            return;
+        }
+        this.clearReconnectTimer();
+        const delay = Math.min(this.options.reconnectDelay * Math.pow(2, this.stats.reconnectAttempts), 30000 // Max 30 seconds
+        );
+        console.log(`[SSEClient] Scheduling reconnect in ${delay}ms (attempt ${this.stats.reconnectAttempts + 1})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.stats.reconnectAttempts++;
+            this.connect();
+        }, delay);
+    }
+    /**
+     * Handle connection errors and schedule reconnection
+     */
+    handleConnectionError() {
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = null;
+        }
+        // Update uptime stats
+        if (this.stats.connectionStartTime) {
+            this.stats.totalUptime += Date.now() - this.stats.connectionStartTime;
+            this.stats.connectionStartTime = undefined;
+        }
+        // Schedule reconnection
+        this.scheduleReconnect();
+    }
+    /**
+     * Clear reconnection timer
+     */
+    clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    /**
+     * Get connection statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Check if currently connected
+     */
+    isConnected() {
+        return this.eventSource?.readyState === EventSource.OPEN;
+    }
+    /**
+     * Get connection state
+     */
+    getConnectionState() {
+        if (!this.eventSource)
+            return 'closed';
+        switch (this.eventSource.readyState) {
+            case EventSource.CONNECTING:
+                return 'connecting';
+            case EventSource.OPEN:
+                return 'open';
+            case EventSource.CLOSED:
+                return 'closed';
+            default:
+                return 'closed';
+        }
+    }
+}
+exports.SSEClient = SSEClient;
+//# sourceMappingURL=sse-client.js.map

package/dist/client/sse-client.js.map

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

package/dist/client/storage.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Client-side storage management for reactive queries
+ * Handles localStorage-based query registry and session persistence
+ */
+import type { QueryRegistry, HookState } from '../core/types';
+export declare class ReactiveStorage {
+    private storageKey;
+    private indexKey;
+    private activeHooks;
+    private sessionId;
+    private organizationId;
+    constructor(organizationId: string);
+    /** Derive the per-org index key */
+    private getIndexKey;
+    /** Derive per-query entry key */
+    private getEntryKey;
+    /** Simple 32-bit hash for stable short keys */
+    private hash;
+    /**
+     * Initialize the query registry for this organization
+     */
+    private initializeRegistry;
+    /**
+     * Get the current query registry
+     */
+    getRegistry(): QueryRegistry | null;
+    /**
+     * Save the query registry to localStorage
+     */
+    private saveRegistry;
+    /**
+     * Register a query execution
+     */
+    registerQuery(queryKey: string, dependencies: string[], data?: any, ttl?: number): void;
+    /**
+     * Mark a query as stale (needs revalidation)
+     */
+    invalidateQuery(queryKey: string): void;
+    /**
+     * Mark a query as stale for testing (simulates server-side changes)
+     */
+    markQueryStaleForTesting(queryKey: string): void;
+    /**
+     * Invalidate queries based on table changes
+     */
+    invalidateByTable(table: string, relations: Record<string, string[]>): void;
+    /**
+     * Get cached data for a query
+     */
+    getCachedData(queryKey: string): {
+        data: any;
+        isStale: boolean;
+        lastRevalidated: number;
+    } | null;
+    /**
+     * Detect session gaps and queries that need revalidation
+     */
+    detectSessionGap(): {
+        hasGap: boolean;
+        gapDuration: number;
+        staleQueries: string[];
+    };
+    /**
+     * Register an active hook for priority revalidation
+     */
+    registerActiveHook(queryKey: string, dependencies: string[], organizationId?: string): void;
+    /**
+     * Unregister an active hook
+     */
+    unregisterActiveHook(queryKey: string): void;
+    /**
+     * Get active hooks for priority revalidation
+     */
+    getActiveHooks(): HookState[];
+    /**
+     * Get active hooks sorted by priority (most recent access first)
+     */
+    getActiveHooksByPriority(): HookState[];
+    /**
+     * Update real-time connection status
+     */
+    updateRealtimeStatus(connected: boolean): void;
+    /**
+     * Get queries that should be revalidated first (active hooks)
+     */
+    getPriorityQueries(): string[];
+    /**
+     * Get background queries that can be revalidated later
+     */
+    getBackgroundQueries(): string[];
+    /**
+     * Clean up expired entries to free up localStorage space
+     */
+    private cleanupExpiredEntries;
+    /**
+     * Clean up old entries when localStorage is full
+     */
+    private cleanupOldEntries;
+    /**
+     * Generate a unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Get session information
+     */
+    getSessionInfo(): {
+        startTime: number;
+        lastSync: number;
+        realtimeConnected: boolean;
+    } | null;
+    /**
+     * Clear all stored data for this organization
+     */
+    clearRegistry(): void;
+    /**
+     * Export registry for debugging
+     */
+    exportRegistry(): QueryRegistry | null;
+}
+/**
+ * Create a storage instance for an organization
+ */
+export declare function createReactiveStorage(organizationId: string): ReactiveStorage;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/client/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE7D,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAAQ;gBAElB,cAAc,EAAE,MAAM;IAQlC,mCAAmC;IACnC,OAAO,CAAC,WAAW;IAInB,iCAAiC;IACjC,OAAO,CAAC,WAAW;IAInB,+CAA+C;IAC/C,OAAO,CAAC,IAAI;IASZ;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,WAAW,IAAI,aAAa,GAAG,IAAI;IAmBnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,CAAC,EAAE,GAAG,EACV,GAAG,CAAC,EAAE,MAAM,GACX,IAAI;IA+DP;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiBvC;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiBhD;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IA6B3E;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAC/B,IAAI,EAAE,GAAG,CAAA;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,eAAe,EAAE,MAAM,CAAA;KACxB,GAAG,IAAI;IAgDR;;OAEG;IACH,gBAAgB,IAAI;QAClB,MAAM,EAAE,OAAO,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,EAAE,CAAA;KACvB;IAgCD;;OAEG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI;IAUP;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,cAAc,IAAI,SAAS,EAAE;IAI7B;;OAEG;IACH,wBAAwB,IAAI,SAAS,EAAE;IAIvC;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAS9C;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAK9B;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAUhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,cAAc;;;;;IAKd;;OAEG;IACH,aAAa,IAAI,IAAI;IAwBrB;;OAEG;IACH,cAAc,IAAI,aAAa,GAAG,IAAI;CAGvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,CAE7E"}