@scalemule/nextjs 0.1.13 → 0.1.14

package/dist/index.d.mts

@@ -324,6 +324,42 @@ interface UseContentOptions {
  */
 declare function useContent(options?: UseContentOptions): UseContentReturn;
 
+interface AudioFile {
+    audio_id: string;
+    file_id: string;
+    filename: string;
+    mime_type: string;
+    size_bytes: number;
+    status: string;
+    codec: string | null;
+    bit_rate_kbps: number | null;
+    duration_ms: number | null;
+    created_at: string;
+    original_view_url: string | null;
+    transcoded_url: string | null;
+    waveform_peaks?: unknown;
+}
+interface UseAudioUploadOptions {
+    filename?: string;
+    metadata?: Record<string, unknown>;
+    onProgress?: (progress: number) => void;
+    signal?: AbortSignal;
+}
+interface AudioUploadResult {
+    file_id: string;
+    audio_id: string | null;
+    original_view_url: string | null;
+    transcoded_url_promise: Promise<string | null>;
+}
+interface UseAudioReturn {
+    upload: (file: File | Blob, opts?: UseAudioUploadOptions) => Promise<AudioUploadResult>;
+    list: () => Promise<AudioFile[]>;
+    remove: (fileId: string) => Promise<void>;
+    error: ApiError | null;
+    loading: boolean;
+}
+declare function useAudio(): UseAudioReturn;
+
 /**
  * Conversation kinds recognized by the chat realtime channel naming scheme.
  * Matches `broadcast_to_conversation` in `ms/scalemule-chat/src/realtime.rs`.
@@ -996,4 +1032,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError$1 as ApiError, 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, 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, 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, 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 };

package/dist/index.d.ts

@@ -324,6 +324,42 @@ interface UseContentOptions {
  */
 declare function useContent(options?: UseContentOptions): UseContentReturn;
 
+interface AudioFile {
+    audio_id: string;
+    file_id: string;
+    filename: string;
+    mime_type: string;
+    size_bytes: number;
+    status: string;
+    codec: string | null;
+    bit_rate_kbps: number | null;
+    duration_ms: number | null;
+    created_at: string;
+    original_view_url: string | null;
+    transcoded_url: string | null;
+    waveform_peaks?: unknown;
+}
+interface UseAudioUploadOptions {
+    filename?: string;
+    metadata?: Record<string, unknown>;
+    onProgress?: (progress: number) => void;
+    signal?: AbortSignal;
+}
+interface AudioUploadResult {
+    file_id: string;
+    audio_id: string | null;
+    original_view_url: string | null;
+    transcoded_url_promise: Promise<string | null>;
+}
+interface UseAudioReturn {
+    upload: (file: File | Blob, opts?: UseAudioUploadOptions) => Promise<AudioUploadResult>;
+    list: () => Promise<AudioFile[]>;
+    remove: (fileId: string) => Promise<void>;
+    error: ApiError | null;
+    loading: boolean;
+}
+declare function useAudio(): UseAudioReturn;
+
 /**
  * Conversation kinds recognized by the chat realtime channel naming scheme.
  * Matches `broadcast_to_conversation` in `ms/scalemule-chat/src/realtime.rs`.
@@ -996,4 +1032,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError$1 as ApiError, 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, 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, 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, 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 };

package/dist/index.js

@@ -9036,6 +9036,193 @@ function useContent(options = {}) {
     ]
   );
 }
+var AUDIO_POLL_INTERVAL_MS = 1e3;
+var AUDIO_POLL_MAX_ATTEMPTS = 30;
+function isAudioFile(file) {
+  return file.content_type.startsWith("audio/");
+}
+function toStorageBackedAudioFile(file) {
+  return {
+    audio_id: file.id,
+    file_id: file.id,
+    filename: file.filename,
+    mime_type: file.content_type,
+    size_bytes: file.size_bytes,
+    status: "pending_transcode",
+    codec: null,
+    bit_rate_kbps: null,
+    duration_ms: null,
+    created_at: file.created_at,
+    original_view_url: file.url ?? null,
+    transcoded_url: null
+  };
+}
+function isNotFoundError(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const candidate = error;
+  return candidate.status === 404 || candidate.statusCode === 404 || candidate.response?.status === 404 || candidate.code === "not_found" || candidate.message?.toLowerCase().includes("not found") === true;
+}
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError" || !!error && typeof error === "object" && "name" in error && error.name === "AbortError";
+}
+async function waitForPollInterval(signal) {
+  if (signal?.aborted) {
+    return false;
+  }
+  return new Promise((resolve) => {
+    const timeoutId = window.setTimeout(() => {
+      cleanup();
+      resolve(true);
+    }, AUDIO_POLL_INTERVAL_MS);
+    const onAbort = () => {
+      cleanup();
+      resolve(false);
+    };
+    const cleanup = () => {
+      window.clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", onAbort);
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function useAudio() {
+  const { client, audio } = useScaleMule();
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+  const pollTranscodedUrl = React.useCallback(
+    async (audioId, signal) => {
+      for (let attempt = 0; attempt < AUDIO_POLL_MAX_ATTEMPTS; attempt++) {
+        if (signal?.aborted) {
+          return null;
+        }
+        try {
+          const details = await client.get(`/v1/audios/${audioId}`);
+          if (details.status === "ready" && details.url) {
+            return details.url;
+          }
+          if (details.status === "failed") {
+            return null;
+          }
+        } catch (err) {
+          if (isAbortError(err) || signal?.aborted) {
+            return null;
+          }
+          if (!isNotFoundError(err)) {
+            throw err;
+          }
+        }
+        if (!await waitForPollInterval(signal)) {
+          return null;
+        }
+      }
+      return null;
+    },
+    [client]
+  );
+  const upload = React.useCallback(
+    async (file, opts) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const result = await audio.uploadViaStorage(file, {
+          filename: opts?.filename,
+          metadata: opts?.metadata,
+          onProgress: opts?.onProgress,
+          signal: opts?.signal
+        });
+        if (result.error || !result.data) {
+          throw result.error ?? { code: "upload_error", message: "Audio upload failed" };
+        }
+        return {
+          file_id: result.data.file_id,
+          audio_id: result.data.audio_id,
+          original_view_url: result.data.original_view_url,
+          transcoded_url_promise: result.data.audio_id ? pollTranscodedUrl(result.data.audio_id, opts?.signal) : Promise.resolve(null)
+        };
+      } catch (err) {
+        const apiError = err;
+        setError(apiError);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [audio, pollTranscodedUrl]
+  );
+  const list = React.useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const response = await client.get("/v1/storage/my-files");
+      const audioFiles = response.files.filter(isAudioFile);
+      const enriched = await Promise.all(
+        audioFiles.map(async (file) => {
+          try {
+            const details = await client.get(`/v1/audios/${file.id}`);
+            return {
+              audio_id: details.id,
+              file_id: file.id,
+              filename: file.filename,
+              mime_type: file.content_type,
+              size_bytes: details.size_bytes ?? file.size_bytes,
+              status: details.status,
+              codec: details.codec,
+              bit_rate_kbps: details.bit_rate_kbps ?? null,
+              duration_ms: details.duration_ms ?? null,
+              created_at: details.created_at,
+              original_view_url: file.url ?? null,
+              transcoded_url: details.url ?? null,
+              waveform_peaks: details.waveform_peaks
+            };
+          } catch {
+            return toStorageBackedAudioFile(file);
+          }
+        })
+      );
+      return enriched;
+    } catch (err) {
+      const apiError = err;
+      setError(apiError);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+  const remove = React.useCallback(
+    async (fileId) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const [audioDeleteResult, storageDeleteResult] = await Promise.allSettled([
+          client.delete(`/v1/audios/${fileId}`),
+          client.delete(`/v1/storage/files/${fileId}`)
+        ]);
+        if (storageDeleteResult.status === "rejected" && !isNotFoundError(storageDeleteResult.reason)) {
+          throw storageDeleteResult.reason ?? new Error("Storage delete failed");
+        }
+        if (audioDeleteResult.status === "rejected" && !isNotFoundError(audioDeleteResult.reason)) {
+          console.warn("Audio record delete failed after storage delete", audioDeleteResult.reason);
+        }
+      } catch (err) {
+        const apiError = err;
+        setError(apiError);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [client]
+  );
+  return {
+    upload,
+    list,
+    remove,
+    error,
+    loading
+  };
+}
 function useMedia() {
   const { storage, photo, video, audio, mediaPolicy: providerDefaultPolicy } = useScaleMule();
   const [uploading, setUploading] = React.useState(false);
@@ -11261,6 +11448,7 @@ exports.normalizePhone = normalizePhone;
 exports.phoneCountries = phoneCountries;
 exports.sanitizeForLog = sanitizeForLog;
 exports.useAnalytics = useAnalytics;
+exports.useAudio = useAudio;
 exports.useAuth = useAuth;
 exports.useBilling = useBilling;
 exports.useContent = useContent;

package/dist/index.mjs

@@ -9016,6 +9016,193 @@ function useContent(options = {}) {
     ]
   );
 }
+var AUDIO_POLL_INTERVAL_MS = 1e3;
+var AUDIO_POLL_MAX_ATTEMPTS = 30;
+function isAudioFile(file) {
+  return file.content_type.startsWith("audio/");
+}
+function toStorageBackedAudioFile(file) {
+  return {
+    audio_id: file.id,
+    file_id: file.id,
+    filename: file.filename,
+    mime_type: file.content_type,
+    size_bytes: file.size_bytes,
+    status: "pending_transcode",
+    codec: null,
+    bit_rate_kbps: null,
+    duration_ms: null,
+    created_at: file.created_at,
+    original_view_url: file.url ?? null,
+    transcoded_url: null
+  };
+}
+function isNotFoundError(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const candidate = error;
+  return candidate.status === 404 || candidate.statusCode === 404 || candidate.response?.status === 404 || candidate.code === "not_found" || candidate.message?.toLowerCase().includes("not found") === true;
+}
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError" || !!error && typeof error === "object" && "name" in error && error.name === "AbortError";
+}
+async function waitForPollInterval(signal) {
+  if (signal?.aborted) {
+    return false;
+  }
+  return new Promise((resolve) => {
+    const timeoutId = window.setTimeout(() => {
+      cleanup();
+      resolve(true);
+    }, AUDIO_POLL_INTERVAL_MS);
+    const onAbort = () => {
+      cleanup();
+      resolve(false);
+    };
+    const cleanup = () => {
+      window.clearTimeout(timeoutId);
+      signal?.removeEventListener("abort", onAbort);
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function useAudio() {
+  const { client, audio } = useScaleMule();
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const pollTranscodedUrl = useCallback(
+    async (audioId, signal) => {
+      for (let attempt = 0; attempt < AUDIO_POLL_MAX_ATTEMPTS; attempt++) {
+        if (signal?.aborted) {
+          return null;
+        }
+        try {
+          const details = await client.get(`/v1/audios/${audioId}`);
+          if (details.status === "ready" && details.url) {
+            return details.url;
+          }
+          if (details.status === "failed") {
+            return null;
+          }
+        } catch (err) {
+          if (isAbortError(err) || signal?.aborted) {
+            return null;
+          }
+          if (!isNotFoundError(err)) {
+            throw err;
+          }
+        }
+        if (!await waitForPollInterval(signal)) {
+          return null;
+        }
+      }
+      return null;
+    },
+    [client]
+  );
+  const upload = useCallback(
+    async (file, opts) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const result = await audio.uploadViaStorage(file, {
+          filename: opts?.filename,
+          metadata: opts?.metadata,
+          onProgress: opts?.onProgress,
+          signal: opts?.signal
+        });
+        if (result.error || !result.data) {
+          throw result.error ?? { code: "upload_error", message: "Audio upload failed" };
+        }
+        return {
+          file_id: result.data.file_id,
+          audio_id: result.data.audio_id,
+          original_view_url: result.data.original_view_url,
+          transcoded_url_promise: result.data.audio_id ? pollTranscodedUrl(result.data.audio_id, opts?.signal) : Promise.resolve(null)
+        };
+      } catch (err) {
+        const apiError = err;
+        setError(apiError);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [audio, pollTranscodedUrl]
+  );
+  const list = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const response = await client.get("/v1/storage/my-files");
+      const audioFiles = response.files.filter(isAudioFile);
+      const enriched = await Promise.all(
+        audioFiles.map(async (file) => {
+          try {
+            const details = await client.get(`/v1/audios/${file.id}`);
+            return {
+              audio_id: details.id,
+              file_id: file.id,
+              filename: file.filename,
+              mime_type: file.content_type,
+              size_bytes: details.size_bytes ?? file.size_bytes,
+              status: details.status,
+              codec: details.codec,
+              bit_rate_kbps: details.bit_rate_kbps ?? null,
+              duration_ms: details.duration_ms ?? null,
+              created_at: details.created_at,
+              original_view_url: file.url ?? null,
+              transcoded_url: details.url ?? null,
+              waveform_peaks: details.waveform_peaks
+            };
+          } catch {
+            return toStorageBackedAudioFile(file);
+          }
+        })
+      );
+      return enriched;
+    } catch (err) {
+      const apiError = err;
+      setError(apiError);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+  const remove = useCallback(
+    async (fileId) => {
+      setLoading(true);
+      setError(null);
+      try {
+        const [audioDeleteResult, storageDeleteResult] = await Promise.allSettled([
+          client.delete(`/v1/audios/${fileId}`),
+          client.delete(`/v1/storage/files/${fileId}`)
+        ]);
+        if (storageDeleteResult.status === "rejected" && !isNotFoundError(storageDeleteResult.reason)) {
+          throw storageDeleteResult.reason ?? new Error("Storage delete failed");
+        }
+        if (audioDeleteResult.status === "rejected" && !isNotFoundError(audioDeleteResult.reason)) {
+          console.warn("Audio record delete failed after storage delete", audioDeleteResult.reason);
+        }
+      } catch (err) {
+        const apiError = err;
+        setError(apiError);
+        throw err;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [client]
+  );
+  return {
+    upload,
+    list,
+    remove,
+    error,
+    loading
+  };
+}
 function useMedia() {
   const { storage, photo, video, audio, mediaPolicy: providerDefaultPolicy } = useScaleMule();
   const [uploading, setUploading] = useState(false);
@@ -11221,4 +11408,4 @@ function createSafeLogger(prefix) {
   };
 }
 
-export { FeedbackWidget, ScaleMuleApiError, ScaleMuleClient2 as ScaleMuleClient, ScaleMuleMedia, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, 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, useUser, validateForm, validators };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",