@uniformdev/assets 20.7.1-alpha.12 → 20.7.1-alpha.121

package/LICENSE.txt

@@ -1,2 +1,2 @@
-© 2024 Uniform Systems, Inc. All Rights Reserved.
+© 2025 Uniform Systems, Inc. All Rights Reserved.
 See details of Uniform Systems, Inc. Master Subscription Agreement here: https://uniform.dev/eula

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import { ApiClient, ClientOptions } from '@uniformdev/context/api';
+import { XOR } from 'ts-xor';
 
 interface components$1 {
     schemas: {
@@ -11,6 +12,8 @@ interface components$1 {
             name: string;
             /** @description Appears next to the parameter in the Composition editor */
             helpText?: string;
+            /** @description Context provided to AI when generating content for this parameter. May also be shown to humans. */
+            guidance?: string;
             /** @description Type name of the parameter (provided by a Uniform integration) */
             type: string;
             /** @description If true, this property can have locale-specific values. If false or not defined,
@@ -145,7 +148,7 @@ interface components$1 {
             categoryId?: string | null;
             /** @description Description of the component definition */
             description?: string;
-            /** @description Description of the component definition */
+            /** @description Preview image URL for the component definition (shown in the UI) */
             previewImageUrl?: string;
             /**
              * @description if this component uses team permissions or custom permissions
@@ -218,6 +221,27 @@ interface components$1 {
              * @description ID of the workflow that instances of this content type will use by default. When not set, no workflow is attached
              */
             workflowId?: string;
+            /** @description Configurations for previewing an entry on a consuming pattern or composition. */
+            previewConfigurations?: components$1["schemas"]["ContentTypePreviewConfiguration"][];
+        };
+        /** @description Defines a configuration for previewing an entry on a consuming pattern or composition. */
+        ContentTypePreviewConfiguration: {
+            /**
+             * @description The type of preview configuration
+             * @enum {string}
+             */
+            type: "pattern" | "project-map";
+            /** @description Display label for the preview configuration */
+            label: string;
+            /**
+             * Format: uuid
+             * @description Target preview entity ID (project map node ID or pattern ID)
+             */
+            id: string;
+            /** @description Optional mapping of dynamic input names to their values */
+            dynamicInputs?: {
+                [key: string]: string;
+            };
         };
         /** @description Defines an editable parameter on a component */
         ComponentParameter: {
@@ -878,6 +902,8 @@ interface components$1 {
             /** @description Allows executing the transition for a role. Note that write permissions to the destination stage are NOT required to execute a transition to it */
             execute?: boolean;
         };
+        /** @enum {string} */
+        ReleaseState: "open" | "locked" | "queued" | "launching" | "launched" | "deleting";
         ProjectMapNodeAllowedQueryString: {
             /** @description The name of the query string parameter */
             name: string;
@@ -885,6 +911,20 @@ interface components$1 {
             value?: string;
             /** @description Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /** @description Configuration for providing a list of allowed values for this query string */
+            optionsSource?: {
+                /**
+                 * @description The source type for the options
+                 * @enum {string}
+                 */
+                source: "static";
+                options: {
+                    /** @description Display name for the option */
+                    name: string;
+                    /** @description The actual value to be used */
+                    value: string;
+                }[];
+            };
         };
         ProjectMapNodeData: {
             /** @description While performing a search if a node is a hit, this property will return true.  If it's supporting structure, like a parent of a search hit, it will return false */
@@ -1157,6 +1197,14 @@ interface components {
                     /** @constant */
                     type: "number";
                 };
+                focalPoint?: {
+                    value: {
+                        x: number;
+                        y: number;
+                    };
+                    /** @constant */
+                    type: "focalPoint";
+                };
                 /** @description Asset field values */
                 custom?: {
                     [key: string]: components["schemas"]["ComponentParameter"];
@@ -1192,6 +1240,14 @@ interface components {
                     /** @constant */
                     type: "file";
                 };
+                focalPoint?: {
+                    value: {
+                        x: number;
+                        y: number;
+                    };
+                    /** @constant */
+                    type: "focalPoint";
+                };
             };
             _dataResources?: components["schemas"]["DataResourceDefinitions"];
         };
@@ -1497,33 +1553,31 @@ type AssetParamValueItem = {
         };
         /**
          * The width of the original asset
-         *
-         * Should resolve to a number but might
-         * be a string with a pointer reference
          */
         width?: {
             type: 'number';
-            value: number | string | undefined;
+            value: number | undefined;
         };
         /**
          * The height of the original asset
-         *
-         * Should resolve to a number but might
-         * be a string with a pointer reference
          */
         height?: {
             type: 'number';
-            value: number | string | undefined;
+            value: number | undefined;
         };
         /**
          * The size in bytes of the original asset
-         *
-         * Should resolve to a number but might
-         * be a string with a pointer reference
          */
         size?: {
             type: 'number';
-            value: number | string | undefined;
+            value: number | undefined;
+        };
+        focalPoint?: {
+            type: 'focalPoint';
+            value: {
+                x: number;
+                y: number;
+            } | undefined;
         };
         /**
          * Any key/value properties which the source
@@ -1566,10 +1620,62 @@ type AssetDefinition = {
 };
 declare const assetDefinitions: Record<AssetDefinitionType, AssetDefinition>;
 
+/**
+ * A union type of possible query parameters for the image delivery API.
+ */
+type ImageDeliveryParams = XOR<{
+    format: 'original';
+}, {
+    width?: number;
+    height?: number;
+    /**
+     * scale-down - resize the image to fit within the given dimensions, but never larger than the original size, while maintaining the aspect ratio
+     * contain - resize the image to fit within the given dimensions, including possibly enlarging the image, while maintaining the aspect ratio
+     * cover - resize the image to fully cover the given dimensions, cropping as needed
+     *
+     * "cover" additionally supports specifying a focal point via the "focal" parameter
+     */
+    fit?: 'scale-down' | 'contain' | 'cover';
+    focal?: undefined;
+}, {
+    width?: number;
+    height?: number;
+    /** cover - resize the image to fully cover the given dimensions, cropping as needed */
+    fit: 'cover';
+    /** "string" is in format NxM - N and M are numbers between 0.00 and 1.00, N representing the x-axis and M representing the y-axis */
+    focal: 'auto' | 'center' | string;
+}>;
+/**
+ * A union type of possible transformations accepted by the `imageFrom` function.
+ * Differentiates slightly from the `ImageDeliveryParams` type, in that the focal
+ * point is represented by an object { x: number, y: number }, and not a string.
+ */
+type ImageFromTransformProps = XOR<{
+    width?: number;
+    height?: number;
+    fit?: 'scale-down' | 'contain' | 'cover';
+}, {
+    width?: number;
+    height?: number;
+    fit?: 'cover';
+    focal: 'auto' | 'center' | {
+        x: number;
+        y: number;
+    };
+}>;
+/**
+ * A helper function for extracting the image URL from an asset and optionally
+ * applying transformation URL query parameters.
+ */
+declare const imageFrom: (asset: Asset | AssetParamValueItem | string) => {
+    url: () => string;
+    transform: (transformProps: ImageFromTransformProps) => /*elided*/ any;
+};
+
 /**
  * Converts a content asset to a put content asset body that has only the properties expected to the PUT API.
  * Removes things like author, stats, etc.
  */
 declare function convertAssetToPutAsset(asset: AssetGetResponseSingle): AssetUpsertRequest;
 
-export { type Asset, AssetClient, type AssetDefinitionType, type AssetDeleteRequest, type AssetGetRequest, type AssetGetRequestList, type AssetGetRequestSingle, type AssetGetResponse, type AssetGetResponseList, type AssetGetResponseSingle, type AssetParamValue, type AssetParamValueItem, type AssetUpsertRequest, UncachedAssetClient, assetDefinitions, convertAssetToPutAsset };
+export { type Asset, AssetClient, type AssetDefinitionType, type AssetDeleteRequest, type AssetGetRequest, type AssetGetRequestList, type AssetGetRequestSingle, type AssetGetResponse, type AssetGetResponseList, type AssetGetResponseSingle, type AssetParamValue, type AssetParamValueItem, type AssetUpsertRequest, type ImageDeliveryParams, type ImageFromTransformProps, UncachedAssetClient, assetDefinitions, convertAssetToPutAsset, imageFrom };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { ApiClient, ClientOptions } from '@uniformdev/context/api';
+import { XOR } from 'ts-xor';
 
 interface components$1 {
     schemas: {
@@ -11,6 +12,8 @@ interface components$1 {
             name: string;
             /** @description Appears next to the parameter in the Composition editor */
             helpText?: string;
+            /** @description Context provided to AI when generating content for this parameter. May also be shown to humans. */
+            guidance?: string;
             /** @description Type name of the parameter (provided by a Uniform integration) */
             type: string;
             /** @description If true, this property can have locale-specific values. If false or not defined,
@@ -145,7 +148,7 @@ interface components$1 {
             categoryId?: string | null;
             /** @description Description of the component definition */
             description?: string;
-            /** @description Description of the component definition */
+            /** @description Preview image URL for the component definition (shown in the UI) */
             previewImageUrl?: string;
             /**
              * @description if this component uses team permissions or custom permissions
@@ -218,6 +221,27 @@ interface components$1 {
              * @description ID of the workflow that instances of this content type will use by default. When not set, no workflow is attached
              */
             workflowId?: string;
+            /** @description Configurations for previewing an entry on a consuming pattern or composition. */
+            previewConfigurations?: components$1["schemas"]["ContentTypePreviewConfiguration"][];
+        };
+        /** @description Defines a configuration for previewing an entry on a consuming pattern or composition. */
+        ContentTypePreviewConfiguration: {
+            /**
+             * @description The type of preview configuration
+             * @enum {string}
+             */
+            type: "pattern" | "project-map";
+            /** @description Display label for the preview configuration */
+            label: string;
+            /**
+             * Format: uuid
+             * @description Target preview entity ID (project map node ID or pattern ID)
+             */
+            id: string;
+            /** @description Optional mapping of dynamic input names to their values */
+            dynamicInputs?: {
+                [key: string]: string;
+            };
         };
         /** @description Defines an editable parameter on a component */
         ComponentParameter: {
@@ -878,6 +902,8 @@ interface components$1 {
             /** @description Allows executing the transition for a role. Note that write permissions to the destination stage are NOT required to execute a transition to it */
             execute?: boolean;
         };
+        /** @enum {string} */
+        ReleaseState: "open" | "locked" | "queued" | "launching" | "launched" | "deleting";
         ProjectMapNodeAllowedQueryString: {
             /** @description The name of the query string parameter */
             name: string;
@@ -885,6 +911,20 @@ interface components$1 {
             value?: string;
             /** @description Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /** @description Configuration for providing a list of allowed values for this query string */
+            optionsSource?: {
+                /**
+                 * @description The source type for the options
+                 * @enum {string}
+                 */
+                source: "static";
+                options: {
+                    /** @description Display name for the option */
+                    name: string;
+                    /** @description The actual value to be used */
+                    value: string;
+                }[];
+            };
         };
         ProjectMapNodeData: {
             /** @description While performing a search if a node is a hit, this property will return true.  If it's supporting structure, like a parent of a search hit, it will return false */
@@ -1157,6 +1197,14 @@ interface components {
                     /** @constant */
                     type: "number";
                 };
+                focalPoint?: {
+                    value: {
+                        x: number;
+                        y: number;
+                    };
+                    /** @constant */
+                    type: "focalPoint";
+                };
                 /** @description Asset field values */
                 custom?: {
                     [key: string]: components["schemas"]["ComponentParameter"];
@@ -1192,6 +1240,14 @@ interface components {
                     /** @constant */
                     type: "file";
                 };
+                focalPoint?: {
+                    value: {
+                        x: number;
+                        y: number;
+                    };
+                    /** @constant */
+                    type: "focalPoint";
+                };
             };
             _dataResources?: components["schemas"]["DataResourceDefinitions"];
         };
@@ -1497,33 +1553,31 @@ type AssetParamValueItem = {
         };
         /**
          * The width of the original asset
-         *
-         * Should resolve to a number but might
-         * be a string with a pointer reference
          */
         width?: {
             type: 'number';
-            value: number | string | undefined;
+            value: number | undefined;
         };
         /**
          * The height of the original asset
-         *
-         * Should resolve to a number but might
-         * be a string with a pointer reference
          */
         height?: {
             type: 'number';
-            value: number | string | undefined;
+            value: number | undefined;
         };
         /**
          * The size in bytes of the original asset
-         *
-         * Should resolve to a number but might
-         * be a string with a pointer reference
          */
         size?: {
             type: 'number';
-            value: number | string | undefined;
+            value: number | undefined;
+        };
+        focalPoint?: {
+            type: 'focalPoint';
+            value: {
+                x: number;
+                y: number;
+            } | undefined;
         };
         /**
          * Any key/value properties which the source
@@ -1566,10 +1620,62 @@ type AssetDefinition = {
 };
 declare const assetDefinitions: Record<AssetDefinitionType, AssetDefinition>;
 
+/**
+ * A union type of possible query parameters for the image delivery API.
+ */
+type ImageDeliveryParams = XOR<{
+    format: 'original';
+}, {
+    width?: number;
+    height?: number;
+    /**
+     * scale-down - resize the image to fit within the given dimensions, but never larger than the original size, while maintaining the aspect ratio
+     * contain - resize the image to fit within the given dimensions, including possibly enlarging the image, while maintaining the aspect ratio
+     * cover - resize the image to fully cover the given dimensions, cropping as needed
+     *
+     * "cover" additionally supports specifying a focal point via the "focal" parameter
+     */
+    fit?: 'scale-down' | 'contain' | 'cover';
+    focal?: undefined;
+}, {
+    width?: number;
+    height?: number;
+    /** cover - resize the image to fully cover the given dimensions, cropping as needed */
+    fit: 'cover';
+    /** "string" is in format NxM - N and M are numbers between 0.00 and 1.00, N representing the x-axis and M representing the y-axis */
+    focal: 'auto' | 'center' | string;
+}>;
+/**
+ * A union type of possible transformations accepted by the `imageFrom` function.
+ * Differentiates slightly from the `ImageDeliveryParams` type, in that the focal
+ * point is represented by an object { x: number, y: number }, and not a string.
+ */
+type ImageFromTransformProps = XOR<{
+    width?: number;
+    height?: number;
+    fit?: 'scale-down' | 'contain' | 'cover';
+}, {
+    width?: number;
+    height?: number;
+    fit?: 'cover';
+    focal: 'auto' | 'center' | {
+        x: number;
+        y: number;
+    };
+}>;
+/**
+ * A helper function for extracting the image URL from an asset and optionally
+ * applying transformation URL query parameters.
+ */
+declare const imageFrom: (asset: Asset | AssetParamValueItem | string) => {
+    url: () => string;
+    transform: (transformProps: ImageFromTransformProps) => /*elided*/ any;
+};
+
 /**
  * Converts a content asset to a put content asset body that has only the properties expected to the PUT API.
  * Removes things like author, stats, etc.
  */
 declare function convertAssetToPutAsset(asset: AssetGetResponseSingle): AssetUpsertRequest;
 
-export { type Asset, AssetClient, type AssetDefinitionType, type AssetDeleteRequest, type AssetGetRequest, type AssetGetRequestList, type AssetGetRequestSingle, type AssetGetResponse, type AssetGetResponseList, type AssetGetResponseSingle, type AssetParamValue, type AssetParamValueItem, type AssetUpsertRequest, UncachedAssetClient, assetDefinitions, convertAssetToPutAsset };
+export { type Asset, AssetClient, type AssetDefinitionType, type AssetDeleteRequest, type AssetGetRequest, type AssetGetRequestList, type AssetGetRequestSingle, type AssetGetResponse, type AssetGetResponseList, type AssetGetResponseSingle, type AssetParamValue, type AssetParamValueItem, type AssetUpsertRequest, type ImageDeliveryParams, type ImageFromTransformProps, UncachedAssetClient, assetDefinitions, convertAssetToPutAsset, imageFrom };

package/dist/index.esm.js

@@ -62,9 +62,80 @@ var assetDefinitions = {
   }
 };
 
+// src/imageDelivery.ts
+var isUniformImageUrl = (imageUrl) => {
+  try {
+    if (typeof imageUrl !== "string") {
+      return false;
+    }
+    return /(img)\.(eu\.)?uniform\.(rocks|global)$/.test(new URL(imageUrl).hostname);
+  } catch (e) {
+    return false;
+  }
+};
+var imageFrom = (asset) => {
+  var _a, _b, _c, _d;
+  const baseUrl = typeof asset === "string" ? asset : (_b = (_a = asset.fields) == null ? void 0 : _a.url) == null ? void 0 : _b.value;
+  const isUniformHosted = isUniformImageUrl(baseUrl);
+  const deliveryParams = {};
+  if (typeof asset !== "string") {
+    if ((_d = (_c = asset.fields) == null ? void 0 : _c.focalPoint) == null ? void 0 : _d.value) {
+      deliveryParams.focal = `${asset.fields.focalPoint.value.x}x${asset.fields.focalPoint.value.y}`;
+    }
+  }
+  const api = {
+    url: () => {
+      if (!baseUrl) {
+        return "";
+      }
+      if (!isUniformHosted) {
+        return baseUrl;
+      }
+      const url = new URL(baseUrl);
+      const params = deliveryParams;
+      if (params.width !== void 0) {
+        url.searchParams.set("width", params.width.toString());
+      }
+      if (params.height !== void 0) {
+        url.searchParams.set("height", params.height.toString());
+      }
+      if (params.fit !== void 0) {
+        url.searchParams.set("fit", params.fit);
+      } else if (params.width !== void 0 && params.height !== void 0) {
+        url.searchParams.set("fit", "cover");
+        params.fit = "cover";
+      }
+      if (params.width !== void 0 && params.height !== void 0 && params.focal !== void 0 && params.fit === "cover") {
+        url.searchParams.set("focal", params.focal);
+      }
+      return url.toString();
+    },
+    transform: (transformProps) => {
+      if (transformProps.width !== void 0) {
+        deliveryParams.width = transformProps.width;
+      }
+      if (transformProps.height !== void 0) {
+        deliveryParams.height = transformProps.height;
+      }
+      if (transformProps.fit !== void 0) {
+        deliveryParams.fit = transformProps.fit;
+      }
+      if (transformProps.focal !== void 0) {
+        if (typeof transformProps.focal === "string") {
+          deliveryParams.focal = transformProps.focal;
+        } else {
+          deliveryParams.focal = `${transformProps.focal.x}x${transformProps.focal.y}`;
+        }
+      }
+      return api;
+    }
+  };
+  return api;
+};
+
 // src/utils/assetConverter.ts
 function convertAssetToPutAsset(asset) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   return {
     asset: {
       _id: asset.asset._id,
@@ -74,7 +145,8 @@ function convertAssetToPutAsset(asset) {
       fields: {
         title: (_a = asset.asset.fields) == null ? void 0 : _a.title,
         description: (_b = asset.asset.fields) == null ? void 0 : _b.description,
-        file: (_c = asset.asset.fields) == null ? void 0 : _c.file
+        file: (_c = asset.asset.fields) == null ? void 0 : _c.file,
+        focalPoint: (_d = asset.asset.fields) == null ? void 0 : _d.focalPoint
       }
     },
     projectId: asset.projectId
@@ -84,5 +156,6 @@ export {
   AssetClient,
   UncachedAssetClient,
   assetDefinitions,
-  convertAssetToPutAsset
+  convertAssetToPutAsset,
+  imageFrom
 };

package/dist/index.js

@@ -23,7 +23,8 @@ __export(src_exports, {
   AssetClient: () => AssetClient,
   UncachedAssetClient: () => UncachedAssetClient,
   assetDefinitions: () => assetDefinitions,
-  convertAssetToPutAsset: () => convertAssetToPutAsset
+  convertAssetToPutAsset: () => convertAssetToPutAsset,
+  imageFrom: () => imageFrom
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -91,9 +92,80 @@ var assetDefinitions = {
   }
 };
 
+// src/imageDelivery.ts
+var isUniformImageUrl = (imageUrl) => {
+  try {
+    if (typeof imageUrl !== "string") {
+      return false;
+    }
+    return /(img)\.(eu\.)?uniform\.(rocks|global)$/.test(new URL(imageUrl).hostname);
+  } catch (e) {
+    return false;
+  }
+};
+var imageFrom = (asset) => {
+  var _a, _b, _c, _d;
+  const baseUrl = typeof asset === "string" ? asset : (_b = (_a = asset.fields) == null ? void 0 : _a.url) == null ? void 0 : _b.value;
+  const isUniformHosted = isUniformImageUrl(baseUrl);
+  const deliveryParams = {};
+  if (typeof asset !== "string") {
+    if ((_d = (_c = asset.fields) == null ? void 0 : _c.focalPoint) == null ? void 0 : _d.value) {
+      deliveryParams.focal = `${asset.fields.focalPoint.value.x}x${asset.fields.focalPoint.value.y}`;
+    }
+  }
+  const api = {
+    url: () => {
+      if (!baseUrl) {
+        return "";
+      }
+      if (!isUniformHosted) {
+        return baseUrl;
+      }
+      const url = new URL(baseUrl);
+      const params = deliveryParams;
+      if (params.width !== void 0) {
+        url.searchParams.set("width", params.width.toString());
+      }
+      if (params.height !== void 0) {
+        url.searchParams.set("height", params.height.toString());
+      }
+      if (params.fit !== void 0) {
+        url.searchParams.set("fit", params.fit);
+      } else if (params.width !== void 0 && params.height !== void 0) {
+        url.searchParams.set("fit", "cover");
+        params.fit = "cover";
+      }
+      if (params.width !== void 0 && params.height !== void 0 && params.focal !== void 0 && params.fit === "cover") {
+        url.searchParams.set("focal", params.focal);
+      }
+      return url.toString();
+    },
+    transform: (transformProps) => {
+      if (transformProps.width !== void 0) {
+        deliveryParams.width = transformProps.width;
+      }
+      if (transformProps.height !== void 0) {
+        deliveryParams.height = transformProps.height;
+      }
+      if (transformProps.fit !== void 0) {
+        deliveryParams.fit = transformProps.fit;
+      }
+      if (transformProps.focal !== void 0) {
+        if (typeof transformProps.focal === "string") {
+          deliveryParams.focal = transformProps.focal;
+        } else {
+          deliveryParams.focal = `${transformProps.focal.x}x${transformProps.focal.y}`;
+        }
+      }
+      return api;
+    }
+  };
+  return api;
+};
+
 // src/utils/assetConverter.ts
 function convertAssetToPutAsset(asset) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   return {
     asset: {
       _id: asset.asset._id,
@@ -103,7 +175,8 @@ function convertAssetToPutAsset(asset) {
       fields: {
         title: (_a = asset.asset.fields) == null ? void 0 : _a.title,
         description: (_b = asset.asset.fields) == null ? void 0 : _b.description,
-        file: (_c = asset.asset.fields) == null ? void 0 : _c.file
+        file: (_c = asset.asset.fields) == null ? void 0 : _c.file,
+        focalPoint: (_d = asset.asset.fields) == null ? void 0 : _d.focalPoint
       }
     },
     projectId: asset.projectId
@@ -114,5 +187,6 @@ function convertAssetToPutAsset(asset) {
   AssetClient,
   UncachedAssetClient,
   assetDefinitions,
-  convertAssetToPutAsset
+  convertAssetToPutAsset,
+  imageFrom
 });

package/dist/index.mjs

@@ -62,9 +62,80 @@ var assetDefinitions = {
   }
 };
 
+// src/imageDelivery.ts
+var isUniformImageUrl = (imageUrl) => {
+  try {
+    if (typeof imageUrl !== "string") {
+      return false;
+    }
+    return /(img)\.(eu\.)?uniform\.(rocks|global)$/.test(new URL(imageUrl).hostname);
+  } catch (e) {
+    return false;
+  }
+};
+var imageFrom = (asset) => {
+  var _a, _b, _c, _d;
+  const baseUrl = typeof asset === "string" ? asset : (_b = (_a = asset.fields) == null ? void 0 : _a.url) == null ? void 0 : _b.value;
+  const isUniformHosted = isUniformImageUrl(baseUrl);
+  const deliveryParams = {};
+  if (typeof asset !== "string") {
+    if ((_d = (_c = asset.fields) == null ? void 0 : _c.focalPoint) == null ? void 0 : _d.value) {
+      deliveryParams.focal = `${asset.fields.focalPoint.value.x}x${asset.fields.focalPoint.value.y}`;
+    }
+  }
+  const api = {
+    url: () => {
+      if (!baseUrl) {
+        return "";
+      }
+      if (!isUniformHosted) {
+        return baseUrl;
+      }
+      const url = new URL(baseUrl);
+      const params = deliveryParams;
+      if (params.width !== void 0) {
+        url.searchParams.set("width", params.width.toString());
+      }
+      if (params.height !== void 0) {
+        url.searchParams.set("height", params.height.toString());
+      }
+      if (params.fit !== void 0) {
+        url.searchParams.set("fit", params.fit);
+      } else if (params.width !== void 0 && params.height !== void 0) {
+        url.searchParams.set("fit", "cover");
+        params.fit = "cover";
+      }
+      if (params.width !== void 0 && params.height !== void 0 && params.focal !== void 0 && params.fit === "cover") {
+        url.searchParams.set("focal", params.focal);
+      }
+      return url.toString();
+    },
+    transform: (transformProps) => {
+      if (transformProps.width !== void 0) {
+        deliveryParams.width = transformProps.width;
+      }
+      if (transformProps.height !== void 0) {
+        deliveryParams.height = transformProps.height;
+      }
+      if (transformProps.fit !== void 0) {
+        deliveryParams.fit = transformProps.fit;
+      }
+      if (transformProps.focal !== void 0) {
+        if (typeof transformProps.focal === "string") {
+          deliveryParams.focal = transformProps.focal;
+        } else {
+          deliveryParams.focal = `${transformProps.focal.x}x${transformProps.focal.y}`;
+        }
+      }
+      return api;
+    }
+  };
+  return api;
+};
+
 // src/utils/assetConverter.ts
 function convertAssetToPutAsset(asset) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   return {
     asset: {
       _id: asset.asset._id,
@@ -74,7 +145,8 @@ function convertAssetToPutAsset(asset) {
       fields: {
         title: (_a = asset.asset.fields) == null ? void 0 : _a.title,
         description: (_b = asset.asset.fields) == null ? void 0 : _b.description,
-        file: (_c = asset.asset.fields) == null ? void 0 : _c.file
+        file: (_c = asset.asset.fields) == null ? void 0 : _c.file,
+        focalPoint: (_d = asset.asset.fields) == null ? void 0 : _d.focalPoint
       }
     },
     projectId: asset.projectId
@@ -84,5 +156,6 @@ export {
   AssetClient,
   UncachedAssetClient,
   assetDefinitions,
-  convertAssetToPutAsset
+  convertAssetToPutAsset,
+  imageFrom
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/assets",
-  "version": "20.7.1-alpha.12+75bdbe8f17",
+  "version": "20.7.1-alpha.121+a4f284458c",
   "description": "Uniform Assets",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -36,7 +36,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@uniformdev/context": "20.7.1-alpha.12+75bdbe8f17"
+    "@uniformdev/context": "20.7.1-alpha.121+a4f284458c"
   },
-  "gitHead": "75bdbe8f179a18d65e3460f795a657c69349a7dc"
+  "devDependencies": {
+    "ts-xor": "^1.3.0"
+  },
+  "gitHead": "a4f284458cffb24442299a5210bdad47c05aada3"
 }