@datocms/cma-client 1.1.2 → 1.1.4

package/src/generated/SimpleSchemaTypes.ts

@@ -307,6 +307,23 @@ export type MenuItemType = 'menu_item';
  * via the `definition` "type".
  */
 export type ItemTypeType = 'item_type';
+/**
+ * JSON API type field
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
+ * via the `definition` "type".
+ */
+export type ItemTypeFilterType = 'item_type_filter';
+/**
+ * ID of filter
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
+ * via the `definition` "identity".
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
+ * via the `definition` "id".
+ */
+export type ItemTypeFilterIdentity = string;
 /**
  * This interface was referenced by `MenuItem`'s JSON-Schema
  * via the `instances.targetSchema` link.
@@ -1167,23 +1184,6 @@ export type WebhookCallInstancesHrefSchema = {
  * via the `instances.targetSchema` link.
  */
 export type BuildTriggerInstancesTargetSchema = BuildTrigger[];
-/**
- * ID of filter
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
- * via the `definition` "identity".
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
- * via the `definition` "id".
- */
-export type ItemTypeFilterIdentity = string;
-/**
- * JSON API type field
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
- * via the `definition` "type".
- */
-export type ItemTypeFilterType = 'item_type_filter';
 /**
  * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
  * via the `instances.targetSchema` link.
@@ -3897,10 +3897,11 @@ export type MenuItem = {
    */
   position: number;
   /**
-   * Opens link in new tab (used together with `external_url`)
+   * Opens link in new tab (to be used together with `external_url`)
    */
   open_in_new_tab: boolean;
   item_type: ItemTypeData | null;
+  item_type_filter: ItemTypeFilterData | null;
   parent: null | MenuItemData;
   children: MenuItemData[];
 };
@@ -3919,6 +3920,17 @@ export type ItemTypeData = {
   id: ItemTypeIdentity;
 };
 
+/**
+ * JSON API data
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
+ * via the `definition` "data".
+ */
+export type ItemTypeFilterData = {
+  type: ItemTypeFilterType;
+  id: ItemTypeFilterIdentity;
+};
+
 /**
  * JSON API data
  *
@@ -3950,7 +3962,7 @@ export type MenuItemAttributes = {
    */
   position: number;
   /**
-   * Opens link in new tab (used together with `external_url`)
+   * Opens link in new tab (to be used together with `external_url`)
    */
   open_in_new_tab: boolean;
 };
