@giveitsmaller/contracts 0.34.0 → 0.36.0

package/dist/openapi/models/WorkflowWarning.js

@@ -4,7 +4,7 @@
  * GISL Compression API
  * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Currently committed locales:** `en-GB` only (per ticket   [`4GKyuYo6`](https://trello.com/c/4GKyuYo6)). The I26 carrier   shape (`Accept-Language` + `Content-Language` + `Vary` headers +   `locale` envelope field + `message_key` + `message_params`) is   stable and exercised; the **catalog** of translated `message`   strings is en-GB-only at runtime today. Additional locales (e.g.   `pt-PT`) will be advertised by name when their catalogs ship —   the request/response carrier shape does NOT change when a new   locale lands. Treat unrequested locales as \"machine-code +   `message_key` path is committed; localised `message` prose is   not\" until this prose enumerates them by name. - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match —   which, until additional catalogs land, is every non-`en-GB`   `Accept-Language`. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). `Vary` is emitted unconditionally so the   header contract does not flip when a second locale ships. - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source 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.
  *
- * The version of the OpenAPI document: 2.97.0
+ * The version of the OpenAPI document: 2.104.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/openapi/models/WorkflowWarningSeverity.d.ts

@@ -2,7 +2,7 @@
  * GISL Compression API
  * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Currently committed locales:** `en-GB` only (per ticket   [`4GKyuYo6`](https://trello.com/c/4GKyuYo6)). The I26 carrier   shape (`Accept-Language` + `Content-Language` + `Vary` headers +   `locale` envelope field + `message_key` + `message_params`) is   stable and exercised; the **catalog** of translated `message`   strings is en-GB-only at runtime today. Additional locales (e.g.   `pt-PT`) will be advertised by name when their catalogs ship —   the request/response carrier shape does NOT change when a new   locale lands. Treat unrequested locales as \"machine-code +   `message_key` path is committed; localised `message` prose is   not\" until this prose enumerates them by name. - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match —   which, until additional catalogs land, is every non-`en-GB`   `Accept-Language`. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). `Vary` is emitted unconditionally so the   header contract does not flip when a second locale ships. - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source 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.
  *
- * The version of the OpenAPI document: 2.97.0
+ * The version of the OpenAPI document: 2.104.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/openapi/models/WorkflowWarningSeverity.js

@@ -4,7 +4,7 @@
  * GISL Compression API
  * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Currently committed locales:** `en-GB` only (per ticket   [`4GKyuYo6`](https://trello.com/c/4GKyuYo6)). The I26 carrier   shape (`Accept-Language` + `Content-Language` + `Vary` headers +   `locale` envelope field + `message_key` + `message_params`) is   stable and exercised; the **catalog** of translated `message`   strings is en-GB-only at runtime today. Additional locales (e.g.   `pt-PT`) will be advertised by name when their catalogs ship —   the request/response carrier shape does NOT change when a new   locale lands. Treat unrequested locales as \"machine-code +   `message_key` path is committed; localised `message` prose is   not\" until this prose enumerates them by name. - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match —   which, until additional catalogs land, is every non-`en-GB`   `Accept-Language`. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). `Vary` is emitted unconditionally so the   header contract does not flip when a second locale ships. - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source 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.
  *
- * The version of the OpenAPI document: 2.97.0
+ * The version of the OpenAPI document: 2.104.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/openapi/runtime.d.ts

@@ -2,7 +2,7 @@
  * GISL Compression API
  * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Currently committed locales:** `en-GB` only (per ticket   [`4GKyuYo6`](https://trello.com/c/4GKyuYo6)). The I26 carrier   shape (`Accept-Language` + `Content-Language` + `Vary` headers +   `locale` envelope field + `message_key` + `message_params`) is   stable and exercised; the **catalog** of translated `message`   strings is en-GB-only at runtime today. Additional locales (e.g.   `pt-PT`) will be advertised by name when their catalogs ship —   the request/response carrier shape does NOT change when a new   locale lands. Treat unrequested locales as \"machine-code +   `message_key` path is committed; localised `message` prose is   not\" until this prose enumerates them by name. - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match —   which, until additional catalogs land, is every non-`en-GB`   `Accept-Language`. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). `Vary` is emitted unconditionally so the   header contract does not flip when a second locale ships. - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source 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.
  *
- * The version of the OpenAPI document: 2.97.0
+ * The version of the OpenAPI document: 2.104.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/openapi/runtime.js

@@ -4,7 +4,7 @@
  * GISL Compression API
  * REST API for the GISL (Give It Smaller) file compression and processing service.  **Architecture:** - Upload files to get a `file_id` - Create workflows referencing uploaded files with operations (compress, thumbnail, image_watermark, text_watermark, merge, archive, convert, custom_luma, audio_overlay, audio_watermark) - Poll status, stream SSE events, or receive webhook callbacks - Download results per operation output  **Response envelope:** All mutation and query endpoints return `{ success: true, data: {...} }` on success and `{ success: false, error: \"...\", details: [...] }` on failure. Exceptions: `GET /api/operations/schema` returns raw JSON (per-tier private caching with ETag revalidation per ADR-0002 + I3), health probes return flat objects, and `POST /api/contact` returns 204 with no body.  **Availability metadata.** This spec uses the `x-availability` vendor extension as **decorative documentation only**. Per [ADR-0001](../docs/decisions/0001-contract-first-availability.md) §1.5, the runtime endpoint `GET /api/operations/schema` (ticket I3) is the authoritative source; the sidecar `availability.json` (ticket I3b) is the authoritative companion (generated, never hand-edited; CI cross-checks runtime ⇄ sidecar). SDKs MUST NOT depend on `x-availability` reaching generated code — code-generators that surface vendor extensions may emit it as documentation, but consumers read availability from the runtime endpoint, not from the generated bindings.  The 5-value vocabulary (`stable | beta | experimental | planned | deprecated`) is defined in the `AvailabilityValue` schema. See `schemas/FORMAT.md` §Availability Taxonomy for the operational rules (parser obligation: absent = stable; per-enum-value granularity is the `per_value_availability` primitive landed via ticket I17).  **Localisation (per ticket [I26](https://trello.com/c/rcnqwgI4)).**  Error responses + paused/blocked workflow statuses carry a localised human-readable `message` alongside a stable, never-localised `message_key`. Machine-readable fields (`error`, enum values, status codes) stay canonical English.  - **Currently committed locales:** `en-GB` only (per ticket   [`4GKyuYo6`](https://trello.com/c/4GKyuYo6)). The I26 carrier   shape (`Accept-Language` + `Content-Language` + `Vary` headers +   `locale` envelope field + `message_key` + `message_params`) is   stable and exercised; the **catalog** of translated `message`   strings is en-GB-only at runtime today. Additional locales (e.g.   `pt-PT`) will be advertised by name when their catalogs ship —   the request/response carrier shape does NOT change when a new   locale lands. Treat unrequested locales as \"machine-code +   `message_key` path is committed; localised `message` prose is   not\" until this prose enumerates them by name. - **Request:** `Accept-Language` header per RFC 9110 §12.5.4 (q-value   negotiation supported). The server selects the best-match locale   from its supported list; falls back to `en-GB` when no match —   which, until additional catalogs land, is every non-`en-GB`   `Accept-Language`. - **Response:** `Content-Language: <locale>` echo on every localised   response; `Vary: Accept-Language` on every response (CDN/cache   correctness — different `Accept-Language` requests produce   different responses). `Vary` is emitted unconditionally so the   header contract does not flip when a second locale ships. - **Fallback locale:** `en-GB` (also the canonical locale for   `message_key` translations and English `message` prose). - **SDK guidance:** switch on `error` (machine code) for typed   error branches; surface `message_key` to client-side i18n   catalogs (SDK companion work tracked at X19, cross-repo);   display `message` for end-user UI; **never parse `message` for   control flow** — it changes per locale.  Carrier shape lives on `ErrorEnvelope` (envelope-level optional `message_key` + `message` + `locale` + `message_params`) and `ValidationErrorEnvelope` (also per-`details[]` entry). Existing 402 / 403 / 422 envelopes (`BalanceExhaustedResponse`, `FeatureNotAvailableResponse`, `FeatureTierRestrictedResponse`, `WorkflowPausedDetail`) inherit the convention.  **Upload thresholds (per tickets [u0ar7Yye](https://trello.com/c/u0ar7Yye) + [58nBQLWQ](https://trello.com/c/58nBQLWQ)).** Canonical upload constants (single-shot cap, multipart chunk size, multipart concurrency default, multipart first-chunk size) live on the `UploadThresholds` schema with `const:`-pinned values. SDK generators emit these as typed binding constants so frontend / API / SDKs reference one source 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.
  *
- * The version of the OpenAPI document: 2.97.0
+ * The version of the OpenAPI document: 2.104.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/operations/compress.d.ts

@@ -1,3 +1,7 @@
+export declare enum CompressImageJpegEncodingMode {
+    Quality = "quality",
+    TargetSize = "target_size"
+}
 export declare enum CompressImageJpegMetadata {
     All = "all",
     Keep = "keep"
@@ -13,6 +17,8 @@ export declare enum CompressImageJpegFit {
 }
 export interface CompressImageJpegOptions {
     quality?: number;
+    encoding_mode?: CompressImageJpegEncodingMode;
+    target_size_bytes?: number;
     metadata?: CompressImageJpegMetadata;
     progressive?: boolean;
     output_format?: CompressImageJpegOutputFormat;
@@ -44,9 +50,12 @@ export interface CompressImagePngOptions {
     height?: number;
     fit?: CompressImagePngFit;
 }
+export declare enum CompressImageAvifEncodingMode {
+    Quality = "quality",
+    TargetSize = "target_size"
+}
 export declare enum CompressImageAvifMetadata {
-    All = "all",
-    Keep = "keep"
+    All = "all"
 }
 export declare enum CompressImageAvifOutputFormat {
     Original = "original",
@@ -59,6 +68,8 @@ export declare enum CompressImageAvifFit {
 }
 export interface CompressImageAvifOptions {
     quality?: number;
+    encoding_mode?: CompressImageAvifEncodingMode;
+    target_size_bytes?: number;
     metadata?: CompressImageAvifMetadata;
     avif_speed?: number;
     output_format?: CompressImageAvifOutputFormat;
@@ -66,6 +77,10 @@ export interface CompressImageAvifOptions {
     height?: number;
     fit?: CompressImageAvifFit;
 }
+export declare enum CompressImageWebpEncodingMode {
+    Quality = "quality",
+    TargetSize = "target_size"
+}
 export declare enum CompressImageWebpMetadata {
     All = "all",
     Keep = "keep"
@@ -81,6 +96,8 @@ export declare enum CompressImageWebpFit {
 }
 export interface CompressImageWebpOptions {
     quality?: number;
+    encoding_mode?: CompressImageWebpEncodingMode;
+    target_size_bytes?: number;
     metadata?: CompressImageWebpMetadata;
     output_format?: CompressImageWebpOutputFormat;
     lossless?: boolean;
@@ -89,8 +106,7 @@ export interface CompressImageWebpOptions {
     fit?: CompressImageWebpFit;
 }
 export declare enum CompressImageSvgMetadata {
-    All = "all",
-    Keep = "keep"
+    All = "all"
 }
 export declare enum CompressImageSvgOutputFormat {
     Original = "original",

package/dist/operations/compress.js

@@ -1,4 +1,9 @@
 // Auto-generated from compress.yaml -- do not edit
+export var CompressImageJpegEncodingMode;
+(function (CompressImageJpegEncodingMode) {
+    CompressImageJpegEncodingMode["Quality"] = "quality";
+    CompressImageJpegEncodingMode["TargetSize"] = "target_size";
+})(CompressImageJpegEncodingMode || (CompressImageJpegEncodingMode = {}));
 export var CompressImageJpegMetadata;
 (function (CompressImageJpegMetadata) {
     CompressImageJpegMetadata["All"] = "all";
@@ -31,10 +36,14 @@ export var CompressImagePngFit;
     CompressImagePngFit["Crop"] = "crop";
     CompressImagePngFit["Scale"] = "scale";
 })(CompressImagePngFit || (CompressImagePngFit = {}));
+export var CompressImageAvifEncodingMode;
+(function (CompressImageAvifEncodingMode) {
+    CompressImageAvifEncodingMode["Quality"] = "quality";
+    CompressImageAvifEncodingMode["TargetSize"] = "target_size";
+})(CompressImageAvifEncodingMode || (CompressImageAvifEncodingMode = {}));
 export var CompressImageAvifMetadata;
 (function (CompressImageAvifMetadata) {
     CompressImageAvifMetadata["All"] = "all";
-    CompressImageAvifMetadata["Keep"] = "keep";
 })(CompressImageAvifMetadata || (CompressImageAvifMetadata = {}));
 export var CompressImageAvifOutputFormat;
 (function (CompressImageAvifOutputFormat) {
@@ -47,6 +56,11 @@ export var CompressImageAvifFit;
     CompressImageAvifFit["Crop"] = "crop";
     CompressImageAvifFit["Scale"] = "scale";
 })(CompressImageAvifFit || (CompressImageAvifFit = {}));
+export var CompressImageWebpEncodingMode;
+(function (CompressImageWebpEncodingMode) {
+    CompressImageWebpEncodingMode["Quality"] = "quality";
+    CompressImageWebpEncodingMode["TargetSize"] = "target_size";
+})(CompressImageWebpEncodingMode || (CompressImageWebpEncodingMode = {}));
 export var CompressImageWebpMetadata;
 (function (CompressImageWebpMetadata) {
     CompressImageWebpMetadata["All"] = "all";
@@ -66,7 +80,6 @@ export var CompressImageWebpFit;
 export var CompressImageSvgMetadata;
 (function (CompressImageSvgMetadata) {
     CompressImageSvgMetadata["All"] = "all";
-    CompressImageSvgMetadata["Keep"] = "keep";
 })(CompressImageSvgMetadata || (CompressImageSvgMetadata = {}));
 export var CompressImageSvgOutputFormat;
 (function (CompressImageSvgOutputFormat) {

package/dist/operations/compress.metadata.js

@@ -9,13 +9,20 @@ export const compressMetadata = {
                 quality: {
                     per_value_availability: {},
                 },
-                metadata: {
+                encoding_mode: {
                     per_value_availability: {
-                        keep: {
+                        target_size: {
                             availability: 'planned',
                         },
                     },
                 },
+                target_size_bytes: {
+                    availability: 'planned',
+                    per_value_availability: {},
+                },
+                metadata: {
+                    per_value_availability: {},
+                },
                 progressive: {
                     per_value_availability: {},
                 },
@@ -23,7 +30,6 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 lossless: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
                 width: {
@@ -46,11 +52,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 metadata: {
-                    per_value_availability: {
-                        keep: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
                 optimization_level: {
                     per_value_availability: {},
@@ -82,13 +84,20 @@ export const compressMetadata = {
                 quality: {
                     per_value_availability: {},
                 },
-                metadata: {
+                encoding_mode: {
                     per_value_availability: {
-                        keep: {
+                        target_size: {
                             availability: 'planned',
                         },
                     },
                 },
+                target_size_bytes: {
+                    availability: 'planned',
+                    per_value_availability: {},
+                },
+                metadata: {
+                    per_value_availability: {},
+                },
                 avif_speed: {
                     per_value_availability: {},
                 },
@@ -114,18 +123,24 @@ export const compressMetadata = {
                 quality: {
                     per_value_availability: {},
                 },
-                metadata: {
+                encoding_mode: {
                     per_value_availability: {
-                        keep: {
+                        target_size: {
                             availability: 'planned',
                         },
                     },
                 },
+                target_size_bytes: {
+                    availability: 'planned',
+                    per_value_availability: {},
+                },
+                metadata: {
+                    per_value_availability: {},
+                },
                 output_format: {
                     per_value_availability: {},
                 },
                 lossless: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
                 width: {
@@ -148,11 +163,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 metadata: {
-                    per_value_availability: {
-                        keep: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
                 output_format: {
                     per_value_availability: {},
@@ -168,11 +179,7 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 metadata: {
-                    per_value_availability: {
-                        keep: {
-                            availability: 'planned',
-                        },
-                    },
+                    per_value_availability: {},
                 },
                 output_format: {
                     per_value_availability: {},
@@ -209,11 +216,9 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 trim_start: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
                 trim_end: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
             },
@@ -291,11 +296,9 @@ export const compressMetadata = {
                     per_value_availability: {},
                 },
                 trim_start: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
                 trim_end: {
-                    availability: 'planned',
                     per_value_availability: {},
                 },
             },

package/dist/operations/convert.d.ts

@@ -6,10 +6,31 @@ export declare enum ConvertImageOutputFormat {
     Gif = "gif",
     Tiff = "tiff"
 }
+export declare enum ConvertImageFit {
+    Max = "max",
+    Crop = "crop",
+    Scale = "scale"
+}
 export interface ConvertImageOptions {
     output_format: ConvertImageOutputFormat;
     quality?: number;
     background?: string;
+    width?: number;
+    height?: number;
+    fit?: ConvertImageFit;
+}
+export declare enum ConvertImageSvgOutputFormat {
+    Jpeg = "jpeg",
+    Png = "png",
+    Webp = "webp",
+    Avif = "avif",
+    Gif = "gif",
+    Tiff = "tiff"
+}
+export interface ConvertImageSvgOptions {
+    output_format: ConvertImageSvgOutputFormat;
+    quality?: number;
+    background?: string;
 }
 export declare enum ConvertVideoOutputFormat {
     Mp4 = "mp4",

package/dist/operations/convert.js

@@ -8,6 +8,21 @@ export var ConvertImageOutputFormat;
     ConvertImageOutputFormat["Gif"] = "gif";
     ConvertImageOutputFormat["Tiff"] = "tiff";
 })(ConvertImageOutputFormat || (ConvertImageOutputFormat = {}));
+export var ConvertImageFit;
+(function (ConvertImageFit) {
+    ConvertImageFit["Max"] = "max";
+    ConvertImageFit["Crop"] = "crop";
+    ConvertImageFit["Scale"] = "scale";
+})(ConvertImageFit || (ConvertImageFit = {}));
+export var ConvertImageSvgOutputFormat;
+(function (ConvertImageSvgOutputFormat) {
+    ConvertImageSvgOutputFormat["Jpeg"] = "jpeg";
+    ConvertImageSvgOutputFormat["Png"] = "png";
+    ConvertImageSvgOutputFormat["Webp"] = "webp";
+    ConvertImageSvgOutputFormat["Avif"] = "avif";
+    ConvertImageSvgOutputFormat["Gif"] = "gif";
+    ConvertImageSvgOutputFormat["Tiff"] = "tiff";
+})(ConvertImageSvgOutputFormat || (ConvertImageSvgOutputFormat = {}));
 export var ConvertVideoOutputFormat;
 (function (ConvertVideoOutputFormat) {
     ConvertVideoOutputFormat["Mp4"] = "mp4";

package/dist/operations/convert.metadata.js

@@ -12,6 +12,31 @@ export const convertMetadata = {
                     availability: 'beta',
                 },
             },
+            options: {
+                output_format: {
+                    per_value_availability: {},
+                },
+                quality: {
+                    per_value_availability: {},
+                },
+                background: {
+                    per_value_availability: {},
+                },
+                width: {
+                    per_value_availability: {},
+                },
+                height: {
+                    per_value_availability: {},
+                },
+                fit: {
+                    per_value_availability: {},
+                },
+            },
+            per_input_options: {},
+        },
+        image_svg: {
+            processing_class: {},
+            per_mime_availability: {},
             options: {
                 output_format: {
                     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.97.0
+  version: 2.104.0
   contact:
     name: API Support
 
@@ -11281,6 +11281,18 @@ components:
         max:
           type: number
           description: Maximum value (for integer/float types)
+        pattern:
+          type: string
+          description: |
+            ECMA-262 regular expression a `type: string` value MUST match
+            (the string analogue of `min`/`max`). Consumers pre-validate
+            against it before submit, and the server rejects a non-matching
+            value as `invalid_options` — so the contract never advertises a
+            free-form string for an option whose worker silently drops
+            non-conforming input (e.g. `convert.image.background` honours only
+            `#RRGGBB`; a CSS named colour was silently dropped to white). Only
+            meaningful for `type: string`. See `schemas/FORMAT.md`.
+          example: "^#[0-9a-fA-F]{6}$"
         depends_on:
           type: object
           description: |

package/operation-capabilities/operation-capabilities.json

@@ -140,6 +140,33 @@
             ]
           },
           "wire_code": "feature_not_available"
+        },
+        {
+          "availability": "stable",
+          "constraint_id": "compress.video.trim.longform",
+          "eval_scope": "api",
+          "message": "Trimming is not yet available for long-form video. Trim a short-form clip, or chain a split op.",
+          "when": {
+            "all": [
+              {
+                "equals": "long_form",
+                "field": "processing_class"
+              },
+              {
+                "any": [
+                  {
+                    "field": "compress.trim_start",
+                    "isSet": true
+                  },
+                  {
+                    "field": "compress.trim_end",
+                    "isSet": true
+                  }
+                ]
+              }
+            ]
+          },
+          "wire_code": "feature_not_available"
         }
       ],
       "input": {
@@ -471,5 +498,5 @@
       "isAnimated": "maybe"
     }
   },
-  "schema_version": "2.97.0"
+  "schema_version": "2.104.0"
 }