Regenerate client from commit b951844 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v1/openapi.yaml

@@ -24156,6 +24156,7 @@ components:
         - $ref: "#/components/schemas/ToplistWidgetDefinition"
         - $ref: "#/components/schemas/TopologyMapWidgetDefinition"
         - $ref: "#/components/schemas/TreeMapWidgetDefinition"
+        - $ref: "#/components/schemas/WildcardWidgetDefinition"
     WidgetDisplayType:
       description: Type of display to use for the request.
       enum:
@@ -24927,6 +24928,81 @@ components:
       x-enum-varnames:
         - TIMESERIES
         - TOPLIST
+    WildcardWidgetDefinition:
+      description: >-
+        Custom visualization widget using Vega or Vega-Lite specifications. Combines standard Datadog data requests with a Vega or Vega-Lite JSON specification for flexible, custom visualizations.
+      properties:
+        custom_links:
+          description: List of custom links.
+          items:
+            $ref: "#/components/schemas/WidgetCustomLink"
+          type: array
+        requests:
+          description: List of data requests for the wildcard widget.
+          example: [{"formulas": ["formula": "query1"], "queries": [{"aggregator": "avg", "data_source": "metrics", "name": "query1", "query": "avg:system.cpu.user{*} by {env}"}], "response_format": "scalar"}]
+          items:
+            $ref: "#/components/schemas/WildcardWidgetRequest"
+          type: array
+        specification:
+          $ref: "#/components/schemas/WildcardWidgetSpecification"
+        time:
+          $ref: "#/components/schemas/WidgetTime"
+        title:
+          description: Title of the widget.
+          type: string
+        title_align:
+          $ref: "#/components/schemas/WidgetTextAlign"
+        title_size:
+          description: Size of the title.
+          type: string
+        type:
+          $ref: "#/components/schemas/WildcardWidgetDefinitionType"
+      required:
+        - type
+        - requests
+        - specification
+      type: object
+    WildcardWidgetDefinitionType:
+      default: wildcard
+      description: Type of the wildcard widget.
+      enum:
+        - wildcard
+      example: wildcard
+      type: string
+      x-enum-varnames:
+        - WILDCARD
+    WildcardWidgetRequest:
+      description: >-
+        Request object for the wildcard widget. Each variant represents a distinct data-fetching pattern: scalar formulas, timeseries formulas, list streams, and histograms.
+      oneOf:
+        - $ref: "#/components/schemas/TreeMapWidgetRequest"
+        - $ref: "#/components/schemas/TimeseriesWidgetRequest"
+        - $ref: "#/components/schemas/ListStreamWidgetRequest"
+        - $ref: "#/components/schemas/DistributionWidgetRequest"
+    WildcardWidgetSpecification:
+      description: >-
+        Vega or Vega-Lite specification for custom visualization rendering. See https://vega.github.io/vega-lite/ for the full grammar reference.
+      properties:
+        contents:
+          description: The Vega or Vega-Lite JSON specification object.
+          example: {"$schema": "https://vega.github.io/schema/vega-lite/v5.json", "data": {"name": "table1"}, "description": "A simple bar chart", "encoding": {"x": {"field": "env", "sort": "-y", "type": "nominal"}, "y": {"field": "query1", "type": "quantitative"}}, "mark": "bar"}
+          type: object
+        type:
+          $ref: "#/components/schemas/WildcardWidgetSpecificationType"
+      required:
+        - type
+        - contents
+      type: object
+    WildcardWidgetSpecificationType:
+      description: Type of specification used by the wildcard widget.
+      enum:
+        - vega
+        - vega-lite
+      example: vega-lite
+      type: string
+      x-enum-varnames:
+        - VEGA
+        - VEGA_LITE
   securitySchemes:
     AuthZ:
       description: This API uses OAuth 2 with the implicit grant flow.

src/main/java/com/datadog/api/client/v1/model/WidgetDefinition.java

