@giveitsmaller/contracts 0.7.0 → 0.9.0

package/operations/schemas/audio_to_video.yaml

@@ -2,7 +2,7 @@ schema_version: "2.0.0"
 
 operation:
   type: audio_to_video
-  availability: planned
+  availability: beta
   description: |
     Produce a video from an audio input plus an OPTIONAL still image
     overlay. Use cases: podcast → YouTube uploads, audio-only tracks
@@ -29,9 +29,11 @@ operation:
     tiny when the overlay is a still image (the common case).
 
     Per ticket [`SlluxMBN`](https://trello.com/c/SlluxMBN) +
-    ADR-0015. `availability: planned` until the cross-repo Lambda
-    support ships; the API rejects workflow-create with
-    `feature_not_available` (422) until then.
+    ADR-0015. Activated to `availability: beta` (Wave A, ticket
+    [`c3uthIP4`](https://trello.com/c/c3uthIP4)): the cross-repo
+    Lambda backend is live (API accepts + publishes), so this is
+    shape-stable + opt-in for callers and MUST NOT return
+    `feature_not_available` — it may still change with notice while beta.
 
   default: false
   input_model: multi

package/operations/schemas/custom_luma.yaml

@@ -12,10 +12,9 @@ operation:
 
     **NOT** related to FFmpeg's `xfade=custom` filter (which is an
     expression-mode parameter on the same `xfade` filter). The
-    `merge.transition.custom` value is tagged `planned` with
-    documentation_url pointing at this operation; once `custom_luma`
-    ships, the merge slot is repurposed to a "use the dedicated
-    `custom_luma` operation instead" advisory.
+    `merge.transition.custom` value is tagged `planned` as an advisory
+    that points callers at this dedicated operation for caller-uploaded
+    luma-matte transitions.
 
     Multi-input: exactly one input with `role: base` (the source
     video being transitioned) + exactly one input with

package/operations/schemas/merge.yaml

@@ -106,11 +106,11 @@ operation:
             # `custom` is `planned` indefinitely as an advisory — for
             # caller-uploaded luma-matte transitions, use the dedicated
             # `custom_luma` operation (multi-input with role: base +
-            # transition_mask) per ticket I29 (EPUE5Vs1). FFmpeg's
+            # transition_mask). FFmpeg's
             # xfade=custom is an expression-mode parameter, not the
             # shape callers want; the dedicated operation is the
             # supported path.
-            custom:       { availability: planned, documentation_url: "https://trello.com/c/EPUE5Vs1" }
+            custom:       { availability: planned }
             wipetl:       { availability: planned, eta: "2026-Q3" }
             wipetr:       { availability: planned, eta: "2026-Q3" }
             wipebl:       { availability: planned, eta: "2026-Q3" }
@@ -212,11 +212,11 @@ operation:
             # `custom` is `planned` indefinitely as an advisory — for
             # caller-uploaded luma-matte transitions, use the dedicated
             # `custom_luma` operation (multi-input with role: base +
-            # transition_mask) per ticket I29 (EPUE5Vs1). FFmpeg's
+            # transition_mask). FFmpeg's
             # xfade=custom is an expression-mode parameter, not the
             # shape callers want; the dedicated operation is the
             # supported path.
-            custom:       { availability: planned, documentation_url: "https://trello.com/c/EPUE5Vs1" }
+            custom:       { availability: planned }
             wipetl:       { availability: planned, eta: "2026-Q3" }
             wipetr:       { availability: planned, eta: "2026-Q3" }
             wipebl:       { availability: planned, eta: "2026-Q3" }
@@ -289,26 +289,30 @@ operation:
           values: [crf, target_size]
           default: crf
           depends_on: { re_encode_mode: [auto, always] }
+          per_value_depends_on:
+            target_size: { codec: [h264] }
           description: |
             CRF (quality-targeted) vs target_size (two-pass to fixed file size).
             `target_size` is currently `codec=h264` only — libx265 / libvpx-vp9 / libsvtav1 each
             require a different two-pass invocation and are tracked as separate per-codec
-            Lambda follow-ups. The contract narrows `target_size_bytes.depends_on` with
-            `codec: [h264]`, which rejects `encoding_mode=target_size + codec ∈ {h265, vp9, av1}`
-            as `invalid_options` **when `target_size_bytes` is present in the request**. Fully
-            gating `encoding_mode=target_size` itself on codec (so that omitting
-            `target_size_bytes` is also rejected) awaits a `per_value_depends_on` schema
-            vocab extension (ticket bsV3FWM5); Lambda continues to catch the residual
-            `target_size + non-h264 + no target_size_bytes` case in the meantime.
+            Lambda follow-ups. The `per_value_depends_on` block above gates
+            `encoding_mode=target_size` itself on `codec ∈ [h264]`, so a request with
+            `encoding_mode=target_size + codec ∈ {h265, vp9, av1}` is rejected as
+            `invalid_options` regardless of whether `target_size_bytes` is supplied —
+            closing the gap left by the previous option-level `depends_on` (which only
+            triggered when `target_size_bytes` was present in the payload). Per ticket
+            [`bsV3FWM5`](https://trello.com/c/bsV3FWM5).
 
         target_size_bytes:
           type: integer
           min: 1048576
-          depends_on: { re_encode_mode: [auto, always], encoding_mode: target_size, codec: [h264] }
+          depends_on: { re_encode_mode: [auto, always], encoding_mode: target_size }
           description: |
             Two-pass target file size in bytes (minimum 1 MiB). Required when
-            `encoding_mode=target_size`. h264-only today; see `encoding_mode` description
-            for per-codec rollout status.
+            `encoding_mode=target_size`. h264-only — the codec gate now lives on
+            `encoding_mode.per_value_depends_on.target_size.codec` (per ticket
+            [`bsV3FWM5`](https://trello.com/c/bsV3FWM5)); this option's own
+            `depends_on` no longer duplicates it.
 
             Practical floor: a ~100 kbps post-AAC video bitrate (i.e. `target_size_bytes`
             corresponding to less than ~100 kbps of video after subtracting the 160 kbps
@@ -355,11 +359,11 @@ operation:
             # `custom` is `planned` indefinitely as an advisory — for
             # caller-uploaded luma-matte transitions, use the dedicated
             # `custom_luma` operation (multi-input with role: base +
-            # transition_mask) per ticket I29 (EPUE5Vs1). FFmpeg's
+            # transition_mask). FFmpeg's
             # xfade=custom is an expression-mode parameter, not the
             # shape callers want; the dedicated operation is the
             # supported path.
-            custom:       { availability: planned, documentation_url: "https://trello.com/c/EPUE5Vs1" }
+            custom:       { availability: planned }
             wipetl:       { availability: planned, eta: "2026-Q3" }
             wipetr:       { availability: planned, eta: "2026-Q3" }
             wipebl:       { availability: planned, eta: "2026-Q3" }

package/operations/schemas/split.yaml

@@ -2,7 +2,7 @@ schema_version: "2.0.0"
 
 operation:
   type: split
-  availability: planned
+  availability: beta
   description: |
     Fan one input file into N outputs across GIF, PDF, audio, and
     video MIME families. Single-input — one input file per job, fanned
@@ -59,9 +59,12 @@ operation:
     via `processing_class`). No schema-side discriminator beyond MIME
     detection + `processing_class`.
 
-    `availability: planned` until the cross-repo Lambda support ships
-    ([`vKI0CFDu`](https://trello.com/c/vKI0CFDu) + lambdas L1).
-    Dispatch returns `feature_not_available` (422) until then.
+    `availability: beta` for the `audio` mime_group (worker live on
+    staging per lambdas #161 — shape-stable + opt-in, MUST NOT 422).
+    The `image_gif`, `document_pdf`, and `video` mime_groups stay
+    `availability: planned` until their cross-repo Lambda workers ship
+    ([`vKI0CFDu`](https://trello.com/c/vKI0CFDu) + lambdas L1); dispatch
+    returns `feature_not_available` (422) for those groups until then.
 
     Per ADR-0014.
   default: false
@@ -81,6 +84,7 @@ operation:
     # Animated GIF base — parallel mime_group naming follows the
     # `image_gif` precedent established by `image_watermark.image_gif`.
     image_gif:
+      availability: planned
       mimes:
         - image/gif
       options:
@@ -106,6 +110,7 @@ operation:
 
     # PDF base — page-split via qpdf or pdftk equivalent.
     document_pdf:
+      availability: planned
       mimes:
         - application/pdf
       options:
@@ -145,6 +150,7 @@ operation:
 
     # Audio base — three modes + precision flag.
     audio:
+      availability: beta
       mimes:
         - audio/mpeg
         - audio/aac
@@ -223,6 +229,7 @@ operation:
     # Long-form routes to `split-video-fargate` (same OperationType,
     # different worker per `processing_class`).
     video:
+      availability: planned
       mimes:
         - video/mp4
         - video/webm

package/operations/schemas/video_watermark.yaml

@@ -2,7 +2,7 @@ schema_version: "2.0.0"
 
 operation:
   type: video_watermark
-  availability: planned
+  availability: beta
   description: |
     Apply an image overlay (file or external source) onto a base video
     asset using FFmpeg's `overlay` filter. Multi-input role-based:
@@ -21,9 +21,17 @@ operation:
     unchanged via FFmpeg stream-copy — the watermark applies to the
     visual track only.
 
-    `availability: planned` until the cross-repo Lambda support ships;
-    dispatch returns `feature_not_available` (422) until then. Per
-    ADR-0013 + lambdas pre-launch epic Wave A (ticket
+    Activated to `availability: beta` (Wave A, ticket
+    [`c3uthIP4`](https://trello.com/c/c3uthIP4)): the cross-repo Lambda
+    backend is live (API accepts + publishes via the operations SNS
+    topic), so the operation and its `short_form` processing class are
+    shape-stable + opt-in and MUST NOT return `feature_not_available`.
+    `long_form` stays `planned` (no live Fargate worker yet — its
+    long-form path is not provisioned) and the `multi_overlay_stack`
+    feature stays `planned` (Lambda support unconfirmed); requesting
+    those planned sub-features DOES still return `feature_not_available`
+    until they are separately activated. Per ADR-0013 + lambdas
+    pre-launch epic Wave A (ticket
     [`SlluxMBN`'s sibling `4NrRPCgh`](https://trello.com/c/4NrRPCgh)).
   default: false
   input_model: multi
@@ -55,7 +63,7 @@ operation:
         - video/webm
       processing_class:
         short_form:
-          availability: planned
+          availability: beta
           constraints:
             max_input_duration: "PT5M"
             max_input_size_bytes: 524288000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/contracts",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Generated contract types for GISL (Give It Smaller)",
   "license": "MIT",
   "type": "module",