@agelum/backend 0.1.1 → 0.1.3

package/README.md

@@ -27,7 +27,7 @@ pnpm add @agelum/backend drizzle-orm @trpc/server @trpc/client zod
 
 ### 1. Define Reactive Functions
 
-**Key Concept**: Reactive functions work both standalone (server-side) AND via tRPC. The `name` property is crucial for cache keys and tRPC procedures. Use `db.db` to access the underlying Drizzle instance inside handlers.
+**Key Concept**: Reactive functions work both standalone (server-side) AND via tRPC. The `name` property is crucial for cache keys and tRPC procedures. Handlers receive `{ input, db }` and you can use `db.db` to access the underlying Drizzle instance inside handlers.
 
 ```typescript
 // server/functions/users.ts
@@ -49,8 +49,8 @@ export const getUsers =
 
     dependencies: ["user"], // What tables this function reads from
 
-    handler: async (input, db) => {
-      // Clean signature: (input, db)
+    handler: async ({ input, db }) => {
+      // Clean signature: ({ input, db })
       return db.db.query.users.findMany(
         {
           where: (users, { eq }) =>
@@ -76,7 +76,7 @@ export const createUser =
 
     dependencies: ["user"],
 
-    handler: async (input, db) => {
+    handler: async ({ input, db }) => {
       return db.db
         .insert(users)
         .values(input)
@@ -98,7 +98,7 @@ export const getUserProfile =
       "preferences",
     ],
 
-    handler: async (input, db) => {
+    handler: async ({ input, db }) => {
       const user =
         await db.db.query.users.findFirst(
           {
@@ -118,6 +118,34 @@ export const getUserProfile =
   });
 ```
 
