@giveitsmaller/contracts 0.50.0 → 0.53.0

package/accepted-options/accepted-options.json

@@ -854,7 +854,8 @@
             "margin_x",
             "margin_y",
             "opacity",
-            "overlay_width"
+            "overlay_width",
+            "overlays"
           ]
         },
         "output_format_option": null
@@ -1124,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": {
@@ -1159,5 +1197,5 @@
       }
     }
   },
-  "schema_version": "2.148.0"
+  "schema_version": "2.154.0"
 }

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

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

package/asyncapi/events.yaml

@@ -1,7 +1,7 @@
 asyncapi: 3.0.0
 info:
   title: GISL Compression Events
-  version: 3.25.0
+  version: 3.25.1
   description: |
     Asynchronous event contracts for the GISL (Give It Smaller) compression service.
 
@@ -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:
@@ -1708,13 +1903,17 @@ operations:
     description: |
       The operation-image-watermark Lambda consumes image_watermark
       requests routed by `operation_type=image_watermark`. Multi-input
-      (Path B with role: base + overlay per JobInputV2.role).
+      (Path B, role-based): one `base` + 1-8 `overlay` inputs per
+      `JobInputV2.role` (`input` min 2 / max 9; multi-overlay via the
+      index-aligned `overlays[]` option, LIVE 2026-07-01 — the flat
+      single-overlay options remain the 1-overlay back-compat path).
 
-      Stable for image bases today; animated GIF (`image_gif` group) and
-      video bases (`video` group) are advertised as `planned` in the
-      schema (I5 — Trello AKZiOXnd) and dispatch returns
+      Stable for jpeg/png/webp + tiff/bmp image bases; animated GIF
+      (`image_gif` group) is advertised as `planned` and dispatch returns
       `feature_not_available` (422) at the API edge until Lambda support
-      ships. Per ADR-0004 + I4-CONS + I5.
+      ships. Video bases are NOT supported (there is no `video` group) —
+      use `video_watermark`. Multi-overlay (`overlays[]`) is jpeg/png/webp
+      only. Per ADR-0004 + I4-CONS + I5 (Trello AKZiOXnd).
     messages:
       - $ref: '#/channels/opsImageWatermark/messages/operationRequest'
 
@@ -2364,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`,
@@ -2374,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
@@ -2462,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:
@@ -3195,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:
@@ -3230,6 +3458,9 @@ components:
             - video_text_watermark
             - split
             - render_variants
+            - transform_image
+            - transform_video
+            - transform_document
         media_group:
           type: string
           description: |
@@ -3326,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:
@@ -3364,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):
@@ -3405,6 +3660,7 @@ components:
                   - video_text_watermark
                   - split
                   - render_variants
+                  - transform
           then:
             required:
               - file_type
@@ -4759,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
@@ -4891,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
@@ -4914,6 +5186,7 @@ components:
         - video_text_watermark
         - split
         - render_variants
+        - transform
 
     MediaGroup:
       type: string