@giveitsmaller/contracts 0.2.3 → 0.4.0

package/dist/openapi/models/UploadDurationExceedsTierResponse.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 UploadDurationExceedsTierResponse
+ */
+export interface UploadDurationExceedsTierResponse {
+    /**
+     *
+     * @type {UploadDurationExceedsTierResponseSuccessEnum}
+     * @memberof UploadDurationExceedsTierResponse
+     */
+    success: UploadDurationExceedsTierResponseSuccessEnum;
+    /**
+     * 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 UploadDurationExceedsTierResponse
+     */
+    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 UploadDurationExceedsTierResponse
+     */
+    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 UploadDurationExceedsTierResponse
+     */
+    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 UploadDurationExceedsTierResponse
+     */
+    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 UploadDurationExceedsTierResponse
+     */
+    messageParams?: {
+        [key: string]: any;
+    };
+    /**
+     *
+     * @type {UploadDurationExceedsTierResponseErrorTypeEnum}
+     * @memberof UploadDurationExceedsTierResponse
+     */
+    errorType: UploadDurationExceedsTierResponseErrorTypeEnum;
+    /**
+     *
+     * @type {UserTier}
+     * @memberof UploadDurationExceedsTierResponse
+     */
+    currentTier: UserTier;
+    /**
+     * Max duration permitted at the caller's current tier + MIME.
+     * @type {number}
+     * @memberof UploadDurationExceedsTierResponse
+     */
+    maxDurationSeconds: number;
+    /**
+     *
+     * @type {UserTier}
+     * @memberof UploadDurationExceedsTierResponse
+     */
+    requiredTier?: UserTier | null;
+}
+/**
+ * @export
+ */
+export declare const UploadDurationExceedsTierResponseSuccessEnum: {
+    readonly false: false;
+};
+export type UploadDurationExceedsTierResponseSuccessEnum = typeof UploadDurationExceedsTierResponseSuccessEnum[keyof typeof UploadDurationExceedsTierResponseSuccessEnum];
+/**
+ * @export
+ */
+export declare const UploadDurationExceedsTierResponseErrorTypeEnum: {
+    readonly upload_duration_exceeds_tier: "upload_duration_exceeds_tier";
+};
+export type UploadDurationExceedsTierResponseErrorTypeEnum = typeof UploadDurationExceedsTierResponseErrorTypeEnum[keyof typeof UploadDurationExceedsTierResponseErrorTypeEnum];
+/**
+ * Check if a given object implements the UploadDurationExceedsTierResponse interface.
+ */
+export declare function instanceOfUploadDurationExceedsTierResponse(value: object): value is UploadDurationExceedsTierResponse;
+export declare function UploadDurationExceedsTierResponseFromJSON(json: any): UploadDurationExceedsTierResponse;
+export declare function UploadDurationExceedsTierResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadDurationExceedsTierResponse;
+export declare function UploadDurationExceedsTierResponseToJSON(json: any): UploadDurationExceedsTierResponse;
+export declare function UploadDurationExceedsTierResponseToJSONTyped(value?: UploadDurationExceedsTierResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/UploadDurationExceedsTierResponse.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 UploadDurationExceedsTierResponseSuccessEnum = {
+    false: false
+};
+/**
+ * @export
+ */
+export const UploadDurationExceedsTierResponseErrorTypeEnum = {
+    upload_duration_exceeds_tier: 'upload_duration_exceeds_tier'
+};
+/**
+ * Check if a given object implements the UploadDurationExceedsTierResponse interface.
+ */
+export function instanceOfUploadDurationExceedsTierResponse(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 (!('maxDurationSeconds' in value) || value['maxDurationSeconds'] === undefined)
+        return false;
+    return true;
+}
+export function UploadDurationExceedsTierResponseFromJSON(json) {
+    return UploadDurationExceedsTierResponseFromJSONTyped(json, false);
+}
+export function UploadDurationExceedsTierResponseFromJSONTyped(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']),
+        'maxDurationSeconds': json['max_duration_seconds'],
+        'requiredTier': json['required_tier'] == null ? undefined : UserTierFromJSON(json['required_tier']),
+    };
+}
+export function UploadDurationExceedsTierResponseToJSON(json) {
+    return UploadDurationExceedsTierResponseToJSONTyped(json, false);
+}
+export function UploadDurationExceedsTierResponseToJSONTyped(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_duration_seconds': value['maxDurationSeconds'],
+        'required_tier': UserTierToJSON(value['requiredTier']),
+    };
+}

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

