mindcache 3.5.2 → 3.5.3

package/dist/index.d.mts

@@ -16,11 +16,18 @@ interface OAuthConfig {
     redirectUri?: string;
     /** Scopes to request (default: ['read', 'write']) */
     scopes?: string[];
-    /** MindCache authorize URL (default: production) */
+    /**
+     * MindCache API base URL (default: 'https://api.mindcache.dev')
+     * This is the ONLY URL you need to set! All OAuth endpoints are derived from this.
+     * - authUrl = baseUrl + '/oauth/authorize'
+     * - tokenUrl = baseUrl + '/oauth/token'
+     */
+    baseUrl?: string;
+    /** @deprecated Use baseUrl instead. MindCache authorize URL */
     authUrl?: string;
-    /** MindCache token URL (default: production) */
+    /** @deprecated Use baseUrl instead. MindCache token URL */
     tokenUrl?: string;
-    /** MindCache API URL for WebSocket token exchange (default: production) */
+    /** @deprecated Use baseUrl instead. MindCache API URL */
     apiUrl?: string;
     /** Use PKCE for security (default: true) */
     usePKCE?: boolean;
@@ -62,6 +69,10 @@ declare class OAuthClient {
     private tokens;
     private refreshPromise;
     constructor(config: OAuthConfig);
+    /**
+     * Validate the API is reachable and warn about common misconfigurations
+     */
+    private validateApi;
     /**
        * Check if user is authenticated
        */

package/dist/index.d.ts

@@ -16,11 +16,18 @@ interface OAuthConfig {
     redirectUri?: string;
     /** Scopes to request (default: ['read', 'write']) */
     scopes?: string[];
-    /** MindCache authorize URL (default: production) */
+    /**
+     * MindCache API base URL (default: 'https://api.mindcache.dev')
+     * This is the ONLY URL you need to set! All OAuth endpoints are derived from this.
+     * - authUrl = baseUrl + '/oauth/authorize'
+     * - tokenUrl = baseUrl + '/oauth/token'
+     */
+    baseUrl?: string;
+    /** @deprecated Use baseUrl instead. MindCache authorize URL */
     authUrl?: string;
-    /** MindCache token URL (default: production) */
+    /** @deprecated Use baseUrl instead. MindCache token URL */
     tokenUrl?: string;
-    /** MindCache API URL for WebSocket token exchange (default: production) */
+    /** @deprecated Use baseUrl instead. MindCache API URL */
     apiUrl?: string;
     /** Use PKCE for security (default: true) */
     usePKCE?: boolean;
@@ -62,6 +69,10 @@ declare class OAuthClient {
     private tokens;
     private refreshPromise;
     constructor(config: OAuthConfig);
+    /**
+     * Validate the API is reachable and warn about common misconfigurations
+     */
+    private validateApi;
     /**
        * Check if user is authenticated
        */

package/dist/index.js

@@ -2688,9 +2688,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);
@@ -2726,19 +2725,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
      */