@giveitsmaller/contracts 0.2.0 → 0.3.0

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

@@ -0,0 +1,29 @@
+/**
+ * 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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Severity of a workflow advisory warning. V2.0 ships with a
+ * single value `advisory` — non-blocking; the workflow
+ * proceeds regardless. Future severities reserved for cases
+ * where a warning escalates to blocking-but-overrideable (no
+ * such cases in V2.0).
+ *
+ * @export
+ */
+export declare const WorkflowWarningSeverity: {
+    readonly advisory: "advisory";
+};
+export type WorkflowWarningSeverity = typeof WorkflowWarningSeverity[keyof typeof WorkflowWarningSeverity];
+export declare function instanceOfWorkflowWarningSeverity(value: any): boolean;
+export declare function WorkflowWarningSeverityFromJSON(json: any): WorkflowWarningSeverity;
+export declare function WorkflowWarningSeverityFromJSONTyped(json: any, ignoreDiscriminator: boolean): WorkflowWarningSeverity;
+export declare function WorkflowWarningSeverityToJSON(value?: WorkflowWarningSeverity | null): any;
+export declare function WorkflowWarningSeverityToJSONTyped(value: any, ignoreDiscriminator: boolean): WorkflowWarningSeverity;

package/dist/openapi/models/WorkflowWarningSeverity.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.7.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Severity of a workflow advisory warning. V2.0 ships with a
+ * single value `advisory` — non-blocking; the workflow
+ * proceeds regardless. Future severities reserved for cases
+ * where a warning escalates to blocking-but-overrideable (no
+ * such cases in V2.0).
+ *
+ * @export
+ */
+export const WorkflowWarningSeverity = {
+    advisory: 'advisory'
+};
+export function instanceOfWorkflowWarningSeverity(value) {
+    for (const key in WorkflowWarningSeverity) {
+        if (Object.prototype.hasOwnProperty.call(WorkflowWarningSeverity, key)) {
+            if (WorkflowWarningSeverity[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function WorkflowWarningSeverityFromJSON(json) {
+    return WorkflowWarningSeverityFromJSONTyped(json, false);
+}
+export function WorkflowWarningSeverityFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function WorkflowWarningSeverityToJSON(value) {
+    return value;
+}
+export function WorkflowWarningSeverityToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

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

@@ -1,17 +1,54 @@
+export * from './AudioWatermarkDecodeRequest.js';
+export * from './AudioWatermarkDecodeResponse.js';
+export * from './AuthErrorResponse.js';
+export * from './AuthErrorType.js';
+export * from './AvailabilityValue.js';
+export * from './BalanceExhaustedResponse.js';
+export * from './BalanceExhaustedResponseAllOfLinks.js';
 export * from './CallbackEventType.js';
+export * from './ConnectionSource.js';
 export * from './ContactRequest.js';
 export * from './ContactSubject.js';
 export * from './ContactValidationErrorResponse.js';
+export * from './CreateExternalImport403Response.js';
+export * from './CreateWorkflow422Response.js';
+export * from './CreditTransaction.js';
+export * from './CreditTransactionSourceBucket.js';
+export * from './CreditsBalanceResponse.js';
+export * from './CreditsBalanceSuccessEnvelope.js';
+export * from './CreditsUsageResponse.js';
+export * from './CreditsUsageSuccessEnvelope.js';
+export * from './Delivery.js';
+export * from './DeliveryOutputRef.js';
+export * from './DeliveryPlan.js';
+export * from './DeliveryPlanOutput.js';
+export * from './DeliveryPlanReason.js';
+export * from './DeliverySelection.js';
 export * from './ErrorEnvelope.js';
-export * from './ExportConfig.js';
+export * from './EstimateQuality.js';
+export * from './EstimateRange.js';
+export * from './ExternalDestination.js';
+export * from './ExternalImportCreatedResponse.js';
+export * from './ExternalImportCreatedSuccessEnvelope.js';
+export * from './ExternalImportRequest.js';
+export * from './ExternalImportToken.js';
+export * from './ExternalSource.js';
+export * from './FeatureNotAvailableResponse.js';
+export * from './FeatureTierRestrictedResponse.js';
+export * from './FeatureViolation.js';
 export * from './JobDefinition.js';
 export * from './JobDownload.js';
-export * from './JobInput.js';
+export * from './JobInputV2.js';
+export * from './JobOutputSource.js';
 export * from './JobResponse.js';
-export * from './JobSource.js';
 export * from './JobStatus.js';
 export * from './JobType.js';
 export * from './LivenessResponse.js';
+export * from './LoginUser200Response.js';
+export * from './LoginUser200ResponseData.js';
+export * from './LoginUser200ResponseDataUser.js';
+export * from './LoginUserRequest.js';
+export * from './LogoutUser200Response.js';
 export * from './MetadataResponse.js';
 export * from './MetadataResponseDimensions.js';
 export * from './MetadataResponseExif.js';
@@ -20,6 +57,9 @@ export * from './MetadataSuccessEnvelope.js';
 export * from './MimeGroupSchema.js';
 export * from './MultipartCompleteRequest.js';
 export * from './MultipartCompleteRequestPartsInner.js';
+export * from './MultipartCompleteResponse.js';
+export * from './MultipartCompleteSuccessEnvelope.js';
+export * from './MultipartInitiateRequestMetadataHint.js';
 export * from './MultipartInitiateResponse.js';
 export * from './MultipartInitiateSuccessEnvelope.js';
 export * from './OperationDefinition.js';
@@ -33,7 +73,13 @@ export * from './OperationStatus.js';
 export * from './OperationType.js';
 export * from './OperationsSchemaResponse.js';
 export * from './OptionSchema.js';
+export * from './PerValueAvailabilityEntry.js';
 export * from './PresignedUrlPart.js';
+export * from './ProcessingClass.js';
+export * from './ProcessingClassHint.js';
+export * from './ProcessingClassReason.js';
+export * from './ProcessingPlan.js';
+export * from './ProcessingPlanJob.js';
 export * from './ReadinessResponse.js';
 export * from './ResponseEnvelope.js';
 export * from './RetryResponse.js';
@@ -45,18 +91,46 @@ export * from './SseOperationCompletedData.js';
 export * from './SseOperationFailedData.js';
 export * from './SseOperationProgressData.js';
 export * from './SseWorkflowTerminalData.js';
+export * from './TierRestrictionKind.js';
+export * from './TierRestrictionResponse.js';
+export * from './UploadConstraintsApplied.js';
+export * from './UploadDurationExceedsTierResponse.js';
+export * from './UploadFile403Response.js';
+export * from './UploadFile422Response.js';
+export * from './UploadProbeMediaMetadata.js';
+export * from './UploadProbeProcessingClass.js';
+export * from './UploadProbeResponse.js';
+export * from './UploadProbeStatus.js';
 export * from './UploadResponse.js';
+export * from './UploadSizeExceedsTierResponse.js';
+export * from './UploadSource.js';
 export * from './UploadSuccessEnvelope.js';
+export * from './UploadThresholds.js';
+export * from './UserTier.js';
 export * from './ValidationErrorEnvelope.js';
 export * from './ValidationErrorEnvelopeDetailsInner.js';
+export * from './WarningType.js';
 export * from './WebhookOperationContext.js';
 export * from './WebhookPayload.js';
+export * from './WorkflowCancelBillingEffect.js';
+export * from './WorkflowCancelResponse.js';
+export * from './WorkflowCancelSuccessEnvelope.js';
 export * from './WorkflowCreateRequest.js';
 export * from './WorkflowCreateResponse.js';
 export * from './WorkflowCreateSuccessEnvelope.js';
 export * from './WorkflowDownloadResponse.js';
 export * from './WorkflowDownloadSuccessEnvelope.js';
 export * from './WorkflowEdge.js';
+export * from './WorkflowExpiredResponse.js';
+export * from './WorkflowPauseRequiredAction.js';
+export * from './WorkflowPausedDetail.js';
+export * from './WorkflowPausedDetailLinks.js';
+export * from './WorkflowProcessing.js';
+export * from './WorkflowResumeResponse.js';
+export * from './WorkflowResumeSuccessEnvelope.js';
+export * from './WorkflowSource.js';
 export * from './WorkflowStatus.js';
 export * from './WorkflowStatusResponse.js';
 export * from './WorkflowStatusSuccessEnvelope.js';
+export * from './WorkflowWarning.js';
+export * from './WorkflowWarningSeverity.js';

package/dist/openapi/models/index.js

@@ -1,19 +1,56 @@
 /* tslint:disable */
 /* eslint-disable */
+export * from './AudioWatermarkDecodeRequest.js';
+export * from './AudioWatermarkDecodeResponse.js';
+export * from './AuthErrorResponse.js';
+export * from './AuthErrorType.js';
+export * from './AvailabilityValue.js';
+export * from './BalanceExhaustedResponse.js';
+export * from './BalanceExhaustedResponseAllOfLinks.js';
 export * from './CallbackEventType.js';
+export * from './ConnectionSource.js';
 export * from './ContactRequest.js';
 export * from './ContactSubject.js';
 export * from './ContactValidationErrorResponse.js';
+export * from './CreateExternalImport403Response.js';
+export * from './CreateWorkflow422Response.js';
+export * from './CreditTransaction.js';
+export * from './CreditTransactionSourceBucket.js';
+export * from './CreditsBalanceResponse.js';
+export * from './CreditsBalanceSuccessEnvelope.js';
+export * from './CreditsUsageResponse.js';
+export * from './CreditsUsageSuccessEnvelope.js';
+export * from './Delivery.js';
+export * from './DeliveryOutputRef.js';
+export * from './DeliveryPlan.js';
+export * from './DeliveryPlanOutput.js';
+export * from './DeliveryPlanReason.js';
+export * from './DeliverySelection.js';
 export * from './ErrorEnvelope.js';
-export * from './ExportConfig.js';
+export * from './EstimateQuality.js';
+export * from './EstimateRange.js';
+export * from './ExternalDestination.js';
+export * from './ExternalImportCreatedResponse.js';
+export * from './ExternalImportCreatedSuccessEnvelope.js';
+export * from './ExternalImportRequest.js';
+export * from './ExternalImportToken.js';
+export * from './ExternalSource.js';
+export * from './FeatureNotAvailableResponse.js';
+export * from './FeatureTierRestrictedResponse.js';
+export * from './FeatureViolation.js';
 export * from './JobDefinition.js';
 export * from './JobDownload.js';
-export * from './JobInput.js';
+export * from './JobInputV2.js';
+export * from './JobOutputSource.js';
 export * from './JobResponse.js';
-export * from './JobSource.js';
 export * from './JobStatus.js';
 export * from './JobType.js';
 export * from './LivenessResponse.js';
+export * from './LoginUser200Response.js';
+export * from './LoginUser200ResponseData.js';
+export * from './LoginUser200ResponseDataUser.js';
+export * from './LoginUserRequest.js';
+export * from './LogoutUser200Response.js';
 export * from './MetadataResponse.js';
 export * from './MetadataResponseDimensions.js';
 export * from './MetadataResponseExif.js';
@@ -22,6 +59,9 @@ export * from './MetadataSuccessEnvelope.js';
 export * from './MimeGroupSchema.js';
 export * from './MultipartCompleteRequest.js';
 export * from './MultipartCompleteRequestPartsInner.js';
+export * from './MultipartCompleteResponse.js';
+export * from './MultipartCompleteSuccessEnvelope.js';
+export * from './MultipartInitiateRequestMetadataHint.js';
 export * from './MultipartInitiateResponse.js';
 export * from './MultipartInitiateSuccessEnvelope.js';
 export * from './OperationDefinition.js';
@@ -35,7 +75,13 @@ export * from './OperationStatus.js';
 export * from './OperationType.js';
 export * from './OperationsSchemaResponse.js';
 export * from './OptionSchema.js';
+export * from './PerValueAvailabilityEntry.js';
 export * from './PresignedUrlPart.js';
+export * from './ProcessingClass.js';
+export * from './ProcessingClassHint.js';
+export * from './ProcessingClassReason.js';
+export * from './ProcessingPlan.js';
+export * from './ProcessingPlanJob.js';
 export * from './ReadinessResponse.js';
 export * from './ResponseEnvelope.js';
 export * from './RetryResponse.js';
@@ -47,18 +93,46 @@ export * from './SseOperationCompletedData.js';
 export * from './SseOperationFailedData.js';
 export * from './SseOperationProgressData.js';
 export * from './SseWorkflowTerminalData.js';
+export * from './TierRestrictionKind.js';
+export * from './TierRestrictionResponse.js';
+export * from './UploadConstraintsApplied.js';
+export * from './UploadDurationExceedsTierResponse.js';
+export * from './UploadFile403Response.js';
+export * from './UploadFile422Response.js';
+export * from './UploadProbeMediaMetadata.js';
+export * from './UploadProbeProcessingClass.js';
+export * from './UploadProbeResponse.js';
+export * from './UploadProbeStatus.js';
 export * from './UploadResponse.js';
+export * from './UploadSizeExceedsTierResponse.js';
+export * from './UploadSource.js';
 export * from './UploadSuccessEnvelope.js';
+export * from './UploadThresholds.js';
+export * from './UserTier.js';
 export * from './ValidationErrorEnvelope.js';
 export * from './ValidationErrorEnvelopeDetailsInner.js';
+export * from './WarningType.js';
 export * from './WebhookOperationContext.js';
 export * from './WebhookPayload.js';
+export * from './WorkflowCancelBillingEffect.js';
+export * from './WorkflowCancelResponse.js';
+export * from './WorkflowCancelSuccessEnvelope.js';
 export * from './WorkflowCreateRequest.js';
 export * from './WorkflowCreateResponse.js';
 export * from './WorkflowCreateSuccessEnvelope.js';
 export * from './WorkflowDownloadResponse.js';
 export * from './WorkflowDownloadSuccessEnvelope.js';
 export * from './WorkflowEdge.js';
+export * from './WorkflowExpiredResponse.js';
+export * from './WorkflowPauseRequiredAction.js';
+export * from './WorkflowPausedDetail.js';
+export * from './WorkflowPausedDetailLinks.js';
+export * from './WorkflowProcessing.js';
+export * from './WorkflowResumeResponse.js';
+export * from './WorkflowResumeSuccessEnvelope.js';
+export * from './WorkflowSource.js';
 export * from './WorkflowStatus.js';
 export * from './WorkflowStatusResponse.js';
 export * from './WorkflowStatusSuccessEnvelope.js';
+export * from './WorkflowWarning.js';
+export * from './WorkflowWarningSeverity.js';

package/dist/openapi/runtime.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.7.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/openapi/runtime.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.7.1
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -223,6 +223,11 @@ export class ResponseError extends Error {
     constructor(response, msg) {
         super(msg);
         this.response = response;
+        // restore prototype chain
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
     }
 }
 export class FetchError extends Error {
@@ -231,6 +236,11 @@ export class FetchError extends Error {
     constructor(cause, msg) {
         super(msg);
         this.cause = cause;
+        // restore prototype chain
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
     }
 }
 export class RequiredError extends Error {
@@ -239,6 +249,11 @@ export class RequiredError extends Error {
     constructor(field, msg) {
         super(msg);
         this.field = field;
+        // restore prototype chain
+        const actualProto = new.target.prototype;
+        if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(this, actualProto);
+        }
     }
 }
 export const COLLECTION_FORMATS = {

package/dist/operations/archive.metadata.d.ts

@@ -0,0 +1,2 @@
+import type { OperationMetadata } from './metadata-types.js';
+export declare const archiveMetadata: OperationMetadata;

package/dist/operations/archive.metadata.js

@@ -0,0 +1,13 @@
+// Auto-generated from archive.yaml -- do not edit
+export const archiveMetadata = {
+    features: {},
+    mime_groups: {},
+    direct_options: {
+        format: {
+            per_value_availability: {},
+        },
+        folder_structure: {
+            per_value_availability: {},
+        },
+    },
+};

package/dist/operations/audio_overlay.d.ts

@@ -0,0 +1,48 @@
+export declare enum AudioOverlayAudioMode {
+    Mix = "mix",
+    Duck = "duck",
+    Replace = "replace"
+}
+export interface AudioOverlayAudioOptions {
+    start_at?: number;
+    duration?: number;
+    overlay_gain_db?: number;
+    mode?: AudioOverlayAudioMode;
+    duck_threshold?: number;
+    duck_ratio?: number;
+    duck_attack_ms?: number;
+    duck_release_ms?: number;
+    fade_in_ms?: number;
+    fade_out_ms?: number;
+    loop?: boolean;
+    loop_interval?: number;
+    silence_threshold_db?: number;
+    min_silence_ms?: number;
+}
+export declare enum AudioOverlayVideoMode {
+    Mix = "mix",
+    Duck = "duck",
+    Replace = "replace"
+}
+export declare enum AudioOverlayVideoNoAudioTrackBehaviour {
+    Reject = "reject",
+    CreateSilent = "create_silent",
+    Replace = "replace"
+}
+export interface AudioOverlayVideoOptions {
+    start_at?: number;
+    duration?: number;
+    overlay_gain_db?: number;
+    mode?: AudioOverlayVideoMode;
+    duck_threshold?: number;
+    duck_ratio?: number;
+    duck_attack_ms?: number;
+    duck_release_ms?: number;
+    fade_in_ms?: number;
+    fade_out_ms?: number;
+    loop?: boolean;
+    loop_interval?: number;
+    no_audio_track_behaviour?: AudioOverlayVideoNoAudioTrackBehaviour;
+    silence_threshold_db?: number;
+    min_silence_ms?: number;
+}

package/dist/operations/audio_overlay.js

@@ -0,0 +1,19 @@
+// Auto-generated from audio_overlay.yaml -- do not edit
+export var AudioOverlayAudioMode;
+(function (AudioOverlayAudioMode) {
+    AudioOverlayAudioMode["Mix"] = "mix";
+    AudioOverlayAudioMode["Duck"] = "duck";
+    AudioOverlayAudioMode["Replace"] = "replace";
+})(AudioOverlayAudioMode || (AudioOverlayAudioMode = {}));
+export var AudioOverlayVideoMode;
+(function (AudioOverlayVideoMode) {
+    AudioOverlayVideoMode["Mix"] = "mix";
+    AudioOverlayVideoMode["Duck"] = "duck";
+    AudioOverlayVideoMode["Replace"] = "replace";
+})(AudioOverlayVideoMode || (AudioOverlayVideoMode = {}));
+export var AudioOverlayVideoNoAudioTrackBehaviour;
+(function (AudioOverlayVideoNoAudioTrackBehaviour) {
+    AudioOverlayVideoNoAudioTrackBehaviour["Reject"] = "reject";
+    AudioOverlayVideoNoAudioTrackBehaviour["CreateSilent"] = "create_silent";
+    AudioOverlayVideoNoAudioTrackBehaviour["Replace"] = "replace";
+})(AudioOverlayVideoNoAudioTrackBehaviour || (AudioOverlayVideoNoAudioTrackBehaviour = {}));

package/dist/operations/audio_overlay.metadata.d.ts

@@ -0,0 +1,2 @@
+import type { OperationMetadata } from './metadata-types.js';
+export declare const audioOverlayMetadata: OperationMetadata;