@datocms/cma-client 5.8.1 → 6.1.0

package/dist/esm/resources/Role.js

@@ -1,12 +1,3 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import BaseRole from '../generated/resources/Role.js';
 function sameValue(a, b) {
     if ((a === undefined || a === null) && (b === undefined || b === null)) {
@@ -33,7 +24,10 @@ function applyChanges(currentRules, changes, currentEnvironmentId, context) {
     return [
         ...(rulesToRemove
             ? rulesToRemove.reduce((filteredRules, ruleToRemove) => {
-                const ruleToRemoveWithEnvironmentId = Object.assign(Object.assign({}, ruleToRemove), { environment: currentEnvironmentId });
+                const ruleToRemoveWithEnvironmentId = {
+                    ...ruleToRemove,
+                    environment: currentEnvironmentId,
+                };
                 const foundRule = filteredRules.find((rule) => sameRule(rule, ruleToRemoveWithEnvironmentId));
                 if (!foundRule) {
                     throw new Error(`Cannot find rule ${JSON.stringify(ruleToRemoveWithEnvironmentId)} to remove in ${context}!`);
@@ -42,7 +36,10 @@ function applyChanges(currentRules, changes, currentEnvironmentId, context) {
             }, currentRules)
             : currentRules),
         ...(rulesToAdd
-            ? rulesToAdd.map((change) => (Object.assign({ environment: currentEnvironmentId }, change)))
+            ? rulesToAdd.map((change) => ({
+                environment: currentEnvironmentId,
+                ...change,
+            }))
             : []),
     ];
 }
@@ -52,28 +49,29 @@ export default class RoleResource extends BaseRole {
      *
      * Read more: https://www.datocms.com/docs/content-management-api/resources/role/update
      */
-    updateCurrentEnvironmentPermissions(roleId, changes) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const currentEnvironmentId = this.client.config.environment ||
-                (yield this.client.environments.list()).find((environment) => environment.meta.primary).id;
-            const role = yield this.find(roleId);
-            const updateItemTypePermissions = Boolean(changes.positive_item_type_permissions ||
-                changes.negative_item_type_permissions);
-            const updateUploadPermissions = Boolean(changes.positive_upload_permissions ||
-                changes.negative_upload_permissions);
-            const body = Object.assign(Object.assign({}, (updateItemTypePermissions
+    async updateCurrentEnvironmentPermissions(roleId, changes) {
+        const currentEnvironmentId = this.client.config.environment ||
+            (await this.client.environments.list()).find((environment) => environment.meta.primary).id;
+        const role = await this.find(roleId);
+        const updateItemTypePermissions = Boolean(changes.positive_item_type_permissions ||
+            changes.negative_item_type_permissions);
+        const updateUploadPermissions = Boolean(changes.positive_upload_permissions ||
+            changes.negative_upload_permissions);
+        const body = {
+            ...(updateItemTypePermissions
                 ? {
                     positive_item_type_permissions: applyChanges(role.positive_item_type_permissions, changes.positive_item_type_permissions, currentEnvironmentId, 'positive_item_type_permissions'),
                     negative_item_type_permissions: applyChanges(role.negative_item_type_permissions, changes.negative_item_type_permissions, currentEnvironmentId, 'negative_item_type_permissions'),
                 }
-                : {})), (updateUploadPermissions
+                : {}),
+            ...(updateUploadPermissions
                 ? {
                     positive_upload_permissions: applyChanges(role.positive_upload_permissions, changes.positive_upload_permissions, currentEnvironmentId, 'positive_upload_permissions'),
                     negative_upload_permissions: applyChanges(role.negative_upload_permissions, changes.negative_upload_permissions, currentEnvironmentId, 'negative_upload_permissions'),
                 }
-                : {}));
-            return this.update(roleId, body);
-        });
+                : {}),
+        };
+        return this.update(roleId, body);
     }
 }
 //# sourceMappingURL=Role.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/resources/Role.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Role.js","sourceRoot":"","sources":["../../../src/resources/Role.ts"],"names":[],"mappings":"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"}

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

@@ -1,46 +1,59 @@
+import type * as ApiTypes from '../generated/ApiTypes.js';
 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.
+ * `default_field_metadata` travels in one of two shapes, and which one an
+ * environment speaks depends on the `non_localized_focal_points` opt-in — each
+ * rejects the other with `422 INVALID_FORMAT`. This resource hides that: you
+ * always read and write the field-keyed shape the types describe, and the
+ * legacy one is converted to and from as needed.
  *
- * 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.
+ * The raw methods are deliberately left alone: they are the escape hatch for
+ * anyone who needs to see what actually goes over the wire.
  */
-export type UploadLocaleKeyedDefaultFieldMetadata = {
-    [localeCode: string]: {
-        alt: string | null;
-        title: string | null;
-        custom_data: {
-            [k: string]: unknown;
-        };
-        focal_point: {
-            x: number;
-            y: number;
-        } | null;
-        poster_time: 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;
-        poster_time?: number | null;
-    };
-};
 export default class UploadResource extends BaseUpload {
+    /**
+     * Create a new upload
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/create
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    create(body: ApiTypes.UploadCreateSchema): Promise<ApiTypes.Upload>;
+    /**
+     * Update an upload
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/update
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    update(uploadId: string | ApiTypes.UploadData, body: ApiTypes.UploadUpdateSchema, queryParams?: ApiTypes.UploadUpdateHrefSchema): Promise<ApiTypes.Upload>;
+    /**
+     * Retrieve an upload
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/self
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    find(uploadId: string | ApiTypes.UploadData): Promise<ApiTypes.Upload>;
+    /**
+     * List all uploads
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/instances
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    list(queryParams?: ApiTypes.UploadInstancesHrefSchema): Promise<ApiTypes.Upload[]>;
+    /**
+     * Async iterator to auto-paginate over elements returned by list()
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/instances
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    listPagedIterator(...args: Parameters<BaseUpload['listPagedIterator']>): AsyncGenerator<ApiTypes.Upload, void, unknown>;
 }

package/dist/esm/resources/Upload.js

@@ -1,4 +1,72 @@
 import BaseUpload from '../generated/resources/Upload.js';
+import { encodeDefaultFieldMetadata, normalizeUpload, } from '../utilities/defaultFieldMetadata.js';
+/**
+ * `default_field_metadata` travels in one of two shapes, and which one an
+ * environment speaks depends on the `non_localized_focal_points` opt-in — each
+ * rejects the other with `422 INVALID_FORMAT`. This resource hides that: you
+ * always read and write the field-keyed shape the types describe, and the
+ * legacy one is converted to and from as needed.
+ *
+ * The raw methods are deliberately left alone: they are the escape hatch for
+ * anyone who needs to see what actually goes over the wire.
+ */
 export default class UploadResource extends BaseUpload {
+    /**
+     * Create a new upload
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/create
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    async create(body) {
+        return normalizeUpload(await super.create(await encodeDefaultFieldMetadata(this.client, body)));
+    }
+    /**
+     * Update an upload
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/update
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    async update(uploadId, body, queryParams) {
+        return normalizeUpload(await super.update(uploadId, await encodeDefaultFieldMetadata(this.client, body), queryParams));
+    }
+    /**
+     * Retrieve an upload
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/self
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    async find(uploadId) {
+        return normalizeUpload(await super.find(uploadId));
+    }
+    /**
+     * List all uploads
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/instances
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    async list(queryParams) {
+        return (await super.list(queryParams)).map(normalizeUpload);
+    }
+    /**
+     * Async iterator to auto-paginate over elements returned by list()
+     *
+     * Read more: https://www.datocms.com/docs/content-management-api/resources/upload/instances
+     *
+     * @throws {ApiError}
+     * @throws {TimeoutError}
+     */
+    async *listPagedIterator(...args) {
+        for await (const upload of super.listPagedIterator(...args)) {
+            yield normalizeUpload(upload);
+        }
+    }
 }
 //# sourceMappingURL=Upload.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Upload.js","sourceRoot":"","sources":["../../../src/resources/Upload.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,kCAAkC,CAAC;AAqC1D,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,UAAU;CAAG"}
+{"version":3,"file":"Upload.js","sourceRoot":"","sources":["../../../src/resources/Upload.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,UAAU;IACpD;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,IAAiC;QAC5C,OAAO,eAAe,CACpB,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,0BAA0B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,QAAsC,EACtC,IAAiC,EACjC,WAA6C;QAE7C,OAAO,eAAe,CACpB,MAAM,KAAK,CAAC,MAAM,CAChB,QAAQ,EACR,MAAM,0BAA0B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EACnD,WAAW,CACZ,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,QAAsC;QAC/C,OAAO,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,WAAgD;QACzD,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,iBAAiB,CACtB,GAAG,IAAiD;QAEpD,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,EAAE;YAC3D,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;SAC/B;IACH,CAAC;CACF"}

package/dist/esm/utilities/buildBlockRecord.js

@@ -19,6 +19,9 @@ export function buildBlockRecord(body) {
     const itemTypeId = (_c = (_a = body.__itemTypeId) !== null && _a !== void 0 ? _a : (_b = body.item_type) === null || _b === void 0 ? void 0 : _b.id) !== null && _c !== void 0 ? _c : (_f = (_e = (_d = data.relationships) === null || _d === void 0 ? void 0 : _d.item_type) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.id;
     if (itemTypeId === undefined)
         return data;
-    return Object.assign(Object.assign({}, data), { __itemTypeId: itemTypeId });
+    return {
+        ...data,
+        __itemTypeId: itemTypeId,
+    };
 }
 //# sourceMappingURL=buildBlockRecord.js.map

package/dist/esm/utilities/buildBlockRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/buildBlockRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AA6BvD,MAAM,UAAU,gBAAgB,CAG9B,IAEuC;;IAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,oBAAoB,CAEpC,IAAI,EAAE;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC;IAER,qEAAqE;IACrE,uEAAuE;IACvE,yEAAyE;IACzE,mEAAmE;IACnE,EAAE;IACF,6EAA6E;IAC7E,uEAAuE;IACvE,sEAAsE;IACtE,uEAAuE;IACvE,MAAM,UAAU,GACd,MAAA,MAAA,IAAI,CAAC,YAAY,mCACjB,MAAA,IAAI,CAAC,SAAS,0CAAE,EAAE,mCAClB,MAAA,MAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,SAAS,0CAAE,IAAI,0CAAE,EAAE,CAAC;IAE1C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE1C,OAAO,gCACF,IAAI,KACP,YAAY,EAAE,UAAU,GACQ,CAAC;AACrC,CAAC"}
+{"version":3,"file":"buildBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/buildBlockRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AA6BvD,MAAM,UAAU,gBAAgB,CAG9B,IAEuC;;IAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,oBAAoB,CAEpC,IAAI,EAAE;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC;IAER,qEAAqE;IACrE,uEAAuE;IACvE,yEAAyE;IACzE,mEAAmE;IACnE,EAAE;IACF,6EAA6E;IAC7E,uEAAuE;IACvE,sEAAsE;IACtE,uEAAuE;IACvE,MAAM,UAAU,GACd,MAAA,MAAA,IAAI,CAAC,YAAY,mCACjB,MAAA,IAAI,CAAC,SAAS,0CAAE,EAAE,mCAClB,MAAA,MAAA,MAAA,IAAI,CAAC,aAAa,0CAAE,SAAS,0CAAE,IAAI,0CAAE,EAAE,CAAC;IAE1C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE1C,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,UAAU;KACQ,CAAC;AACrC,CAAC"}

package/dist/esm/utilities/defaultFieldMetadata.d.ts

@@ -0,0 +1,84 @@
+import type * as ApiTypes from '../generated/ApiTypes.js';
+import type { Client } from '../generated/Client.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 `uploads` resource converts to and from this shape on your behalf, so you
+ * only ever see the field-keyed one. The type is exported for those working at
+ * the raw layer, which performs no conversion.
+ */
+export type UploadLocaleKeyedDefaultFieldMetadata = {
+    [localeCode: string]: {
+        alt: string | null;
+        title: string | null;
+        custom_data: {
+            [k: string]: unknown;
+        };
+        focal_point: {
+            x: number;
+            y: number;
+        } | null;
+        poster_time: 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;
+        poster_time?: number | null;
+    };
+};
+export type DefaultFieldMetadata = ApiTypes.Upload['default_field_metadata'];
+export type DefaultFieldMetadataInRequest = NonNullable<ApiTypes.UploadUpdateSchema['default_field_metadata']>;
+/**
+ * Tells the two wire shapes apart. A field-keyed payload always carries a
+ * top-level `focal_point`, and a locale-keyed one never can: its keys are
+ * locale codes, and no locale code is the literal string `focal_point`.
+ */
+export declare function isFieldKeyed(metadata: DefaultFieldMetadata | UploadLocaleKeyedDefaultFieldMetadata): metadata is DefaultFieldMetadata;
+/**
+ * Collapses a legacy response payload into the field-keyed shape. The API
+ * replicates the non-localized values into every locale entry on read, so every
+ * entry carries the same value and the first one is enough.
+ */
+export declare function fromLocaleKeyed(byLocale: UploadLocaleKeyedDefaultFieldMetadata): DefaultFieldMetadata;
+/**
+ * Rewrites a field-keyed patch into the legacy locale-keyed one: the localized
+ * keys are pivoted per locale, and the non-localized ones ride along on a
+ * single entry. The API takes `focal_point` / `poster_time` off the first entry
+ * that carries one and ignores the rest, so writing them once is enough — on
+ * any locale the patch already touches, or the environment's first one when it
+ * touches none.
+ */
+export declare function toLocaleKeyed({ alt, title, custom_data, focal_point, poster_time, }: DefaultFieldMetadataInRequest, environmentLocales: string[]): UploadLocaleKeyedDefaultFieldMetadataInRequest;
+/**
+ * Normalizes an upload as served by the API into the field-keyed shape the
+ * `Upload` type describes. Returns the entity untouched — no copy — when it is
+ * already field-keyed, which is the case for every environment that has taken
+ * the opt-in.
+ */
+export declare function normalizeUpload(upload: ApiTypes.Upload): ApiTypes.Upload;
+/**
+ * Encodes a `create` / `update` body into the shape the environment accepts.
+ *
+ * The environment is only consulted when there is metadata to encode, so a
+ * client that never writes asset metadata never asks — and when it does ask,
+ * the lookup is memoized and shared, so a batch of writes pays for one.
+ */
+export declare function encodeDefaultFieldMetadata<T extends {
+    default_field_metadata?: DefaultFieldMetadataInRequest;
+}>(client: Client, body: T): Promise<T>;

package/dist/esm/utilities/defaultFieldMetadata.js

@@ -0,0 +1,113 @@
+import { fetchEnvironmentSettings, isEnvironmentFlagActive, } from './environmentSettings.js';
+/**
+ * Tells the two wire shapes apart. A field-keyed payload always carries a
+ * top-level `focal_point`, and a locale-keyed one never can: its keys are
+ * locale codes, and no locale code is the literal string `focal_point`.
+ */
+export function isFieldKeyed(metadata) {
+    return 'focal_point' in metadata;
+}
+/**
+ * Collapses a legacy response payload into the field-keyed shape. The API
+ * replicates the non-localized values into every locale entry on read, so every
+ * entry carries the same value and the first one is enough.
+ */
+export function fromLocaleKeyed(byLocale) {
+    const alt = {};
+    const title = {};
+    const customData = {};
+    let focalPoint = null;
+    let posterTime = null;
+    let seenAnEntry = false;
+    for (const [locale, entry] of Object.entries(byLocale)) {
+        alt[locale] = entry.alt;
+        title[locale] = entry.title;
+        customData[locale] = entry.custom_data;
+        if (!seenAnEntry) {
+            seenAnEntry = true;
+            focalPoint = entry.focal_point;
+            posterTime = entry.poster_time;
+        }
+    }
+    return {
+        alt,
+        title,
+        custom_data: customData,
+        focal_point: focalPoint,
+        poster_time: posterTime,
+    };
+}
+/**
+ * Rewrites a field-keyed patch into the legacy locale-keyed one: the localized
+ * keys are pivoted per locale, and the non-localized ones ride along on a
+ * single entry. The API takes `focal_point` / `poster_time` off the first entry
+ * that carries one and ignores the rest, so writing them once is enough — on
+ * any locale the patch already touches, or the environment's first one when it
+ * touches none.
+ */
+export function toLocaleKeyed({ alt, title, custom_data, focal_point, poster_time, }, environmentLocales) {
+    var _a;
+    const result = {};
+    function entryFor(locale) {
+        var _a;
+        const entry = (_a = result[locale]) !== null && _a !== void 0 ? _a : {};
+        result[locale] = entry;
+        return entry;
+    }
+    for (const [locale, value] of Object.entries(alt !== null && alt !== void 0 ? alt : {})) {
+        entryFor(locale).alt = value;
+    }
+    for (const [locale, value] of Object.entries(title !== null && title !== void 0 ? title : {})) {
+        entryFor(locale).title = value;
+    }
+    for (const [locale, value] of Object.entries(custom_data !== null && custom_data !== void 0 ? custom_data : {})) {
+        entryFor(locale).custom_data = value;
+    }
+    if (focal_point !== undefined || poster_time !== undefined) {
+        const locale = (_a = Object.keys(result)[0]) !== null && _a !== void 0 ? _a : environmentLocales[0];
+        if (locale) {
+            if (focal_point !== undefined)
+                entryFor(locale).focal_point = focal_point;
+            if (poster_time !== undefined)
+                entryFor(locale).poster_time = poster_time;
+        }
+    }
+    return result;
+}
+/**
+ * Normalizes an upload as served by the API into the field-keyed shape the
+ * `Upload` type describes. Returns the entity untouched — no copy — when it is
+ * already field-keyed, which is the case for every environment that has taken
+ * the opt-in.
+ */
+export function normalizeUpload(upload) {
+    const metadata = upload.default_field_metadata;
+    if (!metadata || isFieldKeyed(metadata)) {
+        return upload;
+    }
+    return { ...upload, default_field_metadata: fromLocaleKeyed(metadata) };
+}
+/**
+ * Encodes a `create` / `update` body into the shape the environment accepts.
+ *
+ * The environment is only consulted when there is metadata to encode, so a
+ * client that never writes asset metadata never asks — and when it does ask,
+ * the lookup is memoized and shared, so a batch of writes pays for one.
+ */
+export async function encodeDefaultFieldMetadata(client, body) {
+    const metadata = body.default_field_metadata;
+    if (!metadata) {
+        return body;
+    }
+    if (await isEnvironmentFlagActive(client, 'non_localized_focal_points')) {
+        return body;
+    }
+    const { locales } = await fetchEnvironmentSettings(client);
+    return {
+        ...body,
+        // The declared type describes the field-keyed shape, which is what callers
+        // write. The legacy payload is this module's business.
+        default_field_metadata: toLocaleKeyed(metadata, locales),
+    };
+}
+//# sourceMappingURL=defaultFieldMetadata.js.map

package/dist/esm/utilities/defaultFieldMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultFieldMetadata.js","sourceRoot":"","sources":["../../../src/utilities/defaultFieldMetadata.ts"],"names":[],"mappings":"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"}

package/dist/esm/utilities/duplicateBlockRecord.js

@@ -1,50 +1,28 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 import { mapBlocksInNonLocalizedFieldValue } from './recursiveBlocks.js';
-export function duplicateBlockRecord(existingBlock, schemaRepository) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const { __itemTypeId, type, attributes, relationships } = existingBlock;
-        const itemType = yield schemaRepository.getRawItemTypeById(existingBlock.relationships.item_type.data.id);
-        const newBlock = {
-            __itemTypeId,
-            type,
-            relationships,
-            attributes,
-        };
-        const fields = yield schemaRepository.getRawItemTypeFields(itemType);
-        for (const field of fields) {
-            newBlock.attributes[field.attributes.api_key] =
-                yield mapBlocksInNonLocalizedFieldValue(newBlock.attributes[field.attributes.api_key], field.attributes.field_type, schemaRepository, (block, path) => {
-                    if (typeof block === 'string') {
-                        throw new Error(`Block cannot be duplicated as it contains nested block at ${path.join('.')} that is expressed as ID (${block}) instead of full object!`);
-                    }
-                    if ('id' in block) {
-                        const { id, meta } = block, blockWithoutIdAndMeta = __rest(block, ["id", "meta"]);
-                        return blockWithoutIdAndMeta;
-                    }
-                    const { meta } = block, blockWithoutMeta = __rest(block, ["meta"]);
-                    return blockWithoutMeta;
-                });
-        }
-        return newBlock;
-    });
+export async function duplicateBlockRecord(existingBlock, schemaRepository) {
+    const { __itemTypeId, type, attributes, relationships } = existingBlock;
+    const itemType = await schemaRepository.getRawItemTypeById(existingBlock.relationships.item_type.data.id);
+    const newBlock = {
+        __itemTypeId,
+        type,
+        relationships,
+        attributes,
+    };
+    const fields = await schemaRepository.getRawItemTypeFields(itemType);
+    for (const field of fields) {
+        newBlock.attributes[field.attributes.api_key] =
+            await mapBlocksInNonLocalizedFieldValue(newBlock.attributes[field.attributes.api_key], field.attributes.field_type, schemaRepository, (block, path) => {
+                if (typeof block === 'string') {
+                    throw new Error(`Block cannot be duplicated as it contains nested block at ${path.join('.')} that is expressed as ID (${block}) instead of full object!`);
+                }
+                if ('id' in block) {
+                    const { id, meta, ...blockWithoutIdAndMeta } = block;
+                    return blockWithoutIdAndMeta;
+                }
+                const { meta, ...blockWithoutMeta } = block;
+                return blockWithoutMeta;
+            });
+    }
+    return newBlock;
 }
 //# sourceMappingURL=duplicateBlockRecord.js.map

package/dist/esm/utilities/duplicateBlockRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"duplicateBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/duplicateBlockRecord.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAKA,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AAKzE,MAAM,UAAgB,oBAAoB,CAGxC,aAAoD,EACpD,gBAAkC;;QAQlC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC;QAExE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,kBAAkB,CACxD,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9C,CAAC;QAEF,MAAM,QAAQ,GAAG;YACf,YAAY;YACZ,IAAI;YACJ,aAAa;YACb,UAAU;SACU,CAAC;QAEvB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAErE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;YAC1B,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;gBAC3C,MAAM,iCAAiC,CACrC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAC7C,KAAK,CAAC,UAAU,CAAC,UAAU,EAC3B,gBAAgB,EAChB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;oBACd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;wBAC7B,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,6BAA6B,KAAK,2BAA2B,CACzI,CAAC;qBACH;oBAED,IAAI,IAAI,IAAI,KAAK,EAAE;wBACjB,MAAM,EAAE,EAAE,EAAE,IAAI,KAA+B,KAAK,EAA/B,qBAAqB,UAAK,KAAK,EAA9C,cAAsC,CAAQ,CAAC;wBAErD,OAAO,qBAA0C,CAAC;qBACnD;oBAED,MAAM,EAAE,IAAI,KAA0B,KAAK,EAA1B,gBAAgB,UAAK,KAAK,EAArC,QAA6B,CAAQ,CAAC;oBAC5C,OAAO,gBAAqC,CAAC;gBAC/C,CAAC,CACF,CAAC;SACL;QAED,OAAO,QAIE,CAAC;IACZ,CAAC;CAAA"}
+{"version":3,"file":"duplicateBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/duplicateBlockRecord.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AAKzE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAGxC,aAAoD,EACpD,gBAAkC;IAQlC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC;IAExE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,kBAAkB,CACxD,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9C,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,YAAY;QACZ,IAAI;QACJ,aAAa;QACb,UAAU;KACU,CAAC;IAEvB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAErE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;YAC3C,MAAM,iCAAiC,CACrC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAC7C,KAAK,CAAC,UAAU,CAAC,UAAU,EAC3B,gBAAgB,EAChB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBACd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;oBAC7B,MAAM,IAAI,KAAK,CACb,6DAA6D,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,6BAA6B,KAAK,2BAA2B,CACzI,CAAC;iBACH;gBAED,IAAI,IAAI,IAAI,KAAK,EAAE;oBACjB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,qBAAqB,EAAE,GAAG,KAAK,CAAC;oBAErD,OAAO,qBAA0C,CAAC;iBACnD;gBAED,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,EAAE,GAAG,KAAK,CAAC;gBAC5C,OAAO,gBAAqC,CAAC;YAC/C,CAAC,CACF,CAAC;KACL;IAED,OAAO,QAIE,CAAC;AACZ,CAAC"}

package/dist/esm/utilities/environmentSettings.d.ts

@@ -0,0 +1,35 @@
+import type * as ApiTypes from '../generated/ApiTypes.js';
+import type { Client } from '../generated/Client.js';
+/**
+ * Every boolean an environment reports about itself in `site.meta`: the
+ * product-update opt-ins (`improved_items_listing`, `milliseconds_in_datetime`,
+ * `non_localized_focal_points`, …) plus the plain state flags.
+ *
+ * Derived from the generated type rather than listed, so a flag added to the
+ * schema is usable here as soon as the types are regenerated, with nothing to
+ * keep in sync.
+ */
+export type EnvironmentFlag = {
+    [K in keyof ApiTypes.SiteMeta]-?: boolean extends ApiTypes.SiteMeta[K] ? K : never;
+}[keyof ApiTypes.SiteMeta];
+/**
+ * `site.find()`, memoized per client for {@link TTL_MS}.
+ *
+ * The promise is cached rather than its result, so concurrent callers share one
+ * request instead of firing one each — the difference between one lookup and
+ * ten thousand when a batch job starts. A failed lookup is not cached.
+ *
+ * Everything expires on the same clock, including flags that in practice never
+ * change back: re-reading `site` every twenty minutes costs nothing next to the
+ * work these clients are doing, and it means a client stays correct across an
+ * activation that happens while it runs.
+ */
+export declare function fetchEnvironmentSettings(client: Client): Promise<ApiTypes.Site>;
+/**
+ * Whether a `site.meta` flag is on for the environment this client talks to.
+ *
+ * An API predating a flag omits it from the meta entirely, which the types
+ * don't admit but runtime does — so anything short of an explicit `true` reads
+ * as off.
+ */
+export declare function isEnvironmentFlagActive(client: Client, flag: EnvironmentFlag): Promise<boolean>;