@agelum/backend 0.1.1 → 0.1.2

package/dist/client/hooks.d.ts

@@ -0,0 +1,65 @@
+/**
+ * React hooks for @agelum/backend
+ * Provides reactive data access with automatic caching and real-time updates
+ */
+import type { ReactiveConfig, InvalidationEvent } from "../core/types";
+/**
+ * Initialize the reactive client
+ * Call this once at app startup
+ */
+export declare function initializeReactiveClient(organizationId: string, config: ReactiveConfig, revalidateFn: (queryKey: string) => Promise<any>): void;
+/**
+ * Main hook for reactive data access
+ * Automatically handles caching, real-time updates, and revalidation
+ */
+export declare function useReactive<T = any>(queryKey: string, input?: any, options?: {
+    enabled?: boolean;
+}): {
+    data: T | undefined;
+    isLoading: boolean;
+    isStale: boolean;
+    error: Error | null;
+    refetch: () => void;
+};
+/**
+ * Optional page-level priority hints for better UX
+ */
+export declare function useReactivePriorities(priorities: string[]): void;
+/**
+ * Hook to get current session statistics
+ */
+export declare function useReactiveStats(): any;
+/**
+ * Hook to manually trigger cache refresh
+ */
+export declare function useReactiveRefresh(): () => Promise<void>;
+/**
+ * Hook to get revalidation statistics and performance metrics
+ */
+export declare function useRevalidationStats(): any;
+/**
+ * Hook to handle invalidation events
+ */
+export declare function useReactiveInvalidation(callback: (event: InvalidationEvent) => void): void;
+/**
+ * Hook for manual queries with dynamic parameters
+ * Unlike useReactive, this hook doesn't auto-fetch and allows changing parameters on each call
+ */
+export declare function useReactiveQuery<TData = unknown, TVariables = unknown>(queryKey: string): {
+    data: TData | undefined;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: (variables?: TVariables) => Promise<TData>;
+    run: (variables: TVariables) => Promise<TData>;
+};
+/**
+ * Hook to get connection status
+ */
+export declare function useReactiveConnection(): {
+    status: "connected" | "connecting" | "disconnected";
+    isConnected: boolean;
+    isConnecting: boolean;
+    isDisconnected: boolean;
+    reconnect: () => void;
+};
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAkBvB;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,CACZ,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,GAAG,CAAC,GAChB,IAAI,CA0CN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,GAAG,EACX,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA;IACD,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAsNA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAAE,GACnB,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,QA2B/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,wBA0BjC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,QAwBnC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CACR,KAAK,EAAE,iBAAiB,KACrB,IAAI,GACR,IAAI,CAgBN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,GAAG,OAAO,EACf,UAAU,GAAG,OAAO,EAEpB,QAAQ,EAAE,MAAM,GACf;IACD,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,CACP,SAAS,CAAC,EAAE,UAAU,KACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,GAAG,EAAE,CACH,SAAS,EAAE,UAAU,KAClB,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB,CAyFA;AAED;;GAEG;AACH,wBAAgB,qBAAqB;;;;;;EAoCpC"}

