@giveitsmaller/contracts 0.37.0 → 0.38.0

package/accepted-options/accepted-options.json

@@ -214,6 +214,8 @@
       "image": {
         "accepted_options": {
           "auto": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -223,6 +225,8 @@
             "width"
           ],
           "original": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -232,6 +236,8 @@
             "width"
           ],
           "smallest": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -241,6 +247,8 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -255,7 +263,9 @@
       "image_avif": {
         "accepted_options": {
           "auto": [
+            "auto_orient",
             "avif_speed",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -266,7 +276,9 @@
             "width"
           ],
           "original": [
+            "auto_orient",
             "avif_speed",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -277,7 +289,9 @@
             "width"
           ],
           "smallest": [
+            "auto_orient",
             "avif_speed",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -288,7 +302,9 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
             "avif_speed",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -304,7 +320,9 @@
       "image_jpeg": {
         "accepted_options": {
           "auto": [
+            "auto_orient",
             "chroma_subsampling",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -318,7 +336,9 @@
             "width"
           ],
           "original": [
+            "auto_orient",
             "chroma_subsampling",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -332,7 +352,9 @@
             "width"
           ],
           "smallest": [
+            "auto_orient",
             "chroma_subsampling",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -346,7 +368,9 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
             "chroma_subsampling",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -365,6 +389,8 @@
       "image_png": {
         "accepted_options": {
           "auto": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -376,6 +402,8 @@
             "width"
           ],
           "original": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -387,6 +415,8 @@
             "width"
           ],
           "smallest": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -398,6 +428,8 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "keep_metadata",
@@ -439,6 +471,8 @@
       "image_webp": {
         "accepted_options": {
           "auto": [
+            "auto_orient",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -451,6 +485,8 @@
             "width"
           ],
           "original": [
+            "auto_orient",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -463,6 +499,8 @@
             "width"
           ],
           "smallest": [
+            "auto_orient",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -475,6 +513,8 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
+            "color_profile",
             "encoding_mode",
             "fit",
             "height",
@@ -609,6 +649,8 @@
       "image": {
         "accepted_options": {
           "avif": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -617,6 +659,8 @@
             "width"
           ],
           "gif": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -624,7 +668,9 @@
             "width"
           ],
           "jpeg": [
+            "auto_orient",
             "background",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -633,6 +679,8 @@
             "width"
           ],
           "png": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -640,6 +688,8 @@
             "width"
           ],
           "tiff": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -647,6 +697,8 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -660,6 +712,8 @@
       "image_gif": {
         "accepted_options": {
           "avif": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -668,6 +722,8 @@
             "width"
           ],
           "gif": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -675,7 +731,9 @@
             "width"
           ],
           "jpeg": [
+            "auto_orient",
             "background",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -684,6 +742,8 @@
             "width"
           ],
           "mp4": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -691,6 +751,8 @@
             "width"
           ],
           "png": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -698,6 +760,8 @@
             "width"
           ],
           "tiff": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -705,6 +769,8 @@
             "width"
           ],
           "webm": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -712,6 +778,8 @@
             "width"
           ],
           "webp": [
+            "auto_orient",
+            "color_profile",
             "fit",
             "height",
             "metadata",
@@ -1049,5 +1117,5 @@
       }
     }
   },
-  "schema_version": "2.111.0"
+  "schema_version": "2.112.0"
 }

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

@@ -15,6 +15,8 @@
           ],
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "metadata"
           ],
           "source_op": "convert"
@@ -28,6 +30,8 @@
           ],
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "metadata"
           ],
           "source_op": "convert"
@@ -43,6 +47,8 @@
           ],
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "metadata"
           ],
           "source_op": "convert"
@@ -56,6 +62,8 @@
           ],
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "metadata"
           ],
           "source_op": "convert"
@@ -69,6 +77,8 @@
           ],
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "metadata"
           ],
           "source_op": "convert"
