@mongrov/db 0.2.0

package/dist/hooks.js

@@ -0,0 +1,221 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * React hooks for RxDB database access
+ *
+ * Provides context-based database injection and reactive query hooks.
+ */
+import { createContext, useContext, useState, useEffect, useCallback, useMemo, } from 'react';
+const DatabaseContext = createContext(null);
+/**
+ * Provides database context to child components.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const [db, setDb] = useState<RxDatabase | null>(null)
+ *
+ *   useEffect(() => {
+ *     createDatabase(config).then(setDb)
+ *   }, [])
+ *
+ *   return (
+ *     <DatabaseProvider database={db}>
+ *       <MyApp />
+ *     </DatabaseProvider>
+ *   )
+ * }
+ * ```
+ */
+export function DatabaseProvider({ database, children }) {
+    const value = useMemo(() => ({
+        db: database,
+        isReady: database !== null,
+    }), [database]);
+    return _jsx(DatabaseContext.Provider, { value: value, children: children });
+}
+// ─── Hooks ──────────────────────────────────────────────────────────────────
+/**
+ * Hook to access the database context.
+ *
+ * @returns The database context value
+ * @throws If used outside of DatabaseProvider
+ */
+export function useDatabase() {
+    const context = useContext(DatabaseContext);
+    if (context === null) {
+        throw new Error('[useDatabase] Hook called outside of DatabaseProvider.\n\n' +
+            'To fix this, wrap your component tree with DatabaseProvider:\n\n' +
+            '  import { DatabaseProvider, createDatabase } from "@mongrov/db"\n\n' +
+            '  function App() {\n' +
+            '    const [db, setDb] = useState(null)\n' +
+            '    useEffect(() => { createDatabase(config).then(setDb) }, [])\n\n' +
+            '    return (\n' +
+            '      <DatabaseProvider database={db}>\n' +
+            '        <YourComponent />\n' +
+            '      </DatabaseProvider>\n' +
+            '    )\n' +
+            '  }');
+    }
+    return context;
+}
+/**
+ * Hook to access a specific collection.
+ *
+ * @param name - Collection name
+ * @returns The collection instance or null if not ready
+ *
+ * @example
+ * ```tsx
+ * function MessageList() {
+ *   const messages = useCollection('messages')
+ *
+ *   if (!messages) return <Loading />
+ *
+ *   // Use messages collection...
+ * }
+ * ```
+ */
+export function useCollection(name) {
+    const { db, isReady } = useDatabase();
+    if (!isReady || !db) {
+        return null;
+    }
+    return db[name] ?? null;
+}
+/**
+ * Hook to execute a reactive query on a collection.
+ *
+ * @param collectionName - Name of the collection to query
+ * @param query - RxDB/Mango query selector
+ * @returns Query result with reactive updates
+ *
+ * @example
+ * ```tsx
+ * function RecentMessages() {
+ *   const { data, isLoading, error } = useQuery('messages', {
+ *     selector: { createdAt: { $gt: Date.now() - 86400000 } },
+ *     sort: [{ createdAt: 'desc' }],
+ *     limit: 50,
+ *   })
+ *
+ *   if (isLoading) return <Loading />
+ *   if (error) return <Error message={error.message} />
+ *
+ *   return <MessageList messages={data} />
+ * }
+ * ```
+ */
+export function useQuery(collectionName, query = {}) {
+    const collection = useCollection(collectionName);
+    const [data, setData] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [refetchTrigger, setRefetchTrigger] = useState(0);
+    // Memoize query to prevent infinite re-subscriptions
+    const queryKey = useMemo(() => JSON.stringify(query), [query]);
+    const refetch = useCallback(() => {
+        setRefetchTrigger(prev => prev + 1);
+    }, []);
+    useEffect(() => {
+        if (!collection) {
+            setIsLoading(true);
+            setData([]);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        let subscription = null;
+        try {
+            const parsedQuery = JSON.parse(queryKey);
+            const rxQuery = collection.find(parsedQuery);
+            subscription = rxQuery.$.subscribe({
+                next: (results) => {
+                    // Convert RxDocuments to plain objects
+                    const plainData = results.map((doc) => typeof doc.toJSON === 'function' ? doc.toJSON() : doc);
+                    setData(plainData);
+                    setIsLoading(false);
+                },
+                error: (err) => {
+                    setError(err);
+                    setIsLoading(false);
+                },
+            });
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setIsLoading(false);
+        }
+        return () => {
+            subscription?.unsubscribe();
+        };
+    }, [collection, queryKey, refetchTrigger]);
+    return { data, isLoading, error, refetch };
+}
+/**
+ * Hook to fetch and subscribe to a single document by ID.
+ *
+ * @param collectionName - Name of the collection
+ * @param id - Document primary key
+ * @returns Document result with reactive updates
+ *
+ * @example
+ * ```tsx
+ * function MessageDetail({ messageId }: { messageId: string }) {
+ *   const { data: message, isLoading, error } = useDocument('messages', messageId)
+ *
+ *   if (isLoading) return <Loading />
+ *   if (error) return <Error message={error.message} />
+ *   if (!message) return <NotFound />
+ *
+ *   return <MessageView message={message} />
+ * }
+ * ```
+ */
+export function useDocument(collectionName, id) {
+    const collection = useCollection(collectionName);
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [refetchTrigger, setRefetchTrigger] = useState(0);
+    const refetch = useCallback(() => {
+        setRefetchTrigger(prev => prev + 1);
+    }, []);
+    useEffect(() => {
+        if (!collection || !id) {
+            setIsLoading(false);
+            setData(null);
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        let subscription = null;
+        try {
+            const doc$ = collection.findOne(id).$;
+            subscription = doc$.subscribe({
+                next: (doc) => {
+                    if (doc) {
+                        const plainData = typeof doc.toJSON === 'function' ? doc.toJSON() : doc;
+                        setData(plainData);
+                    }
+                    else {
+                        setData(null);
+                    }
+                    setIsLoading(false);
+                },
+                error: (err) => {
+                    setError(err);
+                    setIsLoading(false);
+                },
+            });
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setIsLoading(false);
+        }
+        return () => {
+            subscription?.unsubscribe();
+        };
+    }, [collection, id, refetchTrigger]);
+    return { data, isLoading, error, refetch };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,UAAU,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,OAAO,GAER,MAAM,OAAO,CAAA;AAgBd,MAAM,eAAe,GAAG,aAAa,CAA8B,IAAI,CAAC,CAAA;AAWxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAyB;IAC5E,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,QAAQ,KAAK,IAAI;KAC3B,CAAC,EACF,CAAC,QAAQ,CAAC,CACX,CAAA;IAED,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA4B,CAAA;AACtF,CAAC;AAED,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;IAC3C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,4DAA4D;YAC5D,kEAAkE;YAClE,sEAAsE;YACtE,sBAAsB;YACtB,0CAA0C;YAC1C,qEAAqE;YACrE,gBAAgB;YAChB,0CAA0C;YAC1C,6BAA6B;YAC7B,6BAA6B;YAC7B,SAAS;YACT,KAAK,CACN,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAuB,IAAY;IAC9D,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAA;IAErC,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,EAAE,CAAC,IAAI,CAAkB,IAAI,IAAI,CAAA;AAC1C,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CACtB,cAAsB,EACtB,QAAwB,EAAE;IAE1B,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA;IAChD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAM,EAAE,CAAC,CAAA;IACzC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IACtD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEvD,qDAAqD;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAE9D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACrC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,CAAA;YAClB,OAAO,CAAC,EAAE,CAAC,CAAA;YACX,OAAM;QACR,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEd,IAAI,YAAY,GAAuC,IAAI,CAAA;QAE3D,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACxC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YAE5C,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBACjC,IAAI,EAAE,CAAC,OAAyB,EAAE,EAAE;oBAClC,uCAAuC;oBACvC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAmB,EAAE,EAAE,CACpD,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAC/C,CAAA;oBACR,OAAO,CAAC,SAAS,CAAC,CAAA;oBAClB,YAAY,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;gBACD,KAAK,EAAE,CAAC,GAAU,EAAE,EAAE;oBACpB,QAAQ,CAAC,GAAG,CAAC,CAAA;oBACb,YAAY,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;aACF,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC7D,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;QAED,OAAO,GAAG,EAAE;YACV,YAAY,EAAE,WAAW,EAAE,CAAA;QAC7B,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAA;IAE1C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC5C,CAAC;AAgBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CACzB,cAAsB,EACtB,EAA6B;IAE7B,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA;IAChD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IACtD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAEvD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAA;IACrC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,CAAC,IAAI,CAAC,CAAA;YACb,OAAM;QACR,CAAC;QAED,YAAY,CAAC,IAAI,CAAC,CAAA;QAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEd,IAAI,YAAY,GAAuC,IAAI,CAAA;QAE3D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAErC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC5B,IAAI,EAAE,CAAC,GAA0B,EAAE,EAAE;oBACnC,IAAI,GAAG,EAAE,CAAC;wBACR,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;wBACvE,OAAO,CAAC,SAAc,CAAC,CAAA;oBACzB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,IAAI,CAAC,CAAA;oBACf,CAAC;oBACD,YAAY,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;gBACD,KAAK,EAAE,CAAC,GAAU,EAAE,EAAE;oBACpB,QAAQ,CAAC,GAAG,CAAC,CAAA;oBACb,YAAY,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;aACF,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC7D,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;QAED,OAAO,GAAG,EAAE;YACV,YAAY,EAAE,WAAW,EAAE,CAAA;QAC7B,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC,CAAA;IAEpC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @mongrov/db
+ *
+ * Database utilities for @mongrov apps:
+ * - KVStore: Unified async key-value storage (MMKV + SecureStore)
+ * - TokenStore: Auth token persistence backed by KVStore
+ * - RxDB: Document database with reactive queries
+ */
+export { createKVStore } from './kv-store';
+export { createTokenStore } from './token-store';
+export type { TokenStore } from './token-store';
+export { createDatabase, destroyDatabase } from './database';
+export { DatabaseProvider, useDatabase, useCollection, useQuery, useDocument, } from './hooks';
+export type { DatabaseProviderProps, QueryResult, DocumentResult, } from './hooks';
+export { createReplicationState, cancelReplication, resyncReplication, } from './replication';
+export type { KVStore, KVStoreConfig, DBLogger, DatabaseConfig, CollectionConfig, MigrationStrategies, MigrationStrategy, RxStorageType, RxJsonSchemaType, RxDatabaseType, RxCollectionType, RxDocumentType, MangoQueryType, RxReplicationStateType, ReplicationCheckpoint, ReplicationPushHandler, ReplicationPullHandler, ReplicationConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG/C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,GACZ,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AAGtB,YAAY,EACV,OAAO,EACP,aAAa,EACb,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @mongrov/db
+ *
+ * Database utilities for @mongrov apps:
+ * - KVStore: Unified async key-value storage (MMKV + SecureStore)
+ * - TokenStore: Auth token persistence backed by KVStore
+ * - RxDB: Document database with reactive queries
+ */
+// KVStore
+export { createKVStore } from './kv-store';
+// TokenStore (for @mongrov/auth integration)
+export { createTokenStore } from './token-store';
+// RxDB Database
+export { createDatabase, destroyDatabase } from './database';
+export { DatabaseProvider, useDatabase, useCollection, useQuery, useDocument, } from './hooks';
+// Replication
+export { createReplicationState, cancelReplication, resyncReplication, } from './replication';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,6CAA6C;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGhD,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,WAAW,GACZ,MAAM,SAAS,CAAA;AAOhB,cAAc;AACd,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAA"}

package/dist/kv-backends/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * KV backend implementations
+ */
+export { MMKVBackend } from './mmkv-backend';
+export { SecureBackend } from './secure-backend';
+//# sourceMappingURL=index.d.ts.map

package/dist/kv-backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kv-backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/kv-backends/index.js

@@ -0,0 +1,6 @@
+/**
+ * KV backend implementations
+ */
+export { MMKVBackend } from './mmkv-backend';
+export { SecureBackend } from './secure-backend';
+//# sourceMappingURL=index.js.map

package/dist/kv-backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kv-backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/kv-backends/mmkv-backend.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MMKV backend for KVStore.
+ * Wraps synchronous MMKV calls in async interface for API consistency.
+ */
+import type { KVStore } from '../types';
+/**
+ * MMKV-backed KVStore implementation.
+ * Fast synchronous storage wrapped in async API.
+ */
+export declare class MMKVBackend implements KVStore {
+    private mmkv;
+    constructor(instanceId?: string);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    getObject<T>(key: string): Promise<T | null>;
+    setObject<T>(key: string, value: T): Promise<void>;
+    clear(): Promise<void>;
+    getAllKeys(): Promise<string[]>;
+}
+//# sourceMappingURL=mmkv-backend.d.ts.map

package/dist/kv-backends/mmkv-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmkv-backend.d.ts","sourceRoot":"","sources":["../../src/kv-backends/mmkv-backend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAoBvC;;;GAGG;AACH,qBAAa,WAAY,YAAW,OAAO;IACzC,OAAO,CAAC,IAAI,CAAuD;gBAEvD,UAAU,GAAE,MAAqB;IAKvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAU5C,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAGtC"}

package/dist/kv-backends/mmkv-backend.js

@@ -0,0 +1,59 @@
+/**
+ * MMKV backend for KVStore.
+ * Wraps synchronous MMKV calls in async interface for API consistency.
+ */
+// Lazy import to allow optional peer dependency
+let MMKV;
+function getMMKV() {
+    if (!MMKV) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            MMKV = require('react-native-mmkv').MMKV;
+        }
+        catch {
+            throw new Error('@mongrov/db: react-native-mmkv is required for KVStore. ' +
+                'Install it with: pnpm add react-native-mmkv');
+        }
+    }
+    return MMKV;
+}
+/**
+ * MMKV-backed KVStore implementation.
+ * Fast synchronous storage wrapped in async API.
+ */
+export class MMKVBackend {
+    constructor(instanceId = 'mongrov-kv') {
+        const MMKVClass = getMMKV();
+        this.mmkv = new MMKVClass({ id: instanceId });
+    }
+    async get(key) {
+        return this.mmkv.getString(key) ?? null;
+    }
+    async set(key, value) {
+        this.mmkv.set(key, value);
+    }
+    async delete(key) {
+        this.mmkv.delete(key);
+    }
+    async getObject(key) {
+        const value = this.mmkv.getString(key);
+        if (value === undefined)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async setObject(key, value) {
+        this.mmkv.set(key, JSON.stringify(value));
+    }
+    async clear() {
+        this.mmkv.clearAll();
+    }
+    async getAllKeys() {
+        return this.mmkv.getAllKeys();
+    }
+}
+//# sourceMappingURL=mmkv-backend.js.map

package/dist/kv-backends/mmkv-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmkv-backend.js","sourceRoot":"","sources":["../../src/kv-backends/mmkv-backend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,gDAAgD;AAChD,IAAI,IAA6C,CAAA;AAEjD,SAAS,OAAO;IACd,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YACH,iEAAiE;YACjE,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAA;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,0DAA0D;gBACxD,6CAA6C,CAChD,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,WAAW;IAGtB,YAAY,aAAqB,YAAY;QAC3C,MAAM,SAAS,GAAG,OAAO,EAAE,CAAA;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,SAAS,CAAI,GAAW;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACpC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAA;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAI,GAAW,EAAE,KAAQ;QACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAA;IAC/B,CAAC;CACF"}

package/dist/kv-backends/secure-backend.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SecureStore backend for KVStore.
+ * Uses expo-secure-store for secure token/secret storage.
+ */
+import type { KVStore } from '../types';
+/**
+ * SecureStore-backed KVStore implementation.
+ * For tokens, secrets, and sensitive data.
+ *
+ * Note: SecureStore has platform limitations:
+ * - iOS: Keychain (2048 byte limit per value)
+ * - Android: SharedPreferences with encryption
+ */
+export declare class SecureBackend implements KVStore {
+    private store;
+    constructor();
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    getObject<T>(key: string): Promise<T | null>;
+    setObject<T>(key: string, value: T): Promise<void>;
+    clear(): Promise<void>;
+    getAllKeys(): Promise<string[]>;
+    private trackKey;
+    private untrackKey;
+}
+//# sourceMappingURL=secure-backend.d.ts.map

package/dist/kv-backends/secure-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-backend.d.ts","sourceRoot":"","sources":["../../src/kv-backends/secure-backend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AA4BvC;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,KAAK,CAAmB;;IAM1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAU5C,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAYvB,QAAQ;YASR,UAAU;CAQzB"}

package/dist/kv-backends/secure-backend.js

@@ -0,0 +1,97 @@
+/**
+ * SecureStore backend for KVStore.
+ * Uses expo-secure-store for secure token/secret storage.
+ */
+// Lazy import to allow optional peer dependency
+let cachedSecureStore = null;
+function getSecureStore() {
+    if (cachedSecureStore) {
+        return cachedSecureStore;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        cachedSecureStore = require('expo-secure-store');
+        return cachedSecureStore;
+    }
+    catch {
+        throw new Error('@mongrov/db: expo-secure-store is required for secure KVStore. ' +
+            'Install it with: npx expo install expo-secure-store');
+    }
+}
+// Key prefix for getAllKeys tracking (SecureStore doesn't have getAllKeys)
+const KEYS_REGISTRY = '__mongrov_secure_keys__';
+/**
+ * SecureStore-backed KVStore implementation.
+ * For tokens, secrets, and sensitive data.
+ *
+ * Note: SecureStore has platform limitations:
+ * - iOS: Keychain (2048 byte limit per value)
+ * - Android: SharedPreferences with encryption
+ */
+export class SecureBackend {
+    constructor() {
+        this.store = getSecureStore();
+    }
+    async get(key) {
+        return this.store.getItemAsync(key);
+    }
+    async set(key, value) {
+        await this.store.setItemAsync(key, value);
+        await this.trackKey(key);
+    }
+    async delete(key) {
+        await this.store.deleteItemAsync(key);
+        await this.untrackKey(key);
+    }
+    async getObject(key) {
+        const value = await this.store.getItemAsync(key);
+        if (value === null)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async setObject(key, value) {
+        await this.store.setItemAsync(key, JSON.stringify(value));
+        await this.trackKey(key);
+    }
+    async clear() {
+        const keys = await this.getAllKeys();
+        await Promise.all(keys.map((key) => this.store.deleteItemAsync(key)));
+        await this.store.deleteItemAsync(KEYS_REGISTRY);
+    }
+    async getAllKeys() {
+        const keysJson = await this.store.getItemAsync(KEYS_REGISTRY);
+        if (!keysJson)
+            return [];
+        try {
+            return JSON.parse(keysJson);
+        }
+        catch {
+            return [];
+        }
+    }
+    // ─── Internal key tracking ───────────────────────────────────────────────
+    async trackKey(key) {
+        if (key === KEYS_REGISTRY)
+            return;
+        const keys = await this.getAllKeys();
+        if (!keys.includes(key)) {
+            keys.push(key);
+            await this.store.setItemAsync(KEYS_REGISTRY, JSON.stringify(keys));
+        }
+    }
+    async untrackKey(key) {
+        if (key === KEYS_REGISTRY)
+            return;
+        const keys = await this.getAllKeys();
+        const filtered = keys.filter((k) => k !== key);
+        if (filtered.length !== keys.length) {
+            await this.store.setItemAsync(KEYS_REGISTRY, JSON.stringify(filtered));
+        }
+    }
+}
+//# sourceMappingURL=secure-backend.js.map

package/dist/kv-backends/secure-backend.js.map

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

package/dist/kv-store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * KVStore factory
+ *
+ * Creates a unified async key-value store backed by either:
+ * - MMKV (default) — fast, for preferences/caches
+ * - SecureStore (secure: true) — for tokens/secrets
+ */
+import type { KVStore, KVStoreConfig } from './types';
+/**
+ * Create a KVStore instance.
+ *
+ * @example
+ * ```typescript
+ * // Default MMKV store for preferences
+ * const prefs = createKVStore()
+ * await prefs.set('theme', 'dark')
+ *
+ * // Isolated MMKV instance
+ * const cache = createKVStore({ instanceId: 'api-cache' })
+ *
+ * // Secure store for tokens
+ * const tokens = createKVStore({ secure: true })
+ * await tokens.set('accessToken', 'jwt...')
+ * ```
+ */
+export declare function createKVStore(config?: KVStoreConfig): KVStore;
+//# sourceMappingURL=kv-store.d.ts.map

package/dist/kv-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv-store.d.ts","sourceRoot":"","sources":["../src/kv-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAIrD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAQjE"}

package/dist/kv-store.js

@@ -0,0 +1,34 @@
+/**
+ * KVStore factory
+ *
+ * Creates a unified async key-value store backed by either:
+ * - MMKV (default) — fast, for preferences/caches
+ * - SecureStore (secure: true) — for tokens/secrets
+ */
+import { MMKVBackend } from './kv-backends/mmkv-backend';
+import { SecureBackend } from './kv-backends/secure-backend';
+/**
+ * Create a KVStore instance.
+ *
+ * @example
+ * ```typescript
+ * // Default MMKV store for preferences
+ * const prefs = createKVStore()
+ * await prefs.set('theme', 'dark')
+ *
+ * // Isolated MMKV instance
+ * const cache = createKVStore({ instanceId: 'api-cache' })
+ *
+ * // Secure store for tokens
+ * const tokens = createKVStore({ secure: true })
+ * await tokens.set('accessToken', 'jwt...')
+ * ```
+ */
+export function createKVStore(config = {}) {
+    const { secure = false, instanceId = 'mongrov-kv' } = config;
+    if (secure) {
+        return new SecureBackend();
+    }
+    return new MMKVBackend(instanceId);
+}
+//# sourceMappingURL=kv-store.js.map

package/dist/kv-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv-store.js","sourceRoot":"","sources":["../src/kv-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,SAAwB,EAAE;IACtD,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,UAAU,GAAG,YAAY,EAAE,GAAG,MAAM,CAAA;IAE5D,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,aAAa,EAAE,CAAA;IAC5B,CAAC;IAED,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,CAAA;AACpC,CAAC"}

package/dist/replication.d.ts

@@ -0,0 +1,69 @@
+/**
+ * RxDB Replication Helper
+ *
+ * Thin wrapper over rxdb/plugins/replication for creating replication states.
+ * App provides push/pull handlers that connect to their backend (e.g., collab adapter).
+ */
+import type { ReplicationConfig, RxReplicationStateType } from './types';
+/**
+ * Creates a replication state for syncing a collection with a remote backend.
+ *
+ * This is a thin wrapper over RxDB's replication plugin. The app provides
+ * push/pull handlers that connect to their backend (e.g., @mongrov/collab adapter).
+ *
+ * @param config - Replication configuration
+ * @returns RxDB replication state instance
+ *
+ * @example
+ * ```typescript
+ * import { createReplicationState } from '@mongrov/db'
+ *
+ * // Create replication with push/pull handlers
+ * const replication = createReplicationState({
+ *   replicationIdentifier: 'messages-sync',
+ *   collection: db.messages,
+ *   push: {
+ *     handler: async (docs) => {
+ *       // Send changes to backend via collab adapter
+ *       await collabAdapter.pushMessages(docs)
+ *     },
+ *   },
+ *   pull: {
+ *     handler: async (checkpoint, batchSize) => {
+ *       // Fetch changes from backend
+ *       const result = await collabAdapter.pullMessages(checkpoint, batchSize)
+ *       return {
+ *         documents: result.messages,
+ *         checkpoint: result.checkpoint,
+ *       }
+ *     },
+ *   },
+ *   live: true, // Enable real-time sync
+ * })
+ *
+ * // Listen for sync events
+ * replication.error$.subscribe((error) => {
+ *   console.error('Sync error:', error)
+ * })
+ *
+ * // Manual sync trigger
+ * await replication.reSync()
+ *
+ * // Stop replication
+ * await replication.cancel()
+ * ```
+ */
+export declare function createReplicationState<T>(config: ReplicationConfig<T>): RxReplicationStateType;
+/**
+ * Cancels a replication state and cleans up resources.
+ *
+ * @param replicationState - The replication state to cancel
+ */
+export declare function cancelReplication(replicationState: RxReplicationStateType): Promise<void>;
+/**
+ * Triggers a manual sync cycle for a replication state.
+ *
+ * @param replicationState - The replication state to sync
+ */
+export declare function resyncReplication(replicationState: RxReplicationStateType): Promise<void>;
+//# sourceMappingURL=replication.d.ts.map