@datocms/cma-client 3.3.4 → 3.3.7

package/src/generated/SimpleSchemaTypes.ts

@@ -664,7 +664,6 @@ export type ItemInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 30, maximum is 500)
      */
     limit?: number;
-    [k: string]: unknown;
   };
   /**
    * Fields used to order results. You **must** specify also `filter[type]` with one element only to be able use this option. Format: `<field_name>_(ASC|DESC)`, where `<field_name>` can be either the API key of a model's field, or one of the following meta columns: `id`, `_updated_at`, `_created_at`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `_is_valid`, `position` (only for sortable models). You can pass multiple comma separated rules.
@@ -918,7 +917,6 @@ export type ItemVersionInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 15, maximum is 50)
      */
     limit?: number;
-    [k: string]: unknown;
   };
   [k: string]: unknown;
 };
@@ -987,7 +985,6 @@ export type UploadInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 30, maximum is 500)
      */
     limit?: number;
-    [k: string]: unknown;
   };
   [k: string]: unknown;
 };
@@ -1125,7 +1122,6 @@ export type SearchResultInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 20, maximum is 100)
      */
     limit?: number;
-    [k: string]: unknown;
   };
   /**
    * Attributes to filter search results
@@ -1273,8 +1269,82 @@ export type WebhookCallInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 30, maximum is 500)
      */
     limit?: number;
-    [k: string]: unknown;
   };
+  /**
+   * Attributes to filter
+   */
+  filter?: {
+    /**
+     * IDs to fetch, comma separated
+     */
+    ids?: string;
+    fields?: {
+      webhook_id?: {
+        eq?: string;
+      };
+      entity_type?: {
+        /**
+         * The subject of webhook triggering
+         */
+        eq?:
+          | 'item_type'
+          | 'item'
+          | 'upload'
+          | 'build_trigger'
+          | 'environment'
+          | 'maintenance_mode'
+          | 'sso_user'
+          | 'cda_cache_tags';
+      };
+      event_type?: {
+        /**
+         * The event that triggers the webhook call
+         */
+        eq?:
+          | 'create'
+          | 'update'
+          | 'delete'
+          | 'publish'
+          | 'unpublish'
+          | 'promote'
+          | 'deploy_started'
+          | 'deploy_succeeded'
+          | 'deploy_failed'
+          | 'change'
+          | 'invalidate';
+      };
+      status?: {
+        /**
+         * The current status
+         */
+        eq?: 'pending' | 'success' | 'failed' | 'rescheduled';
+      };
+      last_sent_at?: {
+        gt?: string;
+        lt?: string;
+      };
+      next_retry_at?: {
+        gt?: string;
+        lt?: string;
+      };
+      created_at?: {
+        gt?: string;
+        lt?: string;
+      };
+    };
+  };
+  /**
+   * Fields used to order results
+   */
+  order_by?:
+    | 'webhook_id_asc'
+    | 'webhook_id_desc'
+    | 'created_at_asc'
+    | 'created_at_desc'
+    | 'last_sent_at_asc'
+    | 'last_sent_at_desc'
+    | 'next_retry_at_asc'
+    | 'next_retry_at_desc';
   [k: string]: unknown;
 };
 /**
@@ -1588,7 +1658,6 @@ export type UploadTagInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 50, maximum is 500)
      */
     limit?: number;
-    [k: string]: unknown;
   };
   [k: string]: unknown;
 };
@@ -1639,7 +1708,6 @@ export type UploadSmartTagInstancesHrefSchema = {
      * The maximum number of entities to return (defaults to 50, maximum is 500)
      */
     limit?: number;
-    [k: string]: unknown;
   };
   [k: string]: unknown;
 };
@@ -4904,7 +4972,7 @@ export type JobData = {
  *     // single_line is a DatoCMS built-in editor that you can use with single-line string fields
  *     "editor": "single_line",
  *     // each built-in editor has specific settings
- *     "parameters": { "heading": true },
+ *     "parameters": { "heading": true, "placeholder": "My blog post title" },
  *     "addons": []
  *   },
  * }
