@scalemule/nextjs 0.1.22 → 0.1.24

package/dist/index.d.mts

@@ -898,10 +898,11 @@ interface NarrationPlayerProps {
     providerLabel?: string;
     narrationLabel?: string;
     refreshing?: boolean;
-    onRefresh?: () => void;
+    onRefresh?: () => void | Promise<void>;
+    showRefreshButton?: boolean;
     onPlaybackError?: () => void;
 }
-declare function NarrationPlayer({ audio, className, providerLabel, narrationLabel, refreshing, onRefresh, onPlaybackError, }: NarrationPlayerProps): react_jsx_runtime.JSX.Element | null;
+declare function NarrationPlayer({ audio, className, providerLabel, narrationLabel, refreshing, onRefresh, showRefreshButton, onPlaybackError, }: NarrationPlayerProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Client-side validation helpers

package/dist/index.d.ts

@@ -898,10 +898,11 @@ interface NarrationPlayerProps {
     providerLabel?: string;
     narrationLabel?: string;
     refreshing?: boolean;
-    onRefresh?: () => void;
+    onRefresh?: () => void | Promise<void>;
+    showRefreshButton?: boolean;
     onPlaybackError?: () => void;
 }
-declare function NarrationPlayer({ audio, className, providerLabel, narrationLabel, refreshing, onRefresh, onPlaybackError, }: NarrationPlayerProps): react_jsx_runtime.JSX.Element | null;
+declare function NarrationPlayer({ audio, className, providerLabel, narrationLabel, refreshing, onRefresh, showRefreshButton, onPlaybackError, }: NarrationPlayerProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Client-side validation helpers

package/dist/index.js

@@ -11289,6 +11289,7 @@ function FeedbackWidget(props) {
   ] });
 }
 var SPEEDS = [1, 1.25, 1.5, 2];
