mindcache 3.3.1 → 3.4.0

package/dist/{CloudAdapter-BgpqZE00.d.mts → CloudAdapter-WvuWM4fD.d.mts}

@@ -142,7 +142,7 @@ declare class MindCache {
     private rootMap;
     private listeners;
     private globalListeners;
-    readonly version = "3.3.1";
+    readonly version = "3.3.2";
     private _isRemoteUpdate;
     private normalizeSystemTags;
     private _cloudAdapter;
@@ -212,6 +212,11 @@ declare class MindCache {
     get isLoaded(): boolean;
     protected _getCloudAdapterClass(): Promise<any>;
     get isCloud(): boolean;
+    /**
+     * Browser network status. Returns true if online or in local-only mode.
+     * In cloud mode, this updates instantly when network status changes.
+     */
+    get isOnline(): boolean;
     waitForSync(): Promise<void>;
     disconnect(): void;
     isRemoteUpdate(): boolean;
@@ -401,11 +406,6 @@ declare class MindCache {
      * @returns Y.Text or undefined if key doesn't exist or isn't a document
      */
     get_document(key: string): Y.Text | undefined;
-    /**
-     * Get plain text content of a document key.
-     * For collaborative editing, use get_document() and bind to an editor.
-     */
-    get_document_text(key: string): string | undefined;
     /**
      * Insert text at a position in a document key.
      */
@@ -415,15 +415,11 @@ declare class MindCache {
      */
     delete_text(key: string, index: number, length: number): void;
     /**
-     * Replace all text in a document key.
+     * Replace all text in a document key (private - use set_value for public API).
      * Uses diff-based updates when changes are < diffThreshold (default 80%).
      * This preserves concurrent edits and provides better undo granularity.
-     *
-     * @param key - The document key
-     * @param newText - The new text content
-     * @param diffThreshold - Percentage (0-1) of change above which full replace is used (default: 0.8)
      */
-    replace_document_text(key: string, newText: string, diffThreshold?: number): void;
+    private _replaceDocumentText;
     subscribe(key: string, listener: Listener): () => void;
     subscribeToAll(listener: GlobalListener): () => void;
     unsubscribeFromAll(listener: GlobalListener): void;
@@ -498,6 +494,8 @@ interface CloudAdapterEvents {
     disconnected: () => void;
     error: (error: Error) => void;
     synced: () => void;
+    network_online: () => void;
+    network_offline: () => void;
 }
 
 declare class CloudAdapter {
@@ -508,9 +506,16 @@ declare class CloudAdapter {
     private reconnectAttempts;
     private reconnectTimeout;
     private _state;
+    private _isOnline;
     private listeners;
     private token;
+    private handleOnline;
+    private handleOffline;
     constructor(config: CloudConfig);
+    /** Browser network status - instantly updated via navigator.onLine */
+    get isOnline(): boolean;
+    private setupNetworkDetection;
+    private cleanupNetworkDetection;
     setToken(token: string): void;
     setTokenProvider(provider: () => Promise<string>): void;
     get state(): ConnectionState;

package/dist/{CloudAdapter-BgpqZE00.d.ts → CloudAdapter-WvuWM4fD.d.ts}

@@ -142,7 +142,7 @@ declare class MindCache {
     private rootMap;
     private listeners;
     private globalListeners;
-    readonly version = "3.3.1";
+    readonly version = "3.3.2";
     private _isRemoteUpdate;
     private normalizeSystemTags;
     private _cloudAdapter;
@@ -212,6 +212,11 @@ declare class MindCache {
     get isLoaded(): boolean;
     protected _getCloudAdapterClass(): Promise<any>;
     get isCloud(): boolean;
+    /**
+     * Browser network status. Returns true if online or in local-only mode.
+     * In cloud mode, this updates instantly when network status changes.
+     */
+    get isOnline(): boolean;
     waitForSync(): Promise<void>;
     disconnect(): void;
     isRemoteUpdate(): boolean;
@@ -401,11 +406,6 @@ declare class MindCache {
      * @returns Y.Text or undefined if key doesn't exist or isn't a document
      */
     get_document(key: string): Y.Text | undefined;
-    /**
-     * Get plain text content of a document key.
-     * For collaborative editing, use get_document() and bind to an editor.
-     */
-    get_document_text(key: string): string | undefined;
     /**
      * Insert text at a position in a document key.
      */
@@ -415,15 +415,11 @@ declare class MindCache {
      */
     delete_text(key: string, index: number, length: number): void;
     /**
-     * Replace all text in a document key.
+     * Replace all text in a document key (private - use set_value for public API).
      * Uses diff-based updates when changes are < diffThreshold (default 80%).
      * This preserves concurrent edits and provides better undo granularity.
-     *
-     * @param key - The document key
-     * @param newText - The new text content
-     * @param diffThreshold - Percentage (0-1) of change above which full replace is used (default: 0.8)
      */
-    replace_document_text(key: string, newText: string, diffThreshold?: number): void;
+    private _replaceDocumentText;
     subscribe(key: string, listener: Listener): () => void;
     subscribeToAll(listener: GlobalListener): () => void;
     unsubscribeFromAll(listener: GlobalListener): void;
@@ -498,6 +494,8 @@ interface CloudAdapterEvents {
     disconnected: () => void;
     error: (error: Error) => void;
     synced: () => void;
+    network_online: () => void;
+    network_offline: () => void;
 }
 
 declare class CloudAdapter {
@@ -508,9 +506,16 @@ declare class CloudAdapter {
     private reconnectAttempts;
     private reconnectTimeout;
     private _state;
+    private _isOnline;
     private listeners;
     private token;
+    private handleOnline;
+    private handleOffline;
     constructor(config: CloudConfig);
+    /** Browser network status - instantly updated via navigator.onLine */
+    get isOnline(): boolean;
+    private setupNetworkDetection;
+    private cleanupNetworkDetection;
     setToken(token: string): void;
     setTokenProvider(provider: () => Promise<string>): void;
     get state(): ConnectionState;

package/dist/cloud/index.d.mts

@@ -1,5 +1,5 @@
-import { M as MindCache, h as CloudConfig, C as CloudAdapter } from '../CloudAdapter-BgpqZE00.mjs';
-export { m as ClearOperation, j as CloudAdapterEvents, i as ConnectionState, l as DeleteOperation, O as Operation, k as SetOperation } from '../CloudAdapter-BgpqZE00.mjs';
+import { M as MindCache, h as CloudConfig, C as CloudAdapter } from '../CloudAdapter-WvuWM4fD.mjs';
+export { m as ClearOperation, j as CloudAdapterEvents, i as ConnectionState, l as DeleteOperation, O as Operation, k as SetOperation } from '../CloudAdapter-WvuWM4fD.mjs';
 import 'yjs';
 
 /**

package/dist/cloud/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindCache, h as CloudConfig, C as CloudAdapter } from '../CloudAdapter-BgpqZE00.js';
-export { m as ClearOperation, j as CloudAdapterEvents, i as ConnectionState, l as DeleteOperation, O as Operation, k as SetOperation } from '../CloudAdapter-BgpqZE00.js';
+import { M as MindCache, h as CloudConfig, C as CloudAdapter } from '../CloudAdapter-WvuWM4fD.js';
+export { m as ClearOperation, j as CloudAdapterEvents, i as ConnectionState, l as DeleteOperation, O as Operation, k as SetOperation } from '../CloudAdapter-WvuWM4fD.js';
 import 'yjs';
 
 /**

package/dist/cloud/index.js

@@ -210,6 +210,7 @@ var init_CloudAdapter = __esm({
         if (!config.baseUrl) {
           throw new Error("MindCache Cloud: baseUrl is required. Please provide the cloud API URL in your configuration.");
         }
+        this.setupNetworkDetection();
       }
       ws = null;
       mindcache = null;
@@ -217,8 +218,52 @@ var init_CloudAdapter = __esm({
       reconnectAttempts = 0;
       reconnectTimeout = null;
       _state = "disconnected";
+      _isOnline = true;
+      // Browser network status
       listeners = {};
       token = null;
+      handleOnline = null;
+      handleOffline = null;
+      /** Browser network status - instantly updated via navigator.onLine */
+      get isOnline() {
+        return this._isOnline;
+      }
+      setupNetworkDetection() {
+        if (typeof window === "undefined" || typeof navigator === "undefined") {
+          return;
+        }
+        this._isOnline = navigator.onLine;
+        this.handleOnline = () => {
+          console.log("\u2601\uFE0F CloudAdapter: Network is back online");
+          this._isOnline = true;
+          this.emit("network_online");
+          if (this._state === "disconnected" || this._state === "error") {
+            this.connect();
+          }
+        };
+        this.handleOffline = () => {
+          console.log("\u2601\uFE0F CloudAdapter: Network went offline");
+          this._isOnline = false;
+          this.emit("network_offline");
+          if (this._state === "connected" || this._state === "connecting") {
+            this._state = "disconnected";
+            this.emit("disconnected");
+          }
+        };
+        window.addEventListener("online", this.handleOnline);
+        window.addEventListener("offline", this.handleOffline);
+      }
+      cleanupNetworkDetection() {
+        if (typeof window === "undefined") {
+          return;
+        }
+        if (this.handleOnline) {
+          window.removeEventListener("online", this.handleOnline);
+        }
+        if (this.handleOffline) {
+          window.removeEventListener("offline", this.handleOffline);
+        }
+      }
       setToken(token) {
         this.token = token;
       }
@@ -312,6 +357,7 @@ var init_CloudAdapter = __esm({
           this.ws.close();
           this.ws = null;
         }
+        this.cleanupNetworkDetection();
         this._state = "disconnected";
         this.emit("disconnected");
       }
@@ -428,7 +474,7 @@ var MindCache = class {
   listeners = {};
   globalListeners = [];
   // Metadata
-  version = "3.3.1";
+  version = "3.3.2";
   // Internal flag to prevent sync loops when receiving remote updates
   // (Less critical with Yjs but kept for API compat)
   _isRemoteUpdate = false;
@@ -501,14 +547,30 @@ var MindCache = class {
               break;
             }
           }
+        } else {
+          let current = event.target;
+          while (current && current.parent) {
+            if (current.parent.parent === this.rootMap) {
+              for (const [key, val] of this.rootMap) {
+                if (val === current.parent) {
+                  keysAffected.add(key);
+                  break;
+                }
+              }
+              break;
+            }
+            current = current.parent;
+          }
         }
       });
       keysAffected.forEach((key) => {
         const entryMap = this.rootMap.get(key);
         if (entryMap) {
           const value = entryMap.get("value");
+          const attrs = entryMap.get("attributes");
+          const resolvedValue = attrs?.type === "document" && value instanceof Y__namespace.Text ? value.toString() : value;
           if (this.listeners[key]) {
-            this.listeners[key].forEach((l) => l(value));
+            this.listeners[key].forEach((l) => l(resolvedValue));
           }
         } else {
           if (this.listeners[key]) {
@@ -638,12 +700,19 @@ var MindCache = class {
         if (event.target === this.rootMap) {
           const mapEvent = event;
           mapEvent.keysChanged.forEach((key) => keysAffected.add(key));
-        } else if (event.target.parent === this.rootMap) {
-          for (const [key, val] of this.rootMap) {
-            if (val === event.target) {
-              keysAffected.add(key);
+        } else {
+          let current = event.target;
+          while (current && current.parent) {
+            if (current.parent === this.rootMap) {
+              for (const [key, val] of this.rootMap) {
+                if (val === current) {
+                  keysAffected.add(key);
+                  break;
+                }
+              }
               break;
             }
+            current = current.parent;
           }
         }
       });
@@ -783,6 +852,19 @@ var MindCache = class {
   get isCloud() {
     return this._cloudConfig !== null;
   }
+  /**
+   * Browser network status. Returns true if online or in local-only mode.
+   * In cloud mode, this updates instantly when network status changes.
+   */
+  get isOnline() {
+    if (!this._cloudAdapter) {
+      if (typeof navigator !== "undefined") {
+        return navigator.onLine;
+      }
+      return true;
+    }
+    return this._cloudAdapter.isOnline;
+  }
   async waitForSync() {
     if (this._isLoaded) {
       return;
@@ -1027,11 +1109,15 @@ var MindCache = class {
       const existingAttrs = existingEntry.get("attributes");
       if (existingAttrs?.type === "document") {
         if (typeof value === "string") {
-          this.replace_document_text(key, value);
+          this._replaceDocumentText(key, value);
         }
         return;
       }
     }
+    if (!existingEntry && attributes?.type === "document") {
+      this.set_document(key, typeof value === "string" ? value : "", attributes);
+      return;
+    }
     let entryMap = this.rootMap.get(key);
     const isNewEntry = !entryMap;
     if (isNewEntry) {
@@ -1772,14 +1858,6 @@ var MindCache = class {
     }
     return void 0;
   }
-  /**
-   * Get plain text content of a document key.
-   * For collaborative editing, use get_document() and bind to an editor.
-   */
-  get_document_text(key) {
-    const yText = this.get_document(key);
-    return yText?.toString();
-  }
   /**
    * Insert text at a position in a document key.
    */
@@ -1799,15 +1877,11 @@ var MindCache = class {
     }
   }
   /**
-   * Replace all text in a document key.
+   * Replace all text in a document key (private - use set_value for public API).
    * Uses diff-based updates when changes are < diffThreshold (default 80%).
    * This preserves concurrent edits and provides better undo granularity.
-   *
-   * @param key - The document key
-   * @param newText - The new text content
-   * @param diffThreshold - Percentage (0-1) of change above which full replace is used (default: 0.8)
    */
-  replace_document_text(key, newText, diffThreshold = 0.8) {
+  _replaceDocumentText(key, newText, diffThreshold = 0.8) {
     const yText = this.get_document(key);
     if (!yText) {
       return;
@@ -1913,7 +1987,7 @@ var MindCache = class {
         },
         execute: async ({ value }) => {
           if (isDocument) {
-            this.replace_document_text(key, value);
+            this._replaceDocumentText(key, value);
           } else {
             this.set_value(key, value);
           }
@@ -2069,7 +2143,7 @@ var MindCache = class {
     switch (action) {
       case "write":
         if (isDocument) {
-          this.replace_document_text(key, value);
+          this._replaceDocumentText(key, value);
         } else {
           this.set_value(key, value);
         }