@uniformdev/cli 19.80.1-alpha.149 → 19.80.1-alpha.192

package/dist/index.mjs

@@ -7,7 +7,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-// ../../node_modules/.pnpm/tsup@8.0.1_@microsoft+api-extractor@7.36.3_postcss@8.4.31_typescript@5.3.2/node_modules/tsup/assets/esm_shims.js
+// ../../node_modules/.pnpm/tsup@8.0.1_@microsoft+api-extractor@7.38.3_postcss@8.4.32_typescript@5.3.2/node_modules/tsup/assets/esm_shims.js
 import { fileURLToPath } from "url";
 import path from "path";
 var getFilename = () => fileURLToPath(import.meta.url);
@@ -16,11 +16,11 @@ var __dirname = /* @__PURE__ */ getDirname();
 
 // src/index.ts
 import * as dotenv from "dotenv";
-import yargs26 from "yargs";
+import yargs27 from "yargs";
 import { hideBin } from "yargs/helpers";
 
 // src/commands/canvas/index.ts
-import yargs10 from "yargs";
+import yargs11 from "yargs";
 
 // src/commands/canvas/commands/asset.ts
 import yargs from "yargs";
@@ -137,14 +137,14 @@ import httpsProxyAgent from "https-proxy-agent";
 import unfetch from "isomorphic-unfetch";
 import { dump, load } from "js-yaml";
 import { dirname, extname, isAbsolute, resolve, sep } from "path";
