@giveitsmaller/contracts 0.46.0 → 0.48.0

package/operations/schemas/audio_watermark.yaml

@@ -3,6 +3,14 @@ schema_version: "2.0.0"
 operation:
   type: audio_watermark
   availability: planned
+  # required_tier stays `enterprise` after the Max tier (TaAvvGm4): Max gains
+  # the audio MIME *entitlement* (it can compress / convert / overlay / split
+  # audio), but forensic audio watermarking (Cinavia / Resemble PerTh) is a
+  # premium Enterprise differentiator, NOT basic audio processing — Max is
+  # "Pro + audio + larger long-form bands, NOT Enterprise". MIME entitlement
+  # (the UserTier capability summary) and a per-operation `required_tier` gate
+  # are orthogonal axes, so a Max caller having audio is not contradicted by
+  # this op being Enterprise-only. (Reassessed per TaAvvGm4 scope item 3.)
   required_tier: enterprise
   description: |
     Embed a steganographic forensic watermark into an audio asset (or
@@ -43,9 +51,12 @@ operation:
       processing_class:
         # F8 long-form tier (per ticket I15-CONS). audio_watermark is
         # `availability: planned` + `required_tier: enterprise` at the
-        # operation level; per-class entries inherit the enterprise
-        # tier (long_form widens further to enterprise as the natural
-        # superset of pro).
+        # operation level (see the op-level note re: the Max tier — this
+        # premium forensic feature is Enterprise-only despite Max having
+        # the audio MIME entitlement); per-class entries inherit the
+        # enterprise tier, so the baseline IS the Enterprise cap and no
+        # per_tier_constraints (max/...) is declared — there is no tier
+        # above the baseline (ADR-0011 D2).
         short_form:
           availability: planned
           required_tier: enterprise

package/operations/schemas/compress.yaml

@@ -237,7 +237,7 @@ operation:
             that stripping metadata never silently shifts colours. `keep` (default) =
             preserve your colours: embed the ICC profile where the output format can
             carry one, otherwise convert to sRGB and bake the colours in so they survive
-            (never a silent drop); `srgb` = convert to sRGB (also handles CMYK → sRGB);
+            (never a silent drop); `srgb` = convert to sRGB (transform pixels to sRGB, emit untagged — no embedded ICC, the web default; CMYK/grayscale best-effort);
             `strip` = drop the profile (smallest — only when the consumer manages colour
             itself).
         auto_orient:
@@ -365,7 +365,7 @@ operation:
             that stripping metadata never silently shifts colours. `keep` (default) =
             preserve your colours: embed the ICC profile where the output format can
             carry one, otherwise convert to sRGB and bake the colours in so they survive
-            (never a silent drop); `srgb` = convert to sRGB (also handles CMYK → sRGB);
+            (never a silent drop); `srgb` = convert to sRGB (transform pixels to sRGB, emit untagged — no embedded ICC, the web default; CMYK/grayscale best-effort);
             `strip` = drop the profile (smallest — only when the consumer manages colour
             itself).
         auto_orient:
@@ -655,7 +655,7 @@ operation:
             that stripping metadata never silently shifts colours. `keep` (default) =
             preserve your colours: embed the ICC profile where the output format can
             carry one, otherwise convert to sRGB and bake the colours in so they survive
-            (never a silent drop); `srgb` = convert to sRGB (also handles CMYK → sRGB);
+            (never a silent drop); `srgb` = convert to sRGB (transform pixels to sRGB, emit untagged — no embedded ICC, the web default; CMYK/grayscale best-effort);
             `strip` = drop the profile (smallest — only when the consumer manages colour
             itself). On the WebP same-format route `srgb` is `planned` (the byte-level
             optimiser does not yet run the sRGB transform); `keep` and `strip` are live.
@@ -809,14 +809,21 @@ operation:
           type: enum
           values: [keep, srgb, strip]
           default: keep
-          availability: planned
+          per_value_availability:
+            srgb: { availability: planned }
           honored_on: [same_format, format_change]
           description: >-
             Colour-profile handling — a dedicated control, separate from `metadata` so
             that stripping metadata never silently shifts colours. `keep` (default) =
-            preserve the embedded colour profile; `srgb` = convert to sRGB (also
-            handles CMYK → sRGB); `strip` = drop the profile (smallest — only when the
-            consumer manages colour itself). `planned` — not yet supported.
+            preserve your colours: embed the ICC profile where the output format can
+            carry one, otherwise convert to sRGB and bake the colours in so they survive
+            (never a silent drop — for TIFF inputs the gamut is baked to sRGB; GIF carries
+            no profile so this is a no-op); `srgb` = convert to sRGB (transform pixels to
+            sRGB, emit untagged — no embedded ICC, the web default; CMYK/grayscale
+            best-effort); `strip` = drop the profile (smallest — only when the consumer
+            manages colour itself). On compress `srgb` is `planned` for this group (the
+            sRGB pixel transform is wired for JPEG/PNG only so far); `keep` and `strip`
+            are live.
         auto_orient:
           type: boolean
           default: true
@@ -928,6 +935,9 @@ operation:
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
             max_output_size_bytes: 5000000000
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
+              max_output_size_bytes: 50000000000
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
               max_output_size_bytes: 120000000000

package/operations/schemas/convert.yaml

@@ -127,14 +127,17 @@ operation:
           type: enum
           values: [keep, srgb, strip]
           default: keep
-          availability: planned
           honored_on: [format_change]
           description: >-
             Colour-profile handling — a dedicated control, separate from `metadata`
             so that stripping metadata never silently shifts colours. `keep`
-            (default) = preserve the embedded colour profile; `srgb` = convert to
-            sRGB (also handles CMYK → sRGB); `strip` = drop the profile. `planned` —
-            not yet supported.
+            (default) = preserve your colours: embed the ICC profile where the target
+            format can carry one, otherwise convert to sRGB and bake the colours in so
+            they survive (never a silent drop); `srgb` = convert to sRGB (transform
+            pixels to sRGB, emit untagged — no embedded ICC, the web default;
+            CMYK/grayscale best-effort); `strip` = drop the profile. The worker reads
+            the input ICC for every accepted raster input (JPEG/PNG/WebP/TIFF, plus
+            HEIF/AVIF via the ISO-BMFF `colr` box).
         auto_orient:
           type: boolean
           default: true
@@ -272,15 +275,16 @@ operation:
           type: enum
           values: [keep, srgb, strip]
           default: keep
-          availability: planned
           depends_on: { output_format: [jpeg, png, webp, avif, gif, tiff] }
           honored_on: [format_change]
           description: >-
-            Colour-profile handling — `keep` (default) = preserve the embedded colour
-            profile; `srgb` = convert to sRGB; `strip` = drop the profile. `planned`
-            — not yet supported. Scoped to the STILL-IMAGE targets only — the video
-            targets (mp4/webm) carry no colour profile, so this is not accepted for a
-            gif→video output.
+            Colour-profile handling — `keep` (default) = preserve your colours (embed
+            where the target carries an ICC, else bake to sRGB; a no-op for the GIF
+            input itself, which carries no profile); `srgb` = convert to sRGB
+            (transform pixels to sRGB, emit untagged — no embedded ICC, the web
+            default); `strip` = drop the profile. Scoped to the STILL-IMAGE targets
+            only — the video targets (mp4/webm) carry no colour profile, so this is
+            not accepted for a gif→video output.
         auto_orient:
           type: boolean
           default: true
@@ -317,6 +321,9 @@ operation:
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
             max_output_size_bytes: 5000000000
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
+              max_output_size_bytes: 50000000000
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
               max_output_size_bytes: 120000000000

package/operations/schemas/custom_luma.yaml

@@ -74,6 +74,9 @@ operation:
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
             max_output_size_bytes: 5000000000
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
+              max_output_size_bytes: 50000000000
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
               max_output_size_bytes: 120000000000

package/operations/schemas/merge.yaml

@@ -174,6 +174,8 @@ operation:
             max_total_duration: "PT24H"              # 24h (was PT12H) — binding Enterprise ceiling
             max_total_input_size_bytes: 5000000000   # 5 GB combined (Pro)
           per_tier_constraints:
+            max:
+              max_total_input_size_bytes: 50000000000   # 50 GB combined (Max self-serve band)
             enterprise:
               max_total_input_size_bytes: 120000000000  # 120 GB combined (Enterprise)
       options:

package/operations/schemas/split.yaml

@@ -307,6 +307,9 @@ operation:
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
             max_output_size_bytes: 5000000000
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
+              max_output_size_bytes: 50000000000
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB
               max_output_size_bytes: 120000000000

package/operations/schemas/thumbnail.yaml

@@ -157,6 +157,8 @@ operation:
             max_input_duration: "PT12H"
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
       # Same 16MP output-area wall as image (width*height <= max_output_pixels).

package/operations/schemas/video_text_watermark.yaml

@@ -48,6 +48,9 @@ operation:
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
             max_output_size_bytes: 5000000000
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
+              max_output_size_bytes: 50000000000
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
               max_output_size_bytes: 120000000000

package/operations/schemas/video_watermark.yaml

@@ -75,6 +75,9 @@ operation:
             max_input_size_bytes: 5000000000       # 5 GB (Pro)
             max_output_size_bytes: 5000000000
           per_tier_constraints:
+            max:
+              max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
+              max_output_size_bytes: 50000000000
             enterprise:
               max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
               max_output_size_bytes: 120000000000

package/package.json

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