@@ -83,6 +93,8 @@
           ],
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "metadata"
           ],
           "source_op": "convert"
@@ -113,7 +125,10 @@
           ],
           "input_mime": "image/avif",
           "max_output_pixels": 16000000,
-          "planned_options": [],
+          "planned_options": [
+            "auto_orient",
+            "color_profile"
+          ],
           "source_op": "compress"
         },
         "gif": {
@@ -128,6 +143,8 @@
           "input_mime": "image/gif",
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "keep_metadata"
           ],
           "source_op": "compress"
@@ -149,6 +166,8 @@
           "input_mime": "image/jpeg",
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "keep_metadata"
           ],
           "source_op": "compress"
@@ -166,6 +185,8 @@
           "input_mime": "image/png",
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "keep_metadata",
             "lossy"
           ],
@@ -193,6 +214,8 @@
           "input_mime": "image/tiff",
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "keep_metadata"
           ],
           "source_op": "compress"
@@ -212,6 +235,8 @@
           "input_mime": "image/webp",
           "max_output_pixels": 16000000,
           "planned_options": [
+            "auto_orient",
+            "color_profile",
             "keep_metadata"
           ],
           "source_op": "compress"
@@ -231,5 +256,5 @@
       "source_op": "compress"
     }
   },
-  "schema_version": "2.111.0"
+  "schema_version": "2.112.0"
 }

package/availability/availability.json

