mindcache 3.5.1 → 3.5.3

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';
 
@@ -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

@@ -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';
 
@@ -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

@@ -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;
@@ -2650,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);
@@ -2688,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
      */