// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. import * as Core from 'cloudflare/core'; import { APIResource } from 'cloudflare/resource'; import * as VariantsAPI from 'cloudflare/resources/cache/variants'; export class Variants extends APIResource { /** * Variant support enables caching variants of images with certain file extensions * in addition to the original. This only applies when the origin server sends the * 'Vary: Accept' response header. If the origin server sends 'Vary: Accept' but * does not serve the variant requested, the response will not be cached. This will * be indicated with BYPASS cache status in the response headers. */ delete(params: VariantDeleteParams, options?: Core.RequestOptions): Core.APIPromise { const { zone_id } = params; return ( this._client.delete(`/zones/${zone_id}/cache/variants`, options) as Core.APIPromise<{ result: CacheVariants; }> )._thenUnwrap((obj) => obj.result); } /** * Variant support enables caching variants of images with certain file extensions * in addition to the original. This only applies when the origin server sends the * 'Vary: Accept' response header. If the origin server sends 'Vary: Accept' but * does not serve the variant requested, the response will not be cached. This will * be indicated with BYPASS cache status in the response headers. */ edit(params: VariantEditParams, options?: Core.RequestOptions): Core.APIPromise { const { zone_id, ...body } = params; return ( this._client.patch(`/zones/${zone_id}/cache/variants`, { body, ...options }) as Core.APIPromise<{ result: VariantEditResponse; }> )._thenUnwrap((obj) => obj.result); } /** * Variant support enables caching variants of images with certain file extensions * in addition to the original. This only applies when the origin server sends the * 'Vary: Accept' response header. If the origin server sends 'Vary: Accept' but * does not serve the variant requested, the response will not be cached. This will * be indicated with BYPASS cache status in the response headers. */ get(params: VariantGetParams, options?: Core.RequestOptions): Core.APIPromise { const { zone_id } = params; return ( this._client.get(`/zones/${zone_id}/cache/variants`, options) as Core.APIPromise<{ result: VariantGetResponse; }> )._thenUnwrap((obj) => obj.result); } } /** * Variant support enables caching variants of images with certain file extensions * in addition to the original. This only applies when the origin server sends the * 'Vary: Accept' response header. If the origin server sends 'Vary: Accept' but * does not serve the variant requested, the response will not be cached. This will * be indicated with BYPASS cache status in the response headers. */ export interface CacheVariants { /** * ID of the zone setting. */ id: 'variants'; /** * last time this setting was modified. */ modified_on: string | null; } /** * Variant support enables caching variants of images with certain file extensions * in addition to the original. This only applies when the origin server sends the * 'Vary: Accept' response header. If the origin server sends 'Vary: Accept' but * does not serve the variant requested, the response will not be cached. This will * be indicated with BYPASS cache status in the response headers. */ export interface VariantEditResponse { /** * ID of the zone setting. */ id: 'variants'; /** * last time this setting was modified. */ modified_on: string | null; /** * Value of the zone setting. */ value: VariantEditResponse.Value; } export namespace VariantEditResponse { /** * Value of the zone setting. */ export interface Value { /** * List of strings with the MIME types of all the variants that should be served * for avif. */ avif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for bmp. */ bmp?: Array; /** * List of strings with the MIME types of all the variants that should be served * for gif. */ gif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jp2. */ jp2?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpeg. */ jpeg?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpg. */ jpg?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpg2. */ jpg2?: Array; /** * List of strings with the MIME types of all the variants that should be served * for png. */ png?: Array; /** * List of strings with the MIME types of all the variants that should be served * for tif. */ tif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for tiff. */ tiff?: Array; /** * List of strings with the MIME types of all the variants that should be served * for webp. */ webp?: Array; } } /** * Variant support enables caching variants of images with certain file extensions * in addition to the original. This only applies when the origin server sends the * 'Vary: Accept' response header. If the origin server sends 'Vary: Accept' but * does not serve the variant requested, the response will not be cached. This will * be indicated with BYPASS cache status in the response headers. */ export interface VariantGetResponse { /** * ID of the zone setting. */ id: 'variants'; /** * last time this setting was modified. */ modified_on: string | null; /** * Value of the zone setting. */ value: VariantGetResponse.Value; } export namespace VariantGetResponse { /** * Value of the zone setting. */ export interface Value { /** * List of strings with the MIME types of all the variants that should be served * for avif. */ avif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for bmp. */ bmp?: Array; /** * List of strings with the MIME types of all the variants that should be served * for gif. */ gif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jp2. */ jp2?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpeg. */ jpeg?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpg. */ jpg?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpg2. */ jpg2?: Array; /** * List of strings with the MIME types of all the variants that should be served * for png. */ png?: Array; /** * List of strings with the MIME types of all the variants that should be served * for tif. */ tif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for tiff. */ tiff?: Array; /** * List of strings with the MIME types of all the variants that should be served * for webp. */ webp?: Array; } } export interface VariantDeleteParams { /** * Identifier */ zone_id: string; } export interface VariantEditParams { /** * Path param: Identifier */ zone_id: string; /** * Body param: Value of the zone setting. */ value: VariantEditParams.Value; } export namespace VariantEditParams { /** * Value of the zone setting. */ export interface Value { /** * List of strings with the MIME types of all the variants that should be served * for avif. */ avif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for bmp. */ bmp?: Array; /** * List of strings with the MIME types of all the variants that should be served * for gif. */ gif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jp2. */ jp2?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpeg. */ jpeg?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpg. */ jpg?: Array; /** * List of strings with the MIME types of all the variants that should be served * for jpg2. */ jpg2?: Array; /** * List of strings with the MIME types of all the variants that should be served * for png. */ png?: Array; /** * List of strings with the MIME types of all the variants that should be served * for tif. */ tif?: Array; /** * List of strings with the MIME types of all the variants that should be served * for tiff. */ tiff?: Array; /** * List of strings with the MIME types of all the variants that should be served * for webp. */ webp?: Array; } } export interface VariantGetParams { /** * Identifier */ zone_id: string; } export namespace Variants { export import CacheVariants = VariantsAPI.CacheVariants; export import VariantEditResponse = VariantsAPI.VariantEditResponse; export import VariantGetResponse = VariantsAPI.VariantGetResponse; export import VariantDeleteParams = VariantsAPI.VariantDeleteParams; export import VariantEditParams = VariantsAPI.VariantEditParams; export import VariantGetParams = VariantsAPI.VariantGetParams; }