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

package/dist/types/generated/RawApiTypes.d.ts

@@ -7815,14 +7815,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
      */
@@ -8142,42 +8134,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]: {
-            /**
-             * 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;
     };
     /**
      * Is this upload an image?
@@ -8231,6 +8206,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
  *
@@ -8312,42 +8325,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]: {
-                    /**
-                     * Alternate text for the asset
-                     */
-                    alt?: string | null;
+                focal_point?: {
                     /**
-                     * Title for the asset
+                     * Horizontal position expressed as float between 0 and 1
                      */
-                    title?: string | null;
-                    /**
-                     * Object with arbitrary metadata
-                     */
-                    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;
             };
             /**
              * Tags
@@ -8437,42 +8433,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;
+                focal_point?: {
                     /**
-                     * Title for the asset
+                     * Horizontal position expressed as float between 0 and 1
                      */
-                    title?: string | null;
-                    /**
-                     * Object with arbitrary metadata
-                     */
-                    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;
         };
@@ -10953,32 +10932,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;
         };
-        accent_color: {
+        /**
+         * 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;
         };
-        dark_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;
+        };
+        /**
+         * 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;
         };
     };
@@ -11343,7 +11415,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: {
         /**
@@ -11354,28 +11426,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;
         };
-        accent_color: {
+        /**
+         * 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;
         };
-        dark_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;
+        };
+        /**
+         * 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;
         };
         /**
@@ -11494,6 +11651,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
@@ -11592,28 +11753,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;
@@ -11684,6 +11905,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?: {
@@ -11783,6 +12008,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/dist/types/generated/resources/Site.d.ts

@@ -259,6 +259,28 @@ export default class Site extends BaseResource {
      * @deprecated This API call is to be considered private and might change without notice
      */
     rawActivateMillisecondsInDatetime(): Promise<RawApiTypes.SiteActivateMillisecondsInDatetimeTargetSchema>;
+    /**
+     * 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(): Promise<ApiTypes.Site>;
+    /**
+     * 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>;
     /**
      * Update CDN settings default assets
      *

package/dist/types/generated/resources/index.d.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/dist/types/index.d.ts

@@ -4,6 +4,7 @@ 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';