@sokol111/ecommerce-image-service-api 1.0.0

package/dist/api.d.ts

@@ -0,0 +1,1325 @@
+/**
+ * Image Service API
+ * API for image management in an e-commerce system using the **Draft → Promote** pattern.  Responsibilities: - Generate presigned URLs for direct PUT uploads to MinIO/S3. - Confirm uploads and persist image metadata to the database. - Promote/attach images from a product draft to a final product. - Read/update/delete image metadata. - Generate signed delivery URLs for imgproxy.  Notes: - No authentication is configured yet (public API for now). Add auth later when ready. - Idempotency is supported via the `Idempotency-Key` header for POST/DELETE operations.
+ *
+ * The version of the OpenAPI document: 1.0.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 { Configuration } from './configuration';
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import type { RequestArgs } from './base';
+import { BaseAPI } from './base';
+/**
+ *
+ * @export
+ * @interface ConfirmRequest
+ */
+export interface ConfirmRequest {
+    /**
+     *
+     * @type {OwnerType}
+     * @memberof ConfirmRequest
+     */
+    'ownerType': OwnerType;
+    /**
+     *
+     * @type {string}
+     * @memberof ConfirmRequest
+     */
+    'ownerId': string;
+    /**
+     * S3 key that was used for PUT
+     * @type {string}
+     * @memberof ConfirmRequest
+     */
+    'key': string;
+    /**
+     *
+     * @type {string}
+     * @memberof ConfirmRequest
+     */
+    'tempId'?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof ConfirmRequest
+     */
+    'alt'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ConfirmRequest
+     */
+    'mime'?: string;
+    /**
+     *
+     * @type {ImageRole}
+     * @memberof ConfirmRequest
+     */
+    'role'?: ImageRole;
+    /**
+     * e.g., SHA256 hex for additional integrity check
+     * @type {string}
+     * @memberof ConfirmRequest
+     */
+    'checksum'?: string | null;
+}
+/**
+ *
+ * @export
+ * @interface GetDeliveryUrl200Response
+ */
+export interface GetDeliveryUrl200Response {
+    /**
+     *
+     * @type {string}
+     * @memberof GetDeliveryUrl200Response
+     */
+    'url'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof GetDeliveryUrl200Response
+     */
+    'expiresAt'?: string | null;
+}
+/**
+ *
+ * @export
+ * @interface Healthz200Response
+ */
+export interface Healthz200Response {
+    /**
+     *
+     * @type {string}
+     * @memberof Healthz200Response
+     */
+    'status'?: string;
+}
+/**
+ *
+ * @export
+ * @interface Image
+ */
+export interface Image {
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'id'?: string;
+    /**
+     *
+     * @type {OwnerType}
+     * @memberof Image
+     */
+    'ownerType'?: OwnerType;
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'ownerId'?: string;
+    /**
+     *
+     * @type {ImageRole}
+     * @memberof Image
+     */
+    'role'?: ImageRole;
+    /**
+     * S3 key of the original image
+     * @type {string}
+     * @memberof Image
+     */
+    'key'?: string;
+    /**
+     * Optional — direct URL if public or via proxy
+     * @type {string}
+     * @memberof Image
+     */
+    'url'?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'alt'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'mime'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof Image
+     */
+    'size'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'hash'?: string | null;
+    /**
+     *
+     * @type {ImageStatus}
+     * @memberof Image
+     */
+    'status'?: ImageStatus;
+    /**
+     *
+     * @type {Array<Variant>}
+     * @memberof Image
+     */
+    'variants'?: Array<Variant>;
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'createdAt'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Image
+     */
+    'updatedAt'?: string;
+}
+/**
+ *
+ * @export
+ * @interface ImagePatch
+ */
+export interface ImagePatch {
+    /**
+     *
+     * @type {string}
+     * @memberof ImagePatch
+     */
+    'alt'?: string;
+    /**
+     *
+     * @type {ImageRole}
+     * @memberof ImagePatch
+     */
+    'role'?: ImageRole;
+    /**
+     * Position in the product gallery
+     * @type {number}
+     * @memberof ImagePatch
+     */
+    'order'?: number;
+}
+/**
+ *
+ * @export
+ * @enum {string}
+ */
+export declare const ImageRole: {
+    readonly Main: "main";
+    readonly Gallery: "gallery";
+    readonly Other: "other";
+};
+export type ImageRole = typeof ImageRole[keyof typeof ImageRole];
+/**
+ *
+ * @export
+ * @enum {string}
+ */
+export declare const ImageStatus: {
+    readonly Pending: "pending";
+    readonly Uploaded: "uploaded";
+    readonly Processing: "processing";
+    readonly Ready: "ready";
+    readonly Failed: "failed";
+    readonly Deleted: "deleted";
+};
+export type ImageStatus = typeof ImageStatus[keyof typeof ImageStatus];
+/**
+ *
+ * @export
+ * @interface ListImages200Response
+ */
+export interface ListImages200Response {
+    /**
+     *
+     * @type {Array<Image>}
+     * @memberof ListImages200Response
+     */
+    'items'?: Array<Image>;
+    /**
+     *
+     * @type {number}
+     * @memberof ListImages200Response
+     */
+    'page'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof ListImages200Response
+     */
+    'pageSize'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof ListImages200Response
+     */
+    'total'?: number;
+}
+/**
+ *
+ * @export
+ * @enum {string}
+ */
+export declare const OwnerType: {
+    readonly ProductDraft: "productDraft";
+    readonly Product: "product";
+    readonly User: "user";
+};
+export type OwnerType = typeof OwnerType[keyof typeof OwnerType];
+/**
+ *
+ * @export
+ * @interface PresignRequest
+ */
+export interface PresignRequest {
+    /**
+     *
+     * @type {OwnerType}
+     * @memberof PresignRequest
+     */
+    'ownerType': OwnerType;
+    /**
+     * Draft ID or owner ID
+     * @type {string}
+     * @memberof PresignRequest
+     */
+    'ownerId': string;
+    /**
+     *
+     * @type {string}
+     * @memberof PresignRequest
+     */
+    'filename': string;
+    /**
+     *
+     * @type {string}
+     * @memberof PresignRequest
+     */
+    'contentType': string;
+    /**
+     * Size in bytes
+     * @type {number}
+     * @memberof PresignRequest
+     */
+    'size': number;
+    /**
+     *
+     * @type {ImageRole}
+     * @memberof PresignRequest
+     */
+    'role'?: ImageRole;
+}
+/**
+ *
+ * @export
+ * @interface PresignResponse
+ */
+export interface PresignResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof PresignResponse
+     */
+    'uploadUrl'?: string;
+    /**
+     * Final S3 key to PUT to
+     * @type {string}
+     * @memberof PresignResponse
+     */
+    'key'?: string;
+    /**
+     * Temporary ID for idempotency/confirm
+     * @type {string}
+     * @memberof PresignResponse
+     */
+    'tempId'?: string;
+    /**
+     * TTL in seconds
+     * @type {number}
+     * @memberof PresignResponse
+     */
+    'expiresIn'?: number;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof PresignResponse
+     */
+    'requiredHeaders'?: {
+        [key: string]: string;
+    };
+}
+/**
+ * RFC7807 Problem Details
+ * @export
+ * @interface Problem
+ */
+export interface Problem {
+    /**
+     *
+     * @type {string}
+     * @memberof Problem
+     */
+    'type'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Problem
+     */
+    'title'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof Problem
+     */
+    'status'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof Problem
+     */
+    'detail'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Problem
+     */
+    'instance'?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Problem
+     */
+    'traceId'?: string;
+}
+/**
+ *
+ * @export
+ * @interface ProcessImageRequest
+ */
+export interface ProcessImageRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof ProcessImageRequest
+     */
+    'imageId'?: string;
+    /**
+     * Name of the preset (variant set), if used
+     * @type {string}
+     * @memberof ProcessImageRequest
+     */
+    'preset'?: string;
+}
+/**
+ *
+ * @export
+ * @interface PromoteImages200Response
+ */
+export interface PromoteImages200Response {
+    /**
+     *
+     * @type {Array<Image>}
+     * @memberof PromoteImages200Response
+     */
+    'promoted'?: Array<Image>;
+}
+/**
+ *
+ * @export
+ * @interface PromoteRequest
+ */
+export interface PromoteRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof PromoteRequest
+     */
+    'fromDraft': string;
+    /**
+     *
+     * @type {string}
+     * @memberof PromoteRequest
+     */
+    'toProduct': string;
+    /**
+     * If true — copy to products/{productId}/... and remove old objects
+     * @type {boolean}
+     * @memberof PromoteRequest
+     */
+    'move'?: boolean;
+    /**
+     * If omitted — promote all images of the draft
+     * @type {Array<string>}
+     * @memberof PromoteRequest
+     */
+    'images'?: Array<string>;
+}
+/**
+ *
+ * @export
+ * @interface Variant
+ */
+export interface Variant {
+    /**
+     *
+     * @type {string}
+     * @memberof Variant
+     */
+    'name'?: string;
+    /**
+     * S3 key of the variant
+     * @type {string}
+     * @memberof Variant
+     */
+    'key'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof Variant
+     */
+    'width'?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof Variant
+     */
+    'height'?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof Variant
+     */
+    'mime'?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof Variant
+     */
+    'size'?: number;
+}
+/**
+ * DeliveryApi - axios parameter creator
+ * @export
+ */
+export declare const DeliveryApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Generate a signed imgproxy URL for delivery with requested params
+     * @param {string} id
+     * @param {string} [variant]
+     * @param {number} [w]
+     * @param {number} [h]
+     * @param {GetDeliveryUrlFitEnum} [fit]
+     * @param {GetDeliveryUrlFormatEnum} [format]
+     * @param {number} [quality]
+     * @param {number} [dpr]
+     * @param {number} [ttlSeconds]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeliveryUrl: (id: string, variant?: string, w?: number, h?: number, fit?: GetDeliveryUrlFitEnum, format?: GetDeliveryUrlFormatEnum, quality?: number, dpr?: number, ttlSeconds?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * DeliveryApi - functional programming interface
+ * @export
+ */
+export declare const DeliveryApiFp: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Generate a signed imgproxy URL for delivery with requested params
+     * @param {string} id
+     * @param {string} [variant]
+     * @param {number} [w]
+     * @param {number} [h]
+     * @param {GetDeliveryUrlFitEnum} [fit]
+     * @param {GetDeliveryUrlFormatEnum} [format]
+     * @param {number} [quality]
+     * @param {number} [dpr]
+     * @param {number} [ttlSeconds]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeliveryUrl(id: string, variant?: string, w?: number, h?: number, fit?: GetDeliveryUrlFitEnum, format?: GetDeliveryUrlFormatEnum, quality?: number, dpr?: number, ttlSeconds?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetDeliveryUrl200Response>>;
+};
+/**
+ * DeliveryApi - factory interface
+ * @export
+ */
+export declare const DeliveryApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     *
+     * @summary Generate a signed imgproxy URL for delivery with requested params
+     * @param {DeliveryApiGetDeliveryUrlRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getDeliveryUrl(requestParameters: DeliveryApiGetDeliveryUrlRequest, options?: RawAxiosRequestConfig): AxiosPromise<GetDeliveryUrl200Response>;
+};
+/**
+ * Request parameters for getDeliveryUrl operation in DeliveryApi.
+ * @export
+ * @interface DeliveryApiGetDeliveryUrlRequest
+ */
+export interface DeliveryApiGetDeliveryUrlRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly variant?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly w?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly h?: number;
+    /**
+     *
+     * @type {'cover' | 'contain' | 'fill' | 'inside' | 'outside'}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly fit?: GetDeliveryUrlFitEnum;
+    /**
+     *
+     * @type {'original' | 'webp' | 'avif' | 'jpeg' | 'png'}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly format?: GetDeliveryUrlFormatEnum;
+    /**
+     *
+     * @type {number}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly quality?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly dpr?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DeliveryApiGetDeliveryUrl
+     */
+    readonly ttlSeconds?: number;
+}
+/**
+ * DeliveryApi - object-oriented interface
+ * @export
+ * @class DeliveryApi
+ * @extends {BaseAPI}
+ */
+export declare class DeliveryApi extends BaseAPI {
+    /**
+     *
+     * @summary Generate a signed imgproxy URL for delivery with requested params
+     * @param {DeliveryApiGetDeliveryUrlRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DeliveryApi
+     */
+    getDeliveryUrl(requestParameters: DeliveryApiGetDeliveryUrlRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<GetDeliveryUrl200Response, any, {}>>;
+}
+/**
+ * @export
+ */
+export declare const GetDeliveryUrlFitEnum: {
+    readonly Cover: "cover";
+    readonly Contain: "contain";
+    readonly Fill: "fill";
+    readonly Inside: "inside";
+    readonly Outside: "outside";
+};
+export type GetDeliveryUrlFitEnum = typeof GetDeliveryUrlFitEnum[keyof typeof GetDeliveryUrlFitEnum];
+/**
+ * @export
+ */
+export declare const GetDeliveryUrlFormatEnum: {
+    readonly Original: "original";
+    readonly Webp: "webp";
+    readonly Avif: "avif";
+    readonly Jpeg: "jpeg";
+    readonly Png: "png";
+};
+export type GetDeliveryUrlFormatEnum = typeof GetDeliveryUrlFormatEnum[keyof typeof GetDeliveryUrlFormatEnum];
+/**
+ * HealthApi - axios parameter creator
+ * @export
+ */
+export declare const HealthApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Health check
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthz: (options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * HealthApi - functional programming interface
+ * @export
+ */
+export declare const HealthApiFp: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Health check
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthz(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Healthz200Response>>;
+};
+/**
+ * HealthApi - factory interface
+ * @export
+ */
+export declare const HealthApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     *
+     * @summary Health check
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    healthz(options?: RawAxiosRequestConfig): AxiosPromise<Healthz200Response>;
+};
+/**
+ * HealthApi - object-oriented interface
+ * @export
+ * @class HealthApi
+ * @extends {BaseAPI}
+ */
+export declare class HealthApi extends BaseAPI {
+    /**
+     *
+     * @summary Health check
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof HealthApi
+     */
+    healthz(options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Healthz200Response, any, {}>>;
+}
+/**
+ * ImagesApi - axios parameter creator
+ * @export
+ */
+export declare const ImagesApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Confirm upload (HEAD against S3), persist metadata
+     * @param {ConfirmRequest} confirmRequest
+     * @param {string} [idempotencyKey] Idempotency key for safe retries.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    confirmUpload: (confirmRequest: ConfirmRequest, idempotencyKey?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary Delete image (soft or hard, per policy)
+     * @param {string} id
+     * @param {boolean} [hard]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteImage: (id: string, hard?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary Get image metadata
+     * @param {string} id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getImage: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary List/search images by owner/filters
+     * @param {OwnerType} [ownerType]
+     * @param {string} [ownerId]
+     * @param {ImageStatus} [status]
+     * @param {number} [page]
+     * @param {number} [pageSize]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listImages: (ownerType?: OwnerType, ownerId?: string, status?: ImageStatus, page?: number, pageSize?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary Update image metadata (alt, role, order)
+     * @param {string} id
+     * @param {ImagePatch} imagePatch
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateImage: (id: string, imagePatch: ImagePatch, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * ImagesApi - functional programming interface
+ * @export
+ */
+export declare const ImagesApiFp: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Confirm upload (HEAD against S3), persist metadata
+     * @param {ConfirmRequest} confirmRequest
+     * @param {string} [idempotencyKey] Idempotency key for safe retries.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    confirmUpload(confirmRequest: ConfirmRequest, idempotencyKey?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Image>>;
+    /**
+     *
+     * @summary Delete image (soft or hard, per policy)
+     * @param {string} id
+     * @param {boolean} [hard]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteImage(id: string, hard?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     *
+     * @summary Get image metadata
+     * @param {string} id
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getImage(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Image>>;
+    /**
+     *
+     * @summary List/search images by owner/filters
+     * @param {OwnerType} [ownerType]
+     * @param {string} [ownerId]
+     * @param {ImageStatus} [status]
+     * @param {number} [page]
+     * @param {number} [pageSize]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listImages(ownerType?: OwnerType, ownerId?: string, status?: ImageStatus, page?: number, pageSize?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListImages200Response>>;
+    /**
+     *
+     * @summary Update image metadata (alt, role, order)
+     * @param {string} id
+     * @param {ImagePatch} imagePatch
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateImage(id: string, imagePatch: ImagePatch, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Image>>;
+};
+/**
+ * ImagesApi - factory interface
+ * @export
+ */
+export declare const ImagesApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     *
+     * @summary Confirm upload (HEAD against S3), persist metadata
+     * @param {ImagesApiConfirmUploadRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    confirmUpload(requestParameters: ImagesApiConfirmUploadRequest, options?: RawAxiosRequestConfig): AxiosPromise<Image>;
+    /**
+     *
+     * @summary Delete image (soft or hard, per policy)
+     * @param {ImagesApiDeleteImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    deleteImage(requestParameters: ImagesApiDeleteImageRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     *
+     * @summary Get image metadata
+     * @param {ImagesApiGetImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getImage(requestParameters: ImagesApiGetImageRequest, options?: RawAxiosRequestConfig): AxiosPromise<Image>;
+    /**
+     *
+     * @summary List/search images by owner/filters
+     * @param {ImagesApiListImagesRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    listImages(requestParameters?: ImagesApiListImagesRequest, options?: RawAxiosRequestConfig): AxiosPromise<ListImages200Response>;
+    /**
+     *
+     * @summary Update image metadata (alt, role, order)
+     * @param {ImagesApiUpdateImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    updateImage(requestParameters: ImagesApiUpdateImageRequest, options?: RawAxiosRequestConfig): AxiosPromise<Image>;
+};
+/**
+ * Request parameters for confirmUpload operation in ImagesApi.
+ * @export
+ * @interface ImagesApiConfirmUploadRequest
+ */
+export interface ImagesApiConfirmUploadRequest {
+    /**
+     *
+     * @type {ConfirmRequest}
+     * @memberof ImagesApiConfirmUpload
+     */
+    readonly confirmRequest: ConfirmRequest;
+    /**
+     * Idempotency key for safe retries.
+     * @type {string}
+     * @memberof ImagesApiConfirmUpload
+     */
+    readonly idempotencyKey?: string;
+}
+/**
+ * Request parameters for deleteImage operation in ImagesApi.
+ * @export
+ * @interface ImagesApiDeleteImageRequest
+ */
+export interface ImagesApiDeleteImageRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof ImagesApiDeleteImage
+     */
+    readonly id: string;
+    /**
+     *
+     * @type {boolean}
+     * @memberof ImagesApiDeleteImage
+     */
+    readonly hard?: boolean;
+}
+/**
+ * Request parameters for getImage operation in ImagesApi.
+ * @export
+ * @interface ImagesApiGetImageRequest
+ */
+export interface ImagesApiGetImageRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof ImagesApiGetImage
+     */
+    readonly id: string;
+}
+/**
+ * Request parameters for listImages operation in ImagesApi.
+ * @export
+ * @interface ImagesApiListImagesRequest
+ */
+export interface ImagesApiListImagesRequest {
+    /**
+     *
+     * @type {OwnerType}
+     * @memberof ImagesApiListImages
+     */
+    readonly ownerType?: OwnerType;
+    /**
+     *
+     * @type {string}
+     * @memberof ImagesApiListImages
+     */
+    readonly ownerId?: string;
+    /**
+     *
+     * @type {ImageStatus}
+     * @memberof ImagesApiListImages
+     */
+    readonly status?: ImageStatus;
+    /**
+     *
+     * @type {number}
+     * @memberof ImagesApiListImages
+     */
+    readonly page?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof ImagesApiListImages
+     */
+    readonly pageSize?: number;
+}
+/**
+ * Request parameters for updateImage operation in ImagesApi.
+ * @export
+ * @interface ImagesApiUpdateImageRequest
+ */
+export interface ImagesApiUpdateImageRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof ImagesApiUpdateImage
+     */
+    readonly id: string;
+    /**
+     *
+     * @type {ImagePatch}
+     * @memberof ImagesApiUpdateImage
+     */
+    readonly imagePatch: ImagePatch;
+}
+/**
+ * ImagesApi - object-oriented interface
+ * @export
+ * @class ImagesApi
+ * @extends {BaseAPI}
+ */
+export declare class ImagesApi extends BaseAPI {
+    /**
+     *
+     * @summary Confirm upload (HEAD against S3), persist metadata
+     * @param {ImagesApiConfirmUploadRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ImagesApi
+     */
+    confirmUpload(requestParameters: ImagesApiConfirmUploadRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Image, any, {}>>;
+    /**
+     *
+     * @summary Delete image (soft or hard, per policy)
+     * @param {ImagesApiDeleteImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ImagesApi
+     */
+    deleteImage(requestParameters: ImagesApiDeleteImageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     *
+     * @summary Get image metadata
+     * @param {ImagesApiGetImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ImagesApi
+     */
+    getImage(requestParameters: ImagesApiGetImageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Image, any, {}>>;
+    /**
+     *
+     * @summary List/search images by owner/filters
+     * @param {ImagesApiListImagesRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ImagesApi
+     */
+    listImages(requestParameters?: ImagesApiListImagesRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ListImages200Response, any, {}>>;
+    /**
+     *
+     * @summary Update image metadata (alt, role, order)
+     * @param {ImagesApiUpdateImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ImagesApi
+     */
+    updateImage(requestParameters: ImagesApiUpdateImageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<Image, any, {}>>;
+}
+/**
+ * InternalApi - axios parameter creator
+ * @export
+ */
+export declare const InternalApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Trigger (or retry) variant generation for an image
+     * @param {ProcessImageRequest} processImageRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    processImage: (processImageRequest: ProcessImageRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     *
+     * @summary MinIO/S3 event webhook (ObjectCreated/Delete) for auto-confirm/triggers
+     * @param {{ [key: string]: any; }} requestBody
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    s3Webhook: (requestBody: {
+        [key: string]: any;
+    }, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * InternalApi - functional programming interface
+ * @export
+ */
+export declare const InternalApiFp: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Trigger (or retry) variant generation for an image
+     * @param {ProcessImageRequest} processImageRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    processImage(processImageRequest: ProcessImageRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     *
+     * @summary MinIO/S3 event webhook (ObjectCreated/Delete) for auto-confirm/triggers
+     * @param {{ [key: string]: any; }} requestBody
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    s3Webhook(requestBody: {
+        [key: string]: any;
+    }, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+};
+/**
+ * InternalApi - factory interface
+ * @export
+ */
+export declare const InternalApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     *
+     * @summary Trigger (or retry) variant generation for an image
+     * @param {InternalApiProcessImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    processImage(requestParameters: InternalApiProcessImageRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     *
+     * @summary MinIO/S3 event webhook (ObjectCreated/Delete) for auto-confirm/triggers
+     * @param {InternalApiS3WebhookRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    s3Webhook(requestParameters: InternalApiS3WebhookRequest, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+};
+/**
+ * Request parameters for processImage operation in InternalApi.
+ * @export
+ * @interface InternalApiProcessImageRequest
+ */
+export interface InternalApiProcessImageRequest {
+    /**
+     *
+     * @type {ProcessImageRequest}
+     * @memberof InternalApiProcessImage
+     */
+    readonly processImageRequest: ProcessImageRequest;
+}
+/**
+ * Request parameters for s3Webhook operation in InternalApi.
+ * @export
+ * @interface InternalApiS3WebhookRequest
+ */
+export interface InternalApiS3WebhookRequest {
+    /**
+     *
+     * @type {{ [key: string]: any; }}
+     * @memberof InternalApiS3Webhook
+     */
+    readonly requestBody: {
+        [key: string]: any;
+    };
+}
+/**
+ * InternalApi - object-oriented interface
+ * @export
+ * @class InternalApi
+ * @extends {BaseAPI}
+ */
+export declare class InternalApi extends BaseAPI {
+    /**
+     *
+     * @summary Trigger (or retry) variant generation for an image
+     * @param {InternalApiProcessImageRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof InternalApi
+     */
+    processImage(requestParameters: InternalApiProcessImageRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+    /**
+     *
+     * @summary MinIO/S3 event webhook (ObjectCreated/Delete) for auto-confirm/triggers
+     * @param {InternalApiS3WebhookRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof InternalApi
+     */
+    s3Webhook(requestParameters: InternalApiS3WebhookRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
+}
+/**
+ * LinkingApi - axios parameter creator
+ * @export
+ */
+export declare const LinkingApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Promote images from a product draft to a final product
+     * @param {PromoteRequest} promoteRequest
+     * @param {string} [idempotencyKey]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    promoteImages: (promoteRequest: PromoteRequest, idempotencyKey?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * LinkingApi - functional programming interface
+ * @export
+ */
+export declare const LinkingApiFp: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Promote images from a product draft to a final product
+     * @param {PromoteRequest} promoteRequest
+     * @param {string} [idempotencyKey]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    promoteImages(promoteRequest: PromoteRequest, idempotencyKey?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PromoteImages200Response>>;
+};
+/**
+ * LinkingApi - factory interface
+ * @export
+ */
+export declare const LinkingApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     *
+     * @summary Promote images from a product draft to a final product
+     * @param {LinkingApiPromoteImagesRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    promoteImages(requestParameters: LinkingApiPromoteImagesRequest, options?: RawAxiosRequestConfig): AxiosPromise<PromoteImages200Response>;
+};
+/**
+ * Request parameters for promoteImages operation in LinkingApi.
+ * @export
+ * @interface LinkingApiPromoteImagesRequest
+ */
+export interface LinkingApiPromoteImagesRequest {
+    /**
+     *
+     * @type {PromoteRequest}
+     * @memberof LinkingApiPromoteImages
+     */
+    readonly promoteRequest: PromoteRequest;
+    /**
+     *
+     * @type {string}
+     * @memberof LinkingApiPromoteImages
+     */
+    readonly idempotencyKey?: string;
+}
+/**
+ * LinkingApi - object-oriented interface
+ * @export
+ * @class LinkingApi
+ * @extends {BaseAPI}
+ */
+export declare class LinkingApi extends BaseAPI {
+    /**
+     *
+     * @summary Promote images from a product draft to a final product
+     * @param {LinkingApiPromoteImagesRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof LinkingApi
+     */
+    promoteImages(requestParameters: LinkingApiPromoteImagesRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PromoteImages200Response, any, {}>>;
+}
+/**
+ * PresignApi - axios parameter creator
+ * @export
+ */
+export declare const PresignApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Create a presigned PUT URL for uploading an image to MinIO/S3
+     * @param {PresignRequest} presignRequest
+     * @param {string} [idempotencyKey] Idempotency key for safe retries.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPresign: (presignRequest: PresignRequest, idempotencyKey?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+};
+/**
+ * PresignApi - functional programming interface
+ * @export
+ */
+export declare const PresignApiFp: (configuration?: Configuration) => {
+    /**
+     *
+     * @summary Create a presigned PUT URL for uploading an image to MinIO/S3
+     * @param {PresignRequest} presignRequest
+     * @param {string} [idempotencyKey] Idempotency key for safe retries.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPresign(presignRequest: PresignRequest, idempotencyKey?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PresignResponse>>;
+};
+/**
+ * PresignApi - factory interface
+ * @export
+ */
+export declare const PresignApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     *
+     * @summary Create a presigned PUT URL for uploading an image to MinIO/S3
+     * @param {PresignApiCreatePresignRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    createPresign(requestParameters: PresignApiCreatePresignRequest, options?: RawAxiosRequestConfig): AxiosPromise<PresignResponse>;
+};
+/**
+ * Request parameters for createPresign operation in PresignApi.
+ * @export
+ * @interface PresignApiCreatePresignRequest
+ */
+export interface PresignApiCreatePresignRequest {
+    /**
+     *
+     * @type {PresignRequest}
+     * @memberof PresignApiCreatePresign
+     */
+    readonly presignRequest: PresignRequest;
+    /**
+     * Idempotency key for safe retries.
+     * @type {string}
+     * @memberof PresignApiCreatePresign
+     */
+    readonly idempotencyKey?: string;
+}
+/**
+ * PresignApi - object-oriented interface
+ * @export
+ * @class PresignApi
+ * @extends {BaseAPI}
+ */
+export declare class PresignApi extends BaseAPI {
+    /**
+     *
+     * @summary Create a presigned PUT URL for uploading an image to MinIO/S3
+     * @param {PresignApiCreatePresignRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PresignApi
+     */
+    createPresign(requestParameters: PresignApiCreatePresignRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<PresignResponse, any, {}>>;
+}