@giveitsmaller/contracts 0.29.0 → 0.30.0

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.92.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.92.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/package.json

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