@epic-web/workshop-utils 6.57.0 → 6.59.0

package/dist/offline-videos.server.d.ts

@@ -85,10 +85,13 @@ export declare function downloadOfflineVideo({ playbackId, title, url, }: {
     url: string;
 }): Promise<{
     readonly status: "error";
+    readonly message: string;
 } | {
     readonly status: "ready";
+    readonly message?: undefined;
 } | {
     readonly status: "downloaded";
+    readonly message?: undefined;
 }>;
 export declare function deleteOfflineVideo(playbackId: string, options?: {
     workshopId?: string;

package/dist/offline-videos.server.js

@@ -358,14 +358,26 @@ async function downloadMuxVideo({ playbackId, filePath, key, iv, resolution, })
         status: 'downloading',
     });
     for (const url of urls) {
+        log.info('Attempting mux download', { playbackId, url });
         const response = await fetch(url).catch((error) => {
             lastError = error;
+            log.warn('Mux download request failed', {
+                playbackId,
+                url,
+                message: lastError.message,
+            });
             return null;
         });
         if (!response)
             continue;
         if (!response.ok || !response.body) {
             lastError = new Error(`Failed to download ${playbackId} from ${url} (${response.status})`);
+            log.warn('Mux download response not ok', {
+                playbackId,
+                url,
+                status: response.status,
+                hasBody: Boolean(response.body),
+            });
             continue;
         }
         // Get content-length if available for progress tracking
@@ -403,6 +415,11 @@ async function downloadMuxVideo({ playbackId, filePath, key, iv, resolution, })
             totalBytes: stat.size,
             status: 'complete',
         });
+        log.info('Mux download complete', {
+            playbackId,
+            url,
+            size: stat.size,
+        });
         return { size: stat.size };
     }
     emitDownloadProgress({
@@ -421,6 +438,10 @@ async function runOfflineVideoDownloads({ videos, index, keyInfo, workshop, reso
             title: video.title,
         };
         downloadState.updatedAt = updatedAt;
+        log.info('Downloading offline video', {
+            playbackId: video.playbackId,
+            title: video.title,
+        });
         const iv = createOfflineVideoIv();
         const entry = {
             playbackId: video.playbackId,
@@ -551,6 +572,10 @@ export async function startOfflineVideoDownload({ request, } = {}) {
         allowUserIdUpdate: true,
     });
     if (!keyInfo) {
+        log.warn('Offline video download unavailable: missing key info', {
+            available: videos.length,
+            unavailable,
+        });
         return {
             state: downloadState,
             available: videos.length,
@@ -590,6 +615,11 @@ export async function startOfflineVideoDownload({ request, } = {}) {
         current: null,
         errors: [],
     };
+    log.info('Offline video downloads queued', {
+        queued: downloads.length,
+        skipped: alreadyDownloaded,
+        unavailable,
+    });
     if (downloads.length > 0) {
         const resolution = await getOfflineVideoDownloadResolution();
         void runOfflineVideoDownloads({
@@ -613,6 +643,7 @@ export async function startOfflineVideoDownload({ request, } = {}) {
     };
 }
 export async function downloadOfflineVideo({ playbackId, title, url, }) {
+    log.info('Offline video download requested', { playbackId, title, url });
     const workshop = getWorkshopIdentity();
     const index = await readOfflineVideoIndex();
     const authInfo = await getAuthInfo();
@@ -620,8 +651,16 @@ export async function downloadOfflineVideo({ playbackId, title, url, }) {
         userId: authInfo?.id ?? null,
         allowUserIdUpdate: true,
     });
-    if (!keyInfo)
-        return { status: 'error' };
+    if (!keyInfo) {
+        log.warn('Offline video download failed: missing key info', {
+            playbackId,
+        });
+        const message = `Unable to download "${title}". Try again later.`;
+        return {
+            status: 'error',
+            message,
+        };
+    }
     const resolution = await getOfflineVideoDownloadResolution();
     const existing = index[playbackId];
     if (existing?.status === 'ready' &&
@@ -665,18 +704,21 @@ export async function downloadOfflineVideo({ playbackId, title, url, }) {
             updatedAt: new Date().toISOString(),
         };
         await writeOfflineVideoIndex(index);
+        log.info('Offline video download complete', { playbackId, size });
         return { status: 'downloaded' };
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : 'Download failed';
+        const detailedMessage = error instanceof Error ? error.message : 'Download failed';
+        const message = `Failed to download "${title}". Please try again.`;
+        log.error(`Offline video download failed for ${playbackId}`, error);
         index[playbackId] = {
             ...entry,
             status: 'error',
-            error: message,
+            error: detailedMessage,
             updatedAt: new Date().toISOString(),
         };
         await writeOfflineVideoIndex(index);
-        return { status: 'error' };
+        return { status: 'error', message };
     }
 }
 export async function deleteOfflineVideo(playbackId, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epic-web/workshop-utils",
-  "version": "6.57.0",
+  "version": "6.59.0",
   "publishConfig": {
     "access": "public"
   },