@fluxbase/sdk 2026.3.2 → 2026.3.4

package/dist/index.cjs

@@ -1126,6 +1126,63 @@ var FluxbaseAuth = class {
       return result.data;
     });
   }
+  /**
+   * Get provider OAuth tokens for calling external APIs
+   *
+   * Retrieves the stored OAuth tokens for a provider (e.g., Google, GitHub) that
+   * the user has previously authenticated with. Use these tokens to call provider
+   * APIs directly (e.g., Google Drive API).
+   *
+   * The access_token is automatically refreshed if it has expired or is about to expire.
+   *
+   * @param provider - OAuth provider name (e.g., 'google', 'github')
+   * @returns Promise with provider tokens (access_token, refresh_token, etc.)
+   *
+   * @example
+   * ```typescript
+   * // Get Google tokens to call Google Drive API
+   * const { data, error } = await client.auth.getProviderToken('google')
+   *
+   * if (error) {
+   *   if (error.error_code === 'oauth_token_not_found') {
+   *     // User needs to sign in with Google first
+   *     window.location.href = error.authorize_url
+   *   }
+   *   return
+   * }
+   *
+   * // Use the access token to call Google Drive API
+   * const response = await fetch('https://www.googleapis.com/drive/v3/files', {
+   *   headers: {
+   *     'Authorization': `Bearer ${data.access_token}`
+   *   }
+   * })
+   * const files = await response.json()
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Check token expiry before making API calls
+   * const { data } = await client.auth.getProviderToken('google')
+   *
+   * if (data.expires_in < 60) {
+   *   console.warn('Token expires soon, consider caching and refreshing')
+   * }
+   *
+   * // Token expiry is also available as ISO timestamp
+   * console.log('Token expires at:', data.token_expiry)
+   * ```
+   */
+  async getProviderToken(provider) {
+    return wrapAsync(async () => {
+      if (!this.session) {
+        throw new Error("Not authenticated");
+      }
+      return await this.fetch.get(
+        `/api/v1/auth/oauth/${provider}/token`
+      );
+    });
+  }
   /**
    * Sign in with OTP (One-Time Password) - Supabase-compatible
    * Sends a one-time password via email or SMS for passwordless authentication