@@ -3963,6 +3975,7 @@ export type MenuItemAttributes = {
  */
 export type MenuItemRelationships = {
   item_type: ItemTypeData | null;
+  item_type_filter: ItemTypeFilterData | null;
   parent: null | MenuItemData;
   children: MenuItemData[];
 };
@@ -3984,12 +3997,13 @@ export type MenuItemCreateSchema = {
   /**
    * Ordering index
    */
-  position: number;
+  position?: number;
   /**
-   * Opens link in new tab (used together with `external_url`)
+   * Opens link in new tab (to be used together with `external_url`)
    */
   open_in_new_tab?: boolean;
   item_type?: ItemTypeData | null;
+  item_type_filter?: ItemTypeFilterData | null;
   parent?: null | MenuItemData;
 };
 
@@ -4013,10 +4027,11 @@ export type MenuItemUpdateSchema = {
    */
   position?: number;
   /**
-   * Opens link in new tab (used together with `external_url`)
+   * Opens link in new tab (to be used together with `external_url`)
    */
   open_in_new_tab?: boolean;
   item_type?: ItemTypeData | null;
+  item_type_filter?: ItemTypeFilterData | null;
   parent?: null | MenuItemData;
 };
 
@@ -4860,9 +4875,9 @@ export type JobData = {
  *
  * Only accept assets with specific file extensions.
  *
- * | Parameter         | Type                                      | Required | Description                    |
- * | ----------------- | ----------------------------------------- | -------- | ------------------------------ |
- * | `extensions`      | `Array<String>`                           |          | Set of allowed file extensions |
+ * | Parameter         | Type                                                               | Required | Description                    |
+ * | ----------------- | ------------------------------------------------------------------ | -------- | ------------------------------ |
+ * | `extensions`      | `Array<String>`                                                    |          | Set of allowed file extensions |
  * | `predefined_list` | one of `"image"`, `"transformable_image"`, `"video"`, `"document"` |          | Allowed file type              |
  *
  * Only one of the parameters must be specified.
@@ -5305,13 +5320,14 @@ export type JobData = {
  *
  * Built-in editor for _Structured text_ fields.
  *
- * | Parameter                 | Type            | Required | Description                                                                                                                                   |
- * | ------------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
- * | `nodes`                   | `Array<String>` | ✅       | Specify which nodes the field should allow. Valid values: `"blockquote"`, `"code"`, `"heading"`, `"link"`, `"list"`, `"thematicBreak"`        |
- * | `marks`                   | `Array<String>` | ✅       | Specify which marks the field should allow. Valid values: `"strong"`, `"emphasis"`, `"underline"`, `"strikethrough"`, `"code"`, `"highlight"` |
- * | `blocks_start_collapsed`  | `Boolean`       |          | Whether you want block nodes collapsed by default or not                                                                                      |
- * | `show_links_target_blank` | `Boolean`       |          | Whether you want to show the "Open this link in a new tab?" checkbox, that fills in the `target: "_blank"` meta attribute for links           |
- * | `show_links_meta_editor`  | `Boolean`       |          | Whether you want to show the complete meta editor for links                                                                                   |
+ * | Parameter                 | Type             | Required | Description                                                                                                                                   |
+ * | ------------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+ * | `nodes`                   | `Array<String>`  | ✅       | Specify which nodes the field should allow. Valid values: `"blockquote"`, `"code"`, `"heading"`, `"link"`, `"list"`, `"thematicBreak"`        |
+ * | `marks`                   | `Array<String>`  | ✅       | Specify which marks the field should allow. Valid values: `"strong"`, `"emphasis"`, `"underline"`, `"strikethrough"`, `"code"`, `"highlight"` |
+ * | `heading_levels`          | `Array<Integer>` | ✅       | If `nodes` includes `"heading"`, specify which heading levels the field should allow. Valid values: numbers between 1 and 6                   |
+ * | `blocks_start_collapsed`  | `Boolean`        |          | Whether you want block nodes collapsed by default or not                                                                                      |
+ * | `show_links_target_blank` | `Boolean`        |          | Whether you want to show the "Open this link in a new tab?" checkbox, that fills in the `target: "_blank"` meta attribute for links           |
+ * | `show_links_meta_editor`  | `Boolean`        |          | Whether you want to show the complete meta editor for links                                                                                   |
  *
  * </details>
  *
@@ -8284,6 +8300,37 @@ export type ItemTypeFilter = {
   filter: {
     [k: string]: unknown;
   };
+  /**
+   * The columns to show with this filter
+   */
+  columns:
+    | [
+        {
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        },
+        ...{
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        }[],
+      ]
+    | null;
+  /**
+   * The ordering to apply with this filter, or `null` for the default model ordering. It follows the form of the `order_by` query parameter of the [List all records](https://www.datocms.com/docs/content-management-api/resources/item/instances) endpoint.
+   */
+  order_by: string | null;
   /**
    * Whether it's a shared filter or not
    */
@@ -8294,17 +8341,6 @@ export type ItemTypeFilterCreateTargetSchema = ItemTypeFilter;
 export type ItemTypeFilterUpdateTargetSchema = ItemTypeFilter;
 export type ItemTypeFilterSelfTargetSchema = ItemTypeFilter;
 export type ItemTypeFilterDestroyTargetSchema = ItemTypeFilter;
-/**
- * JSON API data
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema
- * via the `definition` "data".
- */
-export type ItemTypeFilterData = {
-  type: ItemTypeFilterType;
-  id: ItemTypeFilterIdentity;
-};
-
 /**
  * JSON API attributes
  *
@@ -8322,6 +8358,37 @@ export type ItemTypeFilterAttributes = {
   filter: {
     [k: string]: unknown;
   };
+  /**
+   * The columns to show with this filter
+   */
+  columns:
+    | [
+        {
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        },
+        ...{
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        }[],
+      ]
+    | null;
+  /**
+   * The ordering to apply with this filter, or `null` for the default model ordering. It follows the form of the `order_by` query parameter of the [List all records](https://www.datocms.com/docs/content-management-api/resources/item/instances) endpoint.
+   */
+  order_by: string | null;
   /**
    * Whether it's a shared filter or not
    */
@@ -8351,13 +8418,44 @@ export type ItemTypeFilterCreateSchema = {
   /**
    * The actual filter. It follows the form of the `filter` query parameter of the [List all records](https://www.datocms.com/docs/content-management-api/resources/item/instances) endpoint.
    */
-  filter: {
+  filter?: {
     [k: string]: unknown;
   };
+  /**
+   * The columns to show with this filter
+   */
+  columns?:
+    | [
+        {
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        },
+        ...{
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        }[],
+      ]
+    | null;
+  /**
+   * The ordering to apply with this filter, or `null` for the default model ordering. It follows the form of the `order_by` query parameter of the [List all records](https://www.datocms.com/docs/content-management-api/resources/item/instances) endpoint.
+   */
+  order_by?: string | null;
   /**
    * Whether it's a shared filter or not
    */
-  shared: boolean;
+  shared?: boolean;
   item_type: ItemTypeData;
 };
 
@@ -8371,7 +8469,38 @@ export type ItemTypeFilterUpdateSchema = {
   /**
    * The name of the filter
    */
-  name: string;
+  name?: string;
+  /**
+   * The columns to show with this filter
+   */
+  columns?:
+    | [
+        {
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        },
+        ...{
+          /**
+           * Can be either the API key of a model's field, or one of the following meta columns: `id`, `_preview`, `_updated_at`, `_created_at`, `_creator`, `_status`, `_published_at`, `_first_published_at`, `_publication_scheduled_at`, `_unpublishing_scheduled_at`, `position` (only for sortable models), `_stage (only for models associated with a workflow).
+           */
+          name: string;
+          /**
+           * The percentage width for the column (float, from 0 to 1.0)
+           */
+          width: number;
+        }[],
+      ]
+    | null;
+  /**
+   * The ordering to apply with this filter, or `null` for the default model ordering. It follows the form of the `order_by` query parameter of the [List all records](https://www.datocms.com/docs/content-management-api/resources/item/instances) endpoint.
+   */
+  order_by?: string | null;
   /**
    * Whether it's a shared filter or not
    */
@@ -8379,9 +8508,10 @@ export type ItemTypeFilterUpdateSchema = {
   /**
    * The actual filter. It follows the form of the `filter` query parameter of the [List all records](https://www.datocms.com/docs/content-management-api/resources/item/instances) endpoint.
    */
-  filter: {
+  filter?: {
     [k: string]: unknown;
   };
+  item_type?: ItemTypeData;
 };
 
 /**

package/src/generated/resources/AccessToken.ts

@@ -10,6 +10,9 @@ export default class AccessToken extends BaseResource {
    * Create a new API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/create
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   create(body: SimpleSchemaTypes.AccessTokenCreateSchema) {
     return this.rawCreate(
@@ -34,6 +37,9 @@ export default class AccessToken extends BaseResource {
    * Create a new API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/create
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawCreate(
     body: SchemaTypes.AccessTokenCreateSchema,
@@ -49,6 +55,9 @@ export default class AccessToken extends BaseResource {
    * Update an API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/update
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   update(
     accessTokenId: string | SimpleSchemaTypes.AccessTokenData,
@@ -78,6 +87,9 @@ export default class AccessToken extends BaseResource {
    * Update an API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/update
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawUpdate(
     accessTokenId: string,
@@ -94,6 +106,9 @@ export default class AccessToken extends BaseResource {
    * List all API tokens
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/instances
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   list() {
     return this.rawList().then((body) =>
@@ -107,6 +122,9 @@ export default class AccessToken extends BaseResource {
    * List all API tokens
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/instances
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawList(): Promise<SchemaTypes.AccessTokenInstancesTargetSchema> {
     return this.client.request<SchemaTypes.AccessTokenInstancesTargetSchema>({
@@ -119,6 +137,9 @@ export default class AccessToken extends BaseResource {
    * Retrieve an API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/self
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   find(accessTokenId: string | SimpleSchemaTypes.AccessTokenData) {
     return this.rawFind(Utils.toId(accessTokenId)).then((body) =>
@@ -132,6 +153,9 @@ export default class AccessToken extends BaseResource {
    * Retrieve an API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/self
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawFind(
     accessTokenId: string,
@@ -146,6 +170,9 @@ export default class AccessToken extends BaseResource {
    * Rotate API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/regenerate_token
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   regenerateToken(accessTokenId: string | SimpleSchemaTypes.AccessTokenData) {
     return this.rawRegenerateToken(Utils.toId(accessTokenId)).then((body) =>
@@ -159,6 +186,9 @@ export default class AccessToken extends BaseResource {
    * Rotate API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/regenerate_token
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawRegenerateToken(
     accessTokenId: string,
@@ -175,6 +205,9 @@ export default class AccessToken extends BaseResource {
    * Delete an API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/destroy
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   destroy(
     accessTokenId: string | SimpleSchemaTypes.AccessTokenData,
@@ -192,6 +225,9 @@ export default class AccessToken extends BaseResource {
    * Delete an API token
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/access-token/destroy
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawDestroy(
     accessTokenId: string,

package/src/generated/resources/AuditLogEvent.ts

@@ -10,6 +10,9 @@ export default class AuditLogEvent extends BaseResource {
    * List Audit Log events
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/audit-log_event/query
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   query(body: SimpleSchemaTypes.AuditLogEventQuerySchema) {
     return this.rawQuery(
@@ -29,6 +32,9 @@ export default class AuditLogEvent extends BaseResource {
    * List Audit Log events
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/audit-log_event/query
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawQuery(
     body: SchemaTypes.AuditLogEventQuerySchema,

package/src/generated/resources/BuildEvent.ts

@@ -10,6 +10,9 @@ export default class BuildEvent extends BaseResource {
    * List all deploy events
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/build-event/instances
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   list() {
     return this.rawList().then((body) =>
@@ -23,6 +26,9 @@ export default class BuildEvent extends BaseResource {
    * List all deploy events
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/build-event/instances
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawList(): Promise<SchemaTypes.BuildEventInstancesTargetSchema> {
     return this.client.request<SchemaTypes.BuildEventInstancesTargetSchema>({
@@ -35,6 +41,9 @@ export default class BuildEvent extends BaseResource {
    * Retrieve a deploy event
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/build-event/self
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   find(buildEventId: string | SimpleSchemaTypes.BuildEventData) {
     return this.rawFind(Utils.toId(buildEventId)).then((body) =>
@@ -48,6 +57,9 @@ export default class BuildEvent extends BaseResource {
    * Retrieve a deploy event
    *
    * Read more: https://www.datocms.com/docs/content-management-api/resources/build-event/self
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
    */
   rawFind(
     buildEventId: string,