@datocms/cma-client 5.5.0-alpha.1 → 5.5.0

package/src/generated/Client.ts

@@ -151,7 +151,7 @@ export class Client {
       ...this.config,
       ...options,
       logFn: this.config.logFn || console.log,
-      userAgent: '@datocms/cma-client v5.5.0-alpha.1',
+      userAgent: '@datocms/cma-client v5.5.0',
       baseUrl: this.baseUrl,
       preCallStack: new Error().stack,
       extraHeaders: {

package/src/generated/RawApiTypes.ts

@@ -8277,14 +8277,6 @@ export type ItemVersionMeta = {
    * Whether the record version is the published version or not
    */
   is_published: boolean;
-  /**
-   * Date this version became the published version of the record, or `null` if it has never been published. May also be `null` for versions that were published before publication-history tracking was introduced; in that case, fall back to `is_published` to determine the live status.
-   */
-  published_from: string | null;
-  /**
-   * Date this version stopped being the published version of the record (either replaced by a newer published version, or explicitly unpublished). `null` when the version is currently published or has never been published.
-   */
-  published_until: string | null;
   /**
    * Whether the record version is the most recent version or not
    */
@@ -8624,42 +8616,25 @@ export type UploadAttributes = {
    */
   mux_mp4_highest_res: null | 'high' | 'medium' | 'low';
   /**
-   * For each of the project's locales, the default metadata to apply if nothing is specified at record's level.
+   * Per-asset default metadata applied when no record-level overrides are present. `alt`, `title`, and `custom_data` are objects keyed by locale; `focal_point` is a single value per asset (only meaningful for image assets). See [non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) for more info.
    */
   default_field_metadata: {
+    alt: LocalizedAlt;
+    title: LocalizedTitle;
+    custom_data: LocalizedCustomData;
     /**
-     * This interface was referenced by `undefined`'s JSON-Schema definition
-     * via the `patternProperty` "^(?<languagecode>[a-z]{0,3}(-[A-Za-z]+)?(-[A-Z]{0,3})?)$".
+     * Focal point (only for image assets)
      */
-    [k: string]: {
+    focal_point: {
       /**
-       * Alternate text for the asset
+       * Horizontal position expressed as float between 0 and 1
        */
-      alt: string | null;
+      x: number;
       /**
-       * Title for the asset
+       * Vertical position expressed as float between 0 and 1
        */
-      title: string | null;
-      /**
-       * Object with arbitrary metadata
-       */
-      custom_data: {
-        [k: string]: unknown;
-      };
-      /**
-       * Focal point (only for image assets)
-       */
-      focal_point: {
-        /**
-         * Horizontal position expressed as float between 0 and 1
-         */
-        x: number;
-        /**
-         * Vertical position expressed as float between 0 and 1
-         */
-        y: number;
-      } | null;
-    };
+      y: number;
+    } | null;
   };
   /**
    * Is this upload an image?
@@ -8713,6 +8688,44 @@ export type UploadAttributes = {
     alpha: number;
   }[];
 };
+/**
+ * Alternate text per locale
+ */
+export type LocalizedAlt = {
+  /**
+   * Alternate text for the asset in this locale
+   *
+   * This interface was referenced by `LocalizedAlt`'s JSON-Schema definition
+   * via the `patternProperty` "^(?<languagecode>[a-z]{0,3}(-[A-Za-z]+)?(-[A-Z]{0,3})?)$".
+   */
+  [k: string]: string | null;
+};
+/**
+ * Title per locale
+ */
+export type LocalizedTitle = {
+  /**
+   * Title for the asset in this locale
+   *
+   * This interface was referenced by `LocalizedTitle`'s JSON-Schema definition
+   * via the `patternProperty` "^(?<languagecode>[a-z]{0,3}(-[A-Za-z]+)?(-[A-Z]{0,3})?)$".
+   */
+  [k: string]: string | null;
+};
+/**
+ * Object with arbitrary metadata, per locale
+ */
+export type LocalizedCustomData = {
+  /**
+   * Arbitrary metadata for the asset in this locale
+   *
+   * This interface was referenced by `LocalizedCustomData`'s JSON-Schema definition
+   * via the `patternProperty` "^(?<languagecode>[a-z]{0,3}(-[A-Za-z]+)?(-[A-Z]{0,3})?)$".
+   */
+  [k: string]: {
+    [k: string]: unknown;
+  };
+};
 /**
  * JSON API links
  *
@@ -8799,42 +8812,25 @@ export type UploadCreateSchema = {
        */
       notes?: string | null;
       /**
-       * For each of the project's locales, the default metadata to apply if nothing is specified at record's level.
+       * Patch the asset's default metadata. Send any subset of `alt`/`title`/`custom_data`/`focal_point` — missing keys preserve their stored values. See the response shape for the full structure and per-key semantics.
        */
       default_field_metadata?: {
+        alt?: LocalizedAlt;
+        title?: LocalizedTitle;
+        custom_data?: LocalizedCustomData;
         /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^(?<languagecode>[a-z]{0,3}(-[A-Za-z]+)?(-[A-Z]{0,3})?)$".
+         * Focal point (only for image assets)
          */
-        [k: string]: {
+        focal_point?: {
           /**
-           * Alternate text for the asset
+           * Horizontal position expressed as float between 0 and 1
            */
-          alt?: string | null;
+          x: number;
           /**
-           * Title for the asset
+           * Vertical position expressed as float between 0 and 1
            */
-          title?: string | null;
-          /**
-           * Object with arbitrary metadata
-           */
-          custom_data?: {
-            [k: string]: unknown;
-          };
-          /**
-           * Focal point (only for image assets)
-           */
-          focal_point?: {
-            /**
-             * Horizontal position expressed as float between 0 and 1
-             */
-            x: number;
-            /**
-             * Vertical position expressed as float between 0 and 1
-             */
-            y: number;
-          } | null;
-        };
+          y: number;
+        } | null;
       };
       /**
        * Tags
@@ -8924,42 +8920,25 @@ export type UploadUpdateSchema = {
        */
       tags?: string[];
       /**
-       * For each of the project's locales, the default metadata to apply if nothing is specified at record's level.
+       * Patch the asset's default metadata. Send any subset of `alt`/`title`/`custom_data`/`focal_point` — missing keys preserve their stored values. See the response shape for the full structure and per-key semantics.
        */
       default_field_metadata?: {
+        alt?: LocalizedAlt;
+        title?: LocalizedTitle;
+        custom_data?: LocalizedCustomData;
         /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^(?<languagecode>[a-z]{0,3}(-[A-Za-z]+)?(-[A-Z]{0,3})?)$".
+         * Focal point (only for image assets)
          */
-        [k: string]: {
-          /**
-           * Alternate text for the asset
-           */
-          alt?: string | null;
-          /**
-           * Title for the asset
-           */
-          title?: string | null;
+        focal_point?: {
           /**
-           * Object with arbitrary metadata
+           * Horizontal position expressed as float between 0 and 1
            */
-          custom_data?: {
-            [k: string]: unknown;
-          };
+          x: number;
           /**
-           * Focal point (only for image assets)
+           * Vertical position expressed as float between 0 and 1
            */
-          focal_point?: {
-            /**
-             * Horizontal position expressed as float between 0 and 1
-             */
-            x: number;
-            /**
-             * Vertical position expressed as float between 0 and 1
-             */
-            y: number;
-          } | null;
-        };
+          y: number;
+        } | null;
       };
       [k: string]: unknown;
     };
@@ -11565,32 +11544,125 @@ export type PublicInfoAttributes = {
    */
   custom_i18n_messages_template_url: null | string;
   /**
-   * Specifies the color-scheme for the project
+   * Specifies the color-scheme for the project. For monochromatic themes the response only includes type and hue — frontends must derive the palette from the hue. For custom themes the primary_color, light_color, accent_color, and dark_color fields are returned.
    */
   theme: {
-    primary_color: {
+    /**
+     * Whether the project is using a custom color palette or a monochromatic one derived from a hue.
+     */
+    type: 'custom' | 'monochromatic';
+    /**
+     * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
+     */
+    hue: number | null;
+    /**
+     * An integer color channel value (0-255)
+     */
+    color_channel?: number;
+    /**
+     * An RGBA color value
+     */
+    color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
       [k: string]: unknown;
     };
-    light_color: {
+    /**
+     * An RGBA color value
+     */
+    primary_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
+      alpha: number;
+    };
+    /**
+     * An RGBA color value
+     */
+    light_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
+      red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
+      green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
+      blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
-    accent_color: {
+    /**
+     * An RGBA color value
+     */
+    accent_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
-    dark_color: {
+    /**
+     * An RGBA color value
+     */
+    dark_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
   };
@@ -11955,7 +12027,7 @@ export type SiteAttributes = {
     };
   };
   /**
-   * Specifies the theme to use in administrative area
+   * Specifies the theme to use in administrative area. For monochromatic themes the response only includes type, hue, and logo — frontends must derive the palette from the hue. For custom themes the primary_color, light_color, accent_color, and dark_color fields are returned.
    */
   theme: {
     /**
@@ -11966,28 +12038,113 @@ export type SiteAttributes = {
      * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
      */
     hue: number | null;
-    primary_color: {
+    /**
+     * An integer color channel value (0-255)
+     */
+    color_channel?: number;
+    /**
+     * An RGBA color value
+     */
+    color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
-    light_color: {
+    /**
+     * An RGBA color value
+     */
+    primary_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
+      alpha: number;
+    };
+    /**
+     * An RGBA color value
+     */
+    light_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
+      red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
+      green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
+      blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
-    accent_color: {
+    /**
+     * An RGBA color value
+     */
+    accent_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
-    dark_color: {
+    /**
+     * An RGBA color value
+     */
+    dark_color?: {
+      /**
+       * An integer color channel value (0-255)
+       */
       red: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       green: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       blue: number;
+      /**
+       * An integer color channel value (0-255)
+       */
       alpha: number;
     };
     /**
@@ -12106,6 +12263,10 @@ export type SiteMeta = {
    * Whether the [Milliseconds in datetime](https://www.datocms.com/product-updates/milliseconds-in-datetime) opt-in product update is active or not
    */
   milliseconds_in_datetime: boolean;
+  /**
+   * Whether the [Non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) opt-in product update is active or not
+   */
+  non_localized_focal_points: boolean;
 };
 /**
  * JSON API data
@@ -12206,28 +12367,88 @@ export type SiteUpdateSchema = {
              * The upload ID that is used as the logo for the project
              */
             logo: string | null;
+            /**
+             * An RGBA color value
+             */
             primary_color: {
+              /**
+               * An integer color channel value (0-255)
+               */
               red: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               green: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               blue: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               alpha: number;
             };
+            /**
+             * An RGBA color value
+             */
             light_color: {
+              /**
+               * An integer color channel value (0-255)
+               */
               red: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               green: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               blue: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               alpha: number;
             };
+            /**
+             * An RGBA color value
+             */
             accent_color: {
+              /**
+               * An integer color channel value (0-255)
+               */
               red: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               green: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               blue: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               alpha: number;
             };
+            /**
+             * An RGBA color value
+             */
             dark_color?: {
+              /**
+               * An integer color channel value (0-255)
+               */
               red: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               green: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               blue: number;
+              /**
+               * An integer color channel value (0-255)
+               */
               alpha: number;
             };
             [k: string]: unknown;
@@ -12298,6 +12519,10 @@ export type SiteUpdateSchema = {
        * Whether the [Milliseconds in datetime](https://www.datocms.com/product-updates/milliseconds-in-datetime) opt-in product update is active or not
        */
       milliseconds_in_datetime?: boolean;
+      /**
+       * Whether the [Non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) opt-in product update is active or not
+       */
+      non_localized_focal_points?: boolean;
     };
     relationships?: {
       sso_default_role?: {
@@ -12397,6 +12622,13 @@ export type SiteActivateImprovedItemsListingTargetSchema = {
 export type SiteActivateMillisecondsInDatetimeTargetSchema = {
   data: Site;
 };
+/**
+ * This interface was referenced by `Site`'s JSON-Schema
+ * via the `activate_non_localized_focal_points.targetSchema` link.
+ */
+export type SiteActivateNonLocalizedFocalPointsTargetSchema = {
+  data: Site;
+};
 /**
  * This interface was referenced by `Site`'s JSON-Schema
  * via the `update_assets_cdn_default_settings.schema` link.

package/src/generated/resources/Site.ts

@@ -457,6 +457,43 @@ export default class Site extends BaseResource {
     );
   }
 
+  /**
+   * Activate non-localized focal points
+   *
+   * Read more: https://www.datocms.com/docs/content-management-api/resources/site/activate_non_localized_focal_points
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
+   *
+   * @deprecated This API call is to be considered private and might change without notice
+   */
+  activateNonLocalizedFocalPoints() {
+    return this.rawActivateNonLocalizedFocalPoints().then((body) =>
+      Utils.deserializeResponseBody<ApiTypes.SiteActivateNonLocalizedFocalPointsTargetSchema>(
+        body,
+      ),
+    );
+  }
+
+  /**
+   * Activate non-localized focal points
+   *
+   * Read more: https://www.datocms.com/docs/content-management-api/resources/site/activate_non_localized_focal_points
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
+   *
+   * @deprecated This API call is to be considered private and might change without notice
+   */
+  rawActivateNonLocalizedFocalPoints(): Promise<RawApiTypes.SiteActivateNonLocalizedFocalPointsTargetSchema> {
+    return this.client.request<RawApiTypes.SiteActivateNonLocalizedFocalPointsTargetSchema>(
+      {
+        method: 'PUT',
+        url: '/site/activate-non-localized-focal-points',
+      },
+    );
+  }
+
   /**
    * Update CDN settings default assets
    *

package/src/generated/resources/index.ts

@@ -18,7 +18,7 @@ export { default as BuildEvent } from './BuildEvent.js';
 export { default as SearchIndexEvent } from './SearchIndexEvent.js';
 export { default as Item } from './Item.js';
 export { default as ItemVersion } from './ItemVersion.js';
-export { default as Upload } from './Upload.js';
+export { default as Upload } from '../../resources/Upload.js';
 export { default as UploadRequest } from './UploadRequest.js';
 export { default as UploadTrack } from './UploadTrack.js';
 export { default as ScheduledPublication } from './ScheduledPublication.js';

package/src/index.ts

@@ -4,6 +4,10 @@ export * from './fieldTypes/index.js';
 export { Client } from './generated/Client.js';
 export type { ClientConfigOptions } from './generated/Client.js';
 export * as Resources from './generated/resources/index.js';
+export type {
+  UploadLocaleKeyedDefaultFieldMetadata,
+  UploadLocaleKeyedDefaultFieldMetadataInRequest,
+} from './resources/Upload.js';
 export * from './utilities/buildBlockRecord.js';
 export * from './utilities/duplicateBlockRecord.js';
 export * from './utilities/fieldsContainingReferences.js';