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

package/dist/types/resources/Upload.d.ts

@@ -0,0 +1,44 @@
+import BaseUpload from '../generated/resources/Upload.js';
+/**
+ * Legacy locale-keyed shape of an upload's `default_field_metadata`, as
+ * returned and accepted by environments where the `non_localized_focal_points`
+ * opt-in is inactive.
+ *
+ * The generated `Upload.default_field_metadata` type reflects the new
+ * field-keyed shape (the path forward). This type is provided so consumers
+ * targeting opted-out environments during the transition can cast the
+ * response value to a structurally accurate shape.
+ */
+export type UploadLocaleKeyedDefaultFieldMetadata = {
+    [localeCode: string]: {
+        alt: string | null;
+        title: string | null;
+        custom_data: {
+            [k: string]: unknown;
+        };
+        focal_point: {
+            x: number;
+            y: number;
+        } | null;
+    };
+};
+/**
+ * Legacy locale-keyed shape accepted on `create` / `update` request bodies
+ * by environments where the `non_localized_focal_points` opt-in is inactive.
+ * All fields are optional, matching the partial-write contract.
+ */
+export type UploadLocaleKeyedDefaultFieldMetadataInRequest = {
+    [localeCode: string]: {
+        alt?: string | null;
+        title?: string | null;
+        custom_data?: {
+            [k: string]: unknown;
+        };
+        focal_point?: {
+            x: number;
+            y: number;
+        } | null;
+    };
+};
+export default class UploadResource extends BaseUpload {
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datocms/cma-client",
-  "version": "5.4.18",
+  "version": "5.5.0-alpha.0",
   "description": "JS client for DatoCMS REST Content Management API",
   "keywords": [
     "datocms",
@@ -45,5 +45,5 @@
     "@datocms/dashboard-client": "^5.4.9",
     "@types/uuid": "^9.0.7"
   },
-  "gitHead": "4f7d64737c1abd7cb2568604a99f2dd0eda6020b"
+  "gitHead": "9871ebb724c5acdf1c84a407938e78b77d3c99e2"
 }

package/src/generated/ApiTypes.ts

@@ -8341,42 +8341,28 @@ export type Upload = {
    */
   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 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.
    */
   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 — non-localized; a single value applies across every locale (only meaningful 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;
+      x: number;
       /**
-       * Object with arbitrary metadata
+       * Vertical position expressed as float between 0 and 1
        */
-      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?
@@ -8442,6 +8428,44 @@ export type UploadCreateJobSchema = Upload;
 export type UploadSelfTargetSchema = Upload;
 export type UploadDestroyTargetSchema = Upload;
 export type UploadUpdateJobSchema = Upload;
+/**
+ * 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;
+  };
+};
 /**
  * Meta attributes
  *
@@ -8557,42 +8581,28 @@ 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 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.
    */
   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 — non-localized; a single value applies across every locale (only meaningful 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;
+      x: number;
       /**
-       * Object with arbitrary metadata
+       * Vertical position expressed as float between 0 and 1
        */
-      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?
@@ -8685,42 +8695,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 — non-localized; a single value applies across every locale (only meaningful 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
@@ -8760,42 +8753,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 — non-localized; a single value applies across every locale (only meaningful 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;
   };
   creator?:
     | AccountData
@@ -11710,6 +11686,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 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.
+   */
+  non_localized_focal_points: boolean;
 };
 /**
  * JSON API data
@@ -12073,6 +12053,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 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.
+     */
+    non_localized_focal_points?: boolean;
   };
 };
 /**

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.4.18',
+      userAgent: '@datocms/cma-client v5.5.0-alpha.0',
       baseUrl: this.baseUrl,
       preCallStack: new Error().stack,
       extraHeaders: {

package/src/generated/RawApiTypes.ts

@@ -8616,42 +8616,28 @@ 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 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.
    */
   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 — non-localized; a single value applies across every locale (only meaningful 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?
@@ -8705,6 +8691,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
  *
@@ -8791,42 +8815,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 — non-localized; a single value applies across every locale (only meaningful 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;
+          x: number;
           /**
-           * Object with arbitrary metadata
+           * Vertical position expressed as float between 0 and 1
            */
-          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
@@ -8916,42 +8923,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 — non-localized; a single value applies across every locale (only meaningful 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;
       };
       [k: string]: unknown;
     };
@@ -12098,6 +12088,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 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.
+   */
+  non_localized_focal_points: boolean;
 };
 /**
  * JSON API data
@@ -12290,6 +12284,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 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.
+       */
+      non_localized_focal_points?: boolean;
     };
     relationships?: {
       sso_default_role?: {

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';

package/src/resources/Upload.ts

@@ -0,0 +1,36 @@
+import BaseUpload from '../generated/resources/Upload.js';
+
+/**
+ * Legacy locale-keyed shape of an upload's `default_field_metadata`, as
+ * returned and accepted by environments where the `non_localized_focal_points`
+ * opt-in is inactive.
+ *
+ * The generated `Upload.default_field_metadata` type reflects the new
+ * field-keyed shape (the path forward). This type is provided so consumers
+ * targeting opted-out environments during the transition can cast the
+ * response value to a structurally accurate shape.
+ */
+export type UploadLocaleKeyedDefaultFieldMetadata = {
+  [localeCode: string]: {
+    alt: string | null;
+    title: string | null;
+    custom_data: { [k: string]: unknown };
+    focal_point: { x: number; y: number } | null;
+  };
+};
+
+/**
+ * Legacy locale-keyed shape accepted on `create` / `update` request bodies
+ * by environments where the `non_localized_focal_points` opt-in is inactive.
+ * All fields are optional, matching the partial-write contract.
+ */
+export type UploadLocaleKeyedDefaultFieldMetadataInRequest = {
+  [localeCode: string]: {
+    alt?: string | null;
+    title?: string | null;
+    custom_data?: { [k: string]: unknown };
+    focal_point?: { x: number; y: number } | null;
+  };
+};
+
+export default class UploadResource extends BaseUpload {}