@@ -1,5 +1,5 @@
 {
-  "capabilities_version": 130,
+  "capabilities_version": 131,
   "endpoints": {
     "DELETE /api/auth/api-keys/{apiKeyId}": {
       "auth": "required",
@@ -1118,6 +1118,31 @@
             "image/tiff"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels (honour the camera/device rotation tag) so the output displays upright everywhere, then drop the now-redundant orientation tag. `planned` \u2014 a restored control (was removed): the worker must apply the EXIF-orientation transform before encode on both Output routes. Default `true` (a behaviour change, proven planned-first). No-op for inputs without an orientation tag.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "boolean"
+            },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling \u2014 its OWN control, DECOUPLED from `metadata` (stripping metadata must NOT silently shift colours; that coupling is the correctness bug this fixes). `keep` (default) = preserve the embedded profile; `srgb` = convert to sRGB (also handles CMYK\u2192sRGB); `strip` = drop the profile (smallest \u2014 only when the consumer manages colour itself). `planned` \u2014 the worker does not yet honour it (today the default strips ICC during metadata-strip; the fix preserves it). Applies on BOTH Output routes (optimiser preserves; transcoder preserves/converts). Worker-proven flip.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "fit": {
               "default": "max",
               "depends_on": {
@@ -1228,6 +1253,16 @@
             "image/avif"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels (honour the camera/device rotation tag) so the output displays upright everywhere, then drop the now-redundant orientation tag. `planned` \u2014 a restored control (was removed): the worker must apply the EXIF-orientation transform before encode on both Output routes. Default `true` (a behaviour change, proven planned-first). No-op for inputs without an orientation tag.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "boolean"
+            },
             "avif_speed": {
               "default": 4,
               "description": "AVIF encode speed (1-10, ravif). Lower = smaller file, slower encode; higher = faster, larger. Default 4. Optimiser (same_format) route.",
@@ -1238,6 +1273,21 @@
               "min": 1,
               "type": "integer"
             },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling \u2014 its OWN control, DECOUPLED from `metadata` (stripping metadata must NOT silently shift colours; that coupling is the correctness bug this fixes). `keep` (default) = preserve the embedded profile; `srgb` = convert to sRGB (also handles CMYK\u2192sRGB); `strip` = drop the profile (smallest \u2014 only when the consumer manages colour itself). `planned` \u2014 the worker does not yet honour it (today the default strips ICC during metadata-strip; the fix preserves it). Applies on BOTH Output routes (optimiser preserves; transcoder preserves/converts). Worker-proven flip.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "encoding_mode": {
               "default": "quality",
               "description": "Compression mode (mirrors compress.video). `quality` = the `quality` slider drives the encode (default). `target_size` = hit a byte budget via the worker's encode-measure-binary-search loop \u2014 STABLE (worker-proven on staging, lambdas git-870a7c2: re-encode under target + best-effort + original-wins). AVIF encodes are slow, so the loop caps iterations (a 6-iteration cap, ~18s worst case). Optimiser (same_format) route.",
@@ -1357,6 +1407,16 @@
             "image/jpeg"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels (honour the camera/device rotation tag) so the output displays upright everywhere, then drop the now-redundant orientation tag. `planned` \u2014 a restored control (was removed): the worker must apply the EXIF-orientation transform before encode on both Output routes. Default `true` (a behaviour change, proven planned-first). No-op for inputs without an orientation tag.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "boolean"
+            },
             "chroma_subsampling": {
               "description": "JPEG chroma subsampling \u2014 the colour-resolution/size trade-off. `420` (4:2:0) = smallest, chroma at quarter resolution (default-ish for web photos); `422` (4:2:2) = half-horizontal; `444` (4:4:4) = full chroma (largest, best for sharp colour edges / text). JPEG ONLY (declared on image_jpeg only \u2014 ravif hardcodes 4:4:4, libwebp lossy locks 4:2:0). String values (the worker strict-matches strings). STABLE \u2014 worker-proven on staging (lambdas PR #264, deployed git-f2bef85: output JPEG SOF luma sampling bytes verified 0x22/0x21/0x11 for 420/422/444). INCOMPATIBLE with `lossless` (any chroma value): lossless JPEG is a DCT-coefficient copy and cannot resample chroma \u2014 see the chroma_subsampling.lossless_conflict constraint.",
               "honored_on": [
@@ -1369,6 +1429,21 @@
                 "444"
               ]
             },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling \u2014 its OWN control, DECOUPLED from `metadata` (stripping metadata must NOT silently shift colours; that coupling is the correctness bug this fixes). `keep` (default) = preserve the embedded profile; `srgb` = convert to sRGB (also handles CMYK\u2192sRGB); `strip` = drop the profile (smallest \u2014 only when the consumer manages colour itself). `planned` \u2014 the worker does not yet honour it (today the default strips ICC during metadata-strip; the fix preserves it). Applies on BOTH Output routes (optimiser preserves; transcoder preserves/converts). Worker-proven flip.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "encoding_mode": {
               "default": "quality",
               "description": "Compression mode (mirrors compress.video). `quality` = the `quality` slider drives the encode (default). `target_size` = hit a byte budget via the worker's encode-measure-binary-search loop \u2014 STABLE (worker-proven on staging, lambdas git-870a7c2: re-encode under target + best-effort below floor + original-wins, all proven). Optimiser (same_format) route.",
@@ -1523,6 +1598,31 @@
             "image/png"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels (honour the camera/device rotation tag) so the output displays upright everywhere, then drop the now-redundant orientation tag. `planned` \u2014 a restored control (was removed): the worker must apply the EXIF-orientation transform before encode on both Output routes. Default `true` (a behaviour change, proven planned-first). No-op for inputs without an orientation tag.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "boolean"
+            },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling \u2014 its OWN control, DECOUPLED from `metadata` (stripping metadata must NOT silently shift colours; that coupling is the correctness bug this fixes). `keep` (default) = preserve the embedded profile; `srgb` = convert to sRGB (also handles CMYK\u2192sRGB); `strip` = drop the profile (smallest \u2014 only when the consumer manages colour itself). `planned` \u2014 the worker does not yet honour it (today the default strips ICC during metadata-strip; the fix preserves it). Applies on BOTH Output routes (optimiser preserves; transcoder preserves/converts). Worker-proven flip.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "fit": {
               "default": "max",
               "depends_on": {
@@ -1704,6 +1804,31 @@
             "image/webp"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels (honour the camera/device rotation tag) so the output displays upright everywhere, then drop the now-redundant orientation tag. `planned` \u2014 a restored control (was removed): the worker must apply the EXIF-orientation transform before encode on both Output routes. Default `true` (a behaviour change, proven planned-first). No-op for inputs without an orientation tag.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "boolean"
+            },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling \u2014 its OWN control, DECOUPLED from `metadata` (stripping metadata must NOT silently shift colours; that coupling is the correctness bug this fixes). `keep` (default) = preserve the embedded profile; `srgb` = convert to sRGB (also handles CMYK\u2192sRGB); `strip` = drop the profile (smallest \u2014 only when the consumer manages colour itself). `planned` \u2014 the worker does not yet honour it (today the default strips ICC during metadata-strip; the fix preserves it). Applies on BOTH Output routes (optimiser preserves; transcoder preserves/converts). Worker-proven flip.",
+              "honored_on": [
+                "same_format",
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "encoding_mode": {
               "default": "quality",
               "description": "Compression mode (mirrors compress.video). `quality` = the `quality` slider drives the encode (default). `target_size` = hit a byte budget via the worker's encode-measure-binary-search loop \u2014 STABLE (worker-proven on staging, lambdas git-870a7c2: re-encode under target + best-effort below floor + original-wins, all proven). Optimiser (same_format) route.",
@@ -2129,6 +2254,15 @@
             "image/heic"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels on the transcoder (format-change) route \u2014 mirrors compress.image.auto_orient. `planned` \u2014 the convert worker does not yet apply the orientation transform. Declared HERE so the API re-validates the rewritten Output convert op.",
+              "honored_on": [
+                "format_change"
+              ],
+              "type": "boolean"
+            },
             "background": {
               "depends_on": {
                 "output_format": "jpeg"
@@ -2140,6 +2274,20 @@
               "pattern": "^#[0-9a-fA-F]{6}$",
               "type": "string"
             },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling on the transcoder (format-change) route \u2014 mirrors compress.image.color_profile (its own control, decoupled from metadata). `keep` (default) = preserve; `srgb` = convert to sRGB (incl. CMYK\u2192sRGB); `strip` = drop. `planned` \u2014 the convert worker re-encodes from pixels and does not yet preserve/convert the profile. Declared HERE so the API re-validates the rewritten Output convert op.",
+              "honored_on": [
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "fit": {
               "default": "max",
               "depends_on": {
@@ -2235,6 +2383,15 @@
             "image/gif"
           ],
           "options": {
+            "auto_orient": {
+              "availability": "planned",
+              "default": true,
+              "description": "Bake EXIF orientation into the pixels (format-change route) \u2014 mirrors compress.image.auto_orient. `planned`. Declared HERE so the API re-validates the rewritten Output op.",
+              "honored_on": [
+                "format_change"
+              ],
+              "type": "boolean"
+            },
             "background": {
               "depends_on": {
                 "output_format": "jpeg"
@@ -2246,6 +2403,20 @@
               "pattern": "^#[0-9a-fA-F]{6}$",
               "type": "string"
             },
+            "color_profile": {
+              "availability": "planned",
+              "default": "keep",
+              "description": "ICC colour-profile handling (format-change route) \u2014 mirrors compress.image.color_profile. `keep` (default)/`srgb`/`strip`. `planned` \u2014 applies to the still-image targets; the video targets (mp4/webm) carry no ICC. Declared HERE so the API re-validates the rewritten Output op.",
+              "honored_on": [
+                "format_change"
+              ],
+              "type": "enum",
+              "values": [
+                "keep",
+                "srgb",
+                "strip"
+              ]
+            },
             "fit": {
               "default": "max",
               "depends_on": {
@@ -4397,7 +4568,7 @@
       "sole_op": true
     }
   },
-  "schema_version": "2.111.0",
+  "schema_version": "2.112.0",
   "source_commit": null,
   "user_tier": null,
   "workflow_features": {