@scalemule/nextjs 0.1.17 → 0.1.19

package/README.md

@@ -34,6 +34,8 @@ This creates all auth endpoints automatically:
 
 API keys never reach the browser. Session tokens are HTTP-only cookies.
 
+Need the cookie/header lifecycle or the proxy-vs-direct decision tree? See [`docs/AUTH_PROXY_PATTERN.md`](./docs/AUTH_PROXY_PATTERN.md).
+
 ## Environment Variables
 
 ```bash
@@ -295,7 +297,7 @@ export const { GET, POST, DELETE, PATCH } = createAuthRoutes({
 
 ```ts
 // Read CSRF token from cookie and include in requests
-const csrfToken = document.cookie.match(/csrf_token=([^;]+)/)?.[1]
+const csrfToken = document.cookie.match(/sm_csrf=([^;]+)/)?.[1]
 
 fetch('/api/auth/login', {
   method: 'POST',

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { a8 as StorageAdapter } from './index-DTWyUcyd.mjs';
+import { a8 as StorageAdapter, A as ApiError } from './index-DTWyUcyd.mjs';
 
 /**
  * ScaleMule API Client
@@ -38,6 +38,12 @@ interface ClientConfig {
     enableAccountSwitcher?: boolean;
     /** Privacy level for account switcher */
     accountSwitcherPrivacy?: 'full' | 'masked' | 'minimal';
+    /** Optional: Callback when a 401 auto-refresh starts. */
+    onRefreshStart?: () => void;
+    /** Optional: Callback when a 401 auto-refresh finishes. */
+    onRefreshEnd?: () => void;
+    /** Optional: Callback when an automatic 401 refresh fails. */
+    onAutoRefreshFailed?: (error: ApiError) => void;
 }
 interface RequestOptions extends RequestInit {
     /** Skip adding auth headers (for public endpoints) */
@@ -48,6 +54,8 @@ interface RequestOptions extends RequestInit {
     retries?: number;
     /** Skip retries */
     skipRetry?: boolean;
+    /** Internal flag to prevent infinite refresh loops */
+    isAutoRefresh?: boolean;
 }
 /**
  * ScaleMule API Client
@@ -69,6 +77,10 @@ declare class ScaleMuleClient {
     private sessionGate;
     private resolveSessionGate;
     private workspaceId;
+    private refreshPromise;
+    private onRefreshStart?;
+    private onRefreshEnd?;
+    private onAutoRefreshFailed?;
     constructor(config: ClientConfig);
     /**
      * Sync offline queue when coming back online

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { a8 as StorageAdapter } from './index-DTWyUcyd.js';
+import { a8 as StorageAdapter, A as ApiError } from './index-DTWyUcyd.js';
 
 /**
  * ScaleMule API Client
@@ -38,6 +38,12 @@ interface ClientConfig {
     enableAccountSwitcher?: boolean;
     /** Privacy level for account switcher */
     accountSwitcherPrivacy?: 'full' | 'masked' | 'minimal';
+    /** Optional: Callback when a 401 auto-refresh starts. */
+    onRefreshStart?: () => void;
+    /** Optional: Callback when a 401 auto-refresh finishes. */
+    onRefreshEnd?: () => void;
+    /** Optional: Callback when an automatic 401 refresh fails. */
+    onAutoRefreshFailed?: (error: ApiError) => void;
 }
 interface RequestOptions extends RequestInit {
     /** Skip adding auth headers (for public endpoints) */
@@ -48,6 +54,8 @@ interface RequestOptions extends RequestInit {
     retries?: number;
     /** Skip retries */
     skipRetry?: boolean;
+    /** Internal flag to prevent infinite refresh loops */
+    isAutoRefresh?: boolean;
 }
 /**
  * ScaleMule API Client
@@ -69,6 +77,10 @@ declare class ScaleMuleClient {
     private sessionGate;
     private resolveSessionGate;
     private workspaceId;
+    private refreshPromise;
+    private onRefreshStart?;
+    private onRefreshEnd?;
+    private onAutoRefreshFailed?;
     constructor(config: ClientConfig);
     /**
      * Sync offline queue when coming back online

package/dist/client.js

@@ -278,6 +278,7 @@ var ScaleMuleClient = class {
     this.sessionGate = null;
     this.resolveSessionGate = null;
     this.workspaceId = null;
+    this.refreshPromise = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -285,6 +286,9 @@ var ScaleMuleClient = class {
     this.storage = config.storage || createDefaultStorage();
     this.enableRateLimitQueue = config.enableRateLimitQueue || false;
     this.enableOfflineQueue = config.enableOfflineQueue || false;
+    this.onRefreshStart = config.onRefreshStart;
+    this.onRefreshEnd = config.onRefreshEnd;
+    this.onAutoRefreshFailed = config.onAutoRefreshFailed;
     if (this.enableRateLimitQueue) {
       this.rateLimitQueue = new RateLimitQueue();
     }
@@ -503,6 +507,10 @@ var ScaleMuleClient = class {
           signal: controller.signal
         });
         clearTimeout(timeoutId);
+        const rotatedToken = response.headers.get("x-rotated-session-token");
+        if (rotatedToken && this.sessionToken && this.userId) {
+          this.setSession(rotatedToken, this.userId);
+        }
         const text = await response.text();
         let responseData = null;
         try {
@@ -512,6 +520,30 @@ var ScaleMuleClient = class {
         if (!response.ok) {
           const rawError = responseData?.error;
           const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          if (response.status === 401 && this.sessionToken && !options.isAutoRefresh) {
+            if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
+            if (!this.refreshPromise) {
+              this.onRefreshStart?.();
+              this.refreshPromise = this.post("/api/auth/refresh", {}, { isAutoRefresh: true });
+            }
+            try {
+              await this.refreshPromise;
+              if (this.debug) console.log("[ScaleMule] Auto-refresh succeeded, retrying original request...");
+              attempt--;
+              if (this.sessionToken) {
+                headers.set("Authorization", `Bearer ${this.sessionToken}`);
+              }
+              continue;
+            } catch (refreshErr) {
+              if (this.debug) console.error("[ScaleMule] Auto-refresh failed:", refreshErr);
+              const refreshApiError = refreshErr instanceof ScaleMuleApiError ? { code: refreshErr.code, message: refreshErr.message, field: refreshErr.field } : { code: "REFRESH_FAILED", message: "Auto-refresh failed" };
+              this.onAutoRefreshFailed?.(refreshApiError);
+              throw new ScaleMuleApiError(error);
+            } finally {
+              this.refreshPromise = null;
+              this.onRefreshEnd?.();
+            }
+          }
           if (attempt < maxRetries && RETRYABLE_STATUS_CODES.has(response.status)) {
             lastError = error;
             const delay = getBackoffDelay(attempt);

package/dist/client.mjs

@@ -276,6 +276,7 @@ var ScaleMuleClient = class {
     this.sessionGate = null;
     this.resolveSessionGate = null;
     this.workspaceId = null;
+    this.refreshPromise = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -283,6 +284,9 @@ var ScaleMuleClient = class {
     this.storage = config.storage || createDefaultStorage();
     this.enableRateLimitQueue = config.enableRateLimitQueue || false;
     this.enableOfflineQueue = config.enableOfflineQueue || false;
+    this.onRefreshStart = config.onRefreshStart;
+    this.onRefreshEnd = config.onRefreshEnd;
+    this.onAutoRefreshFailed = config.onAutoRefreshFailed;
     if (this.enableRateLimitQueue) {
       this.rateLimitQueue = new RateLimitQueue();
     }
@@ -501,6 +505,10 @@ var ScaleMuleClient = class {
           signal: controller.signal
         });
         clearTimeout(timeoutId);
+        const rotatedToken = response.headers.get("x-rotated-session-token");
+        if (rotatedToken && this.sessionToken && this.userId) {
+          this.setSession(rotatedToken, this.userId);
+        }
         const text = await response.text();
         let responseData = null;
         try {
@@ -510,6 +518,30 @@ var ScaleMuleClient = class {
         if (!response.ok) {
           const rawError = responseData?.error;
           const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          if (response.status === 401 && this.sessionToken && !options.isAutoRefresh) {
+            if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
+            if (!this.refreshPromise) {
+              this.onRefreshStart?.();
+              this.refreshPromise = this.post("/api/auth/refresh", {}, { isAutoRefresh: true });
+            }
+            try {
+              await this.refreshPromise;
+              if (this.debug) console.log("[ScaleMule] Auto-refresh succeeded, retrying original request...");
+              attempt--;
+              if (this.sessionToken) {
+                headers.set("Authorization", `Bearer ${this.sessionToken}`);
+              }
+              continue;
+            } catch (refreshErr) {
+              if (this.debug) console.error("[ScaleMule] Auto-refresh failed:", refreshErr);
+              const refreshApiError = refreshErr instanceof ScaleMuleApiError ? { code: refreshErr.code, message: refreshErr.message, field: refreshErr.field } : { code: "REFRESH_FAILED", message: "Auto-refresh failed" };
+              this.onAutoRefreshFailed?.(refreshApiError);
+              throw new ScaleMuleApiError(error);
+            } finally {
+              this.refreshPromise = null;
+              this.onRefreshEnd?.();
+            }
+          }
           if (attempt < maxRetries && RETRYABLE_STATUS_CODES.has(response.status)) {
             lastError = error;
             const delay = getBackoffDelay(attempt);

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ApiError, RealtimeService, StorageService, PhotoService, VideoService, AudioService, FileStatus } from '@scalemule/sdk';
+import { ApiError, RealtimeService, StorageService, PhotoService, VideoService, AudioService, TtsService, TtsJobStatus, FileStatus } from '@scalemule/sdk';
 import * as React from 'react';
 import { ReactNode, ReactElement } from 'react';
 import { MoneyClient } from '@scalemule/money';
@@ -166,6 +166,8 @@ interface ScaleMuleContextValue {
     video: VideoService;
     /** Base SDK audio service — exposed for `useMedia()` and `audio.uploadViaStorage()` */
     audio: AudioService;
+    /** Base SDK TTS service — exposed for `useTtsJob()` and direct narration requests */
+    tts: TtsService;
     /**
      * Default media policy for `useMedia()` calls. Set via
      * `<ScaleMuleProvider mediaPolicy="…">`; per-call overrides win.
@@ -360,6 +362,18 @@ interface UseAudioReturn {
 }
 declare function useAudio(): UseAudioReturn;
 
+interface UseTtsJobOptions {
+    enabled?: boolean;
+    pollIntervalMs?: number;
+}
+interface UseTtsJobReturn {
+    job: TtsJobStatus | null;
+    loading: boolean;
+    error: ApiError | null;
+    refresh: () => Promise<TtsJobStatus | null>;
+}
+declare function useTtsJob(jobId: string | null | undefined, options?: UseTtsJobOptions): UseTtsJobReturn;
+
 /**
  * Conversation kinds recognized by the chat realtime channel naming scheme.
  * Matches `broadcast_to_conversation` in `ms/scalemule-chat/src/realtime.rs`.
@@ -1032,4 +1046,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError$1 as ApiError, type AudioFile, type AudioUploadResult, type ConversationKind, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, type FeedbackItem, type FeedbackItemInput, type FeedbackPriority, type FeedbackStatus, type FeedbackType, FeedbackWidget, type FeedbackWidgetConfig, type FeedbackWidgetProps, ListFilesParams, LoginResponse, type MediaPolicy, type MediaUploadResult, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleMedia, type ScaleMuleMediaProps, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, type UseAudioReturn, type UseAudioUploadOptions, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeedbackOptions, type UseFeedbackResult, type UseFileStatusOptions, type UseFileStatusReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseMediaReturn, type UseMediaUploadOptions, type UsePushNotificationsOptions, type UsePushNotificationsReturn, type UseRealtimeOptions, type UseRealtimeReturn, type UseShareOptions, type UseShareReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAudio, useAuth, useBilling, useContent, useFeatureFlags, useFeedback, useFileStatus, useMedia, useMoney, useMoneyClient, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, useUser, validateForm, validators };
+export { ApiError$1 as ApiError, type AudioFile, type AudioUploadResult, type ConversationKind, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, type FeedbackItem, type FeedbackItemInput, type FeedbackPriority, type FeedbackStatus, type FeedbackType, FeedbackWidget, type FeedbackWidgetConfig, type FeedbackWidgetProps, ListFilesParams, LoginResponse, type MediaPolicy, type MediaUploadResult, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleMedia, type ScaleMuleMediaProps, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, type UseAudioReturn, type UseAudioUploadOptions, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeedbackOptions, type UseFeedbackResult, type UseFileStatusOptions, type UseFileStatusReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseMediaReturn, type UseMediaUploadOptions, type UsePushNotificationsOptions, type UsePushNotificationsReturn, type UseRealtimeOptions, type UseRealtimeReturn, type UseShareOptions, type UseShareReturn, type UseTtsJobOptions, type UseTtsJobReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAudio, useAuth, useBilling, useContent, useFeatureFlags, useFeedback, useFileStatus, useMedia, useMoney, useMoneyClient, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, useTtsJob, useUser, validateForm, validators };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ApiError, RealtimeService, StorageService, PhotoService, VideoService, AudioService, FileStatus } from '@scalemule/sdk';
+import { ApiError, RealtimeService, StorageService, PhotoService, VideoService, AudioService, TtsService, TtsJobStatus, FileStatus } from '@scalemule/sdk';
 import * as React from 'react';
 import { ReactNode, ReactElement } from 'react';
 import { MoneyClient } from '@scalemule/money';
@@ -166,6 +166,8 @@ interface ScaleMuleContextValue {
     video: VideoService;
     /** Base SDK audio service — exposed for `useMedia()` and `audio.uploadViaStorage()` */
     audio: AudioService;
+    /** Base SDK TTS service — exposed for `useTtsJob()` and direct narration requests */
+    tts: TtsService;
     /**
      * Default media policy for `useMedia()` calls. Set via
      * `<ScaleMuleProvider mediaPolicy="…">`; per-call overrides win.
@@ -360,6 +362,18 @@ interface UseAudioReturn {
 }
 declare function useAudio(): UseAudioReturn;
 
+interface UseTtsJobOptions {
+    enabled?: boolean;
+    pollIntervalMs?: number;
+}
+interface UseTtsJobReturn {
+    job: TtsJobStatus | null;
+    loading: boolean;
+    error: ApiError | null;
+    refresh: () => Promise<TtsJobStatus | null>;
+}
+declare function useTtsJob(jobId: string | null | undefined, options?: UseTtsJobOptions): UseTtsJobReturn;
+
 /**
  * Conversation kinds recognized by the chat realtime channel naming scheme.
  * Matches `broadcast_to_conversation` in `ms/scalemule-chat/src/realtime.rs`.
@@ -1032,4 +1046,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError$1 as ApiError, type AudioFile, type AudioUploadResult, type ConversationKind, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, type FeedbackItem, type FeedbackItemInput, type FeedbackPriority, type FeedbackStatus, type FeedbackType, FeedbackWidget, type FeedbackWidgetConfig, type FeedbackWidgetProps, ListFilesParams, LoginResponse, type MediaPolicy, type MediaUploadResult, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleMedia, type ScaleMuleMediaProps, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, type UseAudioReturn, type UseAudioUploadOptions, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeedbackOptions, type UseFeedbackResult, type UseFileStatusOptions, type UseFileStatusReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseMediaReturn, type UseMediaUploadOptions, type UsePushNotificationsOptions, type UsePushNotificationsReturn, type UseRealtimeOptions, type UseRealtimeReturn, type UseShareOptions, type UseShareReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAudio, useAuth, useBilling, useContent, useFeatureFlags, useFeedback, useFileStatus, useMedia, useMoney, useMoneyClient, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, useUser, validateForm, validators };
+export { ApiError$1 as ApiError, type AudioFile, type AudioUploadResult, type ConversationKind, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, type FeedbackItem, type FeedbackItemInput, type FeedbackPriority, type FeedbackStatus, type FeedbackType, FeedbackWidget, type FeedbackWidgetConfig, type FeedbackWidgetProps, ListFilesParams, LoginResponse, type MediaPolicy, type MediaUploadResult, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleMedia, type ScaleMuleMediaProps, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, type UseAudioReturn, type UseAudioUploadOptions, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeedbackOptions, type UseFeedbackResult, type UseFileStatusOptions, type UseFileStatusReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseMediaReturn, type UseMediaUploadOptions, type UsePushNotificationsOptions, type UsePushNotificationsReturn, type UseRealtimeOptions, type UseRealtimeReturn, type UseShareOptions, type UseShareReturn, type UseTtsJobOptions, type UseTtsJobReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAudio, useAuth, useBilling, useContent, useFeatureFlags, useFeedback, useFileStatus, useMedia, useMoney, useMoneyClient, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, useTtsJob, useUser, validateForm, validators };

package/dist/index.js

@@ -7023,6 +7023,7 @@ var ScaleMuleClient2 = class {
     this.sessionGate = null;
     this.resolveSessionGate = null;
     this.workspaceId = null;
+    this.refreshPromise = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -7030,6 +7031,9 @@ var ScaleMuleClient2 = class {
     this.storage = config.storage || createDefaultStorage2();
     this.enableRateLimitQueue = config.enableRateLimitQueue || false;
     this.enableOfflineQueue = config.enableOfflineQueue || false;
+    this.onRefreshStart = config.onRefreshStart;
+    this.onRefreshEnd = config.onRefreshEnd;
+    this.onAutoRefreshFailed = config.onAutoRefreshFailed;
     if (this.enableRateLimitQueue) {
       this.rateLimitQueue = new RateLimitQueue2();
     }
@@ -7248,6 +7252,10 @@ var ScaleMuleClient2 = class {
           signal: controller.signal
         });
         clearTimeout(timeoutId);
+        const rotatedToken = response.headers.get("x-rotated-session-token");
+        if (rotatedToken && this.sessionToken && this.userId) {
+          this.setSession(rotatedToken, this.userId);
+        }
         const text = await response.text();
         let responseData = null;
         try {
@@ -7257,6 +7265,30 @@ var ScaleMuleClient2 = class {
         if (!response.ok) {
           const rawError = responseData?.error;
           const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          if (response.status === 401 && this.sessionToken && !options.isAutoRefresh) {
+            if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
+            if (!this.refreshPromise) {
+              this.onRefreshStart?.();
+              this.refreshPromise = this.post("/api/auth/refresh", {}, { isAutoRefresh: true });
+            }
+            try {
+              await this.refreshPromise;
+              if (this.debug) console.log("[ScaleMule] Auto-refresh succeeded, retrying original request...");
+              attempt--;
+              if (this.sessionToken) {
+                headers.set("Authorization", `Bearer ${this.sessionToken}`);
+              }
+              continue;
+            } catch (refreshErr) {
+              if (this.debug) console.error("[ScaleMule] Auto-refresh failed:", refreshErr);
+              const refreshApiError = refreshErr instanceof ScaleMuleApiError ? { code: refreshErr.code, message: refreshErr.message, field: refreshErr.field } : { code: "REFRESH_FAILED", message: "Auto-refresh failed" };
+              this.onAutoRefreshFailed?.(refreshApiError);
+              throw new ScaleMuleApiError(error);
+            } finally {
+              this.refreshPromise = null;
+              this.onRefreshEnd?.();
+            }
+          }
           if (attempt < maxRetries && RETRYABLE_STATUS_CODES3.has(response.status)) {
             lastError = error;
             const delay = getBackoffDelay2(attempt);
@@ -7772,6 +7804,7 @@ function ScaleMuleProvider({
       photo: baseClient.photo,
       video: baseClient.video,
       audio: baseClient.audio,
+      tts: baseClient.tts,
       mediaPolicy: effectiveMediaPolicy,
       user,
       setUser: handleSetUser,
@@ -9160,7 +9193,7 @@ function useAudio() {
           return null;
         }
         try {
-          const details = await client.get(`/v1/audios/${audioId}`);
+          const details = await client.get(`/v1/audio/${audioId}`);
           if (details.status === "ready" && details.url) {
             return details.url;
           }
@@ -9222,7 +9255,7 @@ function useAudio() {
       const enriched = await Promise.all(
         audioFiles.map(async (file) => {
           try {
-            const details = await client.get(`/v1/audios/${file.id}`);
+            const details = await client.get(`/v1/audio/${file.id}`);
             return {
               audio_id: details.id,
               file_id: file.id,
@@ -9258,7 +9291,7 @@ function useAudio() {
       setError(null);
       try {
         const [audioDeleteResult, storageDeleteResult] = await Promise.allSettled([
-          client.delete(`/v1/audios/${fileId}`),
+          client.delete(`/v1/audio/${fileId}`),
           client.delete(`/v1/storage/files/${fileId}`)
         ]);
         if (storageDeleteResult.status === "rejected" && !isNotFoundError(storageDeleteResult.reason)) {
@@ -9285,6 +9318,63 @@ function useAudio() {
     loading
   };
 }
+var DEFAULT_POLL_INTERVAL_MS = 2e3;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["ready", "failed"]);
+function useTtsJob(jobId, options) {
+  const { tts } = useScaleMule();
+  const [job, setJob] = React.useState(null);
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const refresh = React.useCallback(async () => {
+    if (!jobId) {
+      setJob(null);
+      return null;
+    }
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await tts.getJob(jobId);
+      if (!result) {
+        const apiError = { code: "tts_job_error", message: "Failed to load TTS job", status: 500 };
+        setError(apiError);
+        return null;
+      }
+      if (result.error || !result.data) {
+        const apiError = result.error ?? { code: "tts_job_error", message: "Failed to load TTS job", status: 500 };
+        setError(apiError);
+        return null;
+      }
+      setJob(result.data);
+      return result.data;
+    } finally {
+      setLoading(false);
+    }
+  }, [jobId, tts]);
+  React.useEffect(() => {
+    if (!jobId || options?.enabled === false) {
+      setJob(null);
+      setLoading(false);
+      return;
+    }
+    let cancelled = false;
+    let timeoutId = null;
+    const poll = async () => {
+      const next = await refresh();
+      if (cancelled || !next || TERMINAL_STATUSES.has(next.status)) {
+        return;
+      }
+      timeoutId = window.setTimeout(poll, options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    };
+    poll();
+    return () => {
+      cancelled = true;
+      if (timeoutId != null) {
+        window.clearTimeout(timeoutId);
+      }
+    };
+  }, [jobId, options?.enabled, options?.pollIntervalMs, refresh]);
+  return { job, loading, error, refresh };
+}
 function useMedia() {
   const { storage, photo, video, audio, mediaPolicy: providerDefaultPolicy } = useScaleMule();
   const [uploading, setUploading] = React.useState(false);
@@ -11525,6 +11615,7 @@ exports.useRealtime = useRealtime;
 exports.useScaleMule = useScaleMule;
 exports.useScaleMuleClient = useScaleMuleClient;
 exports.useShare = useShare;
+exports.useTtsJob = useTtsJob;
 exports.useUser = useUser;
 exports.validateForm = validateForm;
 exports.validators = validators;

package/dist/index.mjs

@@ -7003,6 +7003,7 @@ var ScaleMuleClient2 = class {
     this.sessionGate = null;
     this.resolveSessionGate = null;
     this.workspaceId = null;
+    this.refreshPromise = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -7010,6 +7011,9 @@ var ScaleMuleClient2 = class {
     this.storage = config.storage || createDefaultStorage2();
     this.enableRateLimitQueue = config.enableRateLimitQueue || false;
     this.enableOfflineQueue = config.enableOfflineQueue || false;
+    this.onRefreshStart = config.onRefreshStart;
+    this.onRefreshEnd = config.onRefreshEnd;
+    this.onAutoRefreshFailed = config.onAutoRefreshFailed;
     if (this.enableRateLimitQueue) {
       this.rateLimitQueue = new RateLimitQueue2();
     }
@@ -7228,6 +7232,10 @@ var ScaleMuleClient2 = class {
           signal: controller.signal
         });
         clearTimeout(timeoutId);
+        const rotatedToken = response.headers.get("x-rotated-session-token");
+        if (rotatedToken && this.sessionToken && this.userId) {
+          this.setSession(rotatedToken, this.userId);
+        }
         const text = await response.text();
         let responseData = null;
         try {
@@ -7237,6 +7245,30 @@ var ScaleMuleClient2 = class {
         if (!response.ok) {
           const rawError = responseData?.error;
           const error = rawError && typeof rawError === "object" ? rawError : { code: `HTTP_${response.status}`, message: typeof rawError === "string" ? rawError : responseData?.message || text || response.statusText };
+          if (response.status === 401 && this.sessionToken && !options.isAutoRefresh) {
+            if (this.debug) console.log("[ScaleMule] 401 received, attempting auto-refresh...");
+            if (!this.refreshPromise) {
+              this.onRefreshStart?.();
+              this.refreshPromise = this.post("/api/auth/refresh", {}, { isAutoRefresh: true });
+            }
+            try {
+              await this.refreshPromise;
+              if (this.debug) console.log("[ScaleMule] Auto-refresh succeeded, retrying original request...");
+              attempt--;
+              if (this.sessionToken) {
+                headers.set("Authorization", `Bearer ${this.sessionToken}`);
+              }
+              continue;
+            } catch (refreshErr) {
+              if (this.debug) console.error("[ScaleMule] Auto-refresh failed:", refreshErr);
+              const refreshApiError = refreshErr instanceof ScaleMuleApiError ? { code: refreshErr.code, message: refreshErr.message, field: refreshErr.field } : { code: "REFRESH_FAILED", message: "Auto-refresh failed" };
+              this.onAutoRefreshFailed?.(refreshApiError);
+              throw new ScaleMuleApiError(error);
+            } finally {
+              this.refreshPromise = null;
+              this.onRefreshEnd?.();
+            }
+          }
           if (attempt < maxRetries && RETRYABLE_STATUS_CODES3.has(response.status)) {
             lastError = error;
             const delay = getBackoffDelay2(attempt);
@@ -7752,6 +7784,7 @@ function ScaleMuleProvider({
       photo: baseClient.photo,
       video: baseClient.video,
       audio: baseClient.audio,
+      tts: baseClient.tts,
       mediaPolicy: effectiveMediaPolicy,
       user,
       setUser: handleSetUser,
@@ -9140,7 +9173,7 @@ function useAudio() {
           return null;
         }
         try {
-          const details = await client.get(`/v1/audios/${audioId}`);
+          const details = await client.get(`/v1/audio/${audioId}`);
           if (details.status === "ready" && details.url) {
             return details.url;
           }
@@ -9202,7 +9235,7 @@ function useAudio() {
       const enriched = await Promise.all(
         audioFiles.map(async (file) => {
           try {
-            const details = await client.get(`/v1/audios/${file.id}`);
+            const details = await client.get(`/v1/audio/${file.id}`);
             return {
               audio_id: details.id,
               file_id: file.id,
@@ -9238,7 +9271,7 @@ function useAudio() {
       setError(null);
       try {
         const [audioDeleteResult, storageDeleteResult] = await Promise.allSettled([
-          client.delete(`/v1/audios/${fileId}`),
+          client.delete(`/v1/audio/${fileId}`),
           client.delete(`/v1/storage/files/${fileId}`)
         ]);
         if (storageDeleteResult.status === "rejected" && !isNotFoundError(storageDeleteResult.reason)) {
@@ -9265,6 +9298,63 @@ function useAudio() {
     loading
   };
 }
+var DEFAULT_POLL_INTERVAL_MS = 2e3;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["ready", "failed"]);
+function useTtsJob(jobId, options) {
+  const { tts } = useScaleMule();
+  const [job, setJob] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const refresh = useCallback(async () => {
+    if (!jobId) {
+      setJob(null);
+      return null;
+    }
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await tts.getJob(jobId);
+      if (!result) {
+        const apiError = { code: "tts_job_error", message: "Failed to load TTS job", status: 500 };
+        setError(apiError);
+        return null;
+      }
+      if (result.error || !result.data) {
+        const apiError = result.error ?? { code: "tts_job_error", message: "Failed to load TTS job", status: 500 };
+        setError(apiError);
+        return null;
+      }
+      setJob(result.data);
+      return result.data;
+    } finally {
+      setLoading(false);
+    }
+  }, [jobId, tts]);
+  useEffect(() => {
+    if (!jobId || options?.enabled === false) {
+      setJob(null);
+      setLoading(false);
+      return;
+    }
+    let cancelled = false;
+    let timeoutId = null;
+    const poll = async () => {
+      const next = await refresh();
+      if (cancelled || !next || TERMINAL_STATUSES.has(next.status)) {
+        return;
+      }
+      timeoutId = window.setTimeout(poll, options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    };
+    poll();
+    return () => {
+      cancelled = true;
+      if (timeoutId != null) {
+        window.clearTimeout(timeoutId);
+      }
+    };
+  }, [jobId, options?.enabled, options?.pollIntervalMs, refresh]);
+  return { job, loading, error, refresh };
+}
 function useMedia() {
   const { storage, photo, video, audio, mediaPolicy: providerDefaultPolicy } = useScaleMule();
   const [uploading, setUploading] = useState(false);
@@ -11470,4 +11560,4 @@ function createSafeLogger(prefix) {
   };
 }
 
-export { FeedbackWidget, ScaleMuleApiError, ScaleMuleClient2 as ScaleMuleClient, ScaleMuleMedia, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAudio, useAuth, useBilling, useContent, useFeatureFlags, useFeedback, useFileStatus, useMedia, useMoney, useMoneyClient, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, useUser, validateForm, validators };
+export { FeedbackWidget, ScaleMuleApiError, ScaleMuleClient2 as ScaleMuleClient, ScaleMuleMedia, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAudio, useAuth, useBilling, useContent, useFeatureFlags, useFeedback, useFileStatus, useMedia, useMoney, useMoneyClient, usePushNotifications, useRealtime, useScaleMule, useScaleMuleClient, useShare, useTtsJob, useUser, validateForm, validators };