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

package/src/generated/RawApiTypes.ts

@@ -8277,6 +8277,14 @@ 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
    */
@@ -8616,28 +8624,42 @@ 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.
+   * For each of the project's locales, the default metadata to apply if nothing is specified at record's level.
    */
   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)
+     * 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: {
+    [k: string]: {
+      /**
+       * Alternate text for the asset
+       */
+      alt: string | null;
+      /**
+       * Title for the asset
+       */
+      title: string | null;
       /**
-       * Horizontal position expressed as float between 0 and 1
+       * Object with arbitrary metadata
        */
-      x: number;
+      custom_data: {
+        [k: string]: unknown;
+      };
       /**
-       * Vertical position expressed as float between 0 and 1
+       * Focal point (only for image assets)
        */
-      y: number;
-    } | null;
+      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;
+    };
   };
   /**
    * Is this upload an image?
@@ -8691,44 +8713,6 @@ 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
  *
@@ -8815,25 +8799,42 @@ export type UploadCreateSchema = {
        */
       notes?: string | null;
       /**
-       * 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.
+       * For each of the project's locales, the default metadata to apply if nothing is specified at record's level.
        */
       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)
+         * 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?: {
+        [k: string]: {
+          /**
+           * Alternate text for the asset
+           */
+          alt?: string | null;
+          /**
+           * Title for the asset
+           */
+          title?: string | null;
           /**
-           * Horizontal position expressed as float between 0 and 1
+           * Object with arbitrary metadata
            */
-          x: number;
+          custom_data?: {
+            [k: string]: unknown;
+          };
           /**
-           * Vertical position expressed as float between 0 and 1
+           * Focal point (only for image assets)
            */
-          y: number;
-        } | null;
+          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;
+        };
       };
       /**
        * Tags
@@ -8923,25 +8924,42 @@ export type UploadUpdateSchema = {
        */
       tags?: string[];
       /**
-       * 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.
+       * For each of the project's locales, the default metadata to apply if nothing is specified at record's level.
        */
       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)
+         * 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?: {
+        [k: string]: {
           /**
-           * Horizontal position expressed as float between 0 and 1
+           * Alternate text for the asset
            */
-          x: number;
+          alt?: string | null;
           /**
-           * Vertical position expressed as float between 0 and 1
+           * Title for the asset
            */
-          y: number;
-        } | null;
+          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;
+        };
       };
       [k: string]: unknown;
     };
@@ -12088,10 +12106,6 @@ 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
@@ -12284,10 +12298,6 @@ 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/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/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 '../../resources/Upload.js';
+export { default as Upload } from './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,10 +4,6 @@ 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/dist/cjs/resources/Upload.js

@@ -1,10 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const Upload_js_1 = __importDefault(require("../generated/resources/Upload.js"));
-class UploadResource extends Upload_js_1.default {
-}
-exports.default = UploadResource;
-//# sourceMappingURL=Upload.js.map

package/dist/cjs/resources/Upload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Upload.js","sourceRoot":"","sources":["../../../src/resources/Upload.ts"],"names":[],"mappings":";;;;;AAAA,iFAA0D;AAmC1D,MAAqB,cAAe,SAAQ,mBAAU;CAAG;AAAzD,iCAAyD"}

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

@@ -1,44 +0,0 @@
-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/dist/esm/resources/Upload.js

@@ -1,4 +0,0 @@
-import BaseUpload from '../generated/resources/Upload.js';
-export default class UploadResource extends BaseUpload {
-}
-//# sourceMappingURL=Upload.js.map

package/dist/esm/resources/Upload.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Upload.js","sourceRoot":"","sources":["../../../src/resources/Upload.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,kCAAkC,CAAC;AAmC1D,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,UAAU;CAAG"}

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

@@ -1,44 +0,0 @@
-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/src/resources/Upload.ts

@@ -1,36 +0,0 @@
-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 {}