mindcache 3.5.1 → 3.5.2

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { e as MindCacheOptions, M as MindCache } from './CloudAdapter-CM7nyJaG.mjs';
-export { A as AccessLevel, a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, h as ContextRules, n as DEFAULT_KEY_ATTRIBUTES, G as GlobalListener, H as HistoryEntry, k as HistoryOptions, K as KeyAttributes, j as KeyEntry, f as KeyType, L as Listener, l as MindCacheCloudOptions, m as MindCacheIndexedDBOptions, i as STM, j as STMEntry, g as SystemTag, o as SystemTagHelpers } from './CloudAdapter-CM7nyJaG.mjs';
+import { e as MindCacheOptions, M as MindCache } from './CloudAdapter-DK4YecbV.mjs';
+export { A as AccessLevel, a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, h as ContextRules, n as DEFAULT_KEY_ATTRIBUTES, G as GlobalListener, H as HistoryEntry, k as HistoryOptions, K as KeyAttributes, j as KeyEntry, f as KeyType, L as Listener, l as MindCacheCloudOptions, m as MindCacheIndexedDBOptions, i as STM, j as STMEntry, g as SystemTag, o as SystemTagHelpers } from './CloudAdapter-DK4YecbV.mjs';
 export { IndexedDBAdapter, IndexedDBConfig } from './server.mjs';
 import 'yjs';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { e as MindCacheOptions, M as MindCache } from './CloudAdapter-CM7nyJaG.js';
-export { A as AccessLevel, a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, h as ContextRules, n as DEFAULT_KEY_ATTRIBUTES, G as GlobalListener, H as HistoryEntry, k as HistoryOptions, K as KeyAttributes, j as KeyEntry, f as KeyType, L as Listener, l as MindCacheCloudOptions, m as MindCacheIndexedDBOptions, i as STM, j as STMEntry, g as SystemTag, o as SystemTagHelpers } from './CloudAdapter-CM7nyJaG.js';
+import { e as MindCacheOptions, M as MindCache } from './CloudAdapter-DK4YecbV.js';
+export { A as AccessLevel, a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, h as ContextRules, n as DEFAULT_KEY_ATTRIBUTES, G as GlobalListener, H as HistoryEntry, k as HistoryOptions, K as KeyAttributes, j as KeyEntry, f as KeyType, L as Listener, l as MindCacheCloudOptions, m as MindCacheIndexedDBOptions, i as STM, j as STMEntry, g as SystemTag, o as SystemTagHelpers } from './CloudAdapter-DK4YecbV.js';
 export { IndexedDBAdapter, IndexedDBConfig } from './server.js';
 import 'yjs';
 

package/dist/index.js

@@ -212,6 +212,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;
@@ -227,6 +228,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;