+var EXPIRY_REFRESH_WINDOW_MS = 3e4;
 var styles = {
   root: {
     borderRadius: "1.75rem",
@@ -11462,10 +11463,14 @@ function NarrationPlayer({
   narrationLabel = "AI-Narrated",
   refreshing = false,
   onRefresh,
+  showRefreshButton = false,
   onPlaybackError
 }) {
   const audioRef = React.useRef(null);
   const scrubRef = React.useRef(null);
+  const pendingResumeRef = React.useRef(false);
+  const pendingResumeTimeRef = React.useRef(null);
+  const recoveredUrlRef = React.useRef(null);
   const [playing, setPlaying] = React.useState(false);
   const [currentTime, setCurrentTime] = React.useState(0);
   const [duration, setDuration] = React.useState(audio.duration_ms ? audio.duration_ms / 1e3 : 0);
@@ -11480,10 +11485,26 @@ function NarrationPlayer({
   React.useEffect(() => {
     const element = audioRef.current;
     if (!element) return;
-    setCurrentTime(0);
+    recoveredUrlRef.current = null;
+    const resumeTime = pendingResumeTimeRef.current;
+    setCurrentTime(resumeTime ?? 0);
     setPlaying(false);
     element.pause();
-    element.currentTime = 0;
+    try {
+      element.currentTime = resumeTime ?? 0;
+    } catch {
+      element.currentTime = 0;
+    }
+    if (pendingResumeRef.current) {
+      pendingResumeRef.current = false;
+      pendingResumeTimeRef.current = null;
+      element.play().catch(() => {
+        setPlaying(false);
+        onPlaybackError?.();
+      });
+      return;
+    }
+    pendingResumeTimeRef.current = null;
   }, [audio.url]);
   React.useEffect(() => {
     const element = audioRef.current;
@@ -11491,10 +11512,49 @@ function NarrationPlayer({
     element.playbackRate = speed;
     element.preservesPitch = true;
   }, [speed]);
+  function isUrlExpiringSoon() {
+    if (!audio.expires_at) {
+      return false;
+    }
+    const expiresAtMs = Date.parse(audio.expires_at);
+    if (!Number.isFinite(expiresAtMs)) {
+      return false;
+    }
+    return expiresAtMs - Date.now() <= EXPIRY_REFRESH_WINDOW_MS;
+  }
+  async function refreshAndResume() {
+    if (!onRefresh || refreshing) {
+      return false;
+    }
+    if (recoveredUrlRef.current === (audio.url ?? null)) {
+      return false;
+    }
+    recoveredUrlRef.current = audio.url ?? null;
+    pendingResumeRef.current = true;
+    pendingResumeTimeRef.current = currentTime;
+    try {
+      await Promise.resolve(onRefresh());
+      return true;
+    } catch {
+      pendingResumeRef.current = false;
+      pendingResumeTimeRef.current = null;
+      onPlaybackError?.();
+      return false;
+    }
+  }
   function togglePlayback() {
     const element = audioRef.current;
     if (!element) return;
     if (element.paused) {
+      if (refreshing) {
+        pendingResumeRef.current = true;
+        pendingResumeTimeRef.current = currentTime;
+        return;
+      }
+      if (onRefresh && isUrlExpiringSoon()) {
+        void refreshAndResume();
+        return;
+      }
       element.play().catch(() => {
         setPlaying(false);
         onPlaybackError?.();
@@ -11537,7 +11597,17 @@ function NarrationPlayer({
         onPlay: () => setPlaying(true),
         onPause: () => setPlaying(false),
         onEnded: () => setPlaying(false),
-        onError: () => onPlaybackError?.()
+        onError: () => {
+          if (onRefresh) {
+            void refreshAndResume().then((didRefresh) => {
+              if (!didRefresh) {
+                onPlaybackError?.();
+              }
+            });
+            return;
+          }
+          onPlaybackError?.();
+        }
       }
     ),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles.layout, children: [
@@ -11649,7 +11719,7 @@ function NarrationPlayer({
             ]
           }
         ),
-        onRefresh && /* @__PURE__ */ jsxRuntime.jsx(
+        onRefresh && showRefreshButton && /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
             type: "button",

package/dist/index.mjs

@@ -11269,6 +11269,7 @@ function FeedbackWidget(props) {
   ] });
 }
 var SPEEDS = [1, 1.25, 1.5, 2];
+var EXPIRY_REFRESH_WINDOW_MS = 3e4;
 var styles = {
   root: {
     borderRadius: "1.75rem",
@@ -11442,10 +11443,14 @@ function NarrationPlayer({
   narrationLabel = "AI-Narrated",
   refreshing = false,
   onRefresh,
+  showRefreshButton = false,
   onPlaybackError
 }) {
   const audioRef = useRef(null);
   const scrubRef = useRef(null);
+  const pendingResumeRef = useRef(false);
+  const pendingResumeTimeRef = useRef(null);
+  const recoveredUrlRef = useRef(null);
   const [playing, setPlaying] = useState(false);
   const [currentTime, setCurrentTime] = useState(0);
   const [duration, setDuration] = useState(audio.duration_ms ? audio.duration_ms / 1e3 : 0);
@@ -11460,10 +11465,26 @@ function NarrationPlayer({
   useEffect(() => {
     const element = audioRef.current;
     if (!element) return;
-    setCurrentTime(0);
+    recoveredUrlRef.current = null;
+    const resumeTime = pendingResumeTimeRef.current;
+    setCurrentTime(resumeTime ?? 0);
     setPlaying(false);
     element.pause();
-    element.currentTime = 0;
+    try {
+      element.currentTime = resumeTime ?? 0;
+    } catch {
+      element.currentTime = 0;
+    }
+    if (pendingResumeRef.current) {
+      pendingResumeRef.current = false;
+      pendingResumeTimeRef.current = null;
+      element.play().catch(() => {
+        setPlaying(false);
+        onPlaybackError?.();
+      });
+      return;
+    }
+    pendingResumeTimeRef.current = null;
   }, [audio.url]);
   useEffect(() => {
     const element = audioRef.current;
@@ -11471,10 +11492,49 @@ function NarrationPlayer({
     element.playbackRate = speed;
     element.preservesPitch = true;
   }, [speed]);
+  function isUrlExpiringSoon() {
+    if (!audio.expires_at) {
+      return false;
+    }
+    const expiresAtMs = Date.parse(audio.expires_at);
+    if (!Number.isFinite(expiresAtMs)) {
+      return false;
+    }
+    return expiresAtMs - Date.now() <= EXPIRY_REFRESH_WINDOW_MS;
+  }
+  async function refreshAndResume() {
+    if (!onRefresh || refreshing) {
+      return false;
+    }
+    if (recoveredUrlRef.current === (audio.url ?? null)) {
+      return false;
+    }
+    recoveredUrlRef.current = audio.url ?? null;
+    pendingResumeRef.current = true;
+    pendingResumeTimeRef.current = currentTime;
+    try {
+      await Promise.resolve(onRefresh());
+      return true;
+    } catch {
+      pendingResumeRef.current = false;
+      pendingResumeTimeRef.current = null;
+      onPlaybackError?.();
+      return false;
+    }
+  }
   function togglePlayback() {
     const element = audioRef.current;
     if (!element) return;
     if (element.paused) {
+      if (refreshing) {
+        pendingResumeRef.current = true;
+        pendingResumeTimeRef.current = currentTime;
+        return;
+      }
+      if (onRefresh && isUrlExpiringSoon()) {
+        void refreshAndResume();
+        return;
+      }
       element.play().catch(() => {
         setPlaying(false);
         onPlaybackError?.();
@@ -11517,7 +11577,17 @@ function NarrationPlayer({
         onPlay: () => setPlaying(true),
         onPause: () => setPlaying(false),
         onEnded: () => setPlaying(false),
-        onError: () => onPlaybackError?.()
+        onError: () => {
+          if (onRefresh) {
+            void refreshAndResume().then((didRefresh) => {
+              if (!didRefresh) {
+                onPlaybackError?.();
+              }
+            });
+            return;
+          }
+          onPlaybackError?.();
+        }
       }
     ),
     /* @__PURE__ */ jsxs("div", { style: styles.layout, children: [
@@ -11629,7 +11699,7 @@ function NarrationPlayer({
             ]
           }
         ),
-        onRefresh && /* @__PURE__ */ jsx(
+        onRefresh && showRefreshButton && /* @__PURE__ */ jsx(
           "button",
           {
             type: "button",

package/package.json

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