@cloudflare/workers-types 4.20260623.1 → 4.20260625.1

package/2021-11-03/index.d.ts

@@ -12194,6 +12194,8 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12262,6 +12264,67 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+type RequestInitCfPropertiesVaryAction = "normalize" | "passthrough" | "bypass";
+/** Configuration for Workers Standard Vary support. */
+interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2021-11-03/index.ts

@@ -12206,6 +12206,8 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12274,6 +12276,70 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+export type RequestInitCfPropertiesVaryAction =
+  | "normalize"
+  | "passthrough"
+  | "bypass";
+/** Configuration for Workers Standard Vary support. */
+export interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+export interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+export interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+export interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+export interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 export interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2022-01-31/index.d.ts

@@ -12261,6 +12261,8 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12329,6 +12331,67 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+type RequestInitCfPropertiesVaryAction = "normalize" | "passthrough" | "bypass";
+/** Configuration for Workers Standard Vary support. */
+interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2022-01-31/index.ts

@@ -12273,6 +12273,8 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12341,6 +12343,70 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+export type RequestInitCfPropertiesVaryAction =
+  | "normalize"
+  | "passthrough"
+  | "bypass";
+/** Configuration for Workers Standard Vary support. */
+export interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+export interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+export interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+export interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+export interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 export interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2022-03-21/index.d.ts

@@ -12270,6 +12270,8 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12338,6 +12340,67 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+type RequestInitCfPropertiesVaryAction = "normalize" | "passthrough" | "bypass";
+/** Configuration for Workers Standard Vary support. */
+interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2022-03-21/index.ts

@@ -12282,6 +12282,8 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12350,6 +12352,70 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+export type RequestInitCfPropertiesVaryAction =
+  | "normalize"
+  | "passthrough"
+  | "bypass";
+/** Configuration for Workers Standard Vary support. */
+export interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+export interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+export interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+export interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+export interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 export interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2022-08-04/index.d.ts

@@ -12271,6 +12271,8 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12339,6 +12341,67 @@ interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+type RequestInitCfPropertiesVaryAction = "normalize" | "passthrough" | "bypass";
+/** Configuration for Workers Standard Vary support. */
+interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.

package/2022-08-04/index.ts

@@ -12283,6 +12283,8 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    * (e.g. { '200-299': 86400, '404': 1, '500-599': 0 })
    */
   cacheTtlByStatus?: Record<string, number>;
+  /** Controls how responses with a `Vary` header are cached for this request. */
+  vary?: RequestInitCfPropertiesVary;
   /**
    * Explicit Cache-Control header value to set on the response stored in cache.
    * This gives full control over cache directives (e.g. 'public, max-age=3600, s-maxage=86400').
@@ -12351,6 +12353,70 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
    */
   resolveOverride?: string;
 }
+/**
+ * Controls how Workers Standard Vary handles a request header listed by an
+ * origin `Vary` response header:
+ *
+ * - `"normalize"`: normalize the request header value before it is used in the
+ *   cache variance key.
+ * - `"passthrough"`: use the raw request header value in the cache variance
+ *   key.
+ * - `"bypass"`: bypass cache when the header appears in the origin `Vary`
+ *   response header.
+ */
+export type RequestInitCfPropertiesVaryAction =
+  | "normalize"
+  | "passthrough"
+  | "bypass";
+/** Configuration for Workers Standard Vary support. */
+export interface RequestInitCfPropertiesVary {
+  /** The fallback action for varied request headers not listed in `headers`. */
+  default: RequestInitCfPropertiesVaryHeader;
+  /**
+   * Lowercase request header names and their Vary configuration.
+   *
+   * The `accept` header can include `media_types`, the `accept-language`
+   * header can include `languages`, and other headers support only `action`.
+   */
+  headers?: RequestInitCfPropertiesVaryHeaders;
+}
+/** Common Vary behavior for a single request header. */
+export interface RequestInitCfPropertiesVaryHeader {
+  /** How this request header contributes to cache variance. */
+  action: RequestInitCfPropertiesVaryAction;
+}
+/** Vary behavior for the `accept` request header. */
+export interface RequestInitCfPropertiesVaryAcceptHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Media types to keep when normalizing the `Accept` request header.
+   *
+   * Named `media_types` to match the serialized `cf.vary` configuration.
+   */
+  media_types?: string[];
+}
+/** Vary behavior for the `accept-language` request header. */
+export interface RequestInitCfPropertiesVaryAcceptLanguageHeader extends RequestInitCfPropertiesVaryHeader {
+  /**
+   * Language tags to keep when normalizing the `Accept-Language` request
+   * header.
+   */
+  languages?: string[];
+}
+/**
+ * Lowercase request header names and their Vary behavior.
+ *
+ * The index signature allows arbitrary custom request headers beyond the
+ * well-known `accept` and `accept-language` specializations.
+ */
+export interface RequestInitCfPropertiesVaryHeaders {
+  accept?: RequestInitCfPropertiesVaryAcceptHeader;
+  "accept-language"?: RequestInitCfPropertiesVaryAcceptLanguageHeader;
+  [header: string]:
+    | RequestInitCfPropertiesVaryHeader
+    | RequestInitCfPropertiesVaryAcceptHeader
+    | RequestInitCfPropertiesVaryAcceptLanguageHeader
+    | undefined;
+}
 export interface BasicImageTransformations {
   /**
    * Maximum width in image pixels. The value must be an integer.