@giveitsmaller/contracts 0.47.0 → 0.50.0

package/dist/operations/convert.metadata.js

@@ -4,17 +4,7 @@ export const convertMetadata = {
     mime_groups: {
         image: {
             processing_class: {},
-            per_mime_availability: {
-                'image/avif': {
-                    availability: 'beta',
-                },
-                'image/heic': {
-                    availability: 'beta',
-                },
-                'image/heif': {
-                    availability: 'beta',
-                },
-            },
+            per_mime_availability: {},
             options: {
                 output_format: {
                     per_value_availability: {},
@@ -39,7 +29,6 @@ export const convertMetadata = {
                     per_value_availability: {},
                 },
                 color_profile: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
                 auto_orient: {
@@ -77,10 +66,6 @@ export const convertMetadata = {
                 background: {
                     per_value_availability: {},
                 },
-                metadata: {
-                    availability: 'planned',
-                    per_value_availability: {},
-                },
                 width: {
                     per_value_availability: {},
                 },
@@ -91,7 +76,6 @@ export const convertMetadata = {
                     per_value_availability: {},
                 },
                 color_profile: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
                 auto_orient: {

package/dist/operations/image_watermark.metadata.js

@@ -53,7 +53,6 @@ export const imageWatermarkMetadata = {
             per_input_options: {},
         },
         image_tiff: {
-            availability: 'planned',
             processing_class: {},
             per_mime_availability: {},
             options: {
@@ -76,7 +75,6 @@ export const imageWatermarkMetadata = {
             per_input_options: {},
         },
         image_bmp: {
-            availability: 'planned',
             processing_class: {},
             per_mime_availability: {},
             options: {

package/dist/operations/text_watermark.metadata.js

@@ -43,7 +43,6 @@ export const textWatermarkMetadata = {
             per_input_options: {},
         },
         image_tiff: {
-            availability: 'planned',
             processing_class: {},
             per_mime_availability: {},
             options: {
@@ -84,7 +83,6 @@ export const textWatermarkMetadata = {
             per_input_options: {},
         },
         image_bmp: {
-            availability: 'planned',
             processing_class: {},
             per_mime_availability: {},
             options: {

package/dist/operations/thumbnail.d.ts

@@ -9,31 +9,13 @@ export declare enum ThumbnailImageFormat {
     Webp = "webp"
 }
 export interface ThumbnailImageOptions {
-    width: number;
-    height: number;
+    width?: number;
+    height?: number;
     fit?: ThumbnailImageFit;
     format?: ThumbnailImageFormat;
     quality?: number;
     background?: string;
 }
-export declare enum ThumbnailImageSvgFit {
-    Max = "max",
-    Crop = "crop",
-    Scale = "scale"
-}
-export declare enum ThumbnailImageSvgFormat {
-    Jpg = "jpg",
-    Png = "png",
-    Webp = "webp"
-}
-export interface ThumbnailImageSvgOptions {
-    width: number;
-    height: number;
-    fit?: ThumbnailImageSvgFit;
-    format?: ThumbnailImageSvgFormat;
-    quality?: number;
-    background?: string;
-}
 export declare enum ThumbnailVideoFit {
     Max = "max",
     Crop = "crop",
@@ -46,8 +28,8 @@ export declare enum ThumbnailVideoFormat {
 }
 export interface ThumbnailVideoOptions {
     timestamp?: string;
-    width: number;
-    height: number;
+    width?: number;
+    height?: number;
     fit?: ThumbnailVideoFit;
     format?: ThumbnailVideoFormat;
     quality?: number;
@@ -69,8 +51,8 @@ export declare enum ThumbnailDocumentFormat {
 export interface ThumbnailDocumentOptions {
     source?: ThumbnailDocumentSource;
     page?: number;
-    width: number;
-    height: number;
+    width?: number;
+    height?: number;
     fit?: ThumbnailDocumentFit;
     format?: ThumbnailDocumentFormat;
     quality?: number;

package/dist/operations/thumbnail.js

@@ -11,18 +11,6 @@ export var ThumbnailImageFormat;
     ThumbnailImageFormat["Png"] = "png";
     ThumbnailImageFormat["Webp"] = "webp";
 })(ThumbnailImageFormat || (ThumbnailImageFormat = {}));
-export var ThumbnailImageSvgFit;
-(function (ThumbnailImageSvgFit) {
-    ThumbnailImageSvgFit["Max"] = "max";
-    ThumbnailImageSvgFit["Crop"] = "crop";
-    ThumbnailImageSvgFit["Scale"] = "scale";
-})(ThumbnailImageSvgFit || (ThumbnailImageSvgFit = {}));
-export var ThumbnailImageSvgFormat;
-(function (ThumbnailImageSvgFormat) {
-    ThumbnailImageSvgFormat["Jpg"] = "jpg";
-    ThumbnailImageSvgFormat["Png"] = "png";
-    ThumbnailImageSvgFormat["Webp"] = "webp";
-})(ThumbnailImageSvgFormat || (ThumbnailImageSvgFormat = {}));
 export var ThumbnailVideoFit;
 (function (ThumbnailVideoFit) {
     ThumbnailVideoFit["Max"] = "max";

package/dist/operations/thumbnail.metadata.js

@@ -3,39 +3,6 @@ export const thumbnailMetadata = {
     features: {},
     mime_groups: {
         image: {
-            processing_class: {},
-            per_mime_availability: {
-                'image/avif': {
-                    availability: 'beta',
-                },
-                'image/heic': {
-                    availability: 'beta',
-                },
-            },
-            options: {
-                width: {
-                    per_value_availability: {},
-                },
-                height: {
-                    per_value_availability: {},
-                },
-                fit: {
-                    per_value_availability: {},
-                },
-                format: {
-                    per_value_availability: {},
-                },
-                quality: {
-                    per_value_availability: {},
-                },
-                background: {
-                    per_value_availability: {},
-                },
-            },
-            per_input_options: {},
-        },
-        image_svg: {
-            availability: 'planned',
             processing_class: {},
             per_mime_availability: {},
             options: {

package/openapi/api.yaml

@@ -89,7 +89,7 @@ info:
     of truth instead of hardcoding magic numbers. A runtime
     `GET /api/uploads/limits` endpoint for dynamic discovery
     (per-tier / per-environment overrides) is a deferred follow-up.
-  version: 2.133.0
+  version: 2.148.0
   contact:
     name: API Support
 
@@ -7314,8 +7314,8 @@ components:
         - thumbnail_office: Office document (DOCX/XLSX/PPTX/ODT/ODS/ODP)
           thumbnail sub-type. Backed by a dedicated LibreOffice Lambda.
           Emitted by the publisher for office-document inputs.
-        - image_watermark: Image overlay onto a base IMAGE asset. Multi-input (Path B with role: base + overlay). Each input is a `MultiInputSource` (external_import / connection / job_output — no upload-direct); an uploaded base or overlay enters via a `passthrough` source job referenced by `job_output`. Stable for static-image bases (jpeg/png/webp); animated GIF (`image_gif`), TIFF (`image_tiff`) and BMP (`image_bmp`) bases are advertised as `planned` via parallel mime_groups — dispatch returns `feature_not_available` (422) until Lambda support ships. Video bases are NOT supported by image_watermark — use the dedicated `video_watermark` operation per ADR-0013. Per ADR-0004 + I4-CONS + I5 (Trello AKZiOXnd).
-        - text_watermark: Text overlay rendered onto an image (Liberation Sans). Single-input. Stable for jpeg/png/webp; TIFF (`image_tiff`) and BMP (`image_bmp`) inputs are advertised as `planned` — dispatch returns `feature_not_available` (422) until Lambda support ships. Per ADR-0004 + I4-CONS.
+        - image_watermark: Image overlay onto a base IMAGE asset. Multi-input (Path B with role: base + overlay). Each input is a `MultiInputSource` (external_import / connection / job_output — no upload-direct); an uploaded base or overlay enters via a `passthrough` source job referenced by `job_output`. Stable for static-image bases (jpeg/png/webp); TIFF (`image_tiff`) and BMP (`image_bmp`) bases are now `stable` too (flipped 2026-06-30, UANjD38A). Animated GIF (`image_gif`) bases stay `planned` via a parallel mime_group — dispatch returns `feature_not_available` (422) until Lambda support ships. Video bases are NOT supported by image_watermark — use the dedicated `video_watermark` operation per ADR-0013. Per ADR-0004 + I4-CONS + I5 (Trello AKZiOXnd).
+        - text_watermark: Text overlay rendered onto an image (Liberation Sans). Single-input. Stable for jpeg/png/webp; TIFF (`image_tiff`) and BMP (`image_bmp`) inputs are now `stable` too (flipped 2026-06-30, UANjD38A). Per ADR-0004 + I4-CONS.
         - merge: Concatenate/combine multiple files into one (images, video, audio). Multi-input. Image inputs merge into animated GIF or slideshow video; image collage/grid and PDF concatenation are not supported by the V1 Lambda.
         - archive: Bundle files into ZIP/tar.gz (all types). Multi-input.
         - convert: Change file format (all types)
@@ -10495,10 +10495,12 @@ components:
               minimum: 1
               maximum: 100
               description: |
-                The quality the encode-measure loop settled on for a `target_size`
-                encode (`encoding_mode: target_size`). Present only for a target_size
-                operation. Mirrors the AsyncAPI `OperationMetrics.chosen_quality`;
-                lets the client show "hit your target at quality 66".
+                The encoder quality the search settled on — for a `target_size`
+                encode OR an `auto_quality` encode (the quality that met the
+                `quality_preset` perceptual target). Present for target_size and
+                auto_quality operations. Mirrors the AsyncAPI
+                `OperationMetrics.chosen_quality`; lets the client show "hit your
+                target at quality 66".
             target_size_met:
               type: boolean
               description: |
@@ -10506,6 +10508,24 @@ components:
                 `target_size_bytes`. `false` is an honest best-effort outcome (target
                 unreachable at min quality), not a failure. Present only for a
                 target_size operation. Mirrors `OperationMetrics.target_size_met`.
+            measured_quality:
+              type: number
+              format: double
+              minimum: 0
+              maximum: 1
+              description: |
+                The achieved perceptual-quality score (0.0–1.0) for an `auto_quality`
+                encode (compress.image jpeg/webp/avif). Present only for an
+                auto_quality operation; pairs with `chosen_quality`. Metric-agnostic —
+                the producing metric is named in `quality_metric`. Mirrors
+                `OperationMetrics.measured_quality`.
+            quality_metric:
+              type: string
+              description: |
+                The perceptual metric that produced `measured_quality` — a free-form
+                string (not an enum) so it can evolve without contract churn. Present
+                only for an auto_quality operation. Current value: `ssim`. Mirrors
+                `OperationMetrics.quality_metric`.
             duration_ms:
               type: integer
               description: Processing time in milliseconds
@@ -10666,13 +10686,15 @@ components:
           minimum: 1
           maximum: 100
           description: |
-            For a `target_size` encode (`encoding_mode: target_size`): the quality
-            the encode-measure loop settled on. Present only for a target_size
+            The encoder quality the search settled on — for a `target_size` encode
+            OR an `auto_quality` encode (the quality that met the `quality_preset`
+            perceptual target). Present only for a target_size or auto_quality
             output; absent otherwise. Optional/additive (rides the shared property
             bag — not in any oneOf `required`/`not`). The per-output `/downloads`
             read is the canonical output-properties surface per the ZjVXHkYK
             narrowing (alongside `size_bytes`); mirrors the worker source
-            `OperationMetrics.chosen_quality`. Pairs with `target_size_met`.
+            `OperationMetrics.chosen_quality`. Pairs with `target_size_met`
+            (target_size) or `measured_quality` (auto_quality).
         target_size_met:
           type: boolean
           description: |
@@ -10680,6 +10702,24 @@ components:
             requested `target_size_bytes`. `false` is an honest best-effort outcome
             (target unreachable at min quality), NOT a failure. Present only for a
             target_size output. Mirrors `OperationMetrics.target_size_met`.
+        measured_quality:
+          type: number
+          format: double
+          minimum: 0
+          maximum: 1
+          description: |
+            For an `auto_quality` encode (`encoding_mode: auto_quality`): the achieved
+            perceptual-quality score (0.0–1.0) that met the `quality_preset` target.
+            Present only for an auto_quality output; pairs with `chosen_quality`.
+            Metric-agnostic — the producing metric is named in `quality_metric`.
+            Mirrors `OperationMetrics.measured_quality`.
+        quality_metric:
+          type: string
+          description: |
+            For an `auto_quality` encode: the perceptual metric that produced
+            `measured_quality` — a free-form string (not an enum) so it can evolve
+            without contract churn. Present only for an auto_quality output. Current
+            value: `ssim`. Mirrors `OperationMetrics.quality_metric`.
         download_url:
           type: string
           format: uri

package/operation-capabilities/operation-capabilities.json

@@ -265,7 +265,9 @@
               "in": [
                 "mp4",
                 "webm",
-                "ogg"
+                "ogg",
+                "mov",
+                "mkv"
               ]
             }
           },
@@ -478,6 +480,14 @@
       "hasAudioTrack": false,
       "isAnimated": false
     },
+    "mkv": {
+      "hasAudioTrack": true,
+      "isAnimated": false
+    },
+    "mov": {
+      "hasAudioTrack": true,
+      "isAnimated": false
+    },
     "mp3": {
       "hasAudioTrack": true,
       "isAnimated": false
@@ -515,5 +525,5 @@
       "isAnimated": "maybe"
     }
   },
-  "schema_version": "2.133.0"
+  "schema_version": "2.148.0"
 }