@giveitsmaller/contracts 0.29.0 → 0.31.0

package/dist/operations/compress.metadata.js

@@ -16,23 +16,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 output_format: {
-                    per_value_availability: {
-                        auto: {
-                            availability: 'planned',
-                        },
-                        smallest: {
-                            availability: 'planned',
-                        },
-                        jpeg: {
-                            availability: 'planned',
-                        },
-                        png: {
-                            availability: 'planned',
-                        },
-                        avif: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
             },
             per_input_options: {},
@@ -51,23 +35,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 output_format: {
-                    per_value_availability: {
-                        auto: {
-                            availability: 'planned',
-                        },
-                        smallest: {
-                            availability: 'planned',
-                        },
-                        jpeg: {
-                            availability: 'planned',
-                        },
-                        png: {
-                            availability: 'planned',
-                        },
-                        avif: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
             },
             per_input_options: {},
@@ -87,23 +55,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 output_format: {
-                    per_value_availability: {
-                        auto: {
-                            availability: 'planned',
-                        },
-                        smallest: {
-                            availability: 'planned',
-                        },
-                        jpeg: {
-                            availability: 'planned',
-                        },
-                        png: {
-                            availability: 'planned',
-                        },
-                        avif: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
             },
             per_input_options: {},
@@ -119,23 +71,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 output_format: {
-                    per_value_availability: {
-                        auto: {
-                            availability: 'planned',
-                        },
-                        smallest: {
-                            availability: 'planned',
-                        },
-                        jpeg: {
-                            availability: 'planned',
-                        },
-                        png: {
-                            availability: 'planned',
-                        },
-                        avif: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
             },
             per_input_options: {},

package/dist/operations/split.metadata.js

@@ -9,7 +9,6 @@ export const splitMetadata = {
     },
     mime_groups: {
         image_gif: {
-            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.90.0
+  version: 2.93.0
   contact:
     name: API Support
 

package/operation-capabilities/operation-capabilities.json

@@ -491,5 +491,5 @@
       "isAnimated": "maybe"
     }
   },
-  "schema_version": "2.90.0"
+  "schema_version": "2.93.0"
 }

package/operations/schemas/compress.yaml

@@ -25,12 +25,14 @@ operation:
     # 2026-06-20, lossless parked). width/height/fit/auto_orient stay removed
     # (EsD1hs5u — worker recompresses only; resize -> thumbnail, format -> convert).
     #
-    # output_format FACADE (replicated identically per group): non-`original`
-    # values resolve to a SINGLE API-canonicalized convert-with-size-cap pass
-    # (the compress worker never reads output_format). `webp` is live+proven
-    # (untagged = stable, ADR-0001 §1.4); auto/smallest/jpeg/png/avif stay
-    # `planned` until each value's canonicalization lands (per-value stable-flip
-    # with capability proof, ADR-0001/0006). `original` stays stable.
+    # output_format (replicated identically per group): only the LIVE targets
+    # are advertised — `original` (no-op, default) and `webp` (the one proven
+    # compress+format pass: a single API-canonicalized convert-with-size-cap;
+    # the compress worker itself never reads output_format). The planned
+    # facade targets (auto/smallest/jpeg/png/avif) were PRUNED 2026-06-21 —
+    # dangling coming-soon values are dishonest at source; every other format
+    # change is the convert operation's job (all stable). Re-add a target here
+    # only when its compress+format canonicalization actually ships.
     image_jpeg:
       mimes:
         - image/jpeg
@@ -55,19 +57,13 @@ operation:
           description: "Enable progressive JPEG rendering (a low-quality preview renders first, then refines). JPEG only."
         output_format:
           type: enum
-          values: [original, auto, smallest, jpeg, png, webp, avif]
+          values: [original, webp]
           default: original
-          per_value_availability:
-            auto:     { availability: planned }   # runtime Accept-best selection — unbuilt
-            smallest: { availability: planned }   # runtime try-all-smallest selection — unbuilt
-            jpeg:     { availability: planned }   # facade path not live until its own canonicalization
-            png:      { availability: planned }   # facade path not live until its own canonicalization
-            avif:     { availability: planned }   # facade path not live until its own canonicalization
           description: >-
-            Output format. original = keep input format (default); auto = best for browser
-            support (AVIF > WebP > JPEG via Accept hint); smallest = try all supported formats,
-            return the smallest. Non-`original` values are served by the API "compress+format"
-            facade (one combined convert-with-size-cap pass); see per_value_availability + FORMAT.md.
+            Output format. original = keep input format (default); webp = recompress to
+            WebP — the one live compress+format target (proven on staging). Other format
+            changes (jpeg/png/avif/gif/tiff) are the convert operation's job, not compress.
+            See FORMAT.md.
 
     image_png:
       mimes:
@@ -95,19 +91,13 @@ operation:
           description: "PNG optimization effort (0-6, oxipng). Higher = smaller file, slower encode. Default 3."
         output_format:
           type: enum
-          values: [original, auto, smallest, jpeg, png, webp, avif]
+          values: [original, webp]
           default: original
-          per_value_availability:
-            auto:     { availability: planned }   # runtime Accept-best selection — unbuilt
-            smallest: { availability: planned }   # runtime try-all-smallest selection — unbuilt
-            jpeg:     { availability: planned }   # facade path not live until its own canonicalization
-            png:      { availability: planned }   # facade path not live until its own canonicalization
-            avif:     { availability: planned }   # facade path not live until its own canonicalization
           description: >-
-            Output format. original = keep input format (default); auto = best for browser
-            support (AVIF > WebP > JPEG via Accept hint); smallest = try all supported formats,
-            return the smallest. Non-`original` values are served by the API "compress+format"
-            facade (one combined convert-with-size-cap pass); see per_value_availability + FORMAT.md.
+            Output format. original = keep input format (default); webp = recompress to
+            WebP — the one live compress+format target (proven on staging). Other format
+            changes (jpeg/png/avif/gif/tiff) are the convert operation's job, not compress.
+            See FORMAT.md.
 
     image_avif:
       availability: beta
@@ -145,19 +135,13 @@ operation:
           description: "AVIF encode speed (1-10, ravif). Lower = smaller file, slower encode; higher = faster, larger. Default 4."
         output_format:
           type: enum
-          values: [original, auto, smallest, jpeg, png, webp, avif]
+          values: [original, webp]
           default: original
-          per_value_availability:
-            auto:     { availability: planned }   # runtime Accept-best selection — unbuilt
-            smallest: { availability: planned }   # runtime try-all-smallest selection — unbuilt
-            jpeg:     { availability: planned }   # facade path not live until its own canonicalization
-            png:      { availability: planned }   # facade path not live until its own canonicalization
-            avif:     { availability: planned }   # facade path not live until its own canonicalization
           description: >-
-            Output format. original = keep input format (default); auto = best for browser
-            support (AVIF > WebP > JPEG via Accept hint); smallest = try all supported formats,
-            return the smallest. Non-`original` values are served by the API "compress+format"
-            facade (one combined convert-with-size-cap pass); see per_value_availability + FORMAT.md.
+            Output format. original = keep input format (default); webp = recompress to
+            WebP — the one live compress+format target (proven on staging). Other format
+            changes (jpeg/png/avif/gif/tiff) are the convert operation's job, not compress.
+            See FORMAT.md.
 
     image:
       mimes:
@@ -184,19 +168,13 @@ operation:
             currently available).
         output_format:
           type: enum
-          values: [original, auto, smallest, jpeg, png, webp, avif]
+          values: [original, webp]
           default: original
-          per_value_availability:
-            auto:     { availability: planned }   # runtime Accept-best selection — unbuilt
-            smallest: { availability: planned }   # runtime try-all-smallest selection — unbuilt
-            jpeg:     { availability: planned }   # facade path not live until its own canonicalization
-            png:      { availability: planned }   # facade path not live until its own canonicalization
-            avif:     { availability: planned }   # facade path not live until its own canonicalization
           description: >-
-            Output format. original = keep input format (default); auto = best for browser
-            support (AVIF > WebP > JPEG via Accept hint); smallest = try all supported formats,
-            return the smallest. Non-`original` values are served by the API "compress+format"
-            facade (one combined convert-with-size-cap pass); see per_value_availability + FORMAT.md.
+            Output format. original = keep input format (default); webp = recompress to
+            WebP — the one live compress+format target (proven on staging). Other format
+            changes (jpeg/png/avif/gif/tiff) are the convert operation's job, not compress.
+            See FORMAT.md.
 
     audio:
       mimes:

package/operations/schemas/split.yaml

@@ -98,8 +98,13 @@ operation:
   mime_groups:
     # Animated GIF base — parallel mime_group naming follows the
     # `image_gif` precedent established by `image_watermark.image_gif`.
+    # availability flipped planned -> stable (2026-06-21, user-greenlit): the
+    # split-gif worker is built + deployed (lambdas) and proven on staging
+    # (e2e). Create-acceptance also requires the API `operation_weights` row
+    # `split.image_gif` (proposed weight 2, by analogy to split.audio=2 /
+    # archive=2 — pending the user's pricing approval); this flip co-lands with
+    # that weight (the activation third-gate, per split.video precedent).
     image_gif:
-      availability: planned
       mimes:
         - image/gif
       options:

package/operations/schemas/thumbnail.yaml

@@ -2,7 +2,7 @@ schema_version: "1.0.0"
 
 operation:
   type: thumbnail
-  description: "Generate a preview image from the source file"
+  description: "Resize an image to specific dimensions, or extract a preview frame/page from a video or document. For images this is a full resizer (1-16384px), not just small previews."
   default: false
   input_model: single
 
@@ -23,19 +23,27 @@ operation:
         # Re-add after the v2.67.0 interim crash-window drop (aYPbNVKD Phase 2).
         image/avif: { availability: beta }
         image/heic: { availability: beta }
+      # Output-area wall (lambdas thumbnail-image MAX_OUTPUT_PIXELS): the FE
+      # pre-validates width*height <= max_output_pixels. The per-axis max (16384)
+      # is NOT the real limit — e.g. 6000x6000 (36MP) is rejected though each axis
+      # is < 16384; 6000x2000 (12MP) is fine. The worker enforces this regardless.
+      max_output_pixels: 16000000
       options:
+        # IMAGE input is a full resizer (Lanczos): width/height accept the
+        # worker's real 1-16384px range (area-capped above) — this op is the
+        # image-resize path, surfaced in the UI as "Resize", not only thumbnails.
         width:
           type: integer
           min: 1
-          max: 4096
+          max: 16384
           required: true
-          description: "Thumbnail width in pixels"
+          description: "Target width in pixels (1-16384; width*height <= 16MP). For image input this is a full resize, not just a small preview."
         height:
           type: integer
           min: 1
-          max: 4096
+          max: 16384
           required: true
-          description: "Thumbnail height in pixels"
+          description: "Target height in pixels (1-16384; width*height <= 16MP). For image input this is a full resize, not just a small preview."
         fit:
           type: enum
           values: [max, crop, scale]
@@ -81,6 +89,11 @@ operation:
           per_tier_constraints:
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
+      # Same 16MP output-area wall as image (width*height <= max_output_pixels).
+      # Extras (worker-enforced, prose-only): output dimensions are forced EVEN
+      # (force_divisible_by=2 — the worker rounds an odd request down) and the
+      # output file is capped at 50MB.
+      max_output_pixels: 16000000
       options:
         timestamp:
           type: string
@@ -89,15 +102,15 @@ operation:
         width:
           type: integer
           min: 1
-          max: 4096
+          max: 16384
           required: true
-          description: "Thumbnail width in pixels"
+          description: "Target width in pixels (1-16384; width*height <= 16MP). Rounded down to an even number by the worker."
         height:
           type: integer
           min: 1
-          max: 4096
+          max: 16384
           required: true
-          description: "Thumbnail height in pixels"
+          description: "Target height in pixels (1-16384; width*height <= 16MP). Rounded down to an even number by the worker."
         fit:
           type: enum
           values: [max, crop, scale]
@@ -126,6 +139,10 @@ operation:
         - application/vnd.oasis.opendocument.text
         - application/vnd.oasis.opendocument.spreadsheet
         - application/vnd.oasis.opendocument.presentation
+      # Same 16MP output-area wall as image (width*height <= max_output_pixels).
+      # The page is rendered at 150 DPI (render-side ~25MP raster) then resized;
+      # the output file is capped at 50MB (worker-enforced, prose-only).
+      max_output_pixels: 16000000
       options:
         source:
           type: enum
@@ -147,15 +164,15 @@ operation:
         width:
           type: integer
           min: 1
-          max: 4096
+          max: 16384
           required: true
-          description: "Thumbnail width in pixels"
+          description: "Target width in pixels (1-16384; width*height <= 16MP)."
         height:
           type: integer
           min: 1
-          max: 4096
+          max: 16384
           required: true
-          description: "Thumbnail height in pixels"
+          description: "Target height in pixels (1-16384; width*height <= 16MP)."
         fit:
           type: enum
           values: [max, crop, scale]

package/package.json

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