@@ -0,0 +1,27 @@
+/**
+ * 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 { FeatureTierRestrictedResponse } from './FeatureTierRestrictedResponse.js';
+import type { TierRestrictionResponse } from './TierRestrictionResponse.js';
+/**
+ * @type UploadFile403Response
+ *
+ * @export
+ */
+export type UploadFile403Response = {
+    errorType: 'feature_tier_restricted';
+} & FeatureTierRestrictedResponse | {
+    errorType: 'tier_restriction';
+} & TierRestrictionResponse;
+export declare function UploadFile403ResponseFromJSON(json: any): UploadFile403Response;
+export declare function UploadFile403ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadFile403Response;
+export declare function UploadFile403ResponseToJSON(json: any): any;
+export declare function UploadFile403ResponseToJSONTyped(value?: UploadFile403Response | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/UploadFile403Response.js

@@ -0,0 +1,47 @@
+/* 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 { FeatureTierRestrictedResponseFromJSONTyped, FeatureTierRestrictedResponseToJSON, } from './FeatureTierRestrictedResponse.js';
+import { TierRestrictionResponseFromJSONTyped, TierRestrictionResponseToJSON, } from './TierRestrictionResponse.js';
+export function UploadFile403ResponseFromJSON(json) {
+    return UploadFile403ResponseFromJSONTyped(json, false);
+}
+export function UploadFile403ResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    switch (json['error_type']) {
+        case 'feature_tier_restricted':
+            return Object.assign({}, FeatureTierRestrictedResponseFromJSONTyped(json, true), { errorType: 'feature_tier_restricted' });
+        case 'tier_restriction':
+            return Object.assign({}, TierRestrictionResponseFromJSONTyped(json, true), { errorType: 'tier_restriction' });
+        default:
+            return json;
+    }
+}
+export function UploadFile403ResponseToJSON(json) {
+    return UploadFile403ResponseToJSONTyped(json, false);
+}
+export function UploadFile403ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    switch (value['errorType']) {
+        case 'feature_tier_restricted':
+            return Object.assign({}, FeatureTierRestrictedResponseToJSON(value), { errorType: 'feature_tier_restricted' });
+        case 'tier_restriction':
+            return Object.assign({}, TierRestrictionResponseToJSON(value), { errorType: 'tier_restriction' });
+        default:
+            return value;
+    }
+}

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

@@ -0,0 +1,27 @@
+/**
+ * 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 { UploadDurationExceedsTierResponse } from './UploadDurationExceedsTierResponse.js';
+import type { UploadSizeExceedsTierResponse } from './UploadSizeExceedsTierResponse.js';
+/**
+ * @type UploadFile422Response
+ *
+ * @export
+ */
+export type UploadFile422Response = {
+    errorType: 'upload_duration_exceeds_tier';
+} & UploadDurationExceedsTierResponse | {
+    errorType: 'upload_size_exceeds_tier';
+} & UploadSizeExceedsTierResponse;
+export declare function UploadFile422ResponseFromJSON(json: any): UploadFile422Response;
+export declare function UploadFile422ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadFile422Response;
+export declare function UploadFile422ResponseToJSON(json: any): any;
+export declare function UploadFile422ResponseToJSONTyped(value?: UploadFile422Response | null, ignoreDiscriminator?: boolean): any;

package/dist/openapi/models/UploadFile422Response.js

@@ -0,0 +1,47 @@
+/* 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 { UploadDurationExceedsTierResponseFromJSONTyped, UploadDurationExceedsTierResponseToJSON, } from './UploadDurationExceedsTierResponse.js';
+import { UploadSizeExceedsTierResponseFromJSONTyped, UploadSizeExceedsTierResponseToJSON, } from './UploadSizeExceedsTierResponse.js';
+export function UploadFile422ResponseFromJSON(json) {
+    return UploadFile422ResponseFromJSONTyped(json, false);
+}
+export function UploadFile422ResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    switch (json['error_type']) {
+        case 'upload_duration_exceeds_tier':
+            return Object.assign({}, UploadDurationExceedsTierResponseFromJSONTyped(json, true), { errorType: 'upload_duration_exceeds_tier' });
+        case 'upload_size_exceeds_tier':
+            return Object.assign({}, UploadSizeExceedsTierResponseFromJSONTyped(json, true), { errorType: 'upload_size_exceeds_tier' });
+        default:
+            return json;
+    }
+}
+export function UploadFile422ResponseToJSON(json) {
+    return UploadFile422ResponseToJSONTyped(json, false);
+}
+export function UploadFile422ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    switch (value['errorType']) {
+        case 'upload_duration_exceeds_tier':
+            return Object.assign({}, UploadDurationExceedsTierResponseToJSON(value), { errorType: 'upload_duration_exceeds_tier' });
+        case 'upload_size_exceeds_tier':
+            return Object.assign({}, UploadSizeExceedsTierResponseToJSON(value), { errorType: 'upload_size_exceeds_tier' });
+        default:
+            return value;
+    }
+}

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

@@ -0,0 +1,172 @@
+/**
+ * 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.
+ */
+/**
+ * Probe-extracted media metadata. Fields populated according to
+ * the file's MIME type and what the prober could read; absent
+ * fields are NOT errors — they reflect "this metadata is not
+ * applicable / not extractable" rather than "this metadata
+ * failed validation". `probed_at` is always present.
+ *
+ * Schema covers the **union** of fields needed by the API's
+ * `MetadataResponse` projection across video / audio /
+ * document inputs (per the M2 Epic re-scope —
+ * [`SrHwuvIl`](https://trello.com/c/SrHwuvIl) — which makes
+ * this probe Lambda the universal non-image metadata source
+ * feeding `rich_metadata`). The Lambda extractor only
+ * populates fields it can derive from the actual container;
+ * unrelated fields are simply omitted.
+ *
+ * @export
+ * @interface UploadProbeMediaMetadata
+ */
+export interface UploadProbeMediaMetadata {
+    /**
+     * Container-reported duration (audio + video).
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    durationSeconds?: number;
+    /**
+     * Pixel width (image + video; best-effort document).
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    width?: number;
+    /**
+     * Pixel height (image + video; best-effort document).
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    height?: number;
+    /**
+     * Primary codec identifier as reported by the prober. For
+     * video inputs this is the **video** codec; for audio-only
+     * inputs this is the audio codec. For video files with
+     * audio tracks, the audio codec is reported separately as
+     * `audio_codec`. Examples: `h264`, `h265`, `vp9`, `av1`,
+     * `aac`, `opus`, `mp3`. Not constrained to an enum — codec
+     * strings evolve with FFmpeg releases (per ADR-0007 FFmpeg
+     * pin) and SDKs should string-match.
+     *
+     * @type {string}
+     * @memberof UploadProbeMediaMetadata
+     */
+    codec?: string;
+    /**
+     * Audio codec for video files that carry an audio track.
+     * Distinct from `codec` (which is the video codec for
+     * video inputs). Absent for video-only / silent video
+     * inputs and for audio-only inputs (audio-only inputs put
+     * their codec under `codec`).
+     *
+     * @type {string}
+     * @memberof UploadProbeMediaMetadata
+     */
+    audioCodec?: string;
+    /**
+     * Container format. Examples: `mp4`, `webm`, `mov`,
+     * `mkv`, `mp3`, `wav`, `flac`. Not constrained to an
+     * enum.
+     *
+     * @type {string}
+     * @memberof UploadProbeMediaMetadata
+     */
+    container?: string;
+    /**
+     * Container-reported frame rate (video only). Number, not
+     * integer — frame rates are commonly fractional (e.g.
+     * `29.97`, `23.976`).
+     *
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    fps?: number;
+    /**
+     * Overall stream bitrate, **bits per second**. Units in
+     * the field name, mirroring `duration_seconds`, so SDKs
+     * avoid the kbps-vs-bps guessing trap. Container-reported
+     * for video + audio.
+     *
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    bitrateBps?: number;
+    /**
+     * Channel layout, human-display form. Examples: `mono`,
+     * `stereo`, `5.1`, `7.1`. Not constrained. Pairs with the
+     * numeric `channels` field (which is what API consumers
+     * project into `rich_metadata`); `audio_layout` is
+     * preserved on the probe row for UI display ("5.1
+     * surround") without forcing the UI to derive a label
+     * from the integer.
+     *
+     * @type {string}
+     * @memberof UploadProbeMediaMetadata
+     */
+    audioLayout?: string;
+    /**
+     * Numeric audio channel count derived by the Lambda from
+     * ffprobe output. Examples: `1` (mono), `2` (stereo), `6`
+     * (5.1), `8` (7.1). Pairs with `audio_layout`. Audio +
+     * video.
+     *
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    channels?: number;
+    /**
+     * Audio sample rate, **Hertz**. Units in the field name,
+     * mirroring `duration_seconds` / `bitrate_bps`. Examples:
+     * `44100`, `48000`. Audio + video-with-audio.
+     *
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    sampleRateHz?: number;
+    /**
+     * Document page count (PDF / EPUB / DOCX / XLSX / PPTX /
+     * ODT / ODS / ODP). `0` for a document the prober opened
+     * but found empty.
+     *
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    pageCount?: number;
+    /**
+     * Document resolution, single-axis (dots per inch).
+     * Single-axis matches the existing `MetadataResponse`
+     * contract on the OpenAPI side; the prober reports the
+     * page-1 horizontal DPI when the document declares it,
+     * otherwise omits the field.
+     *
+     * @type {number}
+     * @memberof UploadProbeMediaMetadata
+     */
+    dpi?: number;
+    /**
+     * ISO-8601 timestamp at which the probe ran. Idempotent
+     * for the same `file_id` — subsequent probe calls return
+     * the cached `probed_at`.
+     *
+     * @type {Date}
+     * @memberof UploadProbeMediaMetadata
+     */
+    probedAt: Date;
+}
+/**
+ * Check if a given object implements the UploadProbeMediaMetadata interface.
+ */
+export declare function instanceOfUploadProbeMediaMetadata(value: object): value is UploadProbeMediaMetadata;
+export declare function UploadProbeMediaMetadataFromJSON(json: any): UploadProbeMediaMetadata;
+export declare function UploadProbeMediaMetadataFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadProbeMediaMetadata;
+export declare function UploadProbeMediaMetadataToJSON(json: any): UploadProbeMediaMetadata;
+export declare function UploadProbeMediaMetadataToJSONTyped(value?: UploadProbeMediaMetadata | null, ignoreDiscriminator?: boolean): any;