package/dist/client/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Client-side reactive database features
+ */
+export { ReactiveStorage, createReactiveStorage } from './storage';
+export { SimpleSessionManager, createSimpleSessionManager, revalidateOnPageLoad, type SessionInfo, type QueryRegistry, type QueryRegistryEntry, } from './session';
+export { ReactiveClientManager, createReactiveClientManager, type ReactiveManagerOptions, } from './manager';
+export { useReactive, useReactiveQuery, useReactivePriorities, useReactiveStats, useReactiveRefresh, useReactiveInvalidation, useRevalidationStats, useReactiveConnection, initializeReactiveClient, } from './hooks';
+export { SmartRevalidationEngine, createSmartRevalidationEngine, type RevalidationStrategy, type RevalidationOptions, type RevalidationResult, } from './revalidation';
+export { ReactiveProvider } from './provider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAClE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/client/manager.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Client-side reactive manager
+ * Coordinates storage, session recovery, and real-time synchronization
+ */
+import { type SSEClientOptions } from './sse-client';
+import type { ReactiveConfig, InvalidationEvent } from '../core/types';
+export interface ReactiveManagerOptions {
+    organizationId: string;
+    config: ReactiveConfig;
+    onInvalidation?: (event: InvalidationEvent) => void;
+    onRevalidate?: (queryKey: string) => Promise<any>;
+    sseOptions?: Partial<SSEClientOptions>;
+}
+export declare class ReactiveClientManager {
+    private storage;
+    private sessionManager;
+    private revalidationEngine;
+    private sseClient;
+    private config;
+    private organizationId;
+    private onInvalidation?;
+    private onRevalidate?;
+    private visibilityListener?;
+    private beforeUnloadListener?;
+    constructor(options: ReactiveManagerOptions);
+    /**
+     * Get organization ID
+     */
+    get currentOrganizationId(): string;
+    /**
+     * Register a query execution
+     */
+    registerQuery(queryKey: string, dependencies: string[], data?: any, ttl?: number): void;
+    /**
+     * Register an active React hook
+     */
+    registerActiveHook(queryKey: string, dependencies: string[]): () => void;
+    /**
+     * Get cached data for a query
+     */
+    getCachedData(queryKey: string): {
+        data: any;
+        isStale: boolean;
+        lastRevalidated: number;
+    } | null;
+    /**
+     * Handle invalidation event from server
+     */
+    private handleInvalidation;
+    /**
+     * Find queries affected by table changes
+     */
+    private findAffectedQueries;
+    /**
+     * Handle connection status changes
+     */
+    private handleConnectionStatus;
+    /**
+     * Revalidate a specific query
+     */
+    revalidateQuery(queryKey: string): Promise<any>;
+    /**
+     * Initialize SSE connection for real-time updates
+     */
+    private initializeSSEConnection;
+    /**
+     * Get SSE connection statistics
+     */
+    getSSEStats(): import("./sse-client").SSEClientStats | null;
+    /**
+     * Manually reconnect SSE
+     */
+    reconnectSSE(): void;
+    /**
+     * Set up browser event listeners
+     */
+    private setupEventListeners;
+    /**
+     * Remove event listeners
+     */
+    private removeEventListeners;
+    /**
+     * Check for session gap on initial load (simple approach as per spec)
+     */
+    private checkInitialSession;
+    /**
+     * Handle page visibility change
+     */
+    private handleVisibilityChange;
+    /**
+     * Get current connection status
+     */
+    getConnectionStatus(): 'connected' | 'connecting' | 'disconnected';
+    /**
+     * Check if real-time is enabled and connected
+     */
+    isRealtimeEnabled(): boolean;
+    /**
+     * Get storage statistics
+     */
+    getStorageStats(): import("../core/types").QueryRegistry | null;
+    /**
+     * Get session statistics
+     */
+    getSessionStats(): {
+        sessionAge: number;
+        timeSinceLastSync: number;
+        realtimeConnected: boolean;
+        totalQueries: number;
+        staleQueries: number;
+    };
+    /**
+     * Get revalidation statistics
+     */
+    getRevalidationStats(): {
+        activeRevalidations: number;
+        queuedQueries: number;
+        activeHooks: number;
+        recentActivity: {
+            queryKey: string;
+            timestamp: number;
+        }[];
+    };
+    /**
+     * Mark a query as stale for testing purposes
+     */
+    markQueryStaleForTesting(queryKey: string): void;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): void;
+}
+/**
+ * Create reactive client manager
+ */
+export declare function createReactiveClientManager(options: ReactiveManagerOptions): ReactiveClientManager;
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/client/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtE,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,MAAM,EAAE,cAAc,CAAA;IACtB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACnD,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACvC;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAoC;IAC3D,OAAO,CAAC,YAAY,CAAC,CAAoC;IAGzD,OAAO,CAAC,kBAAkB,CAAC,CAAY;IACvC,OAAO,CAAC,oBAAoB,CAAC,CAAY;gBAE7B,OAAO,EAAE,sBAAsB;IA0B3C;;OAEG;IACH,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,CAAC,EAAE,GAAG,EACV,GAAG,CAAC,EAAE,MAAM,GACX,IAAI;IAIP;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI;IASxE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM;;;;;IAI9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAwBrD;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,WAAW;IAIX;;OAEG;IACH,YAAY,IAAI,IAAI;IAUpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;YACW,mBAAmB;IAYjC;;OAEG;YACW,sBAAsB;IAOpC;;OAEG;IACH,mBAAmB,IAAI,WAAW,GAAG,YAAY,GAAG,cAAc;IAUlE;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAO5B;;OAEG;IACH,eAAe;IAIf;;OAEG;IACH,eAAe;;;;;;;IAIf;;OAEG;IACH,oBAAoB;;;;;;;;;IAIpB;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIhD;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAEvB"}

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/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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"}

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/storage.d.ts

