@datocms/cma-client 5.5.0-alpha.0 → 5.5.0-alpha.2

package/src/generated/RawApiTypes.ts

@@ -8616,17 +8616,14 @@ export type UploadAttributes = {
    */
   mux_mp4_highest_res: null | 'high' | 'medium' | 'low';
   /**
-   * 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 non-localized — a single value per asset, applied across every locale (only meaningful for image assets).
-   *
-   * > [!PROTIP] 📘 Requires the `non_localized_focal_points` environment opt-in
-   * > This shape is returned and accepted in environments where the opt-in is active. The opt-in is the path forward and will become the default for all projects. Environments where it is still inactive use a legacy locale-keyed shape under the hood (kept working for compatibility) — opt in to align with this documentation.
+   * 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;
     /**
-     * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+     * Focal point (only for image assets)
      */
     focal_point: {
       /**
@@ -8822,7 +8819,7 @@ export type UploadCreateSchema = {
         title?: LocalizedTitle;
         custom_data?: LocalizedCustomData;
         /**
-         * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+         * Focal point (only for image assets)
          */
         focal_point?: {
           /**
@@ -8930,7 +8927,7 @@ export type UploadUpdateSchema = {
         title?: LocalizedTitle;
         custom_data?: LocalizedCustomData;
         /**
-         * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+         * Focal point (only for image assets)
          */
         focal_point?: {
           /**
@@ -11547,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;
     };
   };
@@ -11937,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: {
     /**
@@ -11948,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;
     };
-    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;
+    };
+    /**
+     * 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;
     };
     /**
@@ -12089,7 +12264,7 @@ export type SiteMeta = {
    */
   milliseconds_in_datetime: boolean;
   /**
-   * Whether the non-localized focal points opt-in is active for the environment. When active, an upload's `focal_point` is stored once per asset rather than once per locale, and the CMA `default_field_metadata` attribute is exposed in its field-keyed shape (with `alt`/`title`/`custom_data` keyed by locale and a single top-level `focal_point`). When inactive, the CMA continues to accept and return the legacy locale-keyed shape — the single stored focal_point is replicated into every locale entry on read. The CDA's behavior is unaffected: it already returns a single `focalPoint` value.
+   * 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;
 };
@@ -12192,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;
@@ -12285,7 +12520,7 @@ export type SiteUpdateSchema = {
        */
       milliseconds_in_datetime?: boolean;
       /**
-       * Whether the non-localized focal points opt-in is active for the environment. When active, an upload's `focal_point` is stored once per asset rather than once per locale, and the CMA `default_field_metadata` attribute is exposed in its field-keyed shape (with `alt`/`title`/`custom_data` keyed by locale and a single top-level `focal_point`). When inactive, the CMA continues to accept and return the legacy locale-keyed shape — the single stored focal_point is replicated into every locale entry on read. The CDA's behavior is unaffected: it already returns a single `focalPoint` value.
+       * 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;
     };
@@ -12387,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/Session.ts

@@ -47,4 +47,35 @@ export default class Session extends BaseResource {
       body,
     });
   }
+
+  /**
+   * Destroy the current session
+   *
+   * Read more: https://www.datocms.com/docs/content-management-api/resources/session/destroy
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
+   *
+   * @deprecated This API call is to be considered private and might change without notice
+   */
+  destroy() {
+    return this.rawDestroy();
+  }
+
+  /**
+   * Destroy the current session
+   *
+   * Read more: https://www.datocms.com/docs/content-management-api/resources/session/destroy
+   *
+   * @throws {ApiError}
+   * @throws {TimeoutError}
+   *
+   * @deprecated This API call is to be considered private and might change without notice
+   */
+  rawDestroy(): Promise<void> {
+    return this.client.request<void>({
+      method: 'DELETE',
+      url: '/session',
+    });
+  }
 }

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/utilities/id.ts

@@ -76,7 +76,7 @@ export function isValidId(id: string) {
 }
 
 export function generateId() {
-  const bytes = v4(null, new Uint8Array(16));
+  const bytes = v4(undefined, new Uint8Array(16));
 
   // Here we unset the first bit to ensure [A-Za-f] as the first char.
   //