@maravilla-labs/platform 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @maravilla-labs/platform
 
+## 0.14.0
+
+### Minor Changes
+
+- c92a9a3: `transforms.extractFrames` gains an optional `detach_audio` option: extract a video's audio track to a chosen storage key in the same job as the frame extraction, so a single call yields both the frame set and a detachable audio asset.
+
+## 0.13.0
+
+### Minor Changes
+
+- 195fe65: Pre-extracted video frames for deterministic begin-frame renders.
+  - `@maravilla-labs/platform`: add `transforms.extractFrames(srcKey, { fps, ... })`
+    — decode any video to a sequence of still images at a fixed fps, returning a
+    `JobHandle` whose `output_key` holds a `FramesetManifest` (frames live under
+    `${prefix}/frame_NNNNNN.<ext>`). General capability; the frames renderer
+    consumes it to swap `<video>`→`<img>` per frame, and it's reusable for
+    thumbnails/scrubbing. Adds `ExtractFramesOpts` + `FramesetManifest` types.
+  - `@maravilla-labs/frames`: video timeline slots now carry an optional
+    `frameset` key (the `extractFrames` manifest) exposed on
+    `window.__mvFrames.videos[]`; the renderer sets `window.__mvFramesNoVideoSeek`
+    on the begin-frame path so the helper leaves `<video>` inert (live-seeking it
+    crashes Chromium — crbug.com/40656275) while the worker swaps in pre-extracted
+    frames. Editor scrubbing + the screenshot/dev path keep live video seeking.
+
 ## 0.12.0
 
 ### Minor Changes

package/dist/config.d.ts

@@ -1,5 +1,5 @@
-import { T as TransformsConfig } from './transforms-DwCPOVTn.js';
-export { a as TransformsPatternSpec } from './transforms-DwCPOVTn.js';
+import { T as TransformsConfig } from './transforms-BHWez32E.js';
+export { a as TransformsPatternSpec } from './transforms-BHWez32E.js';
 
 /**
  * @fileoverview Typed schema for `maravilla.config.{ts,yaml,json}` files.

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { ActAsContext, AddCircleMemberOptions, AddRelationOptions, ApiKeyInfo, A
 export { b as RenClient, a as RenClientOptions, R as RenEvent, g as getOrCreateClientId, r as renFetch, c as storageDelete, s as storageUpload } from './ren-DetHRhCL.js';
 import { LocalParticipant } from 'livekit-client';
 export { RegisterPushOptions, RegisterPushResult, offsetBefore, registerPush, unregisterPush } from './push.js';
-export { f as DocConvertOpts, D as DocFormat, k as DocInsertQrCodeOpts, j as DocReplaceImagesOpts, m as DocTemplateMergeOpts, e as DocThumbnailOpts, h as DocToHtmlOpts, g as DocToMarkdownOpts, d as DocToPdfOpts, I as ImageFormat, i as ImageRef, o as JobHandle, J as JobStatus, p as JobStatusResponse, M as MediaInfo, O as OcrOpts, Q as QrCodeSpec, l as QrPayload, R as ResizeOpts, c as ThumbnailOpts, b as TranscodeOpts, n as TransformSpec, T as TransformsConfig, a as TransformsPatternSpec, q as TransformsService, V as VideoFormat, r as keyFor, t as transforms } from './transforms-DwCPOVTn.js';
+export { D as DetachAudioOpts, h as DocConvertOpts, e as DocFormat, m as DocInsertQrCodeOpts, l as DocReplaceImagesOpts, o as DocTemplateMergeOpts, g as DocThumbnailOpts, j as DocToHtmlOpts, i as DocToMarkdownOpts, f as DocToPdfOpts, d as ExtractAudioOpts, E as ExtractFramesOpts, F as FramesetManifest, I as ImageFormat, k as ImageRef, q as JobHandle, J as JobStatus, r as JobStatusResponse, M as MediaInfo, O as OcrOpts, Q as QrCodeSpec, n as QrPayload, R as ResizeOpts, c as ThumbnailOpts, b as TranscodeOpts, p as TransformSpec, T as TransformsConfig, a as TransformsPatternSpec, s as TransformsService, V as VideoFormat, t as keyFor, u as transforms } from './transforms-BHWez32E.js';
 
 /**
  * Media service for video/audio room management.

package/dist/index.js

@@ -1097,6 +1097,12 @@ var RemoteTransformsService = class {
   transcode(srcKey, opts) {
     return this.post("/transcode", { srcKey, opts });
   }
+  extractFrames(srcKey, opts) {
+    return this.post("/extract_frames", { srcKey, opts });
+  }
+  extractAudio(srcKey, opts) {
+    return this.post("/extract_audio", { srcKey, opts: opts ?? {} });
+  }
   thumbnail(srcKey, opts) {
     return this.post("/thumbnail", { srcKey, opts });
   }
@@ -2010,6 +2016,10 @@ function outputExtension(spec) {
     case "transcode":
       return spec.format;
     // 'mp4' | 'webm'
+    case "extract_frames":
+      return "json";
+    case "extract_audio":
+      return "m4a";
     case "thumbnail":
     case "resize": {
       const fmt = spec.format ?? "jpg";