mindcache 3.4.3 → 3.5.0

package/dist/index.d.mts

@@ -1,8 +1,130 @@
-import { e as MindCacheOptions, M as MindCache } from './CloudAdapter-CJS3Sh4f.mjs';
-export { A as AccessLevel, a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, m as DEFAULT_KEY_ATTRIBUTES, G as GlobalListener, H as HistoryEntry, j as HistoryOptions, K as KeyAttributes, i as KeyEntry, f as KeyType, L as Listener, k as MindCacheCloudOptions, l as MindCacheIndexedDBOptions, h as STM, i as STMEntry, g as SystemTag, n as SystemTagHelpers } from './CloudAdapter-CJS3Sh4f.mjs';
+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';
 export { IndexedDBAdapter, IndexedDBConfig } from './server.mjs';
 import 'yjs';
 
+/**
+ * MindCache OAuth Client
+ *
+ * Browser-compatible OAuth 2.0 client for "Sign in with MindCache"
+ * Supports PKCE for secure authorization
+ */
+interface OAuthConfig {
+    /** Client ID from developer portal */
+    clientId: string;
+    /** Redirect URI (defaults to current URL) */
+    redirectUri?: string;
+    /** Scopes to request (default: ['read', 'write']) */
+    scopes?: string[];
+    /** MindCache authorize URL (default: production) */
+    authUrl?: string;
+    /** MindCache token URL (default: production) */
+    tokenUrl?: string;
+    /** Use PKCE for security (default: true) */
+    usePKCE?: boolean;
+    /** Storage key prefix (default: 'mindcache_oauth') */
+    storagePrefix?: string;
+}
+interface OAuthTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    scopes: string[];
+    instanceId?: string;
+}
+interface MindCacheUser {
+    id: string;
+    email?: string;
+    name?: string;
+    instanceId?: string;
+}
+/**
+ * OAuth client for browser applications
+ *
+ * @example
+ * ```typescript
+ * const oauth = new OAuthClient({ clientId: 'mc_app_abc123' });
+ *
+ * // Start OAuth flow
+ * await oauth.authorize();
+ *
+ * // Handle callback (on redirect page)
+ * const tokens = await oauth.handleCallback();
+ *
+ * // Get access token for API calls
+ * const token = await oauth.getAccessToken();
+ * ```
+ */
+declare class OAuthClient {
+    private config;
+    private tokens;
+    private refreshPromise;
+    constructor(config: OAuthConfig);
+    /**
+       * Check if user is authenticated
+       */
+    isAuthenticated(): boolean;
+    /**
+       * Get stored tokens (if any)
+       */
+    getTokens(): OAuthTokens | null;
+    /**
+       * Get instance ID for this user+app
+       */
+    getInstanceId(): string | null;
+    /**
+       * Start OAuth authorization flow
+       * Redirects to MindCache authorization page
+       */
+    authorize(options?: {
+        popup?: boolean;
+        state?: string;
+    }): Promise<void>;
+    /**
+       * Handle OAuth callback
+       * Call this on your redirect URI page
+       *
+       * @returns Tokens if successful
+       */
+    handleCallback(): Promise<OAuthTokens>;
+    /**
+       * Get a valid access token
+       * Automatically refreshes if needed
+       */
+    getAccessToken(): Promise<string>;
+    /**
+       * Refresh access token
+       */
+    private refreshTokens;
+    /**
+       * Get user info from MindCache
+       */
+    getUserInfo(): Promise<MindCacheUser>;
+    /**
+       * Logout - revoke tokens and clear storage
+       */
+    logout(): Promise<void>;
+    /**
+       * Clear authentication state
+       */
+    private clearAuth;
+    /**
+       * Token provider function for MindCache cloud config
+       * Use this with MindCacheCloudOptions.tokenProvider
+       */
+    tokenProvider: () => Promise<string>;
+    private getStorage;
+    private setStorage;
+    private removeStorage;
+    private clearStorage;
+    private loadTokens;
+    private saveTokens;
+}
+/**
+ * Create OAuth client with environment-appropriate defaults
+ */
+declare function createOAuthClient(config: OAuthConfig): OAuthClient;
+
 interface UseMindCacheResult {
     /** The MindCache instance, null until loaded */
     mindcache: MindCache | null;
@@ -34,4 +156,4 @@ declare function useMindCache(options?: MindCacheOptions): UseMindCacheResult;
 
 declare const mindcache: MindCache;
 
-export { MindCache, MindCacheOptions, type UseMindCacheResult, mindcache, useMindCache };
+export { MindCache, MindCacheOptions, type MindCacheUser, OAuthClient, type OAuthConfig, type OAuthTokens, type UseMindCacheResult, createOAuthClient, mindcache, useMindCache };

package/dist/index.d.ts

@@ -1,8 +1,130 @@
-import { e as MindCacheOptions, M as MindCache } from './CloudAdapter-CJS3Sh4f.js';
-export { A as AccessLevel, a as CloudAdapter, c as CloudAdapterEvents, C as CloudConfig, b as ConnectionState, m as DEFAULT_KEY_ATTRIBUTES, G as GlobalListener, H as HistoryEntry, j as HistoryOptions, K as KeyAttributes, i as KeyEntry, f as KeyType, L as Listener, k as MindCacheCloudOptions, l as MindCacheIndexedDBOptions, h as STM, i as STMEntry, g as SystemTag, n as SystemTagHelpers } from './CloudAdapter-CJS3Sh4f.js';
+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';
 export { IndexedDBAdapter, IndexedDBConfig } from './server.js';
 import 'yjs';
 
+/**
+ * MindCache OAuth Client
+ *
+ * Browser-compatible OAuth 2.0 client for "Sign in with MindCache"
+ * Supports PKCE for secure authorization
+ */
+interface OAuthConfig {
+    /** Client ID from developer portal */
+    clientId: string;
+    /** Redirect URI (defaults to current URL) */
+    redirectUri?: string;
+    /** Scopes to request (default: ['read', 'write']) */
+    scopes?: string[];
+    /** MindCache authorize URL (default: production) */
+    authUrl?: string;
+    /** MindCache token URL (default: production) */
+    tokenUrl?: string;
+    /** Use PKCE for security (default: true) */
+    usePKCE?: boolean;
+    /** Storage key prefix (default: 'mindcache_oauth') */
+    storagePrefix?: string;
+}
+interface OAuthTokens {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    scopes: string[];
+    instanceId?: string;
+}
+interface MindCacheUser {
+    id: string;
+    email?: string;
+    name?: string;
+    instanceId?: string;
+}
+/**
+ * OAuth client for browser applications
+ *
+ * @example
+ * ```typescript
+ * const oauth = new OAuthClient({ clientId: 'mc_app_abc123' });
+ *
+ * // Start OAuth flow
+ * await oauth.authorize();
+ *
+ * // Handle callback (on redirect page)
+ * const tokens = await oauth.handleCallback();
+ *
+ * // Get access token for API calls
+ * const token = await oauth.getAccessToken();
+ * ```
+ */
+declare class OAuthClient {
+    private config;
+    private tokens;
+    private refreshPromise;
+    constructor(config: OAuthConfig);
+    /**
+       * Check if user is authenticated
+       */
+    isAuthenticated(): boolean;
+    /**
+       * Get stored tokens (if any)
+       */
+    getTokens(): OAuthTokens | null;
+    /**
+       * Get instance ID for this user+app
+       */
+    getInstanceId(): string | null;
+    /**
+       * Start OAuth authorization flow
+       * Redirects to MindCache authorization page
+       */
+    authorize(options?: {
+        popup?: boolean;
+        state?: string;
+    }): Promise<void>;
+    /**
+       * Handle OAuth callback
+       * Call this on your redirect URI page
+       *
+       * @returns Tokens if successful
+       */
+    handleCallback(): Promise<OAuthTokens>;
+    /**
+       * Get a valid access token
+       * Automatically refreshes if needed
+       */
+    getAccessToken(): Promise<string>;
+    /**
+       * Refresh access token
+       */
+    private refreshTokens;
+    /**
+       * Get user info from MindCache
+       */
+    getUserInfo(): Promise<MindCacheUser>;
+    /**
+       * Logout - revoke tokens and clear storage
+       */
+    logout(): Promise<void>;
+    /**
+       * Clear authentication state
+       */
+    private clearAuth;
+    /**
+       * Token provider function for MindCache cloud config
+       * Use this with MindCacheCloudOptions.tokenProvider
+       */
+    tokenProvider: () => Promise<string>;
+    private getStorage;
+    private setStorage;
+    private removeStorage;
+    private clearStorage;
+    private loadTokens;
+    private saveTokens;
+}
+/**
+ * Create OAuth client with environment-appropriate defaults
+ */
+declare function createOAuthClient(config: OAuthConfig): OAuthClient;
+
 interface UseMindCacheResult {
     /** The MindCache instance, null until loaded */
     mindcache: MindCache | null;
@@ -34,4 +156,4 @@ declare function useMindCache(options?: MindCacheOptions): UseMindCacheResult;
 
 declare const mindcache: MindCache;
 
-export { MindCache, MindCacheOptions, type UseMindCacheResult, mindcache, useMindCache };
+export { MindCache, MindCacheOptions, type MindCacheUser, OAuthClient, type OAuthConfig, type OAuthTokens, type UseMindCacheResult, createOAuthClient, mindcache, useMindCache };