mindcache 3.5.0 → 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';
 
@@ -20,6 +20,8 @@ interface OAuthConfig {
     authUrl?: string;
     /** MindCache token URL (default: production) */
     tokenUrl?: string;
+    /** MindCache API URL for WebSocket token exchange (default: production) */
+    apiUrl?: string;
     /** Use PKCE for security (default: true) */
     usePKCE?: boolean;
     /** Storage key prefix (default: 'mindcache_oauth') */
@@ -109,10 +111,16 @@ declare class OAuthClient {
        */
     private clearAuth;
     /**
-       * Token provider function for MindCache cloud config
-       * Use this with MindCacheCloudOptions.tokenProvider
-       */
+     * Token provider for MindCache cloud config
+     * This fetches a WebSocket token (short-lived) using the OAuth access token
+     * Use this with MindCacheCloudOptions.tokenProvider
+     */
     tokenProvider: () => Promise<string>;
+    /**
+     * Get raw OAuth access token (for API calls, not WebSocket)
+     * Use getAccessToken() for most cases
+     */
+    accessTokenProvider: () => Promise<string>;
     private getStorage;
     private setStorage;
     private removeStorage;

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';
 
@@ -20,6 +20,8 @@ interface OAuthConfig {
     authUrl?: string;
     /** MindCache token URL (default: production) */
     tokenUrl?: string;
+    /** MindCache API URL for WebSocket token exchange (default: production) */
+    apiUrl?: string;
     /** Use PKCE for security (default: true) */
     usePKCE?: boolean;
     /** Storage key prefix (default: 'mindcache_oauth') */
@@ -109,10 +111,16 @@ declare class OAuthClient {
        */
     private clearAuth;
     /**
-       * Token provider function for MindCache cloud config
-       * Use this with MindCacheCloudOptions.tokenProvider
-       */
+     * Token provider for MindCache cloud config
+     * This fetches a WebSocket token (short-lived) using the OAuth access token
+     * Use this with MindCacheCloudOptions.tokenProvider
+     */
     tokenProvider: () => Promise<string>;
+    /**
+     * Get raw OAuth access token (for API calls, not WebSocket)
+     * Use getAccessToken() for most cases
+     */
+    accessTokenProvider: () => Promise<string>;
     private getStorage;
     private setStorage;
     private removeStorage;

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;
@@ -395,10 +433,12 @@ var init_CloudAdapter = __esm({
           try {
             if (typeof event.data === "string") {
               const msg = JSON.parse(event.data);
+              console.log("\u2601\uFE0F CloudAdapter: Received JSON message:", msg.type, msg);
               if (msg.type === "auth_success") {
                 this._state = "connected";
                 this.reconnectAttempts = 0;
                 this.emit("connected");
+                console.log("\u2601\uFE0F Connected to MindCache cloud");
               } else if (msg.type === "auth_error" || msg.type === "error") {
                 this._state = "error";
                 this.emit("error", new Error(msg.error));
@@ -406,6 +446,7 @@ var init_CloudAdapter = __esm({
                 console.debug("MindCache Cloud: Received message type:", msg.type, msg);
               }
             } else {
+              console.log("\u2601\uFE0F CloudAdapter: Received binary message, length:", event.data.byteLength);
               const encoder = encoding__namespace.createEncoder();
               const decoder = decoding__namespace.createDecoder(new Uint8Array(event.data));
               if (this.mindcache) {
@@ -416,6 +457,7 @@ var init_CloudAdapter = __esm({
                 if (!this._synced && (messageType === 1 || messageType === 2)) {
                   this._synced = true;
                   this.emit("synced");
+                  console.log("\u2601\uFE0F Synced with cloud");
                 }
               }
             }
@@ -2690,6 +2732,7 @@ var OAuthClient = class {
       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", ""),
       usePKCE: config.usePKCE !== false,
       // Default true
       storagePrefix: config.storagePrefix || "mindcache_oauth"
@@ -2914,10 +2957,39 @@ var OAuthClient = class {
     this.removeStorage("tokens");
   }
   /**
-     * Token provider function for MindCache cloud config
-     * Use this with MindCacheCloudOptions.tokenProvider
-     */
+   * Token provider for MindCache cloud config
+   * This fetches a WebSocket token (short-lived) using the OAuth access token
+   * Use this with MindCacheCloudOptions.tokenProvider
+   */
   tokenProvider = async () => {
+    const accessToken = await this.getAccessToken();
+    const instanceId = this.getInstanceId();
+    if (!instanceId) {
+      throw new Error("No instance ID available. Complete OAuth flow first.");
+    }
+    const response = await fetch(`${this.config.apiUrl}/api/ws-token`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${accessToken}`
+      },
+      body: JSON.stringify({
+        instanceId,
+        permission: "write"
+      })
+    });
+    if (!response.ok) {
+      const data2 = await response.json().catch(() => ({}));
+      throw new Error(data2.error || "Failed to get WebSocket token");
+    }
+    const data = await response.json();
+    return data.token;
+  };
+  /**
+   * Get raw OAuth access token (for API calls, not WebSocket)
+   * Use getAccessToken() for most cases
+   */
+  accessTokenProvider = async () => {
     return this.getAccessToken();
   };
   // Storage helpers