feat(proxy-cache): add wildcard and parameter match support for content_type

app/_hub/kong-inc/proxy-cache-advanced/_index.md

@@ -49,15 +49,32 @@ params:
       datatype: array of string elements
       description: |
         Downstream request methods considered cacheable. Available options: `HEAD`, `GET`, `POST`, `PATCH`, `PUT`.
-    - name: content_type
-      required: true
-      default: 'text/plain, application/json'
+    - name: content_type # old version of param
+      maximum_version: "3.2.x"
+      required: null
+      default: '`["text/plain", "application/json"]`'
       value_in_examples:
         - text/plain
         - application/json
       datatype: array of string elements
       description: |
         Upstream response content types considered cacheable. The plugin performs an **exact match** against each specified value; for example, if the upstream is expected to respond with a `application/json; charset=utf-8` content-type, the plugin configuration must contain said value or a `Bypass` cache status is returned.
+    - name: content_type # current version of param
+      minimum_version: "3.3.x"
+      required: null
+      default: '`["text/plain", "application/json"]`'
+      value_in_examples:
+        - text/plain
+        - application/json
+      datatype: array of string elements
+      description: |
+        Upstream response content types considered cacheable. 
+
+        The wildcard content type can be used to match any specific type or subtype.
+        For example, `application/*` matches any subtypes of the application, `*/*` matches all content types. 
+
+        Note that `*/*` does not match with a content type that contains a parameter (e.g. `*/*` would not match `application/json; charset=utf-8`). 
+        If the response content type does not match the configuration, a `Bypass` cache status is returned.
     - name: vary_headers
       required: false
       default: null
@@ -448,6 +465,7 @@ Note that this endpoint purges all cache entities across all `proxy-cache-advanc
 
 **{{site.base_gateway}} 3.3.x**
 * Added the `ignore_uri_case` configuration parameter.
+* Added wildcard and parameter match support for `config.content_type`.
 
 **{{site.base_gateway}} 3.1.x**
 * Added support for integrating with redis clusters using the `config.redis.cluster_addresses` configuration parameter.

app/_hub/kong-inc/proxy-cache/_index.md

@@ -50,7 +50,8 @@ params:
       datatype: array of string elements
       description: |
         Downstream request methods considered cacheable.
-    - name: content_type
+    - name: content_type # old version of param
+      maximum_version: "3.2.x"
       required: null
       default: '`["text/plain", "application/json"]`'
       value_in_examples:
@@ -59,6 +60,22 @@ params:
       datatype: array of string elements
       description: |
         Upstream response content types considered cacheable. The plugin performs an **exact match** against each specified value; for example, if the upstream is expected to respond with a `application/json; charset=utf-8` content-type, the plugin configuration must contain said value or a `Bypass` cache status is returned.
+    - name: content_type # current version of param
+      minimum_version: "3.3.x"
+      required: null
+      default: '`["text/plain", "application/json"]`'
+      value_in_examples:
+        - text/plain
+        - application/json
+      datatype: array of string elements
+      description: |
+        Upstream response content types considered cacheable. 
+
+        The wildcard content type can be used to match any specific type or subtype.
+        For example, `application/*` matches any subtypes of the application, `*/*` matches all content types. 
+
+        Note that `*/*` does not match with a content type that contains a parameter (e.g. `*/*` would not match `application/json; charset=utf-8`). 
+        If the response content type does not match the configuration, a `Bypass` cache status is returned.
     - name: vary_headers
       required: false
       default: null
@@ -253,3 +270,10 @@ HTTP 204 No Content
 ```
 
 Note that this endpoint purges all cache entities across all `proxy-cache` plugins.
+
+---
+
+## Changelog 
+
+**{{site.base_gateway}} 3.3.x**
+* Added wildcard and parameter match support for `config.content_type`.