@scalemule/nextjs 0.1.18 → 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/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

@@ -7804,6 +7804,7 @@ function ScaleMuleProvider({
       photo: baseClient.photo,
       video: baseClient.video,
       audio: baseClient.audio,
+      tts: baseClient.tts,
       mediaPolicy: effectiveMediaPolicy,
       user,
       setUser: handleSetUser,
@@ -9192,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;
           }
@@ -9254,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,
@@ -9290,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)) {
@@ -9317,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);
@@ -11557,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

@@ -7784,6 +7784,7 @@ function ScaleMuleProvider({
       photo: baseClient.photo,
       video: baseClient.video,
       audio: baseClient.audio,
+      tts: baseClient.tts,
       mediaPolicy: effectiveMediaPolicy,
       user,
       setUser: handleSetUser,
@@ -9172,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;
           }
@@ -9234,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,
@@ -9270,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)) {
@@ -9297,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);
@@ -11502,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 };