@giveitsmaller/contracts 0.83.0 → 0.85.0

package/operations/schemas/audio_watermark.yaml

@@ -78,8 +78,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         payload:
           type: string
@@ -184,8 +184,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         payload:
           type: string

package/operations/schemas/compress.yaml

@@ -1179,8 +1179,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         output_format:
           type: enum
@@ -1217,9 +1217,10 @@ operation:
             Output container. original = keep the input container (default, same-format
             compression). Other values change the container as part of the same job, keeping
             the size cap. When set, the RESOLVED target container determines the valid
-            codec/audio_codec/faststart sets — an absent/default codec resolves to a
-            container-valid one (e.g. webm -> vp9) and is never rejected; only a
-            caller-EXPLICIT incompatible value is rejected.
+            codec/audio_codec/faststart sets — an absent or default-equal value (sent equal
+            to its default counts as the default) resolves to a container-valid one (e.g.
+            webm -> vp9), is never rejected, and is reported in dropped_options; only a
+            NON-default incompatible value is rejected.
         codec:
           type: enum
           values: [h264, h265, vp9, av1]
@@ -1241,8 +1242,10 @@ operation:
             the input container): for a container that cannot carry it (e.g. WebM, which
             carries VP8/VP9/AV1) the server resolves a container-valid codec (WebM -> vp9).
             A DEFAULT value is never rejected — including an explicit `output_format: webm`
-            left at the default `h264` (resolves to vp9, not rejected); only a
-            caller-EXPLICIT incompatible codec is rejected.
+            left at the default `h264` (resolves to vp9, not rejected). A value equal to the
+            default counts as the default even when sent, and the substitution is reported
+            in dropped_options. Only a NON-default codec the container cannot carry is
+            rejected (e.g. h265 on WebM).
         encoding_mode:
           type: enum
           values: [crf, target_size]
@@ -1395,9 +1398,9 @@ operation:
             Move the MP4/MOV moov atom to the front so the file starts playing before it is
             fully downloaded (progressive web playback). MP4/MOV only. CONTAINER-CONDITIONAL
             against the RESOLVED output container (the explicit `output_format` if set, else
-            the input): the default (true) is silently inapplicable for a container with no
-            moov atom (e.g. WebM) — that is NOT a rejection. Only a caller-EXPLICIT
-            faststart:true on such a container is rejected.
+            the input): on a container with no moov atom (e.g. WebM) the default (true),
+            omitted or sent, is dropped and reported in dropped_options — never a rejection.
+            false there asks for nothing and is accepted.
         audio_codec:
           type: enum
           values: [aac, opus, vorbis, copy]
@@ -1422,9 +1425,11 @@ operation:
             the container, an absent/default audio_codec resolves to a container-valid codec
             via the facade (e.g. webm -> opus), NOT a blind copy of an incompatible stream —
             a DEFAULT is never rejected (the exact per-container resolution, incl. ogg
-            vorbis-vs-opus, is an output_format stable-flip prerequisite). A caller-EXPLICIT
-            codec the resolved container cannot carry (e.g. aac on a webm target) is
-            rejected.
+            vorbis-vs-opus, is an output_format stable-flip prerequisite). `copy` sent
+            explicitly counts as the default: if the source audio cannot be copied into the
+            target container it is re-encoded to the container default (webm -> opus) and
+            reported in dropped_options. A NON-default codec the resolved container cannot
+            carry (e.g. aac on a webm target) is rejected.
         audio_bitrate:
           type: enum
           value_type: integer

package/operations/schemas/convert.yaml

@@ -352,8 +352,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         output_format:
           type: enum

package/operations/schemas/custom_luma.yaml

@@ -84,8 +84,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         duration:
           type: float

package/operations/schemas/split.yaml

@@ -533,8 +533,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         mode:
           type: enum

package/operations/schemas/thumbnail.yaml

@@ -132,7 +132,7 @@ operation:
             max:
               max_input_size_bytes: 50000000000    # 50 GB (Max self-serve band)
             enterprise:
-              max_input_size_bytes: 120000000000   # 120 GB (Enterprise enforced ceiling)
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
       # 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

package/operations/schemas/transform.yaml

@@ -163,8 +163,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         rotate:
           type: enum

package/operations/schemas/video_text_watermark.yaml

@@ -126,8 +126,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         text:
           type: string

package/operations/schemas/video_watermark.yaml

@@ -93,8 +93,8 @@ operation:
               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
