@fatagnus/dink-sync 1.0.0

package/dist/persistence/quota-manager.js

@@ -0,0 +1,242 @@
+/**
+ * Eviction policy for when storage quota is exceeded.
+ */
+export const EvictionPolicy = {
+    /** Evict least recently used documents first */
+    LRU: 'lru',
+    /** Evict oldest documents first (by creation time) */
+    Oldest: 'oldest',
+    /** Evict lowest priority documents first */
+    Priority: 'priority',
+};
+/** Default quota: 50MB */
+const DEFAULT_QUOTA_BYTES = 50 * 1024 * 1024;
+/** Default warning threshold: 80% */
+const DEFAULT_WARNING_THRESHOLD = 0.8;
+/** Priority order for eviction (lower = evict first) */
+const PRIORITY_EVICTION_ORDER = {
+    low: 0,
+    normal: 1,
+    high: 2,
+};
+/**
+ * Manages storage quota and eviction for persistence providers.
+ */
+export class QuotaManager {
+    persistence;
+    quotaBytes;
+    warningThreshold;
+    evictionPolicy;
+    autoEvict;
+    // Event callbacks
+    warningCallbacks = new Set();
+    fullCallbacks = new Set();
+    // Document metadata for eviction tracking
+    documentMetadata = new Map();
+    // Track if warning has been emitted to avoid duplicates
+    warningEmitted = false;
+    constructor(persistence, config = {}) {
+        this.persistence = persistence;
+        this.quotaBytes = config.quotaBytes ?? DEFAULT_QUOTA_BYTES;
+        this.warningThreshold = config.warningThreshold ?? DEFAULT_WARNING_THRESHOLD;
+        this.evictionPolicy = config.evictionPolicy ?? EvictionPolicy.Oldest;
+        this.autoEvict = config.autoEvict ?? false;
+    }
+    /**
+     * Get the current storage usage in bytes.
+     */
+    async getStorageUsage() {
+        let totalBytes = 0;
+        // Iterate through all tracked documents
+        for (const metadata of this.documentMetadata.values()) {
+            totalBytes += metadata.size;
+        }
+        return totalBytes;
+    }
+    /**
+     * Get the configured storage quota in bytes.
+     */
+    getStorageQuota() {
+        return this.quotaBytes;
+    }
+    /**
+     * Get current usage as a percentage (0-100).
+     */
+    async getUsagePercent() {
+        const usage = await this.getStorageUsage();
+        return (usage / this.quotaBytes) * 100;
+    }
+    /**
+     * Check quota and emit events / perform eviction as needed.
+     */
+    async checkQuota() {
+        const usage = await this.getStorageUsage();
+        const usagePercent = (usage / this.quotaBytes) * 100;
+        // Check warning threshold
+        if (usagePercent >= this.warningThreshold * 100) {
+            if (!this.warningEmitted) {
+                this.emitWarning({
+                    usageBytes: usage,
+                    quotaBytes: this.quotaBytes,
+                    usagePercent,
+                });
+                this.warningEmitted = true;
+            }
+        }
+        else {
+            // Reset warning flag when below threshold
+            this.warningEmitted = false;
+        }
+        // Check if quota exceeded
+        if (usage > this.quotaBytes) {
+            const overageBytes = usage - this.quotaBytes;
+            this.emitFull({
+                usageBytes: usage,
+                quotaBytes: this.quotaBytes,
+                overageBytes,
+            });
+            // Auto-evict if enabled
+            if (this.autoEvict) {
+                await this.evict(overageBytes);
+            }
+        }
+    }
+    /**
+     * Track document creation for eviction purposes.
+     */
+    async trackCreation(collection, docId) {
+        const key = this.metadataKey(collection, docId);
+        const data = await this.persistence.load(collection, docId);
+        const size = data?.length ?? 0;
+        const now = Date.now();
+        this.documentMetadata.set(key, {
+            collection,
+            docId,
+            size,
+            createdAt: now,
+            lastAccessedAt: now,
+            priority: 'normal',
+        });
+    }
+    /**
+     * Track document access for LRU eviction.
+     */
+    async trackAccess(collection, docId) {
+        const key = this.metadataKey(collection, docId);
+        const existing = this.documentMetadata.get(key);
+        if (existing) {
+            existing.lastAccessedAt = Date.now();
+        }
+        else {
+            // If not tracked, start tracking
+            await this.trackCreation(collection, docId);
+        }
+    }
+    /**
+     * Track document priority for priority-based eviction.
+     */
+    async trackPriority(collection, docId, priority) {
+        const key = this.metadataKey(collection, docId);
+        const existing = this.documentMetadata.get(key);
+        if (existing) {
+            existing.priority = priority;
+        }
+        else {
+            // If not tracked, start tracking
+            await this.trackCreation(collection, docId);
+            const metadata = this.documentMetadata.get(key);
+            if (metadata) {
+                metadata.priority = priority;
+            }
+        }
+    }
+    /**
+     * Evict documents to free at least the specified bytes.
+     * @param bytesToFree - Minimum bytes to free
+     * @returns Number of documents evicted
+     */
+    async evict(bytesToFree) {
+        const candidates = this.getEvictionCandidates();
+        let freedBytes = 0;
+        let evictedCount = 0;
+        for (const metadata of candidates) {
+            if (freedBytes >= bytesToFree) {
+                break;
+            }
+            // Delete the document
+            await this.persistence.delete(metadata.collection, metadata.docId);
+            // Remove from tracking
+            const key = this.metadataKey(metadata.collection, metadata.docId);
+            this.documentMetadata.delete(key);
+            freedBytes += metadata.size;
+            evictedCount++;
+        }
+        return evictedCount;
+    }
+    /**
+     * Subscribe to storage warning events.
+     */
+    onStorageWarning(callback) {
+        this.warningCallbacks.add(callback);
+        return () => {
+            this.warningCallbacks.delete(callback);
+        };
+    }
+    /**
+     * Subscribe to storage full events.
+     */
+    onStorageFull(callback) {
+        this.fullCallbacks.add(callback);
+        return () => {
+            this.fullCallbacks.delete(callback);
+        };
+    }
+    /**
+     * Get eviction candidates sorted by the configured policy.
+     */
+    getEvictionCandidates() {
+        const candidates = Array.from(this.documentMetadata.values());
+        switch (this.evictionPolicy) {
+            case EvictionPolicy.LRU:
+                // Sort by last access time (oldest first)
+                return candidates.sort((a, b) => a.lastAccessedAt - b.lastAccessedAt);
+            case EvictionPolicy.Oldest:
+                // Sort by creation time (oldest first)
+                return candidates.sort((a, b) => a.createdAt - b.createdAt);
+            case EvictionPolicy.Priority:
+                // Sort by priority (lowest first), then by creation time
+                return candidates.sort((a, b) => {
+                    const priorityDiff = PRIORITY_EVICTION_ORDER[a.priority] - PRIORITY_EVICTION_ORDER[b.priority];
+                    if (priorityDiff !== 0) {
+                        return priorityDiff;
+                    }
+                    return a.createdAt - b.createdAt;
+                });
+            default:
+                return candidates;
+        }
+    }
+    /**
+     * Create a unique key for document metadata.
+     */
+    metadataKey(collection, docId) {
+        return `${collection}:${docId}`;
+    }
+    /**
+     * Emit storage warning event.
+     */
+    emitWarning(event) {
+        for (const callback of this.warningCallbacks) {
+            callback(event);
+        }
+    }
+    /**
+     * Emit storage full event.
+     */
+    emitFull(event) {
+        for (const callback of this.fullCallbacks) {
+            callback(event);
+        }
+    }
+}
+//# sourceMappingURL=quota-manager.js.map