@@ -0,0 +1,126 @@
+/**
+ * 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 legacyStorageKey;
+    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;
+    private getLegacyEntryKey;
+    /** 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,EACV,aAAa,EACb,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CACW;IAC7B,OAAO,CAAC,gBAAgB,CACO;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAGf;IACJ,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,EAAE,MAAM;IAYlC,mCAAmC;IACnC,OAAO,CAAC,WAAW;IAInB,iCAAiC;IACjC,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,iBAAiB;IAOzB,+CAA+C;IAC/C,OAAO,CAAC,IAAI;IAaZ;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,WAAW,IAAI,aAAa,GAAG,IAAI;IA8BnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,CAAC,EAAE,GAAG,EACV,GAAG,CAAC,EAAE,MAAM,GACX,IAAI;IA4FP;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,GACf,IAAI;IAmBP;;OAEG;IACH,wBAAwB,CACtB,QAAQ,EAAE,MAAM,GACf,IAAI;IAoBP;;OAEG;IACH,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAClC,IAAI;IA0CP;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;QAC/B,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAqER;;OAEG;IACH,gBAAgB,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB;IAgDD;;OAEG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI;IAUP;;OAEG;IACH,oBAAoB,CAClB,QAAQ,EAAE,MAAM,GACf,IAAI;IAIP;;OAEG;IACH,cAAc,IAAI,SAAS,EAAE;IAM7B;;OAEG;IACH,wBAAwB,IAAI,SAAS,EAAE;IAOvC;;OAEG;IACH,oBAAoB,CAClB,SAAS,EAAE,OAAO,GACjB,IAAI;IAWP;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAQ9B;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAehC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,cAAc;;;;;IAKd;;OAEG;IACH,aAAa,IAAI,IAAI;IAgDrB;;OAEG;IACH,cAAc,IAAI,aAAa,GAAG,IAAI;CAGvC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,GACrB,eAAe,CAIjB"}

package/dist/client/trpc.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+type RelationsMap = Record<string, string[]>;
+export declare function createTrpcRevalidateFn(trpcClient: any): (compositeKey: string) => Promise<any>;
+interface TrpcReactiveProviderProps {
+    children: React.ReactNode;
+    organizationId: string;
+    relations: RelationsMap;
+    trpcClient: any;
+}
+export declare function TrpcReactiveProvider({ children, organizationId, relations, trpcClient, }: TrpcReactiveProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=trpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trpc.d.ts","sourceRoot":"","sources":["../../src/client/trpc.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAE5C,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,GAAG,IACtC,cAAc,MAAM,kBAanC;AAED,UAAU,yBAAyB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,GAAG,CAAA;CAChB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,cAAc,EACd,SAAS,EACT,UAAU,GACX,EAAE,yBAAyB,2CAa3B"}

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Client-only exports for @agelum/backend
+ * Import this with: import { ... } from '@agelum/backend/client'
+ */
+export { ReactiveProvider, useReactiveContext, } from "./client/provider";
+export { useReactive, useReactiveQuery, initializeReactiveClient, } from "./client/hooks";
+export { ReactiveClientManager } from "./client/manager";
+export { TrpcReactiveProvider, createTrpcRevalidateFn, } from "./client/trpc";
+export { LocalStorageProvider } from "./providers/localStorage";
+export type { UseReactiveResult } from "./client/types";
+export declare const version = "0.1.0";
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,eAAO,MAAM,OAAO,UAAU,CAAC"}