mindcache 3.5.1 → 3.5.3

package/dist/index.mjs

@@ -184,6 +184,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;
@@ -199,6 +200,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;
@@ -2622,9 +2660,8 @@ init_CloudAdapter();
 init_CloudAdapter();
 
 // src/cloud/OAuthClient.ts
-var DEFAULT_AUTH_URL = "https://api.mindcache.dev/oauth/authorize";
-var DEFAULT_TOKEN_URL = "https://api.mindcache.dev/oauth/token";
-var DEFAULT_USERINFO_URL = "https://api.mindcache.dev/oauth/userinfo";
+var DEFAULT_API_URL = "https://api.mindcache.dev";
+var DEFAULT_USERINFO_URL = DEFAULT_API_URL + "/oauth/userinfo";
 var TOKEN_REFRESH_BUFFER = 5 * 60 * 1e3;
 function generateRandomString(length2) {
   const array = new Uint8Array(length2);
@@ -2660,19 +2697,58 @@ var OAuthClient = class {
       url.hash = "";
       redirectUri = url.toString();
     }
+    const baseUrl = config.baseUrl || config.apiUrl || DEFAULT_API_URL;
+    const authUrl = config.authUrl || baseUrl + "/oauth/authorize";
+    const tokenUrl = config.tokenUrl || baseUrl + "/oauth/token";
+    const apiUrl = config.apiUrl || baseUrl;
     this.config = {
       clientId: config.clientId,
       redirectUri: redirectUri || "",
       scopes: config.scopes || ["read", "write"],
-      authUrl: config.authUrl || DEFAULT_AUTH_URL,
-      tokenUrl: config.tokenUrl || DEFAULT_TOKEN_URL,
-      apiUrl: config.apiUrl || (config.tokenUrl || DEFAULT_TOKEN_URL).replace("/oauth/token", ""),
+      baseUrl,
+      authUrl,
+      tokenUrl,
+      apiUrl,
       usePKCE: config.usePKCE !== false,
       // Default true
       storagePrefix: config.storagePrefix || "mindcache_oauth"
     };
+    console.log("\u{1F510} MindCache OAuth Config:", {
+      baseUrl: this.config.baseUrl,
+      authUrl: this.config.authUrl,
+      tokenUrl: this.config.tokenUrl,
+      apiUrl: this.config.apiUrl,
+      clientId: this.config.clientId.substring(0, 20) + "..."
+    });
+    this.validateApi();
     this.loadTokens();
   }
+  /**
+   * Validate the API is reachable and warn about common misconfigurations
+   */
+  async validateApi() {
+    try {
+      const response = await fetch(`${this.config.apiUrl}/oauth/apps/info`, {
+        method: "GET",
+        headers: { "Accept": "application/json" }
+      });
+      if (response.status === 404) {
+        console.error(
+          "\u274C MindCache OAuth ERROR: API not found at " + this.config.apiUrl + '\n   The server returned 404. Common causes:\n   - Wrong domain: Use "api.mindcache.dev" not "mindcache.dev"\n   - Wrong port: Local dev server is usually on port 8787\n   - Server not running: Make sure the MindCache server is started'
+        );
+      } else if (!response.ok) {
+        console.warn(
+          "\u26A0\uFE0F MindCache OAuth: API responded with status " + response.status + "\n   URL: " + this.config.apiUrl
+        );
+      } else {
+        console.log("\u2705 MindCache OAuth: API is reachable at " + this.config.apiUrl);
+      }
+    } catch (error) {
+      console.error(
+        "\u274C MindCache OAuth ERROR: Cannot reach API at " + this.config.apiUrl + "\n   Error: " + (error instanceof Error ? error.message : String(error)) + "\n   Check your network connection and baseUrl configuration."
+      );
+    }
+  }
   /**
      * Check if user is authenticated
      */