package/dist/persistence/quota-manager.js.map

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

package/dist/persistence/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Persistence provider interface for offline-first sync.
+ *
+ * Implementations handle storage of documents and state vectors
+ * for CRDT synchronization.
+ */
+export interface PersistenceProvider {
+    /**
+     * Save a document's data to storage.
+     * @param collection - Collection name
+     * @param docId - Document ID
+     * @param data - Binary data to store
+     */
+    save(collection: string, docId: string, data: Uint8Array): Promise<void>;
+    /**
+     * Load a document's data from storage.
+     * @param collection - Collection name
+     * @param docId - Document ID
+     * @returns The stored data, or undefined if not found
+     */
+    load(collection: string, docId: string): Promise<Uint8Array | undefined>;
+    /**
+     * List all document IDs in a collection.
+     * @param collection - Collection name
+     * @returns Array of document IDs
+     */
+    list(collection: string): Promise<string[]>;
+    /**
+     * Delete a document from storage.
+     * @param collection - Collection name
+     * @param docId - Document ID
+     */
+    delete(collection: string, docId: string): Promise<void>;
+    /**
+     * Save a state vector for a document.
+     * State vectors track sync progress for CRDT convergence.
+     * @param collection - Collection name
+     * @param docId - Document ID
+     * @param vector - Binary state vector data
+     */
+    saveStateVector(collection: string, docId: string, vector: Uint8Array): Promise<void>;
+    /**
+     * Load a state vector for a document.
+     * @param collection - Collection name
+     * @param docId - Document ID
+     * @returns The stored state vector, or undefined if not found
+     */
+    loadStateVector(collection: string, docId: string): Promise<Uint8Array | undefined>;
+    /**
+     * Close the persistence provider and release resources.
+     */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/persistence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAEzE;;;;OAIG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE5C;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;;;OAMG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAEpF;;OAEG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/persistence/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":""}

package/dist/react/OfflineEdgeProvider.d.ts

@@ -0,0 +1,91 @@
+/**
+ * OfflineEdgeProvider - React context provider for the offline edge client.
+ *
+ * Provides the OfflineEdgeClient to the component tree and handles
+ * initialization lifecycle including loading and error states.
+ *
+ * @example
+ * ```tsx
+ * import { OfflineEdgeProvider, useOfflineEdgeClient } from '@fatagnus/dink-sync/react';
+ * import { MemoryPersistence } from '@fatagnus/dink-sync/persistence';
+ *
+ * function App() {
+ *   return (
+ *     <OfflineEdgeProvider
+ *       config={{ serverUrl: 'nats://localhost:4222', apiKey: 'your-api-key' }}
+ *       persistence={new MemoryPersistence()}
+ *     >
+ *       <TaskList />
+ *     </OfflineEdgeProvider>
+ *   );
+ * }
+ *
+ * function TaskList() {
+ *   const client = useOfflineEdgeClient();
+ *   const tasks = client.collection<Task>('tasks');
+ *   // ...
+ * }
+ * ```
+ */
+import { type ReactNode } from 'react';
+import type { OfflineEdgeClient, OfflineEdgeConfig } from '../client/types.js';
+import type { PersistenceProvider } from '../persistence/types.js';
+/**
+ * Props for the OfflineEdgeProvider component.
+ */
+export interface OfflineEdgeProviderProps {
+    /** Configuration for the offline edge client */
+    config: OfflineEdgeConfig;
+    /** Persistence provider for offline storage */
+    persistence: PersistenceProvider;
+    /** Children to render */
+    children: ReactNode;
+    /** Optional callback for initialization errors */
+    onError?: (error: Error) => void;
+}
+/**
+ * Internal context state.
+ */
+interface OfflineEdgeContextState {
+    /** The initialized client, or null if not yet ready */
+    client: OfflineEdgeClient | null;
+    /** True while initializing */
+    isLoading: boolean;
+    /** True when client is ready to use */
+    isReady: boolean;
+    /** Error if initialization failed */
+    error: Error | null;
+}
+/**
+ * Internal context for the offline edge provider.
+ * Exported for use by useOfflineEdge hook.
+ */
+export declare const OfflineEdgeContext: import("react").Context<OfflineEdgeContextState | null>;
+/**
+ * OfflineEdgeProvider component.
+ *
+ * Wraps your app to provide the OfflineEdgeClient to all child components.
+ * Handles initialization on mount and cleanup on unmount.
+ */
+export declare function OfflineEdgeProvider({ config, persistence, children, onError, }: OfflineEdgeProviderProps): ReactNode;
+/**
+ * Hook to access the offline edge client directly.
+ *
+ * Throws if the client is not yet initialized. Use useOfflineEdge()
+ * if you need to handle loading states.
+ *
+ * @throws Error if used outside of OfflineEdgeProvider
+ * @throws Error if client is not yet initialized
+ *
+ * @example
+ * ```tsx
+ * function TaskList() {
+ *   const client = useOfflineEdgeClient();
+ *   const tasks = client.collection<Task>('tasks');
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useOfflineEdgeClient(): OfflineEdgeClient;
+export {};
+//# sourceMappingURL=OfflineEdgeProvider.d.ts.map

package/dist/react/OfflineEdgeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineEdgeProvider.d.ts","sourceRoot":"","sources":["../../src/react/OfflineEdgeProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,+CAA+C;IAC/C,WAAW,EAAE,mBAAmB,CAAC;IACjC,yBAAyB;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,UAAU,uBAAuB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,yDAAsD,CAAC;AAEtF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,WAAW,EACX,QAAQ,EACR,OAAO,GACR,EAAE,wBAAwB,GAAG,SAAS,CAmEtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAYxD"}

package/dist/react/OfflineEdgeProvider.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * OfflineEdgeProvider - React context provider for the offline edge client.
+ *
+ * Provides the OfflineEdgeClient to the component tree and handles
+ * initialization lifecycle including loading and error states.
+ *
+ * @example
+ * ```tsx
+ * import { OfflineEdgeProvider, useOfflineEdgeClient } from '@fatagnus/dink-sync/react';
+ * import { MemoryPersistence } from '@fatagnus/dink-sync/persistence';
+ *
+ * function App() {
+ *   return (
+ *     <OfflineEdgeProvider
+ *       config={{ serverUrl: 'nats://localhost:4222', apiKey: 'your-api-key' }}
+ *       persistence={new MemoryPersistence()}
+ *     >
+ *       <TaskList />
+ *     </OfflineEdgeProvider>
+ *   );
+ * }
+ *
+ * function TaskList() {
+ *   const client = useOfflineEdgeClient();
+ *   const tasks = client.collection<Task>('tasks');
+ *   // ...
+ * }
+ * ```
+ */
+import { createContext, useContext, useState, useEffect, useRef, } from 'react';
+import { offlineEdge } from '../client/index.js';
+/**
+ * Internal context for the offline edge provider.
+ * Exported for use by useOfflineEdge hook.
+ */
+export const OfflineEdgeContext = createContext(null);
+/**
+ * OfflineEdgeProvider component.
+ *
+ * Wraps your app to provide the OfflineEdgeClient to all child components.
+ * Handles initialization on mount and cleanup on unmount.
+ */
+export function OfflineEdgeProvider({ config, persistence, children, onError, }) {
+    const [state, setState] = useState({
+        client: null,
+        isLoading: true,
+        isReady: false,
+        error: null,
+    });
+    // Track the edge instance for cleanup
+    const edgeRef = useRef(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        const initializeClient = async () => {
+            try {
+                // Create the edge instance
+                const edge = offlineEdge.create({
+                    persistence,
+                    config,
+                });
+                edgeRef.current = edge;
+                // Initialize (loads persisted data)
+                await edge.init();
+                // Get the client
+                const client = edge.get();
+                if (mountedRef.current) {
+                    setState({
+                        client,
+                        isLoading: false,
+                        isReady: true,
+                        error: null,
+                    });
+                }
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                if (mountedRef.current) {
+                    setState({
+                        client: null,
+                        isLoading: false,
+                        isReady: false,
+                        error,
+                    });
+                    onError?.(error);
+                }
+            }
+        };
+        initializeClient();
+        // Cleanup on unmount
+        return () => {
+            mountedRef.current = false;
+            edgeRef.current = null;
+        };
+    }, [config, persistence, onError]);
+    return (_jsx(OfflineEdgeContext.Provider, { value: state, children: children }));
+}
+/**
+ * Hook to access the offline edge client directly.
+ *
+ * Throws if the client is not yet initialized. Use useOfflineEdge()
+ * if you need to handle loading states.
+ *
+ * @throws Error if used outside of OfflineEdgeProvider
+ * @throws Error if client is not yet initialized
+ *
+ * @example
+ * ```tsx
+ * function TaskList() {
+ *   const client = useOfflineEdgeClient();
+ *   const tasks = client.collection<Task>('tasks');
+ *   // ...
+ * }
+ * ```
+ */
+export function useOfflineEdgeClient() {
+    const context = useContext(OfflineEdgeContext);
+    if (context === null) {
+        throw new Error('useOfflineEdgeClient must be used within an OfflineEdgeProvider');
+    }
+    if (!context.isReady || !context.client) {
+        throw new Error('OfflineEdgeClient is not yet initialized. Use useOfflineEdge() to handle loading states.');
+    }
+    return context.client;
+}
+//# sourceMappingURL=OfflineEdgeProvider.js.map

