@giveitsmaller/contracts 0.2.3 → 0.4.0

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

@@ -0,0 +1,155 @@
+/**
+ * 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/Last-Modified 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.  - **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. - **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). - **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.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { UserTier } from './UserTier.js';
+/**
+ *
+ * @export
+ * @interface UploadSizeExceedsTierResponse
+ */
+export interface UploadSizeExceedsTierResponse {
+    /**
+     *
+     * @type {UploadSizeExceedsTierResponseSuccessEnum}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    success: UploadSizeExceedsTierResponseSuccessEnum;
+    /**
+     * Stable, machine-readable error code (e.g.
+     * `INVALID_OPTIONS`, `BALANCE_EXHAUSTED`,
+     * `REQUIRES_REENCODE`). Canonical English; never localised.
+     * SDKs duck-type on this field for typed error-branch
+     * helpers.
+     *
+     * Multipart-session resume codes (per ticket
+     * [`HxUmVr3Y`](https://trello.com/c/HxUmVr3Y), V2.10.0):
+     * - `MULTIPART_SESSION_NOT_FOUND` (404) — upload_id does
+     *   not match an in-flight session (expired / never
+     *   existed / wrong account namespace). Fired by /status,
+     *   /presign, /keepalive.
+     * - `MULTIPART_SESSION_OWNERSHIP` (403) — authenticated
+     *   caller is not the session owner. Fired by /status,
+     *   /presign, /keepalive, /complete (when manifest.userId
+     *   is non-null and differs).
+     * - `MULTIPART_SESSION_AUTH_REQUIRED` (403) — session was
+     *   anonymously initiated; the three resume endpoints
+     *   require authentication. The `8LABloaz` follow-up will
+     *   flip `/initiate` to also require auth.
+     * - `FILE_TOO_LARGE_FOR_MULTIPART` (422) — assembled object
+     *   would exceed the S3 multipart capacity cap. Pre-S3
+     *   server-side capacity gate; distinct from tier-quota
+     *   rejections (`upload_size_exceeds_tier`).
+     *
+     * @type {string}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    error: string;
+    /**
+     * Human-readable error message, localised per the
+     * request's `Accept-Language` header (fallback locale
+     * `en-GB`). The response carries `Content-Language:
+     * <locale>` + `Vary: Accept-Language` headers. **Never
+     * parse this field for control flow** — it changes per
+     * locale.
+     *
+     * @type {string}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    message?: string;
+    /**
+     * Stable canonical lookup key for the message (e.g.
+     * `error.balance_exhausted.add_credits`,
+     * `error.upload_size_exceeds_tier`). Never localised. SDK +
+     * frontend translation layers gate on this for client-side
+     * i18n catalogs (per ticket X19, cross-repo SDK companion
+     * work). Stable across server message-prose updates.
+     *
+     * @type {string}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    messageKey?: string;
+    /**
+     * BCP 47 locale tag echoing the resolved `Content-Language`
+     * response header value (e.g. `en-GB`, `pt-BR`, `ja-JP`).
+     * Lets the SDK confirm which locale the server selected
+     * when the request used q-value negotiation across multiple
+     * `Accept-Language` values.
+     *
+     * @type {string}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    locale?: string;
+    /**
+     * Optional interpolation values for the localised
+     * `message`. Keys are stable parameter names referenced by
+     * the translation table (e.g.
+     * `{ "filename": "photo.heic", "max_size_mb": 100 }`).
+     * **Excludes cost / monetary numbers** per plan v5 §F11
+     * round-13 narrowing — pricing-related localisation reads
+     * numeric state from `GET /api/v2/credits/balance`, not
+     * from this field. Values are JSON-native scalars
+     * (`string` / `integer` / `number` / `boolean` / `null`)
+     * — no nested objects, to keep translation-table
+     * integration simple.
+     *
+     * @type {{ [key: string]: any; }}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    messageParams?: {
+        [key: string]: any;
+    };
+    /**
+     *
+     * @type {UploadSizeExceedsTierResponseErrorTypeEnum}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    errorType: UploadSizeExceedsTierResponseErrorTypeEnum;
+    /**
+     *
+     * @type {UserTier}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    currentTier: UserTier;
+    /**
+     * Max size permitted at the caller's current tier + MIME.
+     * @type {number}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    maxSizeBytes: number;
+    /**
+     *
+     * @type {UserTier}
+     * @memberof UploadSizeExceedsTierResponse
+     */
+    requiredTier?: UserTier | null;
+}
+/**
+ * @export
+ */
+export declare const UploadSizeExceedsTierResponseSuccessEnum: {
+    readonly false: false;
+};
+export type UploadSizeExceedsTierResponseSuccessEnum = typeof UploadSizeExceedsTierResponseSuccessEnum[keyof typeof UploadSizeExceedsTierResponseSuccessEnum];
+/**
+ * @export
+ */
+export declare const UploadSizeExceedsTierResponseErrorTypeEnum: {
+    readonly upload_size_exceeds_tier: "upload_size_exceeds_tier";
+};
+export type UploadSizeExceedsTierResponseErrorTypeEnum = typeof UploadSizeExceedsTierResponseErrorTypeEnum[keyof typeof UploadSizeExceedsTierResponseErrorTypeEnum];
+/**
+ * Check if a given object implements the UploadSizeExceedsTierResponse interface.
+ */
+export declare function instanceOfUploadSizeExceedsTierResponse(value: object): value is UploadSizeExceedsTierResponse;
+export declare function UploadSizeExceedsTierResponseFromJSON(json: any): UploadSizeExceedsTierResponse;
+export declare function UploadSizeExceedsTierResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadSizeExceedsTierResponse;
+export declare function UploadSizeExceedsTierResponseToJSON(json: any): UploadSizeExceedsTierResponse;
+export declare function UploadSizeExceedsTierResponseToJSONTyped(value?: UploadSizeExceedsTierResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/UploadSizeExceedsTierResponse.js

@@ -0,0 +1,82 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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/Last-Modified 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.  - **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. - **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). - **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.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import { UserTierFromJSON, UserTierToJSON, } from './UserTier.js';
+/**
+ * @export
+ */
+export const UploadSizeExceedsTierResponseSuccessEnum = {
+    false: false
+};
+/**
+ * @export
+ */
+export const UploadSizeExceedsTierResponseErrorTypeEnum = {
+    upload_size_exceeds_tier: 'upload_size_exceeds_tier'
+};
+/**
+ * Check if a given object implements the UploadSizeExceedsTierResponse interface.
+ */
+export function instanceOfUploadSizeExceedsTierResponse(value) {
+    if (!('success' in value) || value['success'] === undefined)
+        return false;
+    if (!('error' in value) || value['error'] === undefined)
+        return false;
+    if (!('errorType' in value) || value['errorType'] === undefined)
+        return false;
+    if (!('currentTier' in value) || value['currentTier'] === undefined)
+        return false;
+    if (!('maxSizeBytes' in value) || value['maxSizeBytes'] === undefined)
+        return false;
+    return true;
+}
+export function UploadSizeExceedsTierResponseFromJSON(json) {
+    return UploadSizeExceedsTierResponseFromJSONTyped(json, false);
+}
+export function UploadSizeExceedsTierResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'success': json['success'],
+        'error': json['error'],
+        'message': json['message'] == null ? undefined : json['message'],
+        'messageKey': json['message_key'] == null ? undefined : json['message_key'],
+        'locale': json['locale'] == null ? undefined : json['locale'],
+        'messageParams': json['message_params'] == null ? undefined : json['message_params'],
+        'errorType': json['error_type'],
+        'currentTier': UserTierFromJSON(json['current_tier']),
+        'maxSizeBytes': json['max_size_bytes'],
+        'requiredTier': json['required_tier'] == null ? undefined : UserTierFromJSON(json['required_tier']),
+    };
+}
+export function UploadSizeExceedsTierResponseToJSON(json) {
+    return UploadSizeExceedsTierResponseToJSONTyped(json, false);
+}
+export function UploadSizeExceedsTierResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'success': value['success'],
+        'error': value['error'],
+        'message': value['message'],
+        'message_key': value['messageKey'],
+        'locale': value['locale'],
+        'message_params': value['messageParams'],
+        'error_type': value['errorType'],
+        'current_tier': UserTierToJSON(value['currentTier']),
+        'max_size_bytes': value['maxSizeBytes'],
+        'required_tier': UserTierToJSON(value['requiredTier']),
+    };
+}

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

