@giveitsmaller/contracts 0.85.0 → 0.87.0

package/README.md

@@ -5,8 +5,8 @@
 
 | | |
 |---|---|
-| Package version | `0.85.0` |
-| Generated from spec | **`v2.220.0`** |
+| Package version | `0.87.0` |
+| Generated from spec | **`v2.223.0`** |
 
 ## Two version lines, and they are not comparable
 

package/accepted-options/accepted-options.json

@@ -1214,5 +1214,5 @@
       }
     }
   },
-  "schema_version": "2.220.0"
+  "schema_version": "2.223.0"
 }

package/accepted-options/image-output-routes.json

@@ -260,5 +260,5 @@
       "source_op": "compress"
     }
   },
-  "schema_version": "2.220.0"
+  "schema_version": "2.223.0"
 }

package/asyncapi/events.yaml

@@ -244,9 +244,8 @@ channels:
         [`4NrRPCgh`](https://trello.com/c/4NrRPCgh))
       - `operation_type = split` -> `ops-split` queue (the `audio` and
         `video` mime_groups are `availability: beta` — audio + short-form
-        video split traffic reaches this queue; `image_gif` /
-        `document_pdf` stay `availability: planned` until their Lambdas
-        ship per [`vKI0CFDu`](https://trello.com/c/vKI0CFDu);
+        video split traffic reaches this queue, and so does `image_gif`
+        (`stable`) and `document_pdf` (`beta` since 2026-10-01) traffic;
         long-form video splits route via `processing_class` to the
         `split-video-fargate` worker — same OperationType, different
         worker — now also `availability: beta` (stays beta until a
@@ -908,10 +907,9 @@ channels:
       (workers live on staging). This SNS queue carries audio + SHORT-FORM
       video split traffic only; long-form video split (now also `beta`)
       routes via the direct-to-SQS `longformSplitVideo` claim-check to the
-      `split-video-fargate` worker, NOT here. The `image_gif` and
-      `document_pdf` mime_groups stay `availability: planned`, and the API
-      rejects their workflow-create with `feature_not_available` (422) until those
-      Lambdas ship. Backed by the `operation-split` Lambda (cross-repo
+      `split-video-fargate` worker, NOT here. The `image_gif` (`stable`) and
+      `document_pdf` (`beta`, 2026-10-01) mime_groups also arrive here. Backed
+      by the `operation-split` Lambda (cross-repo
       follow-up — lambdas pre-launch epic Wave A, ticket
       [DbpJpVtm-sibling-L1](https://trello.com/c/vKI0CFDu)
       [`vKI0CFDu`](https://trello.com/c/vKI0CFDu)).
@@ -1319,9 +1317,8 @@ channels:
       Messages land here after 5 failed processing attempts. Live for
       the `split` `audio` + `video` mime_groups (now `availability: beta`;
       this DLQ backs the short-form SNS `ops-split` queue — long-form video
-      split has its own `longformSplitVideoDlq`); the `image_gif` and
-      `document_pdf` groups stay `availability: planned` and carry no
-      traffic yet.
+      split has its own `longformSplitVideoDlq`); it also backs the
+      `image_gif` (`stable`) and `document_pdf` (`beta`) groups.
     parameters:
       env:
         description: Environment (local, stg, prod)
@@ -1642,6 +1639,111 @@ channels:
       region:
         description: AWS region abbreviation (euw1, use1, etc.)
 
+  longformVideoWatermark:
+    address: gisl-{env}-{region}-ops-video-watermark-longform
+    description: |
+      SQS queue for long-form video watermark jobs (`video_watermark.video.long_form`, `planned`;
+      HN-33, [`jOMJOncC`](https://trello.com/c/jOMJOncC)). The API publishes a
+      `LongFormJobMessage` claim-check here directly (NOT via SNS); a
+      terraform-owned launcher reads the spec from S3 (`pointer`) and runs a
+      Fargate task. `max_receive_count = 2` (ADR-0007). On this queue the
+      publisher always sets `operation_type: video_watermark`, `processing_class:
+      long_form`. Declared contract-first: no publisher emits here until api's
+      long-form routing for `video_watermark` ships.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-video-watermark-longform
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      longFormJob:
+        $ref: '#/components/messages/LongFormJobMessage'
+
+  longformVideoWatermarkDlq:
+    address: gisl-{env}-{region}-ops-video-watermark-longform-dlq
+    description: DLQ for failed long-form video watermark jobs. Messages land here after 2 failed processing attempts (ADR-0007).
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
+  longformVideoTextWatermark:
+    address: gisl-{env}-{region}-ops-video-text-watermark-longform
+    description: |
+      SQS queue for long-form video text watermark jobs (`video_text_watermark.video.long_form`, `planned`;
+      HN-33, [`jOMJOncC`](https://trello.com/c/jOMJOncC)). The API publishes a
+      `LongFormJobMessage` claim-check here directly (NOT via SNS); a
+      terraform-owned launcher reads the spec from S3 (`pointer`) and runs a
+      Fargate task. `max_receive_count = 2` (ADR-0007). On this queue the
+      publisher always sets `operation_type: video_text_watermark`, `processing_class:
+      long_form`. Declared contract-first: no publisher emits here until api's
+      long-form routing for `video_text_watermark` ships.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-video-text-watermark-longform
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      longFormJob:
+        $ref: '#/components/messages/LongFormJobMessage'
+
+  longformVideoTextWatermarkDlq:
+    address: gisl-{env}-{region}-ops-video-text-watermark-longform-dlq
+    description: DLQ for failed long-form video text watermark jobs. Messages land here after 2 failed processing attempts (ADR-0007).
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
+  longformAudioToVideo:
+    address: gisl-{env}-{region}-ops-audio-to-video-longform
+    description: |
+      SQS queue for long-form audio-to-video jobs (`audio_to_video.audio.long_form`,
+      `planned`; HN-33, [`d5cywEIR`](https://trello.com/c/d5cywEIR)). The API
+      publishes a `LongFormJobMessage` claim-check here directly (NOT via SNS);
+      a terraform-owned launcher reads the spec from S3 (`pointer`) and runs a
+      Fargate task. `max_receive_count = 2` (ADR-0007). On this queue the
+      publisher always sets `operation_type: audio_to_video`,
+      `processing_class: long_form`. Declared contract-first: no publisher emits
+      here until api's long-form routing for `audio_to_video` ships.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-audio-to-video-longform
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      longFormJob:
+        $ref: '#/components/messages/LongFormJobMessage'
+
+  longformAudioToVideoDlq:
+    address: gisl-{env}-{region}-ops-audio-to-video-longform-dlq
+    description: DLQ for failed long-form audio-to-video jobs. Messages land here after 2 failed processing attempts (ADR-0007).
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
 operations:
   # ============================================
   # PUBLISH OPERATIONS (API -> SNS)
@@ -2486,6 +2588,60 @@ operations:
     messages:
       - $ref: '#/channels/longformSplitVideo/messages/longFormJob'
 
+  publishLongFormVideoWatermark:
+    action: send
+    channel:
+      $ref: '#/channels/longformVideoWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-video-watermark-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Publish a long-form video_watermark claim-check.
+    description: |
+      As `publishLongFormCompressVideo`, for `operation_type = video_watermark`
+      (`video_watermark.video.long_form`). Direct-to-SQS claim-check; no SNS.
+      Contract-first (HN-33): not emitted until api's routing ships.
+    messages:
+      - $ref: '#/channels/longformVideoWatermark/messages/longFormJob'
+
+  publishLongFormVideoTextWatermark:
+    action: send
+    channel:
+      $ref: '#/channels/longformVideoTextWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-video-text-watermark-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Publish a long-form video_text_watermark claim-check.
+    description: |
+      As `publishLongFormCompressVideo`, for `operation_type = video_text_watermark`
+      (`video_text_watermark.video.long_form`). Direct-to-SQS claim-check; no SNS.
+      Contract-first (HN-33): not emitted until api's routing ships.
+    messages:
+      - $ref: '#/channels/longformVideoTextWatermark/messages/longFormJob'
+
+  publishLongFormAudioToVideo:
+    action: send
+    channel:
+      $ref: '#/channels/longformAudioToVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-audio-to-video-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Publish a long-form audio_to_video claim-check.
+    description: |
+      As `publishLongFormCompressVideo`, for `operation_type = audio_to_video`
+      (`audio_to_video.audio.long_form`). Direct-to-SQS claim-check; no SNS.
+      Contract-first (HN-33): not emitted until api's routing ships.
+    messages:
+      - $ref: '#/channels/longformAudioToVideo/messages/longFormJob'
+
   # ============================================
   # LONG-FORM CLAIM-CHECK CONSUMERS (launcher -> Fargate)
   # ============================================
@@ -2549,6 +2705,58 @@ operations:
     messages:
       - $ref: '#/channels/longformSplitVideo/messages/longFormJob'
 
+  consumeLongFormVideoWatermark:
+    action: receive
+    channel:
+      $ref: '#/channels/longformVideoWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-video-watermark-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Consume a long-form video_watermark claim-check.
+    description: |
+      As `consumeLongFormCompressVideo`, for `operation_type = video_watermark`. The
+      launcher forks on `(operation_type=video_watermark, processing_class=long_form)`.
+    messages:
+      - $ref: '#/channels/longformVideoWatermark/messages/longFormJob'
+
+  consumeLongFormVideoTextWatermark:
+    action: receive
+    channel:
+      $ref: '#/channels/longformVideoTextWatermark'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-video-text-watermark-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Consume a long-form video_text_watermark claim-check.
+    description: |
+      As `consumeLongFormCompressVideo`, for `operation_type = video_text_watermark`. The
+      launcher forks on `(operation_type=video_text_watermark, processing_class=long_form)`.
+    messages:
+      - $ref: '#/channels/longformVideoTextWatermark/messages/longFormJob'
+
+  consumeLongFormAudioToVideo:
+    action: receive
+    channel:
+      $ref: '#/channels/longformAudioToVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-audio-to-video-longform
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Consume a long-form audio_to_video claim-check.
+    description: |
+      As `consumeLongFormCompressVideo`, for `operation_type = audio_to_video`.
+      The launcher forks on `(operation_type=audio_to_video,
+      processing_class=long_form)`.
+    messages:
+      - $ref: '#/channels/longformAudioToVideo/messages/longFormJob'
+
 components:
   messages:
     # ============================================
@@ -3918,6 +4126,9 @@ components:
         compression_terraform. `audio_overlay` long-form
         (reserve-name-only, no queue) is NOT yet produced and is therefore
         absent from this enum; it gets added when its publisher ships.
+        `video_watermark` / `video_text_watermark` ARE in the enum ahead of
+        their publisher, deliberately (HN-33 contract-first; see
+        `LongFormOperationType`).
 
         **Scope: the API producer's first-publish.** This schema models the
         message the API publishes to the long-form queues — the 5 fields above.
@@ -5865,10 +6076,13 @@ components:
       description: |
         Coarse operation verb for the long-form claim-check job
         (`LongFormJobMessage.operation_type`). Deliberately a call-site
-        **subset** of `OperationType` — only the long-form classes the API
-        actually publishes today (`compress`, `merge`, `split`). NOT the
-        full `OperationType` enum (which would over-promise the wire).
-        Future long-form publishers widen this enum when they ship.
+        **subset** of `OperationType` — the operations that HAVE a long-form
+        route: the API publishes `compress`, `merge` and `split` today, and
+        `video_watermark` / `video_text_watermark` are declared ahead of their
+        publisher (below), and so is `audio_to_video` (d5cywEIR, same HN-33
+        co-land). NOT the full `OperationType` enum (which would
+        over-promise the wire). A new long-form route widens this enum when it
+        is declared.
 
         `split` joined this enum when the long-form video split publisher
         shipped ([`rcwvUKhI`](https://trello.com/c/rcwvUKhI), per
@@ -5879,6 +6093,14 @@ components:
         `(operation_type=split, processing_class=long_form)` tuple is the
         launcher's fork key.
 
+        `video_watermark` and `video_text_watermark` joined CONTRACT-FIRST
+        ([`jOMJOncC`](https://trello.com/c/jOMJOncC), HN-33): their long-form
+        (Fargate) route is declared so terraform, api (publisher) and lambdas
+        (worker) build against one shape. Until api's publisher ships, nothing
+        is published on their queues, and consumers must deploy before the
+        producer emits (producer-first is the publisher's deploy, gated on
+        the launcher and worker being live).
+
         Named-schema form lifted from inline at
         `LongFormJobMessage.operation_type` per ticket
         [`A3DyuYUd`](https://trello.com/c/A3DyuYUd) — generated SDK bindings
@@ -5888,6 +6110,9 @@ components:
         - compress
         - merge
         - split
+        - video_watermark
+        - video_text_watermark
+        - audio_to_video
 
     LongFormProcessingClass:
       type: string