+              max_input_size_bytes: 107374182400   # 100 GiB = api's Enterprise upload cap (owner 649(2))
+              max_output_size_bytes: 107374182400
       options:
         anchor:
           type: enum

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@giveitsmaller/contracts",
-  "version": "0.83.0",
-  "description": "Generated contract types for GISL (Give It Smaller). Generated from compression_contracts spec v2.218.0.",
-  "gislContractsSpec": "v2.218.0",
+  "version": "0.85.0",
+  "description": "Generated contract types for GISL (Give It Smaller). Generated from compression_contracts spec v2.220.0.",
+  "gislContractsSpec": "v2.220.0",
   "license": "Apache-2.0",
   "homepage": "https://docs.giveitsmaller.com",
   "bugs": {
@@ -32,6 +32,7 @@
     "./asyncapi/events.yaml": "./asyncapi/events.yaml",
     "./resolution-bands.yaml": "./resolution-bands.yaml",
     "./anonymous-policy.yaml": "./anonymous-policy.yaml",
+    "./pricing-policy.yaml": "./pricing-policy.yaml",
     "./availability/availability.json": "./availability/availability.json",
     "./accepted-options/accepted-options.json": "./accepted-options/accepted-options.json",
     "./accepted-options/image-output-routes.json": "./accepted-options/image-output-routes.json",
@@ -67,7 +68,8 @@
     "operation-capabilities/operation-capabilities.json",
     "code-builder/code-builder-metadata.json",
     "resolution-bands.yaml",
-    "anonymous-policy.yaml"
+    "anonymous-policy.yaml",
+    "pricing-policy.yaml"
   ],
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', {recursive: true, force: true})\"",

package/pricing-policy.yaml

@@ -0,0 +1,82 @@
+# Pricing policy — the ONE declaration of how a workflow is charged
+# (card 8Y2fppO9; owner decisions 610(4) 2026-09-26 and 635 2026-09-29).
+#
+# 1.1.0 (card cDZuuyg8, owner decision 645(4) 2026-09-30): an already-optimised
+# compress is not charged (`charge.not_charged`). Additive.
+#
+# Read by: api (pins its billing constants to it: OperationCostCalculator,
+# CreditReservationService, UserTier::overdraftLimit), the frontend's pricing
+# copy, the SDKs, and tests/test_pricing_policy.py (holds the relations below).
+#
+# ⚠️ CONTRACT-FIRST. Two of these rules are AHEAD of api main 2a8dd8d5, and
+# `api_today` under each says what the API does until it ships the change.
+# A consumer reading this file for a PRICE must not assume the new rule is
+# live until api's release notes say so.
+
+schema_version: "1.1.0"
+
+charge:
+  # Owner 610(4)(a) + 635(1): pay only for successful results, PER JOB.
+  # A job that completes is charged; a job that fails (after its retries) is
+  # refunded, as is cancelled work. A multi-job workflow with one failed job
+  # is charged for the jobs that completed.
+  basis: per_completed_job
+  refunded_on: [job_failed, workflow_cancelled]
+  # A workflow paused for insufficient credits has its reservation RELEASED
+  # at the pause and reserved again on resume (so a pause that expires
+  # unresumed owes nothing). api main: CreditReservationService
+  # releaseForPause / ResumeWorkflowCommandHandler.
+  on_pause: released_then_reserved_again_on_resume
+  # Reserved at create for the whole workflow (402 balance_exhausted if the
+  # caller cannot afford it), settled per job as jobs end.
+  reserved_at: workflow_create
+  # A long-form fan-out is settled at what it actually used; the unused
+  # part of its worst-case reservation is refunded.
+  fan_out_settlement: actual_usage
+  # Owner 645(4): an OPERATION that could not make the file smaller and
+  # returned the original is NOT charged; its cost is refunded. The job's
+  # other operations are charged as usual. Per operation, not per job. The
+  # FULL predicate, all of which must hold (a flag alone is not enough: the
+  # metrics object rides on every result):
+  not_charged:
+    - when:
+        operation_type: compress
+        status: completed
+        route: same_format        # resolved: output_format original/absent OR equal to the input format
+        metric: already_optimal   # metrics.already_optimal == true
+  not_charged_api_today: already_optimal_operations_are_charged
+  # api main 2a8dd8d5 refunds the WHOLE reservation when any job fails, so a
+  # partially_failed workflow is charged nothing (OperationResultHandler
+  # releaseReservationOnFailure). Changing to per-job is api's follow-up.
+  api_today: whole_workflow_refund_on_any_job_failure
+
+upload:
+  # Owner 610(4)(b) + 635(2): uploading costs nothing. Larger files cost more
+  # to PROCESS, through the size surcharge below.
+  charged: false
+
+size_surcharge:
+  # Added to each operation's weight. The size is the JOB's input (its
+  # primary upload), applied to every operation of the job, not each
+  # operation's intermediate input (api CreateWorkflowCommandHandler).
+  basis: job_input_bytes
+  # surcharge per operation:
+  #   surcharge = min(max_credits, floor((bytes - free_bytes) / step_bytes))
+  #   for bytes > free_bytes, else 0.
+  # Binary units: 52,428,800 B = 50 MiB (api OperationCostCalculator).
+  free_bytes: 52428800
+  step_bytes: 52428800
+  credits_per_step: 1
+  max_credits: 500
+
+overdraft:
+  # Owner 610(4)(c) + 635(3). The limit is per account and is returned by
+  # GET /api/v2/credits/balance (`overdraft_limit`), which is the source for
+  # any caller; only the Basic value is policy.
+  basic_limit: 0
+  # Overdraft debt is repaid ONE credit for ONE credit from the next monthly
+  # grant, on every paid plan. There is no per-plan multiplier.
+  repayment_ratio: 1
+  # api main already repays 1:1 (CreditAccount); its unused per-plan
+  # multipliers (UserTier::overdraftRate) are deleted in api's follow-up.
+  api_today: repays_1_to_1_unused_per_plan_multiplier_present