@@ -0,0 +1,48 @@
+/**
+ * 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/Last-Modified 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.  - **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. - **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). - **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.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * References an upload created via `POST /api/uploads` (single)
+ * or completed via `POST /api/uploads/multipart/complete`
+ * (multipart). Both flows yield the same `file_id` shape.
+ *
+ * @export
+ * @interface UploadSource
+ */
+export interface UploadSource {
+    /**
+     *
+     * @type {UploadSourceTypeEnum}
+     * @memberof UploadSource
+     */
+    type: UploadSourceTypeEnum;
+    /**
+     * UUID v7 format identifier (time-ordered)
+     * @type {string}
+     * @memberof UploadSource
+     */
+    fileId: string;
+}
+/**
+ * @export
+ */
+export declare const UploadSourceTypeEnum: {
+    readonly upload: "upload";
+};
+export type UploadSourceTypeEnum = typeof UploadSourceTypeEnum[keyof typeof UploadSourceTypeEnum];
+/**
+ * Check if a given object implements the UploadSource interface.
+ */
+export declare function instanceOfUploadSource(value: object): value is UploadSource;
+export declare function UploadSourceFromJSON(json: any): UploadSource;
+export declare function UploadSourceFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadSource;
+export declare function UploadSourceToJSON(json: any): UploadSource;
+export declare function UploadSourceToJSONTyped(value?: UploadSource | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/UploadSource.js

@@ -0,0 +1,53 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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/Last-Modified 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.  - **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. - **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). - **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.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * @export
+ */
+export const UploadSourceTypeEnum = {
+    upload: 'upload'
+};
+/**
+ * Check if a given object implements the UploadSource interface.
+ */
+export function instanceOfUploadSource(value) {
+    if (!('type' in value) || value['type'] === undefined)
+        return false;
+    if (!('fileId' in value) || value['fileId'] === undefined)
+        return false;
+    return true;
+}
+export function UploadSourceFromJSON(json) {
+    return UploadSourceFromJSONTyped(json, false);
+}
+export function UploadSourceFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'type': json['type'],
+        'fileId': json['file_id'],
+    };
+}
+export function UploadSourceToJSON(json) {
+    return UploadSourceToJSONTyped(json, false);
+}
+export function UploadSourceToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'type': value['type'],
+        'file_id': value['fileId'],
+    };
+}

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

