mindcache 3.5.1 → 3.5.3

package/dist/{CloudAdapter-CM7nyJaG.d.mts → CloudAdapter-DK4YecbV.d.mts}

@@ -592,6 +592,10 @@ declare class CloudAdapter {
     private handleOffline;
     private _synced;
     constructor(config: CloudConfig);
+    /**
+     * Validate configuration and warn about common mistakes
+     */
+    private validateConfig;
     /** Browser network status - instantly updated via navigator.onLine */
     get isOnline(): boolean;
     private setupNetworkDetection;

package/dist/{CloudAdapter-CM7nyJaG.d.ts → CloudAdapter-DK4YecbV.d.ts}

@@ -592,6 +592,10 @@ declare class CloudAdapter {
     private handleOffline;
     private _synced;
     constructor(config: CloudConfig);
+    /**
+     * Validate configuration and warn about common mistakes
+     */
+    private validateConfig;
     /** Browser network status - instantly updated via navigator.onLine */
     get isOnline(): boolean;
     private setupNetworkDetection;

package/dist/cloud/index.d.mts

@@ -1,5 +1,5 @@
-import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-CM7nyJaG.mjs';
-export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-CM7nyJaG.mjs';
+import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-DK4YecbV.mjs';
+export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-DK4YecbV.mjs';
 import 'yjs';
 
 /**

package/dist/cloud/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-CM7nyJaG.js';
-export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-CM7nyJaG.js';
+import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-DK4YecbV.js';
+export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-DK4YecbV.js';
 import 'yjs';
 
 /**

package/dist/cloud/index.js

@@ -211,6 +211,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.validateConfig(config);
         this.setupNetworkDetection();
       }
       ws = null;
@@ -226,6 +227,43 @@ var init_CloudAdapter = __esm({
       handleOnline = null;
       handleOffline = null;
       _synced = false;
+      /**
+       * Validate configuration and warn about common mistakes
+       */
+      validateConfig(config) {
+        const baseUrl = config.baseUrl;
+        if (!baseUrl) {
+          return;
+        }
+        console.log("\u2601\uFE0F MindCache Cloud Config:", {
+          baseUrl,
+          instanceId: config.instanceId,
+          hasTokenProvider: !!config.tokenProvider,
+          hasApiKey: !!config.apiKey
+        });
+        try {
+          const url = new URL(baseUrl);
+          if (url.hostname === "mindcache.dev") {
+            console.error(
+              '\u26A0\uFE0F MindCache Cloud WARNING: baseUrl is set to "mindcache.dev" but the API is at "api.mindcache.dev".\n   Current: ' + baseUrl + "\n   Expected: https://api.mindcache.dev\n   This will cause WebSocket connection failures (404 errors)."
+            );
+          }
+          if (url.protocol === "ws:" || url.protocol === "wss:") {
+            console.warn(
+              "\u26A0\uFE0F MindCache Cloud: baseUrl uses WebSocket protocol (" + url.protocol + "). Consider using http:// or https:// - CloudAdapter will handle the WebSocket upgrade automatically."
+            );
+          }
+          if (url.hostname === "localhost" && url.port !== "8787" && url.port !== "3000") {
+            console.warn(
+              "\u26A0\uFE0F MindCache Cloud: localhost URL detected with non-standard port " + url.port + ". Default MindCache dev server runs on port 8787."
+            );
+          }
+          const wsUrl = baseUrl.replace("https://", "wss://").replace("http://", "ws://");
+          console.log("\u2601\uFE0F WebSocket will connect to:", wsUrl + "/sync/" + config.instanceId);
+        } catch (e) {
+          console.error("\u26A0\uFE0F MindCache Cloud: Invalid baseUrl format:", baseUrl);
+        }
+      }
       /** Browser network status - instantly updated via navigator.onLine */
       get isOnline() {
         return this._isOnline;