+#### Typing Notes
+
+If you want explicit handler typing, use `ReactiveFunctionContext<TInput>` with a Zod-inferred input type:
+
+```typescript
+import type { ReactiveFunctionContext } from "@agelum/backend/server";
+import { z } from "zod";
+
+const getUsersInput = z.object({
+  companyId: z.string(),
+  limit: z.number().optional(),
+});
+
+type GetUsersInput = z.infer<typeof getUsersInput>;
+
+export const getUsers = defineReactiveFunction({
+  name: "users.getAll",
+  input: getUsersInput,
+  dependencies: ["user"],
+  handler: async ({ input, db }: ReactiveFunctionContext<GetUsersInput>) => {
+    return db.db.query.users.findMany({
+      where: (users, { eq }) => eq(users.companyId, input.companyId),
+      limit: input.limit ?? 50,
+    });
+  },
+});
+```
+
 ### 2. Server-Side Execution (Without tRPC)
 
 **Use Case**: Background jobs, API routes, server actions, webhooks, etc.

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.js";
+/**
+ * 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,kBAAkB,CAAC;AAkB1B;;;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/hooks.js

@@ -0,0 +1,343 @@
+/**
+ * React hooks for @agelum/backend
+ * Provides reactive data access with automatic caching and real-time updates
+ */
+import { useEffect, useState, useCallback, useRef, } from "react";
+import { createReactiveClientManager, } from "./manager.js";
+// Global client manager instance
+let globalClientManager = null;
+/**
+ * Get or create the global client manager
+ */
+function getClientManager() {
+    if (!globalClientManager) {
+        throw new Error("Reactive client not initialized. Call initializeReactiveClient first.");
+    }
+    return globalClientManager;
+}
+/**
+ * Initialize the reactive client
+ * Call this once at app startup
+ */
+export function initializeReactiveClient(organizationId, config, revalidateFn) {
+    console.log("🚀 Initializing reactive client for org:", organizationId);
+    if (globalClientManager) {
+        console.log("⚠️ Client already initialized, cleaning up previous instance");
+        globalClientManager.cleanup();
+    }
+    globalClientManager =
+        createReactiveClientManager({
+            organizationId,
+            config,
+            onRevalidate: revalidateFn,
+            onInvalidation: (event) => {
+                console.log(`[ReactiveClient] Received invalidation for table: ${event.table}`);
+            },
+        });
+    // Expose client manager to window for testing purposes
+    if (typeof window !== "undefined") {
+        window.__reactiveClientManager =
+            globalClientManager;
+        console.log("🔧 [ReactiveClient] Client manager exposed to window for testing");
+    }
+    console.log("✅ Reactive client initialized successfully for org:", organizationId);
+}
+/**
+ * Main hook for reactive data access
+ * Automatically handles caching, real-time updates, and revalidation
+ */
+export function useReactive(queryKey, input, options) {
+    const [data, setData] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(true);
+    const [isStale, setIsStale] = useState(false);
+    const [error, setError] = useState(null);
+    const clientManager = getClientManager();
+    const isInitialMount = useRef(true);
+    // Handle enabled option
+    const enabled = options?.enabled !== false;
+    // Compose an effective cache key that includes serialized input
+    const inputKey = typeof input === "undefined"
+        ? ""
+        : `::${JSON.stringify(input)}`;
+    const effectiveKey = `${queryKey}${inputKey}`;
+    // Register this hook as active
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        const cleanup = clientManager.registerActiveHook(effectiveKey, []);
+        return cleanup;
+    }, [
+        effectiveKey,
+        clientManager,
+        enabled,
+    ]);
+    // Load data on mount and when queryKey changes
+    useEffect(() => {
+        if (!enabled) {
+            setIsLoading(false);
+            return;
+        }
+        const loadData = async () => {
+            try {
+                setIsLoading(true);
+                setError(null);
+                // Check ReactiveStorage cache first (immediate display)
+                const cached = clientManager.getCachedData(effectiveKey);
+                // Reduced logging - only log cache misses
+                if (!cached) {
+                    console.log(`🔍 [useReactive] Cache miss for ${queryKey}`);
+                }
+                if (cached) {
+                    try {
+                        const now = Date.now();
+                        const cacheAge = now -
+                            cached.lastRevalidated;
+                        const minRevalidationTime = 5 * 60 * 1000; // 5 minutes minimum between revalidations
+                        // Reduced logging - only log when cache is stale
+                        if (cached.isStale) {
+                            console.log(`📊 [useReactive] Cache is stale for ${queryKey}`);
+                        }
+                        // Show cached data immediately
+                        setData(cached.data);
+                        setIsStale(cached.isStale || false);
+                        // Only revalidate if cache is old enough (avoid excessive revalidation)
+                        if (cacheAge >
+                            minRevalidationTime) {
+                            console.log(`🔄 [useReactive] Revalidating stale cache for ${queryKey}`);
+                            // Trigger revalidation in background
+                            clientManager
+                                .revalidateQuery(effectiveKey)
+                                .then((result) => {
+                                if (result !== undefined) {
+                                    setData(result);
+                                    setIsStale(false);
+                                    // Update ReactiveStorage with fresh data
+                                    clientManager.registerQuery(effectiveKey, [], result);
+                                    // Reduced logging - only log significant updates
+                                }
+                            })
+                                .catch((error) => {
+                                console.warn(`[useReactive] Background revalidation failed:`, error);
+                                // Keep showing cached data even if revalidation fails
+                            });
+                        }
+                        else {
+                            // Reduced logging - only log when cache is stale
+                        }
+                        setIsLoading(false);
+                        isInitialMount.current = false;
+                        return;
+                    }
+                    catch (parseError) {
+                        console.warn("⚠️ Failed to parse cached data:", parseError);
+                        // Continue with revalidation if cache is corrupted
+                    }
+                }
+                // No cache or corrupted cache - trigger immediate fetch
+                console.log(`[useReactive] No cache for ${queryKey}, fetching...`);
+                const result = await clientManager.revalidateQuery(effectiveKey);
+                if (result !== undefined) {
+                    setData(result);
+                    setIsStale(false);
+                    // Store in ReactiveStorage for future use
+                    clientManager.registerQuery(effectiveKey, [], result);
+                    // Reduced logging - only log significant updates
+                }
+                setIsLoading(false);
+                isInitialMount.current = false;
+            }
+            catch (err) {
+                // On error, don't register cache; surface error and keep prior cache visible
+                setError(err);
+                setIsLoading(false);
+                isInitialMount.current = false;
+            }
+        };
+        loadData();
+    }, [effectiveKey, clientManager]);
+    const refetch = useCallback(async () => {
+        if (!enabled) {
+            return;
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            // Reduced logging - only log when there are issues
+            // Trigger manual revalidation
+            await clientManager.revalidateQuery(effectiveKey);
+            // Update stale state
+            setIsStale(false);
+            setIsLoading(false);
+        }
+        catch (err) {
+            setError(err);
+            setIsLoading(false);
+        }
+    }, [
+        effectiveKey,
+        clientManager,
+        enabled,
+    ]);
+    return {
+        data,
+        isLoading,
+        isStale,
+        error,
+        refetch,
+    };
+}
+/**
+ * Optional page-level priority hints for better UX
+ */
+export function useReactivePriorities(priorities) {
+    useEffect(() => {
+        // Reduced logging - only log when there are issues
+        // In a full implementation, this would:
+        // 1. Pre-warm cache for these queries
+        // 2. Subscribe to their invalidation events
+        // 3. Set higher revalidation priority
+        return () => {
+            // Reduced logging - only log when there are issues
+        };
+    }, [priorities.join(",")]);
+}
+/**
+ * Hook to get current session statistics
+ */
+export function useReactiveStats() {
+    const [stats, setStats] = useState(null);
+    const clientManager = getClientManager();
+    useEffect(() => {
+        const updateStats = () => {
+            setStats(clientManager.getSessionStats());
+        };
+        // Update stats immediately
+        updateStats();
+        // Update stats every 5 seconds
+        const interval = setInterval(updateStats, 5000);
+        return () => clearInterval(interval);
+    }, [clientManager]);
+    return stats;
+}
+/**
+ * Hook to manually trigger cache refresh
+ */
+export function useReactiveRefresh() {
+    const clientManager = getClientManager();
+    return useCallback(async () => {
+        // Trigger revalidation for all active queries
+        const activeHooks = clientManager.getStorageStats()
+            ?.queries || {};
+        const activeQueryKeys = Object.keys(activeHooks);
+        console.log(`[useReactiveRefresh] Refreshing ${activeQueryKeys.length} active queries`);
+        // Revalidate all active queries
+        await Promise.allSettled(activeQueryKeys.map((queryKey) => clientManager.revalidateQuery(queryKey)));
+    }, [clientManager]);
+}
+/**
+ * Hook to get revalidation statistics and performance metrics
+ */
+export function useRevalidationStats() {
+    const [stats, setStats] = useState(null);
+    const clientManager = getClientManager();
+    useEffect(() => {
+        const updateStats = () => {
+            const revalidationStats = clientManager.getRevalidationStats();
+            setStats(revalidationStats);
+        };
+        updateStats();
+        const interval = setInterval(updateStats, 2000);
+        return () => clearInterval(interval);
+    }, [clientManager]);
+    return stats;
+}
+/**
+ * Hook to handle invalidation events
+ */
+export function useReactiveInvalidation(callback) {
+    const clientManager = getClientManager();
+    useEffect(() => {
+        // In a full implementation, this would subscribe to invalidation events
+        console.log("[useReactiveInvalidation] Setting up invalidation listener");
+        return () => {
+            console.log("[useReactiveInvalidation] Cleaning up invalidation listener");
+        };
+    }, [callback, clientManager]);
+}
+/**
+ * Hook for manual queries with dynamic parameters
+ * Unlike useReactive, this hook doesn't auto-fetch and allows changing parameters on each call
+ */
+export function useReactiveQuery(queryKey) {
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [lastVariables, setLastVariables,] = useState(undefined);
+    const clientManager = getClientManager();
+    const executeQuery = useCallback(async (variables) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            console.log(`[useReactiveQuery] Executing ${queryKey}`, variables);
+            // Compose cache key with variables
+            const inputKey = typeof variables ===
+                "undefined"
+                ? ""
+                : `::${JSON.stringify(variables)}`;
+            const effectiveKey = `${queryKey}${inputKey}`;
+            // Execute the query through the client manager
+            const result = await clientManager.revalidateQuery(effectiveKey);
+            setData(result);
+            setLastVariables(variables);
+            console.log(`✅ [useReactiveQuery] ${queryKey} completed successfully`);
+            return result;
+        }
+        catch (err) {
+            const error = err;
+            setError(error);
+            console.error(`❌ [useReactiveQuery] ${queryKey} failed:`, error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [queryKey, clientManager]);
+    const refetch = useCallback(async (variables) => {
+        const varsToUse = variables || lastVariables;
+        if (!varsToUse) {
+            throw new Error("No variables provided for refetch and no previous variables stored");
+        }
+        return executeQuery(varsToUse);
+    }, [executeQuery, lastVariables]);
+    return {
+        data,
+        isLoading,
+        error,
+        refetch,
+        run: executeQuery,
+    };
+}
+/**
+ * Hook to get connection status
+ */
+export function useReactiveConnection() {
+    const [status, setStatus] = useState("disconnected");
+    const clientManager = getClientManager();
+    useEffect(() => {
+        const updateStatus = () => {
+            setStatus(clientManager.getConnectionStatus());
+        };
+        updateStatus();
+        const interval = setInterval(updateStatus, 1000);
+        return () => clearInterval(interval);
+    }, [clientManager]);
+    return {
+        status,
+        isConnected: status === "connected",
+        isConnecting: status === "connecting",
+        isDisconnected: status === "disconnected",
+        reconnect: () => clientManager.reconnectSSE(),
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/client/hooks.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Client-side reactive database features
+ */
+export { ReactiveStorage, createReactiveStorage } from './storage.js';
+export { SimpleSessionManager, createSimpleSessionManager, revalidateOnPageLoad, type SessionInfo, type QueryRegistry, type QueryRegistryEntry, } from './session.js';
+export { ReactiveClientManager, createReactiveClientManager, type ReactiveManagerOptions, } from './manager.js';
+export { useReactive, useReactiveQuery, useReactivePriorities, useReactiveStats, useReactiveRefresh, useReactiveInvalidation, useRevalidationStats, useReactiveConnection, initializeReactiveClient, } from './hooks.js';
+export { SmartRevalidationEngine, createSmartRevalidationEngine, type RevalidationStrategy, type RevalidationOptions, type RevalidationResult, } from './revalidation.js';
+export { ReactiveProvider } from './provider.js';
+//# 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,cAAc,CAAA;AACrE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA"}

package/dist/client/index.js

@@ -0,0 +1,15 @@
+/**
+ * Client-side reactive database features
+ */
+// Storage and session management
+export { ReactiveStorage, createReactiveStorage } from './storage.js';
+export { SimpleSessionManager, createSimpleSessionManager, revalidateOnPageLoad, } from './session.js';
+// Client manager
+export { ReactiveClientManager, createReactiveClientManager, } from './manager.js';
+// React hooks
+export { useReactive, useReactiveQuery, useReactivePriorities, useReactiveStats, useReactiveRefresh, useReactiveInvalidation, useRevalidationStats, useReactiveConnection, initializeReactiveClient, } from './hooks.js';
+// Smart revalidation
+export { SmartRevalidationEngine, createSmartRevalidationEngine, } from './revalidation.js';
+// Provider and types
+export { ReactiveProvider } from './provider.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iCAAiC;AACjC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,GAIrB,MAAM,cAAc,CAAA;AAErB,iBAAiB;AACjB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAE5B,MAAM,cAAc,CAAA;AAErB,cAAc;AACd,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AAEnB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAI9B,MAAM,mBAAmB,CAAA;AAE1B,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,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.js';
+import type { ReactiveConfig, InvalidationEvent } from '../core/types.js';
+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.js").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.js").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