package/dist/react/OfflineEdgeProvider.js.map

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

package/dist/react/SyncedOfflineEdgeProvider.d.ts

@@ -0,0 +1,105 @@
+/**
+ * SyncedOfflineEdgeProvider - React context provider for SyncedOfflineEdge.
+ *
+ * Provides the SyncedOfflineEdge instance to the component tree and handles
+ * initialization lifecycle including loading and error states.
+ *
+ * @example
+ * ```tsx
+ * import { SyncedOfflineEdgeProvider, useSyncedOfflineEdgeClient } from '@fatagnus/dink-sync/react';
+ * import { MemoryPersistence } from '@fatagnus/dink-sync/persistence';
+ *
+ * function App() {
+ *   return (
+ *     <SyncedOfflineEdgeProvider
+ *       config={{ serverUrl: 'nats://localhost:4222', apiKey: 'your-api-key' }}
+ *       persistence={new MemoryPersistence()}
+ *       syncConfig={{ tasks: 'auto', drafts: 'manual' }}
+ *     >
+ *       <TaskList />
+ *     </SyncedOfflineEdgeProvider>
+ *   );
+ * }
+ *
+ * function TaskList() {
+ *   const { edge, isReady } = useSyncedOfflineEdgeClient();
+ *   if (!isReady) return <Loading />;
+ *
+ *   const tasks = edge.collection<Task>('tasks');
+ *   // ...
+ * }
+ * ```
+ */
+import { type ReactNode } from 'react';
+import type { SyncedOfflineEdge, SyncConfigMap, SyncLifecycleHooks } from '../client/synced-offline-edge-types.js';
+import type { OfflineEdgeConfig } from '../client/types.js';
+import type { PersistenceProvider } from '../persistence/types.js';
+import type { Transport } from '../client/transport.js';
+/**
+ * Props for the SyncedOfflineEdgeProvider component.
+ */
+export interface SyncedOfflineEdgeProviderProps {
+    /** Configuration for the offline edge client */
+    config: OfflineEdgeConfig;
+    /** Persistence provider for offline storage */
+    persistence: PersistenceProvider;
+    /** Optional per-collection sync mode configuration */
+    syncConfig?: SyncConfigMap;
+    /** Optional lifecycle hooks for customizing sync behavior */
+    hooks?: SyncLifecycleHooks;
+    /** Children to render */
+    children: ReactNode;
+    /** Optional callback for initialization errors */
+    onError?: (error: Error) => void;
+    /** Optional custom transport for testing */
+    transport?: Transport;
+}
+/**
+ * Internal context state.
+ */
+interface SyncedOfflineEdgeContextState {
+    /** The initialized SyncedOfflineEdge, or null if not yet ready */
+    edge: SyncedOfflineEdge | null;
+    /** True while initializing */
+    isLoading: boolean;
+    /** True when edge is ready to use */
+    isReady: boolean;
+    /** Error if initialization failed */
+    error: Error | null;
+}
+/**
+ * Internal context for the SyncedOfflineEdge provider.
+ * Exported for use by custom hooks.
+ */
+export declare const SyncedOfflineEdgeContext: import("react").Context<SyncedOfflineEdgeContextState | null>;
+/**
+ * SyncedOfflineEdgeProvider component.
+ *
+ * Wraps your app to provide the SyncedOfflineEdge to all child components.
+ * Handles initialization on mount and cleanup on unmount.
+ */
+export declare function SyncedOfflineEdgeProvider({ config, persistence, syncConfig, hooks, children, onError, transport, }: SyncedOfflineEdgeProviderProps): ReactNode;
+/**
+ * Hook to access the SyncedOfflineEdge context.
+ *
+ * Returns the full context state including loading state, error, and the edge instance.
+ *
+ * @throws Error if used outside of SyncedOfflineEdgeProvider
+ *
+ * @example
+ * ```tsx
+ * function TaskList() {
+ *   const { edge, isLoading, isReady, error } = useSyncedOfflineEdgeClient();
+ *
+ *   if (isLoading) return <Loading />;
+ *   if (error) return <Error error={error} />;
+ *   if (!isReady) return null;
+ *
+ *   const tasks = edge.collection<Task>('tasks');
+ *   // ...
+ * }
+ * ```
+ */
+export declare function useSyncedOfflineEdgeClient(): SyncedOfflineEdgeContextState;
+export {};
+//# sourceMappingURL=SyncedOfflineEdgeProvider.d.ts.map

package/dist/react/SyncedOfflineEdgeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncedOfflineEdgeProvider.d.ts","sourceRoot":"","sources":["../../src/react/SyncedOfflineEdgeProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EACnB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,gDAAgD;IAChD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,+CAA+C;IAC/C,WAAW,EAAE,mBAAmB,CAAC;IACjC,sDAAsD;IACtD,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,yBAAyB;IACzB,QAAQ,EAAE,SAAS,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,4CAA4C;IAC5C,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,UAAU,6BAA6B;IACrC,kEAAkE;IAClE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,+DAA4D,CAAC;AAElG;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,MAAM,EACN,WAAW,EACX,UAAU,EACV,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,GACV,EAAE,8BAA8B,GAAG,SAAS,CAwE5C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,0BAA0B,IAAI,6BAA6B,CAQ1E"}