@@ -1,8 +1,8 @@
 /**
  * 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, watermark, merge, archive, convert) - 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 (CDN-cacheable), health probes return flat objects, and `POST /api/contact` returns 204 with no body.
+ * 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/Last-Modified 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.  - **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. - **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). - **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.0.0
+ * The version of the OpenAPI document: 2.12.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -18,7 +18,7 @@ import type { UploadResponse } from './UploadResponse.js';
 export interface UploadSuccessEnvelope {
     /**
      *
-     * @type {boolean}
+     * @type {UploadSuccessEnvelopeSuccessEnum}
      * @memberof UploadSuccessEnvelope
      */
     success: UploadSuccessEnvelopeSuccessEnum;

package/dist/openapi/models/UploadSuccessEnvelope.js

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * 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, watermark, merge, archive, convert) - 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 (CDN-cacheable), health probes return flat objects, and `POST /api/contact` returns 204 with no body.
+ * 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/Last-Modified 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.  - **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. - **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). - **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.0.0
+ * The version of the OpenAPI document: 2.12.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

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

@@ -0,0 +1,126 @@
+/**
+ * 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/Last-Modified 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.  - **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. - **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). - **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.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Canonical upload threshold constants. Per ticket
+ * [u0ar7Yye](https://trello.com/c/u0ar7Yye). All values are
+ * `const:`-pinned so SDK generators emit them as typed binding
+ * constants — frontend / API / SDKs reference these instead
+ * of hardcoding magic numbers.
+ *
+ * These are CONTRACT VALUES, not runtime-discoverable settings.
+ * A future runtime `GET /api/uploads/limits` endpoint may
+ * overlay per-tier or per-environment overrides on top of
+ * these baselines (deferred follow-up).
+ *
+ * @export
+ * @interface UploadThresholds
+ */
+export interface UploadThresholds {
+    /**
+     * Maximum file size in bytes for the single-shot upload
+     * path (`POST /api/uploads`). Files above this size MUST
+     * use the multipart flow
+     * (`POST /api/uploads/multipart/initiate` → chunk PUTs →
+     * `POST /api/uploads/multipart/complete`). 10 MB /
+     * 10,000,000 bytes — chosen to match the ALB-fronted
+     * single-request body cap. Raising this requires
+     * infrastructure work (ALB swap or rearchitect; out of
+     * scope for this ticket).
+     *
+     * @type {UploadThresholdsSingleShotMaxBytesEnum}
+     * @memberof UploadThresholds
+     */
+    singleShotMaxBytes: UploadThresholdsSingleShotMaxBytesEnum;
+    /**
+     * Recommended chunk size in bytes for multipart upload
+     * chunks (16 MiB / 16,777,216 bytes — 1024-based). Raised
+     * from 5 MiB by CON-1 (ADR-0011): S3 caps a multipart
+     * upload at 10,000 parts, and the Enterprise envelope is a
+     * 120 GB hard ceiling. At 16 MiB a 120 GiB object needs
+     * 7,680 parts (≤ 10,000, inside AWS's 16–64 MB recommended
+     * band); 5 MiB would need 24,576 and 10 MiB 12,288 — both
+     * exceed the S3 limit. **Wire-incompatible change** — SDKs
+     * pin this as a compile-time constant, so CON-1 and SDK-2
+     * ship as a non-independently-mergeable pair. The server's
+     * `MultipartInitiateResponse` returns a
+     * `recommended_chunk_size` per file based on first-chunk
+     * throughput; SDKs SHOULD prefer that runtime value when
+     * present and fall back to this constant otherwise.
+     *
+     * @type {UploadThresholdsMultipartChunkSizeEnum}
+     * @memberof UploadThresholds
+     */
+    multipartChunkSize: UploadThresholdsMultipartChunkSizeEnum;
+    /**
+     * Recommended parallel-upload count for multipart chunks
+     * (4 simultaneous PUT requests). Matches the existing TS
+     * SDK default. Tuning above 4 risks throttling at the S3 +
+     * client-bandwidth layers; below 4 hurts overall
+     * throughput on typical broadband.
+     *
+     * @type {UploadThresholdsMultipartConcurrencyDefaultEnum}
+     * @memberof UploadThresholds
+     */
+    multipartConcurrencyDefault: UploadThresholdsMultipartConcurrencyDefaultEnum;
+    /**
+     * Fixed size in bytes for the FIRST chunk PUT in a multipart
+     * upload (8 MiB / 8,388,608 bytes — 1024-based). The server
+     * uses this chunk for MIME-type detection and throughput
+     * measurement; the 8 MiB window is assumed by the server's
+     * container-metadata probe (see
+     * `MultipartInitiateRequest.metadata_hint`). SDKs MUST send
+     * exactly this size for chunk index 0; for chunks 1+ they
+     * SHOULD prefer the runtime
+     * `MultipartInitiateResponse.recommended_chunk_size` and
+     * fall back to `multipart_chunk_size` when absent.
+     *
+     * @type {UploadThresholdsMultipartFirstChunkSizeEnum}
+     * @memberof UploadThresholds
+     */
+    multipartFirstChunkSize: UploadThresholdsMultipartFirstChunkSizeEnum;
+}
+/**
+ * @export
+ */
+export declare const UploadThresholdsSingleShotMaxBytesEnum: {
+    readonly NUMBER_10000000: 10000000;
+};
+export type UploadThresholdsSingleShotMaxBytesEnum = typeof UploadThresholdsSingleShotMaxBytesEnum[keyof typeof UploadThresholdsSingleShotMaxBytesEnum];
+/**
+ * @export
+ */
+export declare const UploadThresholdsMultipartChunkSizeEnum: {
+    readonly NUMBER_16777216: 16777216;
+};
+export type UploadThresholdsMultipartChunkSizeEnum = typeof UploadThresholdsMultipartChunkSizeEnum[keyof typeof UploadThresholdsMultipartChunkSizeEnum];
+/**
+ * @export
+ */
+export declare const UploadThresholdsMultipartConcurrencyDefaultEnum: {
+    readonly NUMBER_4: 4;
+};
+export type UploadThresholdsMultipartConcurrencyDefaultEnum = typeof UploadThresholdsMultipartConcurrencyDefaultEnum[keyof typeof UploadThresholdsMultipartConcurrencyDefaultEnum];
+/**
+ * @export
+ */
+export declare const UploadThresholdsMultipartFirstChunkSizeEnum: {
+    readonly NUMBER_8388608: 8388608;
+};
+export type UploadThresholdsMultipartFirstChunkSizeEnum = typeof UploadThresholdsMultipartFirstChunkSizeEnum[keyof typeof UploadThresholdsMultipartFirstChunkSizeEnum];
+/**
+ * Check if a given object implements the UploadThresholds interface.
+ */
+export declare function instanceOfUploadThresholds(value: object): value is UploadThresholds;
+export declare function UploadThresholdsFromJSON(json: any): UploadThresholds;
+export declare function UploadThresholdsFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadThresholds;
+export declare function UploadThresholdsToJSON(json: any): UploadThresholds;
+export declare function UploadThresholdsToJSONTyped(value?: UploadThresholds | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/UploadThresholds.js

@@ -0,0 +1,79 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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/Last-Modified 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.  - **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. - **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). - **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.12.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * @export
+ */
+export const UploadThresholdsSingleShotMaxBytesEnum = {
+    NUMBER_10000000: 10000000
+};
+/**
+ * @export
+ */
+export const UploadThresholdsMultipartChunkSizeEnum = {
+    NUMBER_16777216: 16777216
+};
+/**
+ * @export
+ */
+export const UploadThresholdsMultipartConcurrencyDefaultEnum = {
+    NUMBER_4: 4
+};
+/**
+ * @export
+ */
+export const UploadThresholdsMultipartFirstChunkSizeEnum = {
+    NUMBER_8388608: 8388608
+};
+/**
+ * Check if a given object implements the UploadThresholds interface.
+ */
+export function instanceOfUploadThresholds(value) {
+    if (!('singleShotMaxBytes' in value) || value['singleShotMaxBytes'] === undefined)
+        return false;
+    if (!('multipartChunkSize' in value) || value['multipartChunkSize'] === undefined)
+        return false;
+    if (!('multipartConcurrencyDefault' in value) || value['multipartConcurrencyDefault'] === undefined)
+        return false;
+    if (!('multipartFirstChunkSize' in value) || value['multipartFirstChunkSize'] === undefined)
+        return false;
+    return true;
+}
+export function UploadThresholdsFromJSON(json) {
+    return UploadThresholdsFromJSONTyped(json, false);
+}
+export function UploadThresholdsFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'singleShotMaxBytes': json['single_shot_max_bytes'],
+        'multipartChunkSize': json['multipart_chunk_size'],
+        'multipartConcurrencyDefault': json['multipart_concurrency_default'],
+        'multipartFirstChunkSize': json['multipart_first_chunk_size'],
+    };
+}
+export function UploadThresholdsToJSON(json) {
+    return UploadThresholdsToJSONTyped(json, false);
+}
+export function UploadThresholdsToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'single_shot_max_bytes': value['singleShotMaxBytes'],
+        'multipart_chunk_size': value['multipartChunkSize'],
+        'multipart_concurrency_default': value['multipartConcurrencyDefault'],
+        'multipart_first_chunk_size': value['multipartFirstChunkSize'],
+    };
+}