@giveitsmaller/contracts 0.17.0 → 0.18.0

package/dist/operations/convert.metadata.js

@@ -4,7 +4,14 @@ export const convertMetadata = {
     mime_groups: {
         image: {
             processing_class: {},
-            per_mime_availability: {},
+            per_mime_availability: {
+                'image/avif': {
+                    availability: 'beta',
+                },
+                'image/heic': {
+                    availability: 'beta',
+                },
+            },
             options: {
                 output_format: {
                     per_value_availability: {},

package/dist/operations/thumbnail.metadata.js

@@ -4,7 +4,14 @@ export const thumbnailMetadata = {
     mime_groups: {
         image: {
             processing_class: {},
-            per_mime_availability: {},
+            per_mime_availability: {
+                'image/avif': {
+                    availability: 'beta',
+                },
+                'image/heic': {
+                    availability: 'beta',
+                },
+            },
             options: {
                 width: {
                     per_value_availability: {},

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.66.0
+  version: 2.68.0
   contact:
     name: API Support
 

package/operations/schemas/compress.yaml

@@ -16,6 +16,18 @@ operation:
         - image/svg+xml
         - image/tiff
         - image/avif
+      per_mime_availability:
+        # avif INPUT decode shipped in the compress-image worker via libheif
+        # (lambdas w34Taquf, #210). beta: live + opt-in, shape-stable.
+        # Re-add after the v2.67.0 interim crash-window drop (aYPbNVKD Phase 2).
+        # image/heic is intentionally NOT re-added to compress: compress is
+        # decode-only and there is no HEIC encoder, so the worker rejects a
+        # declared image/heic (FormatMismatch). heic stays on convert+thumbnail.
+        # WORKER LIMIT (not yet contract-expressible — F3 follow-up): the
+        # compress-image worker caps avif INPUT at 20MB (compression_processor.rs),
+        # below the general image size budget. Per-MIME input-size caps have no
+        # contract vocab today; tracked for the image-size-cap mechanism (F3).
+        image/avif: { availability: beta }
       options:
         mode:
           type: enum
@@ -73,7 +85,11 @@ operation:
           value_type: integer
           values: [64, 96, 128, 192, 256, 320]
           default: 128
-          description: "Output bitrate in kbps"
+          description: >
+            Output bitrate in kbps. Applies to lossy outputs
+            (mpeg/aac/ogg/mp4) — CBR/ABR; rejected as invalid_options for
+            lossless outputs (flac/wav, which have no bitrate target). The
+            other knobs (channels/sample_rate/normalize) apply to all formats.
         channels:
           type: integer
           min: 1

package/operations/schemas/convert.yaml

@@ -19,6 +19,13 @@ operation:
         - image/vnd.microsoft.icon
         - image/avif
         - image/heic
+      per_mime_availability:
+        # avif/heic input decode shipped in the convert worker via libheif
+        # (lambdas w34Taquf, #210). beta: live + opt-in, shape-stable.
+        # Re-add after the v2.67.0 interim crash-window drop (aYPbNVKD Phase 2).
+        # (avif is also a valid OUTPUT via output_format — ravif encode.)
+        image/avif: { availability: beta }
+        image/heic: { availability: beta }
       options:
         output_format:
           type: enum

package/operations/schemas/thumbnail.yaml

@@ -17,6 +17,12 @@ operation:
         - image/bmp
         - image/avif
         - image/heic
+      per_mime_availability:
+        # avif/heic decode shipped in the thumbnail-image worker via libheif
+        # (lambdas w34Taquf, #210). beta: live + opt-in, shape-stable.
+        # Re-add after the v2.67.0 interim crash-window drop (aYPbNVKD Phase 2).
+        image/avif: { availability: beta }
+        image/heic: { availability: beta }
       options:
         width:
           type: integer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giveitsmaller/contracts",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Generated contract types for GISL (Give It Smaller)",
   "license": "MIT",
   "type": "module",