@@ -4944,7 +5012,7 @@ export type JobData = {
  * {
  *   "appearance": {
  *     "editor": "single_line",
- *     "parameters": { "heading": true },
+ *     "parameters": { "heading": true, "placeholder": "My blog post title" },
  *     "addons": [
  *       {
  *         // "2138" is a the ID of a plugin exposing a manual addon editor
@@ -5645,9 +5713,10 @@ export type JobData = {
  *
  * Simple textual input for _Single-line string_ fields.
  *
- * | Parameter | Type      | Required | Description                                                                      |
- * | --------- | --------- | -------- | -------------------------------------------------------------------------------- |
- * | `heading` | `Boolean` | ✅        | Indicates if the field should be shown bigger, as a field representing a heading |
+ * | Parameter | Type      | Required | Description                                                                                    |
+ * | ------------- | --------- | -------- | ------------------------------------------------------------------------------------------ |
+ * | `heading`     | `Boolean` | ✅       | Indicates if the field should be shown bigger, as a field representing a heading           |
+ * | `placeholder` | `String`  |          | A placeholder that will be shown in the editor's input to provide editors with an example. |
  *
  * </details>
  *
@@ -5678,6 +5747,10 @@ export type JobData = {
  *
  * Basic textarea editor for _Multiple-paragraph text_ fields.
  *
+ * | Parameter     | Type     | Required | Description                                                                                |
+ * | ------------- | -------- | -------- | ------------------------------------------------------------------------------------------ |
+ * | `placeholder` | `String` |          | A placeholder that will be shown in the editor's input to provide editors with an example. |
+ *
  * </details>
  *
  * <details>
@@ -5697,9 +5770,10 @@ export type JobData = {
  *
  * Built-in editor for _Slug_ fields.
  *
- * | Parameter    | Type     | Required | Description                                                                            |
- * | ------------ | -------- | -------- | -------------------------------------------------------------------------------------- |
- * | `url_prefix` | `String` |          | A prefix that will be shown in the editor's form to give some context to your editors. |
+ * | Parameter     | Type     | Required | Description                                                                                |
+ * | ------------- | -------- | -------- | ------------------------------------------------------------------------------------------ |
+ * | `url_prefix`  | `String` |          | A prefix that will be shown in the editor's form to give some context to your editors.     |
+ * | `placeholder` | `String` |          | A placeholder that will be shown in the editor's input to provide editors with an example. |
  *
  * </details>
  *
@@ -5767,6 +5841,28 @@ export type JobData = {
  *
  * </details>
  *
+ * <details>
+ * <summary><code>integer</code></summary>
+ *
+ * Built-in editor for _Integer_ fields.
+ *
+ * | Parameter     | Type     | Required | Description                                                                                |
+ * | ------------- | -------- | -------- | ------------------------------------------------------------------------------------------ |
+ * | `placeholder` | `String` |          | A placeholder that will be shown in the editor's input to provide editors with an example. |
+ *
+ * </details>
+ *
+ * <details>
+ * <summary><code>float</code></summary>
+ *
+ * Built-in editor for _Float_ fields.
+ *
+ * | Parameter     | Type     | Required | Description                                                                                |
+ * | ------------- | -------- | -------- | ------------------------------------------------------------------------------------------ |
+ * | `placeholder` | `String` |          | A placeholder that will be shown in the editor's input to provide editors with an example. |
+ *
+ * </details>
+ *
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "field".
@@ -8647,12 +8743,46 @@ export type Webhook = {
    * Additional headers that will be sent
    */
   headers: {
-    [k: string]: unknown;
+    [k: string]: string;
   };
-  /**
-   * All the events you will be notified for
-   */
-  events: unknown[];
+  events: {
+    /**
+     * The subject of webhook triggering
+     */
+    entity_type:
+      | 'item_type'
+      | 'item'
+      | 'upload'
+      | 'build_trigger'
+      | 'environment'
+      | 'maintenance_mode'
+      | 'sso_user'
+      | 'cda_cache_tags';
+    event_types: (
+      | 'create'
+      | 'update'
+      | 'delete'
+      | 'publish'
+      | 'unpublish'
+      | 'promote'
+      | 'deploy_started'
+      | 'deploy_succeeded'
+      | 'deploy_failed'
+      | 'change'
+      | 'invalidate'
+    )[];
+    filters?:
+      | {
+          entity_type:
+            | 'item_type'
+            | 'item'
+            | 'build_trigger'
+            | 'environment'
+            | 'environment_type';
+          entity_ids: [string, ...string[]];
+        }[]
+      | null;
+  }[];
   /**
    * Specifies which API version to use when serializing entities in the webhook payload
    */
@@ -8661,6 +8791,10 @@ export type Webhook = {
    * Whether the you want records present in the payload to show blocks expanded or not
    */
   nested_items_in_payload: boolean;
+  /**
+   * If enabled, the system will attempt to retry the call several times when the webhook operation fails due to timeouts or errors.
+   */
+  auto_retry: boolean;
 };
 export type WebhookCreateTargetSchema = Webhook;
 export type WebhookUpdateTargetSchema = Webhook;
@@ -8712,12 +8846,46 @@ export type WebhookAttributes = {
    * Additional headers that will be sent
    */
   headers: {
-    [k: string]: unknown;
+    [k: string]: string;
   };
-  /**
-   * All the events you will be notified for
-   */
-  events: unknown[];
+  events: {
+    /**
+     * The subject of webhook triggering
+     */
+    entity_type:
+      | 'item_type'
+      | 'item'
+      | 'upload'
+      | 'build_trigger'
+      | 'environment'
+      | 'maintenance_mode'
+      | 'sso_user'
+      | 'cda_cache_tags';
+    event_types: (
+      | 'create'
+      | 'update'
+      | 'delete'
+      | 'publish'
+      | 'unpublish'
+      | 'promote'
+      | 'deploy_started'
+      | 'deploy_succeeded'
+      | 'deploy_failed'
+      | 'change'
+      | 'invalidate'
+    )[];
+    filters?:
+      | {
+          entity_type:
+            | 'item_type'
+            | 'item'
+            | 'build_trigger'
+            | 'environment'
+            | 'environment_type';
+          entity_ids: [string, ...string[]];
+        }[]
+      | null;
+  }[];
   /**
    * Specifies which API version to use when serializing entities in the webhook payload
    */
@@ -8726,6 +8894,10 @@ export type WebhookAttributes = {
    * Whether the you want records present in the payload to show blocks expanded or not
    */
   nested_items_in_payload: boolean;
+  /**
+   * If enabled, the system will attempt to retry the call several times when the webhook operation fails due to timeouts or errors.
+   */
+  auto_retry: boolean;
 };
 
 /**
@@ -8750,12 +8922,46 @@ export type WebhookCreateSchema = {
    * Additional headers that will be sent
    */
   headers: {
-    [k: string]: unknown;
+    [k: string]: string;
   };
-  /**
-   * All the events you will be notified for
-   */
-  events: unknown[];
+  events: {
+    /**
+     * The subject of webhook triggering
+     */
+    entity_type:
+      | 'item_type'
+      | 'item'
+      | 'upload'
+      | 'build_trigger'
+      | 'environment'
+      | 'maintenance_mode'
+      | 'sso_user'
+      | 'cda_cache_tags';
+    event_types: (
+      | 'create'
+      | 'update'
+      | 'delete'
+      | 'publish'
+      | 'unpublish'
+      | 'promote'
+      | 'deploy_started'
+      | 'deploy_succeeded'
+      | 'deploy_failed'
+      | 'change'
+      | 'invalidate'
+    )[];
+    filters?:
+      | {
+          entity_type:
+            | 'item_type'
+            | 'item'
+            | 'build_trigger'
+            | 'environment'
+            | 'environment_type';
+          entity_ids: [string, ...string[]];
+        }[]
+      | null;
+  }[];
   /**
    * HTTP Basic Authorization username
    */
@@ -8776,6 +8982,10 @@ export type WebhookCreateSchema = {
    * Whether the you want records present in the payload to show blocks expanded or not
    */
   nested_items_in_payload?: boolean;
+  /**
+   * If enabled, the system will attempt to retry the call several times when the webhook operation fails due to timeouts or errors.
+   */
+  auto_retry?: boolean;
 };
 
 /**
@@ -8801,12 +9011,46 @@ export type WebhookUpdateSchema = {
    * Additional headers that will be sent
    */
   headers?: {
-    [k: string]: unknown;
+    [k: string]: string;
   };
-  /**
-   * All the events you will be notified for
-   */
-  events?: unknown[];
+  events?: {
+    /**
+     * The subject of webhook triggering
+     */
+    entity_type:
+      | 'item_type'
+      | 'item'
+      | 'upload'
+      | 'build_trigger'
+      | 'environment'
+      | 'maintenance_mode'
+      | 'sso_user'
+      | 'cda_cache_tags';
+    event_types: (
+      | 'create'
+      | 'update'
+      | 'delete'
+      | 'publish'
+      | 'unpublish'
+      | 'promote'
+      | 'deploy_started'
+      | 'deploy_succeeded'
+      | 'deploy_failed'
+      | 'change'
+      | 'invalidate'
+    )[];
+    filters?:
+      | {
+          entity_type:
+            | 'item_type'
+            | 'item'
+            | 'build_trigger'
+            | 'environment'
+            | 'environment_type';
+          entity_ids: [string, ...string[]];
+        }[]
+      | null;
+  }[];
   /**
    * HTTP Basic Authorization username
    */
@@ -8827,6 +9071,10 @@ export type WebhookUpdateSchema = {
    * Whether the you want records present in the payload to show blocks expanded or not
    */
   nested_items_in_payload?: boolean;
+  /**
+   * If enabled, the system will attempt to retry the call several times when the webhook operation fails due to timeouts or errors.
+   */
+  auto_retry?: boolean;
 };
 
 /**
@@ -8841,13 +9089,32 @@ export type WebhookCall = {
   /**
    * The subject of webhook triggering
    */
-  entity_type: 'item' | 'item_type' | 'upload';
+  entity_type:
+    | 'item_type'
+    | 'item'
+    | 'upload'
+    | 'build_trigger'
+    | 'environment'
+    | 'maintenance_mode'
+    | 'sso_user'
+    | 'cda_cache_tags';
   /**
    * The event that triggers the webhook call
    */
-  event_type: 'create' | 'update' | 'delete' | 'publish' | 'unpublish';
-  /**
-   * The moment the call occurred
+  event_type:
+    | 'create'
+    | 'update'
+    | 'delete'
+    | 'publish'
+    | 'unpublish'
+    | 'promote'
+    | 'deploy_started'
+    | 'deploy_succeeded'
+    | 'deploy_failed'
+    | 'change'
+    | 'invalidate';
+  /**
+   * The moment the event was created
    */
   created_at: string;
   /**
@@ -8873,14 +9140,30 @@ export type WebhookCall = {
    */
   response_headers: {
     [k: string]: unknown;
-  };
+  } | null;
   /**
    * The body of the response
    */
   response_payload: string | null;
+  /**
+   * The number of retries attempted so far
+   */
+  attempted_auto_retries_count: number;
+  /**
+   * The last moment the call occurred
+   */
+  last_sent_at: string;
+  /**
+   * The date when the next retry attempt is scheduled to run. If no retry attempt is scheduled, it is set to null
+   */
+  next_retry_at: string | null;
+  /**
+   * The current status
+   */
+  status: 'pending' | 'success' | 'failed' | 'rescheduled';
   webhook: WebhookData;
 };
-
+export type WebhookCallSelfTargetSchema = WebhookCall;
 /**
  * JSON API data
  *
@@ -8902,13 +9185,32 @@ export type WebhookCallAttributes = {
   /**
    * The subject of webhook triggering
    */
-  entity_type: 'item' | 'item_type' | 'upload';
+  entity_type:
+    | 'item_type'
+    | 'item'
+    | 'upload'
+    | 'build_trigger'
+    | 'environment'
+    | 'maintenance_mode'
+    | 'sso_user'
+    | 'cda_cache_tags';
   /**
    * The event that triggers the webhook call
    */
-  event_type: 'create' | 'update' | 'delete' | 'publish' | 'unpublish';
-  /**
-   * The moment the call occurred
+  event_type:
+    | 'create'
+    | 'update'
+    | 'delete'
+    | 'publish'
+    | 'unpublish'
+    | 'promote'
+    | 'deploy_started'
+    | 'deploy_succeeded'
+    | 'deploy_failed'
+    | 'change'
+    | 'invalidate';
+  /**
+   * The moment the event was created
    */
   created_at: string;
   /**
@@ -8934,11 +9236,27 @@ export type WebhookCallAttributes = {
    */
   response_headers: {
     [k: string]: unknown;
-  };
+  } | null;
   /**
    * The body of the response
    */
   response_payload: string | null;
+  /**
+   * The number of retries attempted so far
+   */
+  attempted_auto_retries_count: number;
+  /**
+   * The last moment the call occurred
+   */
+  last_sent_at: string;
+  /**
+   * The date when the next retry attempt is scheduled to run. If no retry attempt is scheduled, it is set to null
+   */
+  next_retry_at: string | null;
+  /**
+   * The current status
+   */
+  status: 'pending' | 'success' | 'failed' | 'rescheduled';
 };
 
 /**

package/src/generated/resources/Webhook.ts

@@ -29,6 +29,7 @@ export default class Webhook extends BaseResource {
           'enabled',
           'payload_api_version',
           'nested_items_in_payload',
+          'auto_retry',
         ],
         relationships: [],
       }),
@@ -85,6 +86,7 @@ export default class Webhook extends BaseResource {
           'enabled',
           'payload_api_version',
           'nested_items_in_payload',
+          'auto_retry',
         ],
         relationships: [],
       }),

package/src/generated/resources/WebhookCall.ts

@@ -95,6 +95,39 @@ export default class WebhookCall extends BaseResource {
     );
   }
 
+  /**
+   * Retrieve a webhook call
+   *
+   * Read more: https://www.datocms.com/docs/content-management-api/resources/webhook-call/self
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
+   */
+  find(webhookCallId: string | SimpleSchemaTypes.WebhookCallData) {
+    return this.rawFind(Utils.toId(webhookCallId)).then((body) =>
+      Utils.deserializeResponseBody<SimpleSchemaTypes.WebhookCallSelfTargetSchema>(
+        body,
+      ),
+    );
+  }
+
+  /**
+   * Retrieve a webhook call
+   *
+   * Read more: https://www.datocms.com/docs/content-management-api/resources/webhook-call/self
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
+   */
+  rawFind(
+    webhookCallId: string,
+  ): Promise<SchemaTypes.WebhookCallSelfTargetSchema> {
+    return this.client.request<SchemaTypes.WebhookCallSelfTargetSchema>({
+      method: 'GET',
+      url: `/webhook_calls/${webhookCallId}`,
+    });
+  }
+
   /**
    * Re-send the webhook call
    *