@giveitsmaller/contracts 0.51.0 → 0.53.0

package/accepted-options/accepted-options.json

@@ -1125,6 +1125,43 @@
         "output_format_option": null
       }
     },
+    "transform": {
+      "document_pdf": {
+        "accepted_options": {
+          "*": [
+            "rotate"
+          ]
+        },
+        "output_format_option": null
+      },
+      "image": {
+        "accepted_options": {
+          "*": [
+            "flip",
+            "rotate"
+          ]
+        },
+        "output_format_option": null
+      },
+      "image_gif": {
+        "accepted_options": {
+          "*": [
+            "flip",
+            "rotate"
+          ]
+        },
+        "output_format_option": null
+      },
+      "video": {
+        "accepted_options": {
+          "*": [
+            "flip",
+            "rotate"
+          ]
+        },
+        "output_format_option": null
+      }
+    },
     "video_text_watermark": {
       "video": {
         "accepted_options": {
@@ -1160,5 +1197,5 @@
       }
     }
   },
-  "schema_version": "2.152.0"
+  "schema_version": "2.154.0"
 }

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

@@ -246,5 +246,5 @@
       "source_op": "compress"
     }
   },
-  "schema_version": "2.152.0"
+  "schema_version": "2.154.0"
 }

package/asyncapi/events.yaml

@@ -93,7 +93,10 @@ info:
       `operation-custom-luma` (planned per ticket I29 — not yet shipped),
       `operation-audio-overlay` (planned per ticket I19 — not yet shipped),
       `operation-audio-watermark` (planned per ticket I20 —
-      enterprise-tier; not yet shipped).
+      enterprise-tier; not yet shipped),
+      `operation-transform-image`, `operation-transform-video`,
+      `operation-transform-document` (all planned per epic fhiWebI0 /
+      ADR-0026 — not yet shipped).
 
     **Message Types**
 
@@ -175,7 +178,7 @@ channels:
     address: gisl-{env}-{region}-operations
     description: |
       SNS topic where the API publishes **non-compression** operation
-      requests (thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark, audio_to_video, video_watermark, video_text_watermark, split). Filter
+      requests (thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark, audio_to_video, video_watermark, video_text_watermark, split, transform). Filter
       attribute: `operation_type` (single-attribute filter policy).
       Subscriptions fan out to per-operation-type queues, keyed by
       `operation_type` value.