@@ -1698,6 +1698,51 @@ public WidgetDefinition deserialize(JsonParser jp, DeserializationContext ctxt)
         log.log(Level.FINER, "Input data does not match schema 'TreeMapWidgetDefinition'", e);
       }
 
+      // deserialize WildcardWidgetDefinition
+      try {
+        boolean attemptParsing = true;
+        // ensure that we respect type coercion as set on the client ObjectMapper
+        if (WildcardWidgetDefinition.class.equals(Integer.class)
+            || WildcardWidgetDefinition.class.equals(Long.class)
+            || WildcardWidgetDefinition.class.equals(Float.class)
+            || WildcardWidgetDefinition.class.equals(Double.class)
+            || WildcardWidgetDefinition.class.equals(Boolean.class)
+            || WildcardWidgetDefinition.class.equals(String.class)) {
+          attemptParsing = typeCoercion;
+          if (!attemptParsing) {
+            attemptParsing |=
+                ((WildcardWidgetDefinition.class.equals(Integer.class)
+                        || WildcardWidgetDefinition.class.equals(Long.class))
+                    && token == JsonToken.VALUE_NUMBER_INT);
+            attemptParsing |=
+                ((WildcardWidgetDefinition.class.equals(Float.class)
+                        || WildcardWidgetDefinition.class.equals(Double.class))
+                    && (token == JsonToken.VALUE_NUMBER_FLOAT
+                        || token == JsonToken.VALUE_NUMBER_INT));
+            attemptParsing |=
+                (WildcardWidgetDefinition.class.equals(Boolean.class)
+                    && (token == JsonToken.VALUE_FALSE || token == JsonToken.VALUE_TRUE));
+            attemptParsing |=
+                (WildcardWidgetDefinition.class.equals(String.class)
+                    && token == JsonToken.VALUE_STRING);
+          }
+        }
+        if (attemptParsing) {
+          tmp = tree.traverse(jp.getCodec()).readValueAs(WildcardWidgetDefinition.class);
+          // TODO: there is no validation against JSON schema constraints
+          // (min, max, enum, pattern...), this does not perform a strict JSON
+          // validation, which means the 'match' count may be higher than it should be.
+          if (!((WildcardWidgetDefinition) tmp).unparsed) {
+            deserialized = tmp;
+            match++;
+          }
+          log.log(Level.FINER, "Input data matches schema 'WildcardWidgetDefinition'");
+        }
+      } catch (Exception e) {
+        // deserialization failed, continue
+        log.log(Level.FINER, "Input data does not match schema 'WildcardWidgetDefinition'", e);
+      }
+
       WidgetDefinition ret = new WidgetDefinition();
       if (match == 1) {
         ret.setActualInstance(deserialized);
@@ -1906,6 +1951,11 @@ public WidgetDefinition(TreeMapWidgetDefinition o) {
     setActualInstance(o);
   }
 
+  public WidgetDefinition(WildcardWidgetDefinition o) {
+    super("oneOf", Boolean.FALSE);
+    setActualInstance(o);
+  }
+
   static {
     schemas.put("AlertGraphWidgetDefinition", new GenericType<AlertGraphWidgetDefinition>() {});
     schemas.put("AlertValueWidgetDefinition", new GenericType<AlertValueWidgetDefinition>() {});
@@ -1946,6 +1996,7 @@ public WidgetDefinition(TreeMapWidgetDefinition o) {
     schemas.put("ToplistWidgetDefinition", new GenericType<ToplistWidgetDefinition>() {});
     schemas.put("TopologyMapWidgetDefinition", new GenericType<TopologyMapWidgetDefinition>() {});
     schemas.put("TreeMapWidgetDefinition", new GenericType<TreeMapWidgetDefinition>() {});
+    schemas.put("WildcardWidgetDefinition", new GenericType<WildcardWidgetDefinition>() {});
     JSON.registerDescendants(WidgetDefinition.class, Collections.unmodifiableMap(schemas));
   }
 
@@ -1968,7 +2019,7 @@ public Map<String, GenericType> getSchemas() {
    * SankeyWidgetDefinition, ServiceMapWidgetDefinition, ServiceSummaryWidgetDefinition,
    * SplitGraphWidgetDefinition, SunburstWidgetDefinition, TableWidgetDefinition,
    * TimeseriesWidgetDefinition, ToplistWidgetDefinition, TopologyMapWidgetDefinition,
-   * TreeMapWidgetDefinition
+   * TreeMapWidgetDefinition, WildcardWidgetDefinition
    *
    * <p>It could be an instance of the 'oneOf' schemas. The oneOf child schemas may themselves be a
    * composed schema (allOf, anyOf, oneOf).
@@ -2121,6 +2172,10 @@ public void setActualInstance(Object instance) {
       super.setActualInstance(instance);
       return;
     }
+    if (JSON.isInstanceOf(WildcardWidgetDefinition.class, instance, new HashSet<Class<?>>())) {
+      super.setActualInstance(instance);
+      return;
+    }
 
     if (JSON.isInstanceOf(UnparsedObject.class, instance, new HashSet<Class<?>>())) {
       super.setActualInstance(instance);
@@ -2140,7 +2195,7 @@ public void setActualInstance(Object instance) {
             + " ServiceMapWidgetDefinition, ServiceSummaryWidgetDefinition,"
             + " SplitGraphWidgetDefinition, SunburstWidgetDefinition, TableWidgetDefinition,"
             + " TimeseriesWidgetDefinition, ToplistWidgetDefinition, TopologyMapWidgetDefinition,"
-            + " TreeMapWidgetDefinition");
+            + " TreeMapWidgetDefinition, WildcardWidgetDefinition");
   }
 
   /**
@@ -2156,7 +2211,7 @@ public void setActualInstance(Object instance) {
    * ScatterPlotWidgetDefinition, SankeyWidgetDefinition, ServiceMapWidgetDefinition,
    * ServiceSummaryWidgetDefinition, SplitGraphWidgetDefinition, SunburstWidgetDefinition,
    * TableWidgetDefinition, TimeseriesWidgetDefinition, ToplistWidgetDefinition,
-   * TopologyMapWidgetDefinition, TreeMapWidgetDefinition
+   * TopologyMapWidgetDefinition, TreeMapWidgetDefinition, WildcardWidgetDefinition
    *
    * @return The actual instance (AlertGraphWidgetDefinition, AlertValueWidgetDefinition,
    *     BarChartWidgetDefinition, ChangeWidgetDefinition, CheckStatusWidgetDefinition,
@@ -2170,7 +2225,7 @@ public void setActualInstance(Object instance) {
    *     SankeyWidgetDefinition, ServiceMapWidgetDefinition, ServiceSummaryWidgetDefinition,
    *     SplitGraphWidgetDefinition, SunburstWidgetDefinition, TableWidgetDefinition,
    *     TimeseriesWidgetDefinition, ToplistWidgetDefinition, TopologyMapWidgetDefinition,
-   *     TreeMapWidgetDefinition)
+   *     TreeMapWidgetDefinition, WildcardWidgetDefinition)
    */
   @Override
   public Object getActualInstance() {
@@ -2575,4 +2630,15 @@ public TopologyMapWidgetDefinition getTopologyMapWidgetDefinition() throws Class
   public TreeMapWidgetDefinition getTreeMapWidgetDefinition() throws ClassCastException {
     return (TreeMapWidgetDefinition) super.getActualInstance();
   }
+
+  /**
+   * Get the actual instance of `WildcardWidgetDefinition`. If the actual instance is not
+   * `WildcardWidgetDefinition`, the ClassCastException will be thrown.
+   *
+   * @return The actual instance of `WildcardWidgetDefinition`
+   * @throws ClassCastException if the instance is not `WildcardWidgetDefinition`
+   */
+  public WildcardWidgetDefinition getWildcardWidgetDefinition() throws ClassCastException {
+    return (WildcardWidgetDefinition) super.getActualInstance();
+  }
 }