mindcache 2.2.0 → 2.4.0

package/dist/index.d.mts

@@ -1 +1,61 @@
-export { a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, i as DEFAULT_KEY_ATTRIBUTES, K as KeyAttributes, L as Listener, M as MindCache, h as MindCacheCloudOptions, g as MindCacheOptions, e as STM, f as STMEntry, m as mindcache } from './index-XM7bmK7C.mjs';
+import { M as MindCache, a as MindCacheOptions } from './CloudAdapter-B04-OWx3.mjs';
+export { C as CloudAdapter, g as CloudAdapterEvents, e as CloudConfig, f as ConnectionState, D as DEFAULT_KEY_ATTRIBUTES, K as KeyAttributes, L as Listener, c as MindCacheCloudOptions, d as MindCacheIndexedDBOptions, S as STM, b as STMEntry, m as mindcache } from './CloudAdapter-B04-OWx3.mjs';
+
+interface IndexedDBConfig {
+    /** Database name (defaults to 'mindcache_db') */
+    dbName?: string;
+    /** Store name (defaults to 'mindcache_store') */
+    storeName?: string;
+    /** Storage key (defaults to 'mindcache_data') */
+    key?: string;
+    /** Debounce time in ms for saving (defaults to 1000) */
+    debounceMs?: number;
+}
+declare class IndexedDBAdapter {
+    private config;
+    private mindcache;
+    private unsubscribe;
+    private saveTimeout;
+    private db;
+    private dbName;
+    private storeName;
+    private key;
+    constructor(config?: IndexedDBConfig);
+    attach(mc: MindCache): Promise<void>;
+    detach(): void;
+    private initDB;
+    private load;
+    private scheduleSave;
+    private save;
+}
+
+interface UseMindCacheResult {
+    /** The MindCache instance, null until loaded */
+    mindcache: MindCache | null;
+    /** Whether the MindCache is fully loaded and ready to use */
+    isLoaded: boolean;
+    /** Any error that occurred during initialization */
+    error: Error | null;
+}
+/**
+ * React hook for using MindCache with automatic lifecycle management.
+ *
+ * Handles async initialization (IndexedDB/Cloud) and provides loading state.
+ * The MindCache instance is created once and persists across re-renders.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { mindcache, isLoaded } = useMindCache({
+ *     indexedDB: { dbName: 'my-app' }
+ *   });
+ *
+ *   if (!isLoaded) return <Loading />;
+ *
+ *   return <div>{mindcache.get_value('key')}</div>;
+ * }
+ * ```
+ */
+declare function useMindCache(options?: MindCacheOptions): UseMindCacheResult;
+
+export { IndexedDBAdapter, type IndexedDBConfig, MindCache, MindCacheOptions, type UseMindCacheResult, useMindCache };

package/dist/index.d.ts

@@ -1 +1,61 @@
-export { a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, i as DEFAULT_KEY_ATTRIBUTES, K as KeyAttributes, L as Listener, M as MindCache, h as MindCacheCloudOptions, g as MindCacheOptions, e as STM, f as STMEntry, m as mindcache } from './index-XM7bmK7C.js';
+import { M as MindCache, a as MindCacheOptions } from './CloudAdapter-B04-OWx3.js';
+export { C as CloudAdapter, g as CloudAdapterEvents, e as CloudConfig, f as ConnectionState, D as DEFAULT_KEY_ATTRIBUTES, K as KeyAttributes, L as Listener, c as MindCacheCloudOptions, d as MindCacheIndexedDBOptions, S as STM, b as STMEntry, m as mindcache } from './CloudAdapter-B04-OWx3.js';
+
+interface IndexedDBConfig {
+    /** Database name (defaults to 'mindcache_db') */
+    dbName?: string;
+    /** Store name (defaults to 'mindcache_store') */
+    storeName?: string;
+    /** Storage key (defaults to 'mindcache_data') */
+    key?: string;
+    /** Debounce time in ms for saving (defaults to 1000) */
+    debounceMs?: number;
+}
+declare class IndexedDBAdapter {
+    private config;
+    private mindcache;
+    private unsubscribe;
+    private saveTimeout;
+    private db;
+    private dbName;
+    private storeName;
+    private key;
+    constructor(config?: IndexedDBConfig);
+    attach(mc: MindCache): Promise<void>;
+    detach(): void;
+    private initDB;
+    private load;
+    private scheduleSave;
+    private save;
+}
+
+interface UseMindCacheResult {
+    /** The MindCache instance, null until loaded */
+    mindcache: MindCache | null;
+    /** Whether the MindCache is fully loaded and ready to use */
+    isLoaded: boolean;
+    /** Any error that occurred during initialization */
+    error: Error | null;
+}
+/**
+ * React hook for using MindCache with automatic lifecycle management.
+ *
+ * Handles async initialization (IndexedDB/Cloud) and provides loading state.
+ * The MindCache instance is created once and persists across re-renders.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { mindcache, isLoaded } = useMindCache({
+ *     indexedDB: { dbName: 'my-app' }
+ *   });
+ *
+ *   if (!isLoaded) return <Loading />;
+ *
+ *   return <div>{mindcache.get_value('key')}</div>;
+ * }
+ * ```
+ */
+declare function useMindCache(options?: MindCacheOptions): UseMindCacheResult;
+
+export { IndexedDBAdapter, type IndexedDBConfig, MindCache, MindCacheOptions, type UseMindCacheResult, useMindCache };