@@ -233,6 +236,23 @@ channels:
         [`w3EwzHYd`](https://trello.com/c/w3EwzHYd) /
         [`MNuDYJaY`](https://trello.com/c/MNuDYJaY) — same
         `feature_not_available` 422 gating)
+      - `operation_type = transform_image` -> `ops-transform-image` queue
+      - `operation_type = transform_video` -> `ops-transform-video` queue
+      - `operation_type = transform_document` -> `ops-transform-document`
+        queue
+
+        The three `transform_*` values are the per-media routing sub-types
+        of the single `transform` op (geometry — rotate + flip, ADR-0026),
+        mirroring the thumbnail attribute/payload split: the payload
+        `operation_type` field always stays the base value `transform`; the
+        publisher resolves each operation's effective input MIME to the
+        matching `transform_{image,video,document}` SNS attribute. All three
+        media groups are `availability: planned` until their Lambdas ship
+        (epic `fhiWebI0`) — the API rejects workflow-create with
+        `feature_not_available` (422) so no transform traffic reaches the
+        topic today. There is no legacy bare-`transform` routing target
+        (unlike thumbnail): the base value is payload-only, never an SNS
+        attribute.
 
       The API's Option A publisher sets `operation_type` as the filter
       attribute and additionally sets `media_group` as an **informational**
@@ -529,6 +549,93 @@ channels:
       operationRequest:
         $ref: '#/components/messages/OperationRequestMessage'
 
+  opsTransformImage:
+    address: gisl-{env}-{region}-ops-transform-image
+    description: |
+      SQS queue for image transform operations (rotate + flip, ADR-0026).
+      Subscribed to the `operations` SNS topic with filter
+      `operation_type = transform_image`. Backed by the image transform
+      Lambda (`operation-transform-image`, Rust image crate).
+
+      Receives traffic for image inputs — the API publisher emits
+      `operation_type=transform_image` on the SNS attribute (resolved from
+      the operation's effective input MIME); the payload `operation_type`
+      field stays `transform`. `availability: planned` (epic fhiWebI0) —
+      no traffic until the Lambda ships.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-transform-image
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      operationRequest:
+        $ref: '#/components/messages/OperationRequestMessage'
+
+  opsTransformVideo:
+    address: gisl-{env}-{region}-ops-transform-video
+    description: |
+      SQS queue for video transform operations (rotate + flip, ADR-0026).
+      Subscribed to the `operations` SNS topic with filter
+      `operation_type = transform_video`. Backed by the video transform
+      Lambda (`operation-transform-video`, FFmpeg hflip/vflip/transpose —
+      re-encode).
+
+      Receives traffic for video inputs — the API publisher emits
+      `operation_type=transform_video` on the SNS attribute (resolved from
+      the operation's effective input MIME); the payload `operation_type`
+      field stays `transform`. `availability: planned` (epic fhiWebI0) —
+      no traffic until the Lambda ships.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-transform-video
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      operationRequest:
+        $ref: '#/components/messages/OperationRequestMessage'
+
+  opsTransformDocument:
+    address: gisl-{env}-{region}-ops-transform-document
+    description: |
+      SQS queue for document transform operations (PDF page rotate only,
+      ADR-0026). Subscribed to the `operations` SNS topic with filter
+      `operation_type = transform_document`. Backed by the document
+      transform Lambda (`operation-transform-document`).
+
+      Receives traffic for PDF inputs — the API publisher emits
+      `operation_type=transform_document` on the SNS attribute (resolved
+      from the operation's effective input MIME); the payload
+      `operation_type` field stays `transform`. The routing label is
+      media-family level (`transform_document`) though v1 gates the group
+      to PDF. `availability: planned` (epic fhiWebI0) — no traffic until
+      the Lambda ships.
+    bindings:
+      sqs:
+        queue:
+          name: gisl-{env}-{region}-ops-transform-document
+          fifoQueue: false
+        bindingVersion: '0.2.0'
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+    messages:
+      operationRequest:
+        $ref: '#/components/messages/OperationRequestMessage'
+
   opsImageWatermark:
     address: gisl-{env}-{region}-ops-image-watermark
     description: |
@@ -995,6 +1102,33 @@ channels:
       region:
         description: AWS region abbreviation (euw1, use1, etc.)
 
+  opsTransformImageDlq:
+    address: gisl-{env}-{region}-ops-transform-image-dlq
+    description: DLQ for failed image transform operations. Messages land here after 5 failed processing attempts.
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
+  opsTransformVideoDlq:
+    address: gisl-{env}-{region}-ops-transform-video-dlq
+    description: DLQ for failed video transform operations. Messages land here after 5 failed processing attempts.
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
+  opsTransformDocumentDlq:
+    address: gisl-{env}-{region}-ops-transform-document-dlq
+    description: DLQ for failed document transform operations. Messages land here after 5 failed processing attempts.
+    parameters:
+      env:
+        description: Environment (local, stg, prod)
+      region:
+        description: AWS region abbreviation (euw1, use1, etc.)
+
   opsImageWatermarkDlq:
     address: gisl-{env}-{region}-ops-image-watermark-dlq
     description: DLQ for failed image_watermark operations. Messages land here after 5 failed processing attempts.
@@ -1500,7 +1634,10 @@ operations:
       (including the four sub-type values during the migration window),
       image_watermark, text_watermark, merge, archive, convert,
       custom_luma, audio_overlay, audio_watermark, audio_to_video,
-      video_watermark, video_text_watermark, split. The target SNS
+      video_watermark, video_text_watermark, split, transform (the payload
+      `operation_type` stays base `transform`, while the SNS attribute
+      carries one of the `transform_{image,video,document}` sub-types
+      resolved from the effective input MIME — ADR-0026). The target SNS
       topic filters subscriptions on `operation_type` alone.
 
       **Message attributes set on this branch:** `{operation_type,
@@ -1694,6 +1831,64 @@ operations:
     messages:
       - $ref: '#/channels/opsThumbnailOffice/messages/operationRequest'
 
+  consumeTransformImageOperation:
+    action: receive
+    channel:
+      $ref: '#/channels/opsTransformImage'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-transform-image
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Process image transform operation
+    description: |
+      The image transform Lambda consumes transform requests routed by
+      `operation_type=transform_image`. Backed by the Rust image crate
+      (fliph/flipv/rotate90/180/270). Receives traffic for image inputs —
+      see channel description. `availability: planned` (epic fhiWebI0).
+    messages:
+      - $ref: '#/channels/opsTransformImage/messages/operationRequest'
+
+  consumeTransformVideoOperation:
+    action: receive
+    channel:
+      $ref: '#/channels/opsTransformVideo'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-transform-video
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Process video transform operation
+    description: |
+      The video transform Lambda consumes transform requests routed by
+      `operation_type=transform_video`. Backed by FFmpeg
+      (hflip/vflip/transpose — re-encode). Receives traffic for video
+      inputs — see channel description. `availability: planned` (epic
+      fhiWebI0).
+    messages:
+      - $ref: '#/channels/opsTransformVideo/messages/operationRequest'
+
+  consumeTransformDocumentOperation:
+    action: receive
+    channel:
+      $ref: '#/channels/opsTransformDocument'
+    bindings:
+      sqs:
+        queues:
+          - name: gisl-{env}-{region}-ops-transform-document
+            fifoQueue: false
+        bindingVersion: '0.2.0'
+    summary: Process document transform operation
+    description: |
+      The document transform Lambda consumes transform requests routed by
+      `operation_type=transform_document`. Backed by a PDF page-rotate
+      worker. Receives traffic for PDF inputs — see channel description.
+      `availability: planned` (epic fhiWebI0).
+    messages:
+      - $ref: '#/channels/opsTransformDocument/messages/operationRequest'
+
   consumeImageWatermarkOperation:
     action: receive
     channel:
@@ -2368,9 +2563,10 @@ components:
         **non-compression** operation (thumbnail, image_watermark,
         text_watermark, merge, archive, convert, custom_luma,
         audio_overlay, audio_watermark, audio_to_video,
-        video_watermark, video_text_watermark, split). Published to the
-        `operations` SNS topic; routed by the single-attribute
-        filter `operation_type` to one of the ops-family queues.
+        video_watermark, video_text_watermark, split, transform).
+        Published to the `operations` SNS topic; routed by the
+        single-attribute filter `operation_type` to one of the ops-family
+        queues.
 
         **SNS Message Attributes:**
         - `operation_type`: always present. Values: `thumbnail`,
@@ -2378,8 +2574,12 @@ components:
           `thumbnail_office`, `image_watermark`, `text_watermark`,
           `merge`, `archive`, `convert`, `custom_luma`,
           `audio_overlay`, `audio_watermark`, `audio_to_video`,
-          `video_watermark`, `video_text_watermark`, `split`. Used by
-          SNS as the filter attribute on the `operations` topic.
+          `video_watermark`, `video_text_watermark`, `split`,
+          `transform_image`, `transform_video`, `transform_document`. Used
+          by SNS as the filter attribute on the `operations` topic. (The
+          transform sub-types are routing-only — the payload
+          `operation_type` field carries the base value `transform`;
+          there is no bare-`transform` attribute value.)
         - `media_group`: informational metadata, present for every
           operation except `archive` (which is media-agnostic). Values:
           `image`, `video`, `audio`, `document`. **Not** used by SNS as
@@ -2466,6 +2666,23 @@ components:
               height: 512
               fit: "max"
               format: "webp"
+        - name: Transform Image (sub-type routing)
+          summary: Rotate + flip an image via the transform op. The SNS attribute `operation_type` carries the sub-type `transform_image` (drives routing); the payload `operation_type` carries the base value `transform`. Availability is planned today.
+          headers:
+            operation_type: "transform_image"
+            media_group: "image"
+          payload:
+            job_id: "018f9c42-5d6b-7481-b3df-9fd0a0a5e131"
+            operation_id: "018f9c42-5d6b-7481-b3df-9fd0a0a5e231"
+            operation_type: "transform"
+            file_type: "image/jpeg"
+            source_bucket: "gisl-stg-euw1-input"
+            source_key: "uploads/018f9c42-mmnn/selfie.jpg"
+            output_bucket: "gisl-stg-euw1-output"
+            output_key_prefix: "jobs/018f9c42-5d6b-7481-b3df-9fd0a0a5e131/018f9c42-5d6b-7481-b3df-9fd0a0a5e231/"
+            options:
+              rotate: 90
+              flip: "horizontal"
         - name: Image Watermark (file overlay)
           summary: Apply a PNG logo overlay to a JPEG image (V2 multi-input Path B)
           headers:
@@ -3199,6 +3416,13 @@ components:
           - `thumbnail_document` -> `document`
           - `thumbnail_office` -> `document` (office files are routed as
             documents at the media_group level)
+        - For the three transform sub-types (ADR-0026 — the single
+          `transform` op's per-media routing attributes; the payload
+          `operation_type` stays base `transform`), `media_group` is
+          constrained to the matching media:
+          - `transform_image` -> `image`
+          - `transform_video` -> `video`
+          - `transform_document` -> `document`
       required:
         - operation_type
       properties:
@@ -3234,6 +3458,9 @@ components:
             - video_text_watermark
             - split
             - render_variants
+            - transform_image
+            - transform_video
+            - transform_document
         media_group:
           type: string
           description: |
@@ -3330,6 +3557,30 @@ components:
             properties:
               media_group:
                 const: document
+        - if:
+            properties:
+              operation_type:
+                const: transform_image
+          then:
+            properties:
+              media_group:
+                const: image
+        - if:
+            properties:
+              operation_type:
+                const: transform_video
+          then:
+            properties:
+              media_group:
+                const: video
+        - if:
+            properties:
+              operation_type:
+                const: transform_document
+          then:
+            properties:
+              media_group:
+                const: document
         - if:
             properties:
               operation_type:
@@ -3368,9 +3619,9 @@ components:
         API to SNS, consumed by Lambda from SQS.
 
         **Single-input operations** (compress, thumbnail, text_watermark,
-        convert, audio_watermark, video_text_watermark, split): use
-        `source_bucket` + `source_key` for the input file. `file_type` is
-        required.
+        convert, audio_watermark, video_text_watermark, split, transform):
+        use `source_bucket` + `source_key` for the input file. `file_type`
+        is required.
 
         **Multi-input operations** (merge, archive, image_watermark,
         custom_luma, audio_overlay, audio_to_video, video_watermark):
@@ -3409,6 +3660,7 @@ components:
                   - video_text_watermark
                   - split
                   - render_variants
+                  - transform
           then:
             required:
               - file_type
@@ -4763,9 +5015,11 @@ components:
         enum is deliberately narrower than the SNS `operation_type`
         MessageAttribute: the attribute enum permits per-media thumbnail
         sub-types (`thumbnail_image`, `thumbnail_video`,
-        `thumbnail_document`, `thumbnail_office`) for routing on the
-        `operations` topic, but the payload body always carries the
-        semantic base value (`thumbnail`). See
+        `thumbnail_document`, `thumbnail_office`) and per-media transform
+        sub-types (`transform_image`, `transform_video`,
+        `transform_document`) for routing on the `operations` topic, but the
+        payload body always carries the semantic base value (`thumbnail` /
+        `transform`). See
         `OperationRequestAttributes.operation_type` for the broader
         attribute enum and the routing contract. Note that the attribute
         values the publisher currently emits are governed by the
@@ -4895,6 +5149,20 @@ components:
           `planned`. Routes via `operation_type=split` to `ops-split`.
           Per ADR-0004 + ADR-0014
           ([`vKI0CFDu`](https://trello.com/c/vKI0CFDu)).
+        - `transform`: Geometric/orientation transform — v1 = rotate
+          (0/90/180/270) + flip (none/horizontal/vertical/both), ADR-0026.
+          Single-input; `produces: same_as_input`. The payload always
+          carries the base value `transform`; the SNS `operation_type`
+          attribute enum additionally permits the three per-media sub-type
+          values (`transform_image`, `transform_video`,
+          `transform_document`) for routing to the matching per-media
+          Lambda (there is NO legacy bare-`transform` routing target — the
+          base value is payload-only). All media groups
+          (image jpeg/png/webp + image_gif; video mp4/webm; document PDF
+          rotate-only) are `availability: planned`; the API rejects
+          workflow-create with `feature_not_available` (422) until the
+          transform Lambdas ship, so no traffic reaches SNS today. Audio is
+          not supported. Per ADR-0026 (epic `fhiWebI0`).
 
         Note: the `passthrough` OpenAPI operation is **deliberately
         absent** from this payload enum. A passthrough source job is
@@ -4918,6 +5186,7 @@ components:
         - video_text_watermark
         - split
         - render_variants
+        - transform
 
     MediaGroup:
       type: string

package/availability/availability.json

@@ -1,5 +1,5 @@
 {
-  "capabilities_version": 162,
+  "capabilities_version": 163,
   "endpoints": {
     "DELETE /api/auth/api-keys/{apiKeyId}": {
       "auth": "required",
@@ -4659,6 +4659,159 @@
         }
       }
     },
+    "transform": {
+      "availability": "planned",
+      "default": false,
+      "description": "Apply a geometric / orientation transform to a media asset. **v1 supports\nrotate + flip only** (orientation transforms) \u2014 it does NOT do crop, scale,\nskew, or colour transforms. The name is deliberately `transform` (not\n`orient`) to leave room for a future `crop` on the same op; do not read the\nname as advertising arbitrary affine transforms. Full design + normative\norder-of-operations, routing topology, chain order, media gating, and\nbilling model: ADR-0026.\n\n**Params (per media group):**\n- `rotate` \u2014 `0 | 90 | 180 | 270` degrees clockwise (default `0`).\n- `flip` \u2014 `none | horizontal | vertical | both` mirror (default `none`).\n  `horizontal` = left\u2194right (the selfie/webcam mirror-correction),\n  `vertical` = top\u2194bottom, `both` = both axes.\n\n**Normative order-of-operations (v1 has NO arbitrary sequence).** For a\nsingle `transform` op the worker applies, in this fixed order:\n1. (images) normalize display orientation from EXIF,\n2. apply `rotate`,\n3. apply `flip` in the FINAL (post-rotate) display axes,\n4. (images) write pixels with the orientation tag reset/removed.\nSo `flip: horizontal` always means left\u2194right in the *visible result*, even\nafter a 90/270 rotate. See ADR-0026 \u00a7Order-of-operations.\n\n**auto_orient coexistence.** `transform` reads the image honouring EXIF\norientation, applies rotate/flip, and emits normalized-orientation pixels \u2014\nso a downstream `compress`/`convert` `auto_orient` is a no-op. Raw\nstored-pixel rotation that ignores EXIF is out of scope for v1.\n\n**No-op is rejected at create.** A `transform` with `rotate: 0` AND\n`flip: none` (for documents: `rotate: 0`) does nothing, so the API rejects\nit as `invalid_options` at create \u2014 there is no billed, worker-dispatched\nno-op (mirrors the API facade gate that rejects inert option combos). At\nleast one of `rotate`/`flip` must be non-default.\n\n**Media scope (v1).** IMAGE **still-raster** (jpeg/png/webp) and animated\nGIF; VIDEO (mp4/webm); DOCUMENT is PDF-rotate ONLY (no flip \u2014 the\n`document_pdf` group offers `rotate` alone). AUDIO is intentionally absent\n(no spatial geometry). SVG, HEIC/AVIF, and non-PDF documents\n(Office/ODF/EPUB) are out of scope for v1 and are not advertised.\n**Animated PNG (APNG) and animated WebP** are NOT covered by the\nstill-raster `image` group's activation proof \u2014 like animated GIF, a\npixel-baking geometry op would drop frames / animation metadata. Before the\n`image` group flips stable the worker MUST either reject animated PNG/WebP\nvariants at probe or transform ALL frames + preserve animation metadata\n(same bar as the `image_gif` group). Everything ships `availability:\nplanned` first and flips per media on worker capability-source proof\n(ADR-0006) \u2014 each activation co-updates schema availability + AsyncAPI\nrouting + API OperationType/chain/pricing + the billing weight row together\n(ADR-0026 \u00a7Rollout).\n\n**Routing (thumbnail precedent).** The payload `operation_type` stays the\nbase value `transform`; the API publisher resolves the effective input MIME\nto an SNS `operation_type` routing-attribute sub-type\n(`transform_image` / `transform_video` / `transform_document`). Those\nsub-types are ROUTING ATTRIBUTES ONLY \u2014 never persisted or public operation\ntypes (they are absent from the OperationType payload enum). The\n`document_pdf` group routes under `transform_document` (media-family level,\neven though v1 is PDF-only). See ADR-0026 \u00a7Routing + asyncapi/events.yaml.\n",
+      "input_model": "single",
+      "mime_groups": {
+        "document_pdf": {
+          "availability": "planned",
+          "mimes": [
+            "application/pdf"
+          ],
+          "options": {
+            "rotate": {
+              "default": 0,
+              "description": "Clockwise page rotation in degrees, applied to the rendered page orientation. `flip` is NOT offered for documents in v1.",
+              "type": "enum",
+              "value_type": "integer",
+              "values": [
+                0,
+                90,
+                180,
+                270
+              ]
+            }
+          }
+        },
+        "image": {
+          "availability": "planned",
+          "mimes": [
+            "image/jpeg",
+            "image/png",
+            "image/webp"
+          ],
+          "options": {
+            "flip": {
+              "default": "none",
+              "description": "Mirror the image. `horizontal` = left\u2194right, `vertical` = top\u2194bottom, `both` = both axes. Applied AFTER `rotate`, in the final (post-rotate) display axes, so `horizontal` always means left\u2194right in the visible result.",
+              "type": "enum",
+              "values": [
+                "none",
+                "horizontal",
+                "vertical",
+                "both"
+              ]
+            },
+            "rotate": {
+              "default": 0,
+              "description": "Clockwise rotation in degrees. Applied BEFORE `flip` (see the operation-level normative order-of-operations).",
+              "type": "enum",
+              "value_type": "integer",
+              "values": [
+                0,
+                90,
+                180,
+                270
+              ]
+            }
+          }
+        },
+        "image_gif": {
+          "availability": "planned",
+          "mimes": [
+            "image/gif"
+          ],
+          "options": {
+            "flip": {
+              "default": "none",
+              "description": "Mirror all frames. Applied after `rotate`, in final display axes.",
+              "type": "enum",
+              "values": [
+                "none",
+                "horizontal",
+                "vertical",
+                "both"
+              ]
+            },
+            "rotate": {
+              "default": 0,
+              "description": "Clockwise rotation in degrees (all frames). Applied before `flip`.",
+              "type": "enum",
+              "value_type": "integer",
+              "values": [
+                0,
+                90,
+                180,
+                270
+              ]
+            }
+          }
+        },
+        "video": {
+          "mimes": [
+            "video/mp4",
+            "video/webm"
+          ],
+          "options": {
+            "flip": {
+              "default": "none",
+              "description": "Mirror the video (FFmpeg `hflip` / `vflip`). `horizontal` = left\u2194right, `vertical` = top\u2194bottom, `both` = both. Applied AFTER `rotate`, in the final display axes. Re-encodes the video.",
+              "type": "enum",
+              "values": [
+                "none",
+                "horizontal",
+                "vertical",
+                "both"
+              ]
+            },
+            "rotate": {
+              "default": 0,
+              "description": "Clockwise rotation in degrees (FFmpeg `transpose`). Applied BEFORE `flip`. Re-encodes the video.",
+              "type": "enum",
+              "value_type": "integer",
+              "values": [
+                0,
+                90,
+                180,
+                270
+              ]
+            }
+          },
+          "processing_class": {
+            "long_form": {
+              "availability": "planned",
+              "constraints": {
+                "max_input_duration": "PT12H",
+                "max_input_size_bytes": 5000000000,
+                "max_output_size_bytes": 5000000000
+              },
+              "per_tier_constraints": {
+                "enterprise": {
+                  "max_input_size_bytes": 120000000000,
+                  "max_output_size_bytes": 120000000000
+                },
+                "max": {
+                  "max_input_size_bytes": 50000000000,
+                  "max_output_size_bytes": 50000000000
+                }
+              },
+              "required_tier": "pro"
+            },
+            "short_form": {
+              "availability": "planned",
+              "constraints": {
+                "max_input_duration": "PT5M",
+                "max_input_size_bytes": 524288000,
+                "max_output_size_bytes": 524288000
+              }
+            }
+          }
+        }
+      },
+      "sole_op": false
+    },
     "video_text_watermark": {
       "availability": "planned",
       "default": false,
@@ -4896,7 +5049,7 @@
       "sole_op": true
     }
   },
-  "schema_version": "2.152.0",
+  "schema_version": "2.154.0",
   "source_commit": null,
   "user_tier": null,
   "workflow_features": {