@mieweb/pulsevault 0.5.0 → 0.7.0

package/scripts/web-ready-migrate.mjs

@@ -1,17 +1,20 @@
 #!/usr/bin/env node
-// Make every already-uploaded video artifact in a local-storage workspace
-// web-playable, in place. New uploads are handled by the `onUploadComplete`
-// web-ready hook (see examples/fastify-demo/server.mjs); this script is the
-// one-time backfill for artifacts that landed before the hook existed.
+// Conform every already-uploaded video artifact in a local-storage workspace
+// to the format PulseVault serves (`CONFORM_TARGET`). New uploads are handled
+// by the `webReady` option; this script is the one-time backfill for
+// artifacts that landed before it was on. Stop the server first: it caches
+// each artifact's extension, which a container change rewrites.
 //
 // For each ready `kind: "video"` sidecar in `<workspaceDir>/.pulsevault/`:
-//   - moov atom at the end of the file  → lossless faststart remux (sub-second)
-//   - non-H.264 video codec (e.g. HEVC) → one-time libx264 transcode
-//   - already web-ready / not MP4 bytes → untouched
+//   - already in the target format          → untouched
+//   - moov atom at the end of an MP4        → lossless faststart remux
+//   - off-target video or audio             → one ffmpeg run (H.264/AAC, scaled, tone-mapped)
+//   - another container (WebM, MKV, MOV, …) → a new `<id>.mp4`; the sidecar
+//     switches to it and the original is deleted
 //
 // Rewrites are atomic (tmp file + rename), so interrupting the script never
 // corrupts an artifact — rerun it and it picks up where it left off (already
-// fixed files report `none` and are skipped for free).
+// fixed files report `none`).
 //
 // Usage:
 //   node scripts/web-ready-migrate.mjs <workspaceDir> [--dry-run] [--no-transcode]
@@ -46,7 +49,7 @@ try {
   process.exit(1);
 }
 
-const counts = { none: 0, remuxed: 0, transcoded: 0, skipped: 0, missing: 0 };
+const counts = { none: 0, remuxed: 0, transcoded: 0, conformed: 0, skipped: 0, missing: 0 };
 let processed = 0;
 
 for (const sidecarFile of sidecarFiles) {
@@ -84,8 +87,29 @@ for (const sidecarFile of sidecarFiles) {
     continue;
   }
 
-  const result = await ensureWebReady(filePath, { transcode, logger: console });
+  const { outputPath, ...result } = await ensureWebReady(filePath, { transcode, logger: console });
   counts[result.action] += 1;
+  // Record what was done on the sidecar, as the server does; a new container also switches the
+  // artifact to its `.mp4` (keeping the uploaded extension as `sourceExt`), then the original
+  // goes. Atomic tmp + rename, like the adapter's own sidecar writes.
+  // A rerun finds a converted file already in the format: keep what the conversion recorded,
+  // and finish what an interrupted run left: the original, once the sidecar names the `.mp4`.
+  if (result.action === "none" && sidecar.webReady) {
+    if (sidecar.sourceExt && sidecar.sourceExt !== sidecar.ext) {
+      await fs.rm(path.join(root, kind, `${artifactId}${sidecar.sourceExt}`), { force: true });
+    }
+    continue;
+  }
+  const next = { ...sidecar, converted: true, webReady: result };
+  if (outputPath) {
+    next.sourceExt = sidecar.sourceExt ?? sidecar.ext;
+    next.ext = path.extname(outputPath);
+  }
+  const sidecarPath = path.join(sidecarDir, sidecarFile);
+  const tmpPath = `${sidecarPath}.migrate.tmp`;
+  await fs.writeFile(tmpPath, JSON.stringify(next), "utf8");
+  await fs.rename(tmpPath, sidecarPath);
+  if (outputPath) await fs.rm(filePath, { force: true });
   if (result.action !== "none") {
     console.log(`${result.action.padEnd(11)}  ${artifactId}  (${result.reason})`);
   }
@@ -96,7 +120,7 @@ if (dryRun) {
 } else {
   console.log(
     `\nDone: ${processed} ready video artifact(s) — ` +
-      `${counts.remuxed} remuxed, ${counts.transcoded} transcoded, ` +
+      `${counts.remuxed} remuxed, ${counts.transcoded} transcoded, ${counts.conformed} conformed, ` +
       `${counts.none} already web-ready, ${counts.skipped} skipped, ${counts.missing} missing.`,
   );
 }