-function withConfiguration(yargs27) {
-  return yargs27.option("serialization", {
+function withConfiguration(yargs28) {
+  return yargs28.option("serialization", {
     skipValidation: true,
     hidden: true
   });
 }
-function withApiOptions(yargs27) {
-  return yargs27.option("apiKey", {
+function withApiOptions(yargs28) {
+  return yargs28.option("apiKey", {
     describe: "Uniform API key. Defaults to UNIFORM_CLI_API_KEY or UNIFORM_API_KEY env. Supports dotenv.",
     default: process.env.UNIFORM_CLI_API_KEY ?? // deprecated
     process.env.CANVAS_CLI_API_KEY ?? // deprecated
@@ -183,8 +183,8 @@ function nodeFetchProxy(proxy) {
   };
   return wrappedFetch;
 }
-function withProjectOptions(yargs27) {
-  return yargs27.option("project", {
+function withProjectOptions(yargs28) {
+  return yargs28.option("project", {
     describe: "Uniform project ID. Defaults to UNIFORM_CLI_PROJECT_ID or UNIFORM_PROJECT_ID env. Supports dotenv.",
     default: process.env.UNIFORM_CLI_PROJECT_ID ?? // deprecated
     process.env.CANVAS_CLI_PROJECT_ID ?? // deprecated
@@ -194,8 +194,8 @@ function withProjectOptions(yargs27) {
     alias: ["p"]
   });
 }
-function withFormatOptions(yargs27) {
-  return yargs27.option("format", {
+function withFormatOptions(yargs28) {
+  return yargs28.option("format", {
     alias: ["f"],
     describe: "Output format",
     default: "yaml",
@@ -207,8 +207,8 @@ function withFormatOptions(yargs27) {
     type: "string"
   });
 }
-function withDiffOptions(yargs27) {
-  return yargs27.option("diff", {
+function withDiffOptions(yargs28) {
+  return yargs28.option("diff", {
     describe: "Whether to show diffs in stdout. off = no diffs; update = on for updates; on = updates, creates, deletes. Can be set by UNIFORM_CLI_DIFF_MODE environment variable.",
     default: process.env.UNIFORM_CLI_DIFF_MODE ?? "off",
     type: "string",
@@ -632,12 +632,12 @@ function createPublishStatusSyncEngineConsoleLogger(options) {
 var AssetGetModule = {
   command: "get <id>",
   describe: "Get an asset",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Asset ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Asset ID to fetch" })
         )
       )
     )
@@ -658,7 +658,7 @@ import { UncachedAssetClient as UncachedAssetClient2 } from "@uniformdev/assets"
 var AssetListModule = {
   command: "list",
   describe: "List assets",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAssetClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -669,6 +669,7 @@ var AssetListModule = {
 
 // src/commands/canvas/commands/asset/pull.ts
 import { UncachedAssetClient as UncachedAssetClient3 } from "@uniformdev/assets";
+import { UncachedFileClient } from "@uniformdev/files";
 
 // src/files/index.ts
 import { preferredType } from "@thi.ng/mime";
@@ -679,20 +680,60 @@ import sizeOf from "image-size";
 import PQueue from "p-queue";
 import { dirname as dirname2, join as join2 } from "path";
 var FILES_DIRECTORY_NAME = "files";
+var escapeRegExp = (string) => {
+  return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
 var urlToHash = (url) => {
-  const hash = createHash("sha256");
-  hash.update(url);
-  return hash.digest("hex");
+  return Buffer.from(
+    // We take only the first 64 characters of the pathname as
+    // that's enough to guarantee uniqueness
+    new URL(url).pathname.substring(0, 64)
+  ).toString("base64");
+};
+var hashToPartialPathname = (hash) => {
+  try {
+    return Buffer.from(hash, "base64").toString("utf8");
+  } catch {
+    return null;
+  }
+};
+var findUrlMatchingPartialPathname = (source, pathname) => {
+  const escapedPathname = escapeRegExp(pathname);
+  const regex = new RegExp(`"(https://([^"]*?)?img.uniform.(rocks|global)${escapedPathname}([^"]*?))"`);
+  const match = source.match(regex);
+  if (match && match[1]) {
+    return match[1];
+  }
+  return null;
 };
-var urlToFileName = (url) => {
-  const fileName = urlToHash(url);
-  const fileNameChunks = url.split(".");
-  const fileExtension = fileNameChunks.length > 1 ? fileNameChunks.at(-1) : "";
+var urlToFileExtension = (url) => {
+  try {
+    const urlObject = new URL(url);
+    const fileNameChunks = urlObject.pathname.split(".");
+    return fileNameChunks.length > 1 ? fileNameChunks.at(-1) ?? null : null;
+  } catch {
+    return null;
+  }
+};
+var urlToFileName = (url, hash) => {
+  const fileName = hash ?? urlToHash(url);
+  const fileExtension = urlToFileExtension(url);
   return `${fileName}${fileExtension ? `.${fileExtension}` : ""}`;
 };
+var getFilesDirectory = (directory) => {
+  const isPackage = isPathAPackageFile(directory);
+  return isPackage ? dirname2(directory) : (
+    // If we are syncing to a directory, we want to write all files into a
+    // top-lvl folder. That way any entities that contain files will sync to the
+    // same directory, so there is no duplication
+    join2(directory, "..")
+  );
+};
+var getUniformFileUrlMatches = (string) => {
+  return string.matchAll(/"(https:\/\/([^"]*?)?img\.uniform\.(rocks|global)\/([^"]*?))"/g);
+};
 var deleteDownloadedFileByUrl = async (url, options) => {
-  const isPackage = isPathAPackageFile(options.directory);
-  const writeDirectory = isPackage ? dirname2(options.directory) : options.directory;
+  const writeDirectory = getFilesDirectory(options.directory);
   const fileName = urlToFileName(url);
   const fileToDelete = join2(writeDirectory, FILES_DIRECTORY_NAME, fileName);
   try {
@@ -703,18 +744,14 @@ var deleteDownloadedFileByUrl = async (url, options) => {
 };
 var extractAndDownloadUniformFilesForObject = async (object, options) => {
   const objectAsString = JSON.stringify(object);
-  const uniformFileUrlMatches = objectAsString.matchAll(
-    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
-  );
-  const isPackage = isPathAPackageFile(options.directory);
-  const writeDirectory = isPackage ? dirname2(options.directory) : options.directory;
+  const uniformFileUrlMatches = getUniformFileUrlMatches(objectAsString);
+  const writeDirectory = getFilesDirectory(options.directory);
   if (uniformFileUrlMatches) {
     const fileDownloadQueue = new PQueue({ concurrency: 10 });
     for (const match of uniformFileUrlMatches) {
       const url = new URL(match[1]);
       fileDownloadQueue.add(async () => {
         try {
-          const fetchUrl = `${url.origin}${url.pathname}?format=original`;
           const fileName = urlToFileName(url.toString());
           const fileAlreadyExists = await fsj.existsAsync(
             join2(writeDirectory, FILES_DIRECTORY_NAME, fileName)
@@ -722,6 +759,23 @@ var extractAndDownloadUniformFilesForObject = async (object, options) => {
           if (fileAlreadyExists) {
             return;
           }
+          const file = await options.fileClient.get({ url: url.toString() }).catch(() => null);
+          if (!file) {
+            console.warn(`Skipping file ${url} as it does not exist in the project anymore`);
+            return;
+          }
+          if (file.sourceId) {
+            try {
+              const hashAlreadyExists = await fsj.findAsync(join2(writeDirectory, FILES_DIRECTORY_NAME), {
+                matching: [file.sourceId, `${file.sourceId}.*`]
+              });
+              if (hashAlreadyExists.length > 0) {
+                return;
+              }
+            } catch {
+            }
+          }
+          const fetchUrl = `${url.origin}${url.pathname}?format=original`;
           const response = await fetch(fetchUrl);
           if (!response.ok) {
             return;
@@ -739,37 +793,41 @@ var extractAndDownloadUniformFilesForObject = async (object, options) => {
 };
 var extractAndUploadUniformFilesForObject = async (object, options) => {
   let objectAsString = JSON.stringify(object);
-  const uniformFileUrlMatches = objectAsString.matchAll(
-    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
-  );
+  const uniformFileUrlMatches = getUniformFileUrlMatches(objectAsString);
+  const writeDirectory = getFilesDirectory(options.directory);
   const isPackage = isPathAPackageFile(options.directory);
-  const writeDirectory = isPackage ? dirname2(options.directory) : options.directory;
+  const legacyWriteDirectory = isPackage ? dirname2(options.directory) : options.directory;
   if (uniformFileUrlMatches) {
     const fileUploadQueue = new PQueue({ concurrency: 3 });
     for (const match of uniformFileUrlMatches) {
       const url = match[1];
       const hash = urlToHash(url);
+      const legacyHash = legacyUrlToHash(url);
       fileUploadQueue.add(async () => {
         try {
           const fileAlreadyExistsChecks = await Promise.all([
             options.fileClient.get({ url }).catch(() => null),
-            options.fileClient.get({ sourceId: hash }).catch(() => null)
+            options.fileClient.get({ sourceId: hash }).catch(() => null),
+            options.fileClient.get({ sourceId: legacyHash }).catch(() => null)
           ]);
           if (fileAlreadyExistsChecks.some((check) => check !== null)) {
             return;
           }
           const localFileName = urlToFileName(url);
-          const fileExistsLocally = await fsj.existsAsync(
-            join2(writeDirectory, FILES_DIRECTORY_NAME, localFileName)
-          );
+          let expectedFilePath = join2(writeDirectory, FILES_DIRECTORY_NAME, localFileName);
+          let fileExistsLocally = await fsj.existsAsync(expectedFilePath);
           if (!fileExistsLocally) {
-            console.warn(`Skipping file ${url} as we couldn't find a local copy`);
+            const localFileName2 = legacyUrlToFileName(url);
+            expectedFilePath = join2(legacyWriteDirectory, FILES_DIRECTORY_NAME, localFileName2);
+            fileExistsLocally = await fsj.existsAsync(expectedFilePath);
+          }
+          if (!fileExistsLocally) {
+            console.warn(
+              `Skipping file ${url} as we couldn't find a local copy (looked at ${expectedFilePath})`
+            );
             return;
           }
-          const fileBuffer = await fsj.readAsync(
-            join2(writeDirectory, FILES_DIRECTORY_NAME, localFileName),
-            "buffer"
-          );
+          const fileBuffer = await fsj.readAsync(expectedFilePath, "buffer");
           if (!fileBuffer) {
             console.warn(`Skipping file ${url} as we couldn't read it`);
             return;
@@ -815,8 +873,8 @@ var extractAndUploadUniformFilesForObject = async (object, options) => {
             return file.url;
           };
           const abortTimeout = setTimeout(() => {
-            throw new Error(`Failed to upload file ${url}`);
-          }, 1e4);
+            throw new Error(`Failed to upload file ${url} (upload timed out)`);
+          }, 3e4);
           const uploadedFileUrl = await checkForFile();
           clearTimeout(abortTimeout);
           objectAsString = objectAsString.replaceAll(`"${url}"`, `"${uploadedFileUrl}"`);
@@ -831,19 +889,19 @@ var extractAndUploadUniformFilesForObject = async (object, options) => {
 };
 var swapOutUniformFileUrlsForTargetProject = async (object, options) => {
   let objectAsString = JSON.stringify(object);
-  const uniformFileUrlMatches = objectAsString.matchAll(
-    /"(https:\/\/(.*)?img\.uniform\.(rocks|global)\/(.*?))"/g
-  );
+  const uniformFileUrlMatches = getUniformFileUrlMatches(objectAsString);
   if (uniformFileUrlMatches) {
     const fileUrlReplacementQueue = new PQueue({ concurrency: 3 });
     for (const match of uniformFileUrlMatches) {
       const url = match[1];
       const hash = urlToHash(url);
+      const legacyHash = legacyUrlToHash(url);
       fileUrlReplacementQueue.add(async () => {
         try {
           const fileAlreadyExistsChecks = await Promise.all([
             options.fileClient.get({ url }).catch(() => null),
-            options.fileClient.get({ sourceId: hash }).catch(() => null)
+            options.fileClient.get({ sourceId: hash }).catch(() => null),
+            options.fileClient.get({ sourceId: legacyHash }).catch(() => null)
           ]);
           const file = fileAlreadyExistsChecks.find((check) => check !== null);
           if (!file) {
@@ -858,19 +916,74 @@ var swapOutUniformFileUrlsForTargetProject = async (object, options) => {
   }
   return JSON.parse(objectAsString);
 };
+var replaceRemoteUrlsWithLocalReferences = async (sourceObject, targetObject, options) => {
+  let sourceObjectAsString = JSON.stringify(sourceObject);
+  const targetObjectAsString = JSON.stringify(targetObject);
+  const uniformFileUrlMatches = getUniformFileUrlMatches(sourceObjectAsString);
+  const writeDirectory = getFilesDirectory(options.directory);
+  if (uniformFileUrlMatches) {
+    const fileUrlReplacementQueue = new PQueue({ concurrency: 3 });
+    for (const match of uniformFileUrlMatches) {
+      const url = match[1];
+      fileUrlReplacementQueue.add(async () => {
+        try {
+          const localFileName = urlToFileName(url);
+          const fileExistsLocally = await fsj.existsAsync(
+            join2(writeDirectory, FILES_DIRECTORY_NAME, localFileName)
+          );
+          if (fileExistsLocally) {
+            return;
+          }
+          const file = await options.fileClient.get({ url }).catch(() => null);
+          if (!file || !file.sourceId) {
+            return;
+          }
+          const originalPartialPath = hashToPartialPathname(file.sourceId);
+          if (!originalPartialPath) {
+            return;
+          }
+          const originalUrl = findUrlMatchingPartialPathname(targetObjectAsString, originalPartialPath);
+          if (!originalUrl) {
+            return;
+          }
+          sourceObjectAsString = sourceObjectAsString.replaceAll(`"${url}"`, `"${originalUrl}"`);
+        } catch {
+        }
+      });
+    }
+    await fileUrlReplacementQueue.onIdle();
+  }
+  return JSON.parse(sourceObjectAsString);
+};
 var updateAssetFileIdBasedOnUrl = async (asset, options) => {
-  var _a, _b, _c;
-  const fileUrl = (_b = (_a = asset.asset.fields) == null ? void 0 : _a.url) == null ? void 0 : _b.value;
-  if (!fileUrl || !((_c = asset.asset.fields) == null ? void 0 : _c.file)) {
+  var _a;
+  if (!asset.asset.fields) {
+    return asset;
+  }
+  const fileUrl = (_a = asset.asset.fields.url) == null ? void 0 : _a.value;
+  if (!fileUrl) {
     return asset;
   }
   const file = await options.fileClient.get({ url: fileUrl }).catch(() => null);
   if (!file) {
     return asset;
   }
-  asset.asset.fields.file.value = file.id;
+  asset.asset.fields.file = {
+    type: "file",
+    value: file.id
+  };
   return asset;
 };
+var legacyUrlToHash = (url) => {
+  const hash = createHash("sha256");
+  hash.update(url);
+  return hash.digest("hex");
+};
+var legacyUrlToFileName = (url) => {
+  const fileName = legacyUrlToHash(url);
+  const fileExtension = urlToFileExtension(url);
+  return `${fileName}${fileExtension ? `.${fileExtension}` : ""}`;
+};
 
 // src/commands/canvas/assetEngineDataSource.ts
 import { convertAssetToPutAsset } from "@uniformdev/assets";
@@ -895,8 +1008,8 @@ function prepCompositionForDisk(composition) {
   delete prepped.state;
   return prepped;
 }
-function withStateOptions(yargs27) {
-  return yargs27.option("state", {
+function withStateOptions(yargs28) {
+  return yargs28.option("state", {
     type: "string",
     describe: `Composition state to fetch.`,
     choices: ["preview", "published"],
@@ -962,11 +1075,11 @@ function writeCanvasPackage(filename, packageContents) {
 var AssetPullModule = {
   command: "pull <directory>",
   describe: "Pulls all assets to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the assets to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -1009,6 +1122,7 @@ var AssetPullModule = {
       fetch: fetch3,
       projectId
     });
+    const fileClient = new UncachedFileClient({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createAssetEngineDataSource({ client });
     let target;
     const isPackage = isPathAPackageFile(directory);
@@ -1050,14 +1164,27 @@ var AssetPullModule = {
       whatIf,
       allowEmptySource: true,
       log: createSyncEngineConsoleLogger({ diffMode }),
-      onBeforeCompareObjects: async (sourceObject) => {
+      onBeforeCompareObjects: async (sourceObject, targetObject) => {
+        var _a, _b;
         delete sourceObject.object.asset._author;
-        return sourceObject;
+        const sourceObjectWithPotentiallySwappedUrl = await replaceRemoteUrlsWithLocalReferences(
+          sourceObject,
+          targetObject,
+          {
+            directory,
+            fileClient
+          }
+        );
+        if (((_a = sourceObjectWithPotentiallySwappedUrl.object.asset.fields) == null ? void 0 : _a.url) && ((_b = targetObject.object.asset.fields) == null ? void 0 : _b.url) && sourceObjectWithPotentiallySwappedUrl.object.asset.fields.url.value === targetObject.object.asset.fields.url.value) {
+          targetObject.object.asset.fields.file = sourceObjectWithPotentiallySwappedUrl.object.asset.fields.file;
+        }
+        return sourceObjectWithPotentiallySwappedUrl;
       },
       onBeforeWriteObject: async (sourceObject) => {
         delete sourceObject.object.asset._author;
         return extractAndDownloadUniformFilesForObject(sourceObject, {
-          directory
+          directory,
+          fileClient
         });
       }
     });
@@ -1066,15 +1193,15 @@ var AssetPullModule = {
 
 // src/commands/canvas/commands/asset/push.ts
 import { UncachedAssetClient as UncachedAssetClient4 } from "@uniformdev/assets";
-import { UncachedFileClient } from "@uniformdev/files";
+import { UncachedFileClient as UncachedFileClient2 } from "@uniformdev/files";
 var AssetPushModule = {
   command: "push <directory>",
   describe: "Pushes all assets from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the assets from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -1127,7 +1254,7 @@ var AssetPushModule = {
       });
     }
     const target = createAssetEngineDataSource({ client });
-    const fileClient = new UncachedFileClient({ apiKey, apiHost, fetch: fetch3, projectId });
+    const fileClient = new UncachedFileClient2({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
@@ -1150,10 +1277,15 @@ var AssetPushModule = {
         return sourceObjectWithNewFileUrls;
       },
       onBeforeWriteObject: async (sourceObject) => {
-        const sourceObjectWithNewFileUrls = await extractAndUploadUniformFilesForObject(sourceObject, {
-          directory,
-          fileClient
-        });
+        const sourceObjectWithNewFileUrls = await swapOutUniformFileUrlsForTargetProject(
+          await extractAndUploadUniformFilesForObject(sourceObject, {
+            directory,
+            fileClient
+          }),
+          {
+            fileClient
+          }
+        );
         sourceObjectWithNewFileUrls.object = await updateAssetFileIdBasedOnUrl(
           sourceObjectWithNewFileUrls.object,
           {
@@ -1172,9 +1304,9 @@ var AssetRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an asset",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: "Asset ID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: "Asset ID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -1190,10 +1322,10 @@ var AssetUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an asset",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Asset file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Asset file to put" })
       )
     )
   ),
@@ -1209,7 +1341,7 @@ var AssetUpdateModule = {
 var AssetModule = {
   command: "asset <command>",
   describe: "Commands for Assets",
-  builder: (yargs27) => yargs27.command(AssetGetModule).command(AssetListModule).command(AssetRemoveModule).command(AssetUpdateModule).command(AssetPullModule).command(AssetPushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(AssetGetModule).command(AssetListModule).command(AssetRemoveModule).command(AssetUpdateModule).command(AssetPullModule).command(AssetPushModule).demandCommand(),
   handler: () => {
     yargs.help();
   }
@@ -1223,11 +1355,11 @@ import { UncachedCategoryClient } from "@uniformdev/canvas";
 var CategoryGetModule = {
   command: "get <id>",
   describe: "Fetch a category",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Category UUID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Category UUID to fetch" })
         )
       )
     )
@@ -1252,7 +1384,7 @@ var CategoryListModule = {
   command: "list",
   describe: "List categories",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27.options({}))))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28.options({}))))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCategoryClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -1301,11 +1433,11 @@ function createCategoriesEngineDataSource({
 var CategoryPullModule = {
   command: "pull <directory>",
   describe: "Pulls all categories to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the categories to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -1381,11 +1513,11 @@ import { UncachedCategoryClient as UncachedCategoryClient4 } from "@uniformdev/c
 var CategoryPushModule = {
   command: "push <directory>",
   describe: "Pushes all categories from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the categories from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -1449,10 +1581,10 @@ var CategoryRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a category",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Category UUID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Category UUID to delete" })
       )
     )
   ),
@@ -1469,10 +1601,10 @@ var CategoryUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a category",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Category file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Category file to put" })
       )
     )
   ),
@@ -1489,7 +1621,7 @@ var CategoryModule = {
   command: "category <command>",
   aliases: ["cat"],
   describe: "Commands for Canvas categories",
-  builder: (yargs27) => yargs27.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(CategoryPullModule).command(CategoryPushModule).command(CategoryGetModule).command(CategoryRemoveModule).command(CategoryListModule).command(CategoryUpdateModule).demandCommand(),
   handler: () => {
     yargs2.help();
   }
@@ -1510,11 +1642,11 @@ var selectSchemaUrl = () => "/schemas/json-schema/component-definition/v1.json";
 var ComponentGetModule = {
   command: "get <id>",
   describe: "Fetch a component definition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", {
+          yargs28.positional("id", {
             demandOption: true,
             describe: "Component definition public ID to fetch"
           })
@@ -1548,11 +1680,11 @@ var ComponentListModule = {
   command: "list",
   describe: "List component definitions",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.options({
+          yargs28.options({
             offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
             limit: { describe: "Number of rows to fetch", type: "number", default: 20 }
           })
@@ -1607,11 +1739,11 @@ function createComponentDefinitionEngineDataSource({
 var ComponentPullModule = {
   command: "pull <directory>",
   describe: "Pulls all component definitions to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -1688,11 +1820,11 @@ import { UncachedCanvasClient as UncachedCanvasClient4 } from "@uniformdev/canva
 var ComponentPushModule = {
   command: "push <directory>",
   describe: "Pushes all component definitions from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the component definitions from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -1757,10 +1889,10 @@ var ComponentRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a component definition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Component definition public ID to delete" })
       )
     )
   ),
@@ -1777,10 +1909,10 @@ var ComponentUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a component definition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Component definition file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Component definition file to put" })
       )
     )
   ),
@@ -1797,7 +1929,7 @@ var ComponentModule = {
   command: "component <command>",
   aliases: ["def"],
   describe: "Commands for Canvas component definitions",
-  builder: (yargs27) => yargs27.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ComponentPullModule).command(ComponentPushModule).command(ComponentGetModule).command(ComponentRemoveModule).command(ComponentListModule).command(ComponentUpdateModule).demandCommand(),
   handler: () => {
     yargs3.help();
   }
@@ -1811,12 +1943,12 @@ import { UncachedCanvasClient as UncachedCanvasClient7 } from "@uniformdev/canva
 var CompositionGetModule = {
   command: "get <id>",
   describe: "Fetch a composition",
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
           withStateOptions(
-            yargs27.positional("id", { demandOption: true, describe: "Composition/pattern public ID to fetch" }).option({
+            yargs28.positional("id", { demandOption: true, describe: "Composition/pattern public ID to fetch" }).option({
               resolvePatterns: {
                 type: "boolean",
                 default: false,
@@ -1887,12 +2019,12 @@ var CompositionListModule = {
   command: "list",
   describe: "List compositions",
   aliases: ["ls"],
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
           withStateOptions(
-            yargs27.options({
+            yargs28.options({
               offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
               limit: { describe: "Number of rows to fetch", type: "number", default: 20 },
               resolvePatterns: {
@@ -2013,11 +2145,11 @@ function createComponentInstanceEngineDataSource({
 var CompositionPublishModule = {
   command: "publish [ids]",
   describe: "Publishes composition(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("ids", {
+          yargs28.positional("ids", {
             describe: "Publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
             type: "string"
           }).option("all", {
@@ -2089,15 +2221,16 @@ var CompositionPublishModule = {
 
 // src/commands/canvas/commands/composition/pull.ts
 import { UncachedCanvasClient as UncachedCanvasClient10 } from "@uniformdev/canvas";
+import { UncachedFileClient as UncachedFileClient3 } from "@uniformdev/files";
 var CompositionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all compositions to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
               type: "string"
             }).option("format", {
@@ -2148,6 +2281,7 @@ var CompositionPullModule = {
   }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedCanvasClient10({ apiKey, apiHost, fetch: fetch3, projectId });
+    const fileClient = new UncachedFileClient3({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
     const isPackage = isPathAPackageFile(directory);
     let target;
@@ -2177,9 +2311,16 @@ var CompositionPullModule = {
       whatIf,
       allowEmptySource: true,
       log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject, targetObject) => {
+        return replaceRemoteUrlsWithLocalReferences(sourceObject, targetObject, {
+          directory,
+          fileClient
+        });
+      },
       onBeforeWriteObject: async (sourceObject) => {
         return extractAndDownloadUniformFilesForObject(sourceObject, {
-          directory
+          directory,
+          fileClient
         });
       }
     });
@@ -2188,16 +2329,16 @@ var CompositionPullModule = {
 
 // src/commands/canvas/commands/composition/push.ts
 import { UncachedCanvasClient as UncachedCanvasClient11 } from "@uniformdev/canvas";
-import { UncachedFileClient as UncachedFileClient2 } from "@uniformdev/files";
+import { UncachedFileClient as UncachedFileClient4 } from "@uniformdev/files";
 var CompositionPushModule = {
   command: "push <directory>",
   describe: "Pushes all compositions from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to read the compositions/patterns from. If a filename is used, a package will be read instead.",
               type: "string"
             }).option("what-if", {
@@ -2258,7 +2399,7 @@ var CompositionPushModule = {
       });
     }
     const target = createComponentInstanceEngineDataSource({ client, state, onlyCompositions, onlyPatterns });
-    const fileClient = new UncachedFileClient2({ apiKey, apiHost, fetch: fetch3, projectId });
+    const fileClient = new UncachedFileClient4({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
@@ -2286,10 +2427,10 @@ var CompositionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a composition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Composition/pattern public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Composition/pattern public ID to delete" })
       )
     )
   ),
@@ -2306,10 +2447,10 @@ import { diffJson as diffJson2 } from "diff";
 var CompositionUnpublishModule = {
   command: "unpublish [ids]",
   describe: "Unpublish a composition(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("ids", {
+        yargs28.positional("ids", {
           describe: "Un-publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to un-publish all instead.",
           type: "string"
         }).option("all", {
@@ -2403,11 +2544,11 @@ var CompositionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a composition",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
-          yargs27.positional("filename", { demandOption: true, describe: "Composition/pattern file to put" })
+          yargs28.positional("filename", { demandOption: true, describe: "Composition/pattern file to put" })
         )
       )
     )
@@ -2425,7 +2566,7 @@ var CompositionModule = {
   command: "composition <command>",
   describe: "Commands for Canvas compositions",
   aliases: ["comp"],
-  builder: (yargs27) => yargs27.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(CompositionPullModule).command(CompositionPushModule).command(CompositionGetModule).command(CompositionRemoveModule).command(CompositionListModule).command(CompositionUpdateModule).command(CompositionPublishModule).command(CompositionUnpublishModule).demandCommand(),
   handler: () => {
     yargs4.help();
   }
@@ -2439,12 +2580,12 @@ import { ContentClient } from "@uniformdev/canvas";
 var ContentTypeGetModule = {
   command: "get <id>",
   describe: "Get a content type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Content type public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Content type public ID to fetch" })
         )
       )
     )
@@ -2466,7 +2607,7 @@ import { ContentClient as ContentClient2 } from "@uniformdev/canvas";
 var ContentTypeListModule = {
   command: "list",
   describe: "List content types",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -2513,11 +2654,11 @@ function createContentTypeEngineDataSource({
 var ContentTypePullModule = {
   command: "pull <directory>",
   describe: "Pulls all content types to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the content types to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -2599,11 +2740,11 @@ import { ContentClient as ContentClient4 } from "@uniformdev/canvas";
 var ContentTypePushModule = {
   command: "push <directory>",
   describe: "Pushes all content types from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the content types from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -2673,10 +2814,10 @@ var ContentTypeRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a content type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Content type public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Content type public ID to delete" })
       )
     )
   ),
@@ -2693,10 +2834,10 @@ var ContentTypeUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a content type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Content type file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Content type file to put" })
       )
     )
   ),
@@ -2713,7 +2854,7 @@ var ContentTypeModule = {
   command: "contenttype <command>",
   aliases: ["ct"],
   describe: "Commands for Content Types",
-  builder: (yargs27) => yargs27.command(ContentTypeGetModule).command(ContentTypeListModule).command(ContentTypeRemoveModule).command(ContentTypeUpdateModule).command(ContentTypePullModule).command(ContentTypePushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ContentTypeGetModule).command(ContentTypeListModule).command(ContentTypeRemoveModule).command(ContentTypeUpdateModule).command(ContentTypePullModule).command(ContentTypePushModule).demandCommand(),
   handler: () => {
     yargs5.help();
   }
@@ -2728,12 +2869,12 @@ var DataTypeGetModule = {
   command: "get <id>",
   describe: "Get a data type",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Data type public ID to fetch" })
         )
       )
     )
@@ -2756,7 +2897,7 @@ var DataTypeListModule = {
   command: "list",
   describe: "List data types",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new DataTypeClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -2805,11 +2946,11 @@ function createDataTypeEngineDataSource({
 var DataTypePullModule = {
   command: "pull <directory>",
   describe: "Pulls all data types to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the data types to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -2891,11 +3032,11 @@ import { DataTypeClient as DataTypeClient4 } from "@uniformdev/canvas";
 var DataTypePushModule = {
   command: "push <directory>",
   describe: "Pushes all data types from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the data types from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -2965,10 +3106,10 @@ var DataTypeRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a data type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Data type public ID to delete" })
       )
     )
   ),
@@ -2985,10 +3126,10 @@ var DataTypeUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a data type",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Data type file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Data type file to put" })
       )
     )
   ),
@@ -3005,7 +3146,7 @@ var DataTypeModule = {
   command: "datatype <command>",
   aliases: ["dt"],
   describe: "Commands for Data Type definitions",
-  builder: (yargs27) => yargs27.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(DataTypeGetModule).command(DataTypePullModule).command(DataTypePushModule).command(DataTypeRemoveModule).command(DataTypeListModule).command(DataTypeUpdateModule).demandCommand(),
   handler: () => {
     yargs6.help();
   }
@@ -3019,12 +3160,12 @@ import { ContentClient as ContentClient7 } from "@uniformdev/canvas";
 var EntryGetModule = {
   command: "get <id>",
   describe: "Get an entry",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Entry public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Entry public ID to fetch" })
         )
       )
     )
@@ -3050,7 +3191,7 @@ import { ContentClient as ContentClient8 } from "@uniformdev/canvas";
 var EntryListModule = {
   command: "list",
   describe: "List entries",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new ContentClient8({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -3061,6 +3202,7 @@ var EntryListModule = {
 
 // src/commands/canvas/commands/entry/pull.ts
 import { ContentClient as ContentClient10 } from "@uniformdev/canvas";
+import { UncachedFileClient as UncachedFileClient5 } from "@uniformdev/files";
 
 // src/commands/canvas/entryEngineDataSource.ts
 import { convertEntryToPutEntry } from "@uniformdev/canvas";
@@ -3109,12 +3251,12 @@ function createEntryEngineDataSource({
 var EntryPullModule = {
   command: "pull <directory>",
   describe: "Pulls all entries to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to save the entries to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
               type: "string"
             }).option("format", {
@@ -3160,6 +3302,7 @@ var EntryPullModule = {
       projectId,
       bypassCache: true
     });
+    const fileClient = new UncachedFileClient5({ apiKey, apiHost, fetch: fetch3, projectId });
     const source = createEntryEngineDataSource({ client, state });
     let target;
     const isPackage = isPathAPackageFile(directory);
@@ -3188,22 +3331,35 @@ var EntryPullModule = {
       mode,
       whatIf,
       allowEmptySource: true,
-      log: createSyncEngineConsoleLogger({ diffMode })
+      log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject, targetObject) => {
+        return replaceRemoteUrlsWithLocalReferences(sourceObject, targetObject, {
+          directory,
+          fileClient
+        });
+      },
+      onBeforeWriteObject: async (sourceObject) => {
+        return extractAndDownloadUniformFilesForObject(sourceObject, {
+          directory,
+          fileClient
+        });
+      }
     });
   }
 };
 
 // src/commands/canvas/commands/entry/push.ts
 import { ContentClient as ContentClient11 } from "@uniformdev/canvas";
+import { UncachedFileClient as UncachedFileClient6 } from "@uniformdev/files";
 var EntryPushModule = {
   command: "push <directory>",
   describe: "Pushes all entries from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to read the entries from. If a filename is used, a package will be read instead.",
               type: "string"
             }).option("what-if", {
@@ -3259,12 +3415,24 @@ var EntryPushModule = {
       });
     }
     const target = createEntryEngineDataSource({ client, state });
+    const fileClient = new UncachedFileClient6({ apiKey, apiHost, fetch: fetch3, projectId });
     await syncEngine({
       source,
       target,
       mode,
       whatIf,
-      log: createSyncEngineConsoleLogger({ diffMode })
+      log: createSyncEngineConsoleLogger({ diffMode }),
+      onBeforeCompareObjects: async (sourceObject) => {
+        return swapOutUniformFileUrlsForTargetProject(sourceObject, {
+          fileClient
+        });
+      },
+      onBeforeWriteObject: async (sourceObject) => {
+        return extractAndUploadUniformFilesForObject(sourceObject, {
+          directory,
+          fileClient
+        });
+      }
     });
   }
 };
@@ -3275,10 +3443,10 @@ var EntryRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an entry",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Entry public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Entry public ID to delete" })
       )
     )
   ),
@@ -3295,10 +3463,10 @@ var EntryUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an entry",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Entry file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Entry file to put" })
       )
     )
   ),
@@ -3314,15 +3482,218 @@ var EntryUpdateModule = {
 var EntryModule = {
   command: "entry <command>",
   describe: "Commands for Entries",
-  builder: (yargs27) => yargs27.command(EntryGetModule).command(EntryListModule).command(EntryRemoveModule).command(EntryUpdateModule).command(EntryPullModule).command(EntryPushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(EntryGetModule).command(EntryListModule).command(EntryRemoveModule).command(EntryUpdateModule).command(EntryPullModule).command(EntryPushModule).demandCommand(),
   handler: () => {
     yargs7.help();
   }
 };
 
-// src/commands/canvas/commands/pattern.ts
+// src/commands/canvas/commands/locale.ts
 import yargs8 from "yargs";
 
+// src/commands/canvas/commands/locale/pull.ts
+import { LocaleClient } from "@uniformdev/canvas";
+
+// src/commands/canvas/localesEngineDataSource.ts
+function createLocaleEngineDataSource({
+  client
+}) {
+  async function* getObjects() {
+    const locales = (await client.get()).results;
+    for await (const locale of locales) {
+      const result = {
+        id: locale.locale,
+        displayName: locale.displayName,
+        providerId: locale.locale,
+        object: locale
+      };
+      yield result;
+    }
+  }
+  return {
+    objects: getObjects(),
+    deleteObject: async (providerId) => {
+      await client.remove({ locale: providerId });
+    },
+    writeObject: async (object) => {
+      await client.upsert({
+        locale: object.object
+      });
+    }
+  };
+}
+
+// src/commands/canvas/commands/locale/pull.ts
+var LocalePullModule = {
+  command: "pull <directory>",
+  describe: "Pulls all locales to local files in a directory",
+  builder: (yargs28) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs28.positional("directory", {
+            describe: "Directory to save the locales to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
+            type: "string"
+          }).option("format", {
+            alias: ["f"],
+            describe: "Output format",
+            default: "yaml",
+            choices: ["yaml", "json"],
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes no files",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new files, update nothing. "createOrUpdate" = create new files, update existing, delete nothing. "mirror" = create, update, and delete to mirror state',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
+      )
+    )
+  ),
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    directory,
+    format,
+    mode,
+    whatIf,
+    project: projectId,
+    diff: diffMode
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new LocaleClient({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    const source = createLocaleEngineDataSource({ client });
+    let target;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, false);
+      target = await createArraySyncEngineDataSource({
+        objects: packageContents.locales ?? [],
+        selectIdentifier: (i) => i.locale,
+        selectDisplayName: (i) => i.displayName,
+        onSyncComplete: async (_, synced) => {
+          packageContents.locales = synced;
+          writeCanvasPackage(directory, packageContents);
+        }
+      });
+    } else {
+      target = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: (i) => i.locale,
+        selectDisplayName: (i) => i.displayName,
+        format
+      });
+    }
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      allowEmptySource: true,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/locale/push.ts
+import { LocaleClient as LocaleClient2 } from "@uniformdev/canvas";
+var LocalePushModule = {
+  command: "push <directory>",
+  describe: "Pushes all locales from files in a directory to Uniform",
+  builder: (yargs28) => withConfiguration(
+    withApiOptions(
+      withProjectOptions(
+        withDiffOptions(
+          yargs28.positional("directory", {
+            describe: "Directory to read the locales from. If a filename is used, a package will be read instead.",
+            type: "string"
+          }).option("what-if", {
+            alias: ["w"],
+            describe: "What-if mode reports what would be done but changes nothing",
+            default: false,
+            type: "boolean"
+          }).option("mode", {
+            alias: ["m"],
+            describe: 'What kind of changes can be made. "create" = create new, update nothing. "createOrUpdate" = create new, update existing, delete nothing. "mirror" = create, update, and delete',
+            choices: ["create", "createOrUpdate", "mirror"],
+            default: "mirror",
+            type: "string"
+          })
+        )
+      )
+    )
+  ),
+  handler: async ({
+    apiHost,
+    apiKey,
+    proxy,
+    directory,
+    mode,
+    whatIf,
+    project: projectId,
+    diff: diffMode
+  }) => {
+    const fetch3 = nodeFetchProxy(proxy);
+    const client = new LocaleClient2({
+      apiKey,
+      apiHost,
+      fetch: fetch3,
+      projectId,
+      bypassCache: true
+    });
+    let source;
+    const isPackage = isPathAPackageFile(directory);
+    if (isPackage) {
+      const packageContents = readCanvasPackage(directory, true);
+      source = await createArraySyncEngineDataSource({
+        objects: packageContents.locales ?? [],
+        selectIdentifier: (locale) => locale.locale,
+        selectDisplayName: (locale) => locale.displayName
+      });
+    } else {
+      source = await createFileSyncEngineDataSource({
+        directory,
+        selectIdentifier: (locale) => locale.locale,
+        selectDisplayName: (locale) => locale.displayName
+      });
+    }
+    const target = createLocaleEngineDataSource({ client });
+    await syncEngine({
+      source,
+      target,
+      mode,
+      whatIf,
+      log: createSyncEngineConsoleLogger({ diffMode })
+    });
+  }
+};
+
+// src/commands/canvas/commands/locale.ts
+var LocaleModule = {
+  command: "locale <command>",
+  describe: "Commands for locale definitions",
+  builder: (yargs28) => yargs28.command(LocalePullModule).command(LocalePushModule),
+  handler: () => {
+    yargs8.help();
+  }
+};
+
+// src/commands/canvas/commands/pattern.ts
+import yargs9 from "yargs";
+
 // src/commands/canvas/commands/pattern/get.ts
 var PatternGetModule = {
   ...CompositionGetModule,
@@ -3333,12 +3704,12 @@ var PatternGetModule = {
 var PatternListModule = {
   ...CompositionListModule,
   describe: "List patterns",
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
           withStateOptions(
-            yargs27.options({
+            yargs28.options({
               offset: { describe: "Number of rows to skip before fetching", type: "number", default: 0 },
               limit: { describe: "Number of rows to fetch", type: "number", default: 20 },
               resolvePatterns: {
@@ -3376,11 +3747,11 @@ var PatternListModule = {
 var PatternPublishModule = {
   ...CompositionPublishModule,
   describe: "Publishes pattern(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("ids", {
+          yargs28.positional("ids", {
             describe: "Publishes pattern(s) by ID. Comma-separate multiple IDs. Use --all to publish all instead.",
             type: "string"
           }).option("all", {
@@ -3418,12 +3789,12 @@ var PatternPublishModule = {
 var PatternPullModule = {
   ...CompositionPullModule,
   describe: "Pulls all patterns to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to save the component definitions to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
               type: "string"
             }).option("format", {
@@ -3461,12 +3832,12 @@ var PatternPullModule = {
 var PatternPushModule = {
   ...CompositionPushModule,
   describe: "Pushes all patterns from files in a directory to Uniform Canvas",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to read the compositions/patterns from. If a filename is used, a package will be read instead.",
               type: "string"
             }).option("what-if", {
@@ -3504,10 +3875,10 @@ var PatternRemoveModule = {
 var PatternUnpublishModule = {
   command: "unpublish [ids]",
   describe: "Unpublish a pattern(s)",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("ids", {
+        yargs28.positional("ids", {
           describe: "Un-publishes composition(s) by ID. Comma-separate multiple IDs. Use --all to un-publish all instead.",
           type: "string"
         }).option("all", {
@@ -3546,26 +3917,26 @@ var PatternUpdateModule = {
 var PatternModule = {
   command: "pattern <command>",
   describe: "Commands for Canvas patterns",
-  builder: (yargs27) => yargs27.command(PatternPullModule).command(PatternPushModule).command(PatternGetModule).command(PatternRemoveModule).command(PatternListModule).command(PatternUpdateModule).command(PatternPublishModule).command(PatternUnpublishModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(PatternPullModule).command(PatternPushModule).command(PatternGetModule).command(PatternRemoveModule).command(PatternListModule).command(PatternUpdateModule).command(PatternPublishModule).command(PatternUnpublishModule).demandCommand(),
   handler: () => {
-    yargs8.help();
+    yargs9.help();
   }
 };
 
 // src/commands/canvas/commands/prompts.ts
-import yargs9 from "yargs";
+import yargs10 from "yargs";
 
 // src/commands/canvas/commands/prompts/get.ts
 import { PromptClient } from "@uniformdev/canvas";
 var PromptGetModule = {
   command: "get <id>",
   describe: "Get a prompt",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
           // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          yargs27.positional("id", { demandOption: true, describe: "Prompt ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Prompt ID to fetch" })
         )
       )
     )
@@ -3586,7 +3957,7 @@ import { PromptClient as PromptClient2 } from "@uniformdev/canvas";
 var PromptListModule = {
   command: "list",
   describe: "List prompts",
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new PromptClient2({ apiKey, apiHost, fetch: fetch3, projectId, bypassCache: true });
@@ -3633,12 +4004,12 @@ function createPromptEngineDataSource({
 var PromptPullModule = {
   command: "pull <directory>",
   describe: "Pulls all entries to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to save the entries to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
               type: "string"
             }).option("format", {
@@ -3721,12 +4092,12 @@ import { PromptClient as PromptClient4 } from "@uniformdev/canvas";
 var PromptPushModule = {
   command: "push <directory>",
   describe: "Pushes all prompts from files in a directory to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withStateOptions(
           withDiffOptions(
-            yargs27.positional("directory", {
+            yargs28.positional("directory", {
               describe: "Directory to read the prompts from. If a filename is used, a package will be read instead.",
               type: "string"
             }).option("what-if", {
@@ -3797,9 +4168,9 @@ var PromptRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a prompt",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: "Prompt ID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: "Prompt ID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -3815,10 +4186,10 @@ var PromptUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a prompt",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Prompt file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Prompt file to put" })
       )
     )
   ),
@@ -3835,9 +4206,9 @@ var PromptModule = {
   command: "prompt <command>",
   aliases: ["dt"],
   describe: "Commands for AI Prompt definitions",
-  builder: (yargs27) => yargs27.command(PromptGetModule).command(PromptListModule).command(PromptPullModule).command(PromptPushModule).command(PromptRemoveModule).command(PromptUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(PromptGetModule).command(PromptListModule).command(PromptPullModule).command(PromptPushModule).command(PromptRemoveModule).command(PromptUpdateModule).demandCommand(),
   handler: () => {
-    yargs9.help();
+    yargs10.help();
   }
 };
 
@@ -3846,28 +4217,28 @@ var CanvasCommand = {
   command: "canvas <command>",
   aliases: ["cv", "pm", "presentation"],
   describe: "Uniform Canvas commands",
-  builder: (yargs27) => yargs27.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).command(PatternModule).command(ContentTypeModule).command(EntryModule).command(PromptModule).command(AssetModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(CompositionModule).command(ComponentModule).command(DataTypeModule).command(CategoryModule).command(PatternModule).command(ContentTypeModule).command(EntryModule).command(PromptModule).command(AssetModule).command(LocaleModule).demandCommand(),
   handler: () => {
-    yargs10.showHelp();
+    yargs11.showHelp();
   }
 };
 
 // src/commands/context/index.ts
-import yargs17 from "yargs";
+import yargs18 from "yargs";
 
 // src/commands/context/commands/aggregate.ts
-import yargs11 from "yargs";
+import yargs12 from "yargs";
 
 // src/commands/context/commands/aggregate/get.ts
 import { UncachedAggregateClient } from "@uniformdev/context/api";
 var AggregateGetModule = {
   command: "get <id>",
   describe: "Fetch an aggregate",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Aggregate public ID to fetch" })
         )
       )
     )
@@ -3891,7 +4262,7 @@ var AggregateListModule = {
   command: "list",
   describe: "List aggregates",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedAggregateClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -3957,11 +4328,11 @@ function writeContextPackage(filename, packageContents) {
 var AggregatePullModule = {
   command: "pull <directory>",
   describe: "Pulls all aggregates to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the aggregates to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -4036,11 +4407,11 @@ import { UncachedAggregateClient as UncachedAggregateClient4 } from "@uniformdev
 var AggregatePushModule = {
   command: "push <directory>",
   describe: "Pushes all aggregates from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the aggregates from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -4105,10 +4476,10 @@ var AggregateRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an aggregate",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Aggregate public ID to delete" })
       )
     )
   ),
@@ -4125,10 +4496,10 @@ var AggregateUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update an aggregate",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Aggregate file to put" })
       )
     )
   ),
@@ -4145,25 +4516,25 @@ var AggregateModule = {
   command: "aggregate <command>",
   aliases: ["agg", "intent", "audience"],
   describe: "Commands for Context aggregates (intents, audiences)",
-  builder: (yargs27) => yargs27.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(AggregatePullModule).command(AggregatePushModule).command(AggregateGetModule).command(AggregateRemoveModule).command(AggregateListModule).command(AggregateUpdateModule).demandCommand(),
   handler: () => {
-    yargs11.help();
+    yargs12.help();
   }
 };
 
 // src/commands/context/commands/enrichment.ts
-import yargs12 from "yargs";
+import yargs13 from "yargs";
 
 // src/commands/context/commands/enrichment/get.ts
 import { UncachedEnrichmentClient } from "@uniformdev/context/api";
 var EnrichmentGetModule = {
   command: "get <id>",
   describe: "Fetch an enrichment category and its values",
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Enrichment category public ID to fetch" })
         )
       )
     )
@@ -4188,7 +4559,7 @@ var EnrichmentListModule = {
   command: "list",
   describe: "List enrichments",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedEnrichmentClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4289,11 +4660,11 @@ var createEnrichmentValueEngineDataSource = ({
 var EnrichmentPullModule = {
   command: "pull <directory>",
   describe: "Pulls all enrichments to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the enrichments to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -4368,11 +4739,11 @@ import { UncachedEnrichmentClient as UncachedEnrichmentClient4 } from "@uniformd
 var EnrichmentPushModule = {
   command: "push <directory>",
   describe: "Pushes all enrichments from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the enrichments from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -4436,10 +4807,10 @@ var EnrichmentRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete an enrichment category and its values",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Enrichment category public ID to delete" })
       )
     )
   ),
@@ -4455,14 +4826,14 @@ var EnrichmentModule = {
   command: "enrichment <command>",
   aliases: ["enr"],
   describe: "Commands for Context enrichments",
-  builder: (yargs27) => yargs27.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(EnrichmentPullModule).command(EnrichmentPushModule).command(EnrichmentGetModule).command(EnrichmentRemoveModule).command(EnrichmentListModule).demandCommand(),
   handler: () => {
-    yargs12.help();
+    yargs13.help();
   }
 };
 
 // src/commands/context/commands/manifest.ts
-import yargs13 from "yargs";
+import yargs14 from "yargs";
 
 // src/commands/context/commands/manifest/get.ts
 import { ApiClientError, UncachedManifestClient } from "@uniformdev/context/api";
@@ -4473,10 +4844,10 @@ var ManifestGetModule = {
   command: "get [output]",
   aliases: ["dl", "download"],
   describe: "Download the Uniform Context manifest for a project",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.option("preview", {
+        yargs28.option("preview", {
           describe: "If set, fetches the unpublished preview manifest (The API key must have permission)",
           default: false,
           type: "boolean",
@@ -4538,7 +4909,7 @@ import { exit as exit2 } from "process";
 var ManifestPublishModule = {
   command: "publish",
   describe: "Publish the Uniform Context manifest for a project",
-  builder: (yargs27) => withConfiguration(withApiOptions(withProjectOptions(yargs27))),
+  builder: (yargs28) => withConfiguration(withApiOptions(withProjectOptions(yargs28))),
   handler: async ({ apiKey, apiHost, proxy, project }) => {
     const fetch3 = nodeFetchProxy(proxy);
     try {
@@ -4571,25 +4942,25 @@ var ManifestModule = {
   command: "manifest <command>",
   describe: "Commands for context manifests",
   aliases: ["man"],
-  builder: (yargs27) => yargs27.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ManifestGetModule).command(ManifestPublishModule).demandCommand(),
   handler: () => {
-    yargs13.help();
+    yargs14.help();
   }
 };
 
 // src/commands/context/commands/quirk.ts
-import yargs14 from "yargs";
+import yargs15 from "yargs";
 
 // src/commands/context/commands/quirk/get.ts
 import { UncachedQuirkClient } from "@uniformdev/context/api";
 var QuirkGetModule = {
   command: "get <id>",
   describe: "Fetch a quirk",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Quirk public ID to fetch" })
         )
       )
     )
@@ -4613,11 +4984,11 @@ var QuirkListModule = {
   command: "list",
   describe: "List quirks",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.option("withIntegrations", {
+          yargs28.option("withIntegrations", {
             alias: ["i"],
             describe: "Whether to include meta-quirks created by integrations in the list. Defaults to false.",
             type: "boolean"
@@ -4674,11 +5045,11 @@ function createQuirkEngineDataSource({
 var QuirkPullModule = {
   command: "pull <directory>",
   describe: "Pulls all quirks to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the quirks to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -4753,11 +5124,11 @@ import { UncachedQuirkClient as UncachedQuirkClient4 } from "@uniformdev/context
 var QuirkPushModule = {
   command: "push <directory>",
   describe: "Pushes all quirks from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the quirks from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -4821,10 +5192,10 @@ var QuirkRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a quirk",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Quirk public ID to delete" })
       )
     )
   ),
@@ -4841,10 +5212,10 @@ var QuirkUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a quirk",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Quirk file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Quirk file to put" })
       )
     )
   ),
@@ -4861,25 +5232,25 @@ var QuirkModule = {
   command: "quirk <command>",
   aliases: ["qk"],
   describe: "Commands for Context quirks",
-  builder: (yargs27) => yargs27.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(QuirkPullModule).command(QuirkPushModule).command(QuirkGetModule).command(QuirkRemoveModule).command(QuirkListModule).command(QuirkUpdateModule).demandCommand(),
   handler: () => {
-    yargs14.help();
+    yargs15.help();
   }
 };
 
 // src/commands/context/commands/signal.ts
-import yargs15 from "yargs";
+import yargs16 from "yargs";
 
 // src/commands/context/commands/signal/get.ts
 import { UncachedSignalClient } from "@uniformdev/context/api";
 var SignalGetModule = {
   command: "get <id>",
   describe: "Fetch a signal",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Signal public ID to fetch" })
         )
       )
     )
@@ -4903,7 +5274,7 @@ var SignalListModule = {
   command: "list",
   describe: "List signals",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedSignalClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -4952,11 +5323,11 @@ function createSignalEngineDataSource({
 var SignalPullModule = {
   command: "pull <directory>",
   describe: "Pulls all signals to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the signals to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -5031,11 +5402,11 @@ import { UncachedSignalClient as UncachedSignalClient4 } from "@uniformdev/conte
 var SignalPushModule = {
   command: "push <directory>",
   describe: "Pushes all signals from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the signals from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -5099,10 +5470,10 @@ var SignalRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a signal",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Signal public ID to delete" })
       )
     )
   ),
@@ -5119,10 +5490,10 @@ var SignalUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a signal",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Signal file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Signal file to put" })
       )
     )
   ),
@@ -5139,25 +5510,25 @@ var SignalModule = {
   command: "signal <command>",
   aliases: ["sig"],
   describe: "Commands for Context signals",
-  builder: (yargs27) => yargs27.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(SignalPullModule).command(SignalPushModule).command(SignalGetModule).command(SignalRemoveModule).command(SignalListModule).command(SignalUpdateModule).demandCommand(),
   handler: () => {
-    yargs15.help();
+    yargs16.help();
   }
 };
 
 // src/commands/context/commands/test.ts
-import yargs16 from "yargs";
+import yargs17 from "yargs";
 
 // src/commands/context/commands/test/get.ts
 import { UncachedTestClient } from "@uniformdev/context/api";
 var TestGetModule = {
   command: "get <id>",
   describe: "Fetch a test",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Test public ID to fetch" })
         )
       )
     )
@@ -5181,7 +5552,7 @@ var TestListModule = {
   command: "list",
   describe: "List tests",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedTestClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -5230,11 +5601,11 @@ function createTestEngineDataSource({
 var TestPullModule = {
   command: "pull <directory>",
   describe: "Pulls all tests to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save the tests to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -5309,11 +5680,11 @@ import { UncachedTestClient as UncachedTestClient4 } from "@uniformdev/context/a
 var TestPushModule = {
   command: "push <directory>",
   describe: "Pushes all tests from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read the tests from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -5377,10 +5748,10 @@ var TestRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a test",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "Test public ID to delete" })
+        yargs28.positional("id", { demandOption: true, describe: "Test public ID to delete" })
       )
     )
   ),
@@ -5397,9 +5768,9 @@ var TestUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a test",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("filename", { demandOption: true, describe: "Test file to put" }))
+      withProjectOptions(yargs28.positional("filename", { demandOption: true, describe: "Test file to put" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, filename, project: projectId }) => {
@@ -5414,9 +5785,9 @@ var TestUpdateModule = {
 var TestModule = {
   command: "test <command>",
   describe: "Commands for Context A/B tests",
-  builder: (yargs27) => yargs27.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(TestPullModule).command(TestPushModule).command(TestGetModule).command(TestRemoveModule).command(TestListModule).command(TestUpdateModule).demandCommand(),
   handler: () => {
-    yargs16.help();
+    yargs17.help();
   }
 };
 
@@ -5425,9 +5796,9 @@ var ContextCommand = {
   command: "context <command>",
   aliases: ["ctx"],
   describe: "Uniform Context commands",
-  builder: (yargs27) => yargs27.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ManifestModule).command(SignalModule).command(EnrichmentModule).command(AggregateModule).command(QuirkModule).command(TestModule).demandCommand(),
   handler: () => {
-    yargs17.showHelp();
+    yargs18.showHelp();
   }
 };
 
@@ -5455,7 +5826,7 @@ import { PostHog } from "posthog-node";
 // package.json
 var package_default = {
   name: "@uniformdev/cli",
-  version: "19.86.0",
+  version: "19.88.0",
   description: "Uniform command line interface tool",
   license: "SEE LICENSE IN LICENSE.txt",
   main: "./cli.js",
@@ -5512,7 +5883,7 @@ var package_default = {
     "@types/js-yaml": "4.0.9",
     "@types/jsonwebtoken": "9.0.5",
     "@types/lodash.isequalwith": "4.4.9",
-    "@types/node": "18.19.1",
+    "@types/node": "18.19.3",
     "@types/yargs": "17.0.32"
   },
   bin: {
@@ -6465,10 +6836,10 @@ var NewMeshCmd = {
 };
 
 // src/commands/optimize/index.ts
-import yargs19 from "yargs";
+import yargs20 from "yargs";
 
 // src/commands/optimize/manifest.ts
-import yargs18 from "yargs";
+import yargs19 from "yargs";
 
 // src/commands/optimize/manifest/download.ts
 import { gray as gray4, green as green3, red as red5, yellow as yellow2 } from "colorette";
@@ -6483,7 +6854,7 @@ var UniformBaseUrl = "https://uniform.app";
 var module = {
   command: "download [output]",
   describe: "Download intent manifest",
-  builder: (yargs27) => yargs27.option("apiKey", {
+  builder: (yargs28) => yargs28.option("apiKey", {
     alias: "k",
     demandOption: true,
     string: true,
@@ -6584,10 +6955,10 @@ var module2 = {
   command: "manifest <command>",
   describe: "Intent manifest commands",
   builder: () => {
-    return yargs18.command(download_default);
+    return yargs19.command(download_default);
   },
   handler: () => {
-    yargs18.showHelp();
+    yargs19.showHelp();
   }
 };
 var manifest_default = module2;
@@ -6598,29 +6969,29 @@ var OptimizeCommand = {
   aliases: ["opt"],
   describe: "Uniform Optimize commands",
   builder: () => {
-    return yargs19.command(manifest_default);
+    return yargs20.command(manifest_default);
   },
   handler: () => {
-    yargs19.showHelp();
+    yargs20.showHelp();
   }
 };
 
 // src/commands/project-map/index.ts
-import yargs22 from "yargs";
+import yargs23 from "yargs";
 
 // src/commands/project-map/commands/projectMapDefinition.ts
-import yargs20 from "yargs";
+import yargs21 from "yargs";
 
 // src/commands/project-map/commands/ProjectMapDefinition/get.ts
 import { UncachedProjectMapClient } from "@uniformdev/project-map";
 var ProjectMapDefinitionGetModule = {
   command: "get <id>",
   describe: "Fetch a project map",
-  builder: (yargs27) => withFormatOptions(
+  builder: (yargs28) => withFormatOptions(
     withConfiguration(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "ProjectMap UUID to fetch" })
         )
       )
     )
@@ -6644,7 +7015,7 @@ var ProjectMapDefinitionListModule = {
   command: "list",
   describe: "List of project maps",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedProjectMapClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -6701,11 +7072,11 @@ function createProjectMapDefinitionEngineDataSource({
 var ProjectMapDefinitionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all project maps to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save project maps to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -6781,11 +7152,11 @@ import { UncachedProjectMapClient as UncachedProjectMapClient4 } from "@uniformd
 var ProjectMapDefinitionPushModule = {
   command: "push <directory>",
   describe: "Pushes all project maps from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read project maps from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -6849,9 +7220,9 @@ var ProjectMapDefinitionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a project map",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: " UUID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: " UUID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -6867,10 +7238,10 @@ var ProjectMapDefinitionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a project map",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Project map file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Project map file to put" })
       )
     )
   ),
@@ -6886,25 +7257,25 @@ var ProjectMapDefinitionUpdateModule = {
 var ProjectMapDefinitionModule = {
   command: "definition <command>",
   describe: "Commands for ProjectMap Definitions",
-  builder: (yargs27) => yargs27.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ProjectMapDefinitionPullModule).command(ProjectMapDefinitionPushModule).command(ProjectMapDefinitionGetModule).command(ProjectMapDefinitionRemoveModule).command(ProjectMapDefinitionListModule).command(ProjectMapDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs20.help();
+    yargs21.help();
   }
 };
 
 // src/commands/project-map/commands/projectMapNode.ts
-import yargs21 from "yargs";
+import yargs22 from "yargs";
 
 // src/commands/project-map/commands/ProjectMapNode/get.ts
 import { UncachedProjectMapClient as UncachedProjectMapClient7 } from "@uniformdev/project-map";
 var ProjectMapNodeGetModule = {
   command: "get <id> <projectMapId>",
   describe: "Fetch a project map node",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
+          yargs28.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to fetch" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to fetch from" })
         )
       )
     )
@@ -6930,11 +7301,11 @@ var ProjectMapNodeListModule = {
   command: "list <projectMapId>",
   describe: "List project map nodes",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("projectMapId", {
+          yargs28.positional("projectMapId", {
             demandOption: true,
             describe: "ProjectMap UUID to fetch from"
           })
@@ -7005,11 +7376,11 @@ function createProjectMapNodeEngineDataSource({
 var ProjectMapNodePullModule = {
   command: "pull <directory>",
   describe: "Pulls all project maps nodes to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save project maps to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -7089,11 +7460,11 @@ import { UncachedProjectMapClient as UncachedProjectMapClient10 } from "@uniform
 var ProjectMapNodePushModule = {
   command: "push <directory>",
   describe: "Pushes all project maps nodes from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read project maps from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -7166,10 +7537,10 @@ var ProjectMapNodeRemoveModule = {
   command: "remove <id> <projectMapId>",
   aliases: ["delete", "rm"],
   describe: "Delete a project map node",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to delete" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to delete from" })
+        yargs28.positional("id", { demandOption: true, describe: "ProjectMap Node UUID to delete" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to delete from" })
       )
     )
   ),
@@ -7186,10 +7557,10 @@ var ProjectMapNodeUpdateModule = {
   command: "update <filename> <projectMapId>",
   aliases: ["put"],
   describe: "Insert or update a project map node",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "ProjectMap node file with nodes data" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to put into" })
+        yargs28.positional("filename", { demandOption: true, describe: "ProjectMap node file with nodes data" }).positional("projectMapId", { demandOption: true, describe: "ProjectMap UUID to put into" })
       )
     )
   ),
@@ -7205,9 +7576,9 @@ var ProjectMapNodeUpdateModule = {
 var ProjectMapNodeModule = {
   command: "node <command>",
   describe: "Commands for ProjectMap Nodes",
-  builder: (yargs27) => yargs27.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ProjectMapNodePullModule).command(ProjectMapNodePushModule).command(ProjectMapNodeGetModule).command(ProjectMapNodeRemoveModule).command(ProjectMapNodeListModule).command(ProjectMapNodeUpdateModule).demandCommand(),
   handler: () => {
-    yargs21.help();
+    yargs22.help();
   }
 };
 
@@ -7216,28 +7587,28 @@ var ProjectMapCommand = {
   command: "project-map <command>",
   aliases: ["prm"],
   describe: "Uniform ProjectMap commands",
-  builder: (yargs27) => yargs27.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(ProjectMapNodeModule).command(ProjectMapDefinitionModule).demandCommand(),
   handler: () => {
-    yargs22.showHelp();
+    yargs23.showHelp();
   }
 };
 
 // src/commands/redirect/index.ts
-import yargs24 from "yargs";
+import yargs25 from "yargs";
 
 // src/commands/redirect/commands/redirect.ts
-import yargs23 from "yargs";
+import yargs24 from "yargs";
 
 // src/commands/redirect/commands/RedirectDefinition/get.ts
 import { UncachedRedirectClient } from "@uniformdev/redirect";
 var RedirectDefinitionGetModule = {
   command: "get <id>",
   describe: "Fetch a redirect",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withFormatOptions(
       withApiOptions(
         withProjectOptions(
-          yargs27.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" })
+          yargs28.positional("id", { demandOption: true, describe: "Redirect UUID to fetch" })
         )
       )
     )
@@ -7261,7 +7632,7 @@ var RedirectDefinitionListModule = {
   command: "list",
   describe: "List of redirects",
   aliases: ["ls"],
-  builder: (yargs27) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs27)))),
+  builder: (yargs28) => withConfiguration(withFormatOptions(withApiOptions(withProjectOptions(yargs28)))),
   handler: async ({ apiHost, apiKey, proxy, format, filename, project: projectId }) => {
     const fetch3 = nodeFetchProxy(proxy);
     const client = new UncachedRedirectClient2({ apiKey, apiHost, fetch: fetch3, projectId });
@@ -7327,11 +7698,11 @@ function createRedirectDefinitionEngineDataSource({
 var RedirectDefinitionPullModule = {
   command: "pull <directory>",
   describe: "Pulls all redirects to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to save redirects to. If a filename ending in yaml or json is used, a package file will be created instead of files in the directory.",
             type: "string"
           }).option("format", {
@@ -7408,11 +7779,11 @@ import { UncachedRedirectClient as UncachedRedirectClient4 } from "@uniformdev/r
 var RedirectDefinitionPushModule = {
   command: "push <directory>",
   describe: "Pushes all redirects from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.positional("directory", {
+          yargs28.positional("directory", {
             describe: "Directory to read redirects from. If a filename is used, a package will be read instead.",
             type: "string"
           }).option("what-if", {
@@ -7476,9 +7847,9 @@ var RedirectDefinitionRemoveModule = {
   command: "remove <id>",
   aliases: ["delete", "rm"],
   describe: "Delete a redirect",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
-      withProjectOptions(yargs27.positional("id", { demandOption: true, describe: " UUID to delete" }))
+      withProjectOptions(yargs28.positional("id", { demandOption: true, describe: " UUID to delete" }))
     )
   ),
   handler: async ({ apiHost, apiKey, proxy, id, project: projectId }) => {
@@ -7494,10 +7865,10 @@ var RedirectDefinitionUpdateModule = {
   command: "update <filename>",
   aliases: ["put"],
   describe: "Insert or update a redirect",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
-        yargs27.positional("filename", { demandOption: true, describe: "Redirect file to put" })
+        yargs28.positional("filename", { demandOption: true, describe: "Redirect file to put" })
       )
     )
   ),
@@ -7513,9 +7884,9 @@ var RedirectDefinitionUpdateModule = {
 var RedirectDefinitionModule = {
   command: "definition <command>",
   describe: "Commands for Redirect Definitions",
-  builder: (yargs27) => yargs27.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(RedirectDefinitionPullModule).command(RedirectDefinitionPushModule).command(RedirectDefinitionGetModule).command(RedirectDefinitionRemoveModule).command(RedirectDefinitionListModule).command(RedirectDefinitionUpdateModule).demandCommand(),
   handler: () => {
-    yargs23.help();
+    yargs24.help();
   }
 };
 
@@ -7524,14 +7895,14 @@ var RedirectCommand = {
   command: "redirect <command>",
   aliases: ["red"],
   describe: "Uniform Redirect commands",
-  builder: (yargs27) => yargs27.command(RedirectDefinitionModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(RedirectDefinitionModule).demandCommand(),
   handler: () => {
-    yargs24.showHelp();
+    yargs25.showHelp();
   }
 };
 
 // src/commands/sync/index.ts
-import yargs25 from "yargs";
+import yargs26 from "yargs";
 
 // src/commands/sync/commands/util.ts
 import ora2 from "ora";
@@ -7564,11 +7935,11 @@ function spin(entityType) {
 var SyncPullModule = {
   command: "pull",
   describe: "Pulls whole project to local files in a directory",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.option("what-if", {
+          yargs28.option("what-if", {
             alias: ["w"],
             describe: "What-if mode reports what would be done but changes no files",
             default: false,
@@ -7579,8 +7950,11 @@ var SyncPullModule = {
     )
   ),
   handler: async ({ serialization, ...otherParams }) => {
+    var _a;
     const config2 = serialization;
     const enabledEntities = Object.entries({
+      locale: LocalePullModule,
+      asset: AssetPullModule,
       category: CategoryPullModule,
       dataType: DataTypePullModule,
       prompt: PromptPullModule,
@@ -7596,11 +7970,10 @@ var SyncPullModule = {
       projectMapNode: ProjectMapNodePullModule,
       redirect: RedirectDefinitionPullModule,
       entry: EntryPullModule,
-      contentType: ContentTypePullModule,
-      asset: AssetPullModule
+      contentType: ContentTypePullModule
     }).filter(([entityType]) => {
-      var _a, _b, _c, _d, _e, _f;
-      return Boolean((_a = config2.entitiesConfig) == null ? void 0 : _a[entityType]) && ((_c = (_b = config2.entitiesConfig) == null ? void 0 : _b[entityType]) == null ? void 0 : _c.disabled) !== true && ((_f = (_e = (_d = config2.entitiesConfig) == null ? void 0 : _d[entityType]) == null ? void 0 : _e.pull) == null ? void 0 : _f.disabled) !== true;
+      var _a2, _b, _c, _d, _e, _f;
+      return Boolean((_a2 = config2.entitiesConfig) == null ? void 0 : _a2[entityType]) && ((_c = (_b = config2.entitiesConfig) == null ? void 0 : _b[entityType]) == null ? void 0 : _c.disabled) !== true && ((_f = (_e = (_d = config2.entitiesConfig) == null ? void 0 : _d[entityType]) == null ? void 0 : _e.pull) == null ? void 0 : _f.disabled) !== true;
     });
     if (enabledEntities.length === 0) {
       throw new Error(
@@ -7609,10 +7982,14 @@ var SyncPullModule = {
     }
     for (const [entityType, module3] of enabledEntities) {
       const spinner = spin(entityType);
+      const entityConfigSupportsPullState = (entityConfig2) => {
+        return entityConfig2 !== void 0 && "state" in entityConfig2;
+      };
+      const entityConfig = (_a = config2.entitiesConfig) == null ? void 0 : _a[entityType];
       try {
         await module3.handler({
           ...otherParams,
-          state: 0,
+          state: entityConfigSupportsPullState(entityConfig) ? entityConfig.state ?? 0 : 0,
           format: getFormat(entityType, config2),
           onlyCompositions: entityType === "composition" ? true : void 0,
           onlyPatterns: entityType === "pattern" ? true : void 0,
@@ -7655,11 +8032,11 @@ var getFormat = (entityType, config2) => {
 var SyncPushModule = {
   command: "push",
   describe: "Pushes whole project data from files in a directory or package to Uniform",
-  builder: (yargs27) => withConfiguration(
+  builder: (yargs28) => withConfiguration(
     withApiOptions(
       withProjectOptions(
         withDiffOptions(
-          yargs27.option("what-if", {
+          yargs28.option("what-if", {
             alias: ["w"],
             describe: "What-if mode reports what would be done but changes nothing",
             default: false,
@@ -7673,6 +8050,8 @@ var SyncPushModule = {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
     const config2 = serialization;
     const enabledEntities = Object.entries({
+      locale: LocalePushModule,
+      asset: AssetPushModule,
       category: CategoryPushModule,
       dataType: DataTypePushModule,
       prompt: PromptPushModule,
@@ -7688,8 +8067,7 @@ var SyncPushModule = {
       projectMapNode: ProjectMapNodePushModule,
       redirect: RedirectDefinitionPushModule,
       contentType: ContentTypePushModule,
-      entry: EntryPushModule,
-      asset: AssetPushModule
+      entry: EntryPushModule
     }).filter(([entityType]) => {
       var _a2, _b2, _c2, _d2, _e2, _f2;
       return Boolean((_a2 = config2.entitiesConfig) == null ? void 0 : _a2[entityType]) && ((_c2 = (_b2 = config2.entitiesConfig) == null ? void 0 : _b2[entityType]) == null ? void 0 : _c2.disabled) !== true && ((_f2 = (_e2 = (_d2 = config2.entitiesConfig) == null ? void 0 : _d2[entityType]) == null ? void 0 : _e2.push) == null ? void 0 : _f2.disabled) !== true;
@@ -7753,9 +8131,9 @@ var getFormat2 = (entityType, config2) => {
 var SyncCommand = {
   command: "sync <command>",
   describe: "Uniform Sync commands",
-  builder: (yargs27) => yargs27.command(SyncPullModule).command(SyncPushModule).demandCommand(),
+  builder: (yargs28) => yargs28.command(SyncPullModule).command(SyncPushModule).demandCommand(),
   handler: () => {
-    yargs25.showHelp();
+    yargs26.showHelp();
   }
 };
 
@@ -8021,7 +8399,7 @@ First found was: v${firstVersion}`;
 
 // src/index.ts
 dotenv.config();
-var yarggery = yargs26(hideBin(process.argv));
+var yarggery = yargs27(hideBin(process.argv));
 var inlineConfigurationFilePath = "config" in yarggery.argv && yarggery.argv.config;
 var configuration = loadConfig(inlineConfigurationFilePath || null);
 yarggery.option("verbose", {