feat: v1 asset scanning support in bulk publish and import

.talismanrc

@@ -1,4 +1,4 @@
 fileignoreconfig:
 - filename: pnpm-lock.yaml
-  checksum: 31e333d6769adbaae042c92ea0930fab168a0e06fc1bda406d49fd1042a7a9c7
+  checksum: 423213f918d2052ec37ad421d23057e159c8633d200bfa688d34bbcb73a19285
 version: '1.0'

packages/contentstack-bulk-publish/.mocharc.json

@@ -5,7 +5,8 @@
     "test/unit/commands/assets/unpublish.test.js",
     "test/unit/commands/bulk-publish/cross-publish.test.js",
     "test/unit/commands/entries/publish.test.js",
-    "test/unit/commands/entries/unpublish.test.js"
+    "test/unit/commands/entries/unpublish.test.js",
+    "test/unit/util/asset-scan.test.js"
   ],
   "reporter": "dot",
   "timeout": 60000,

packages/contentstack-bulk-publish/src/commands/cm/assets/publish.js

@@ -15,10 +15,12 @@ class AssetsPublishCommand extends Command {
     assetsFlags.folderUid = assetsFlags['folder-uid'] || assetsFlags.folderUid;
     assetsFlags.bulkPublish = assetsFlags['bulk-publish'] || assetsFlags.bulkPublish;
     assetsFlags.apiVersion = assetsFlags['api-version'] || '3'; // setting default value for apiVersion
+    assetsFlags.backupDir = assetsFlags['backup-dir'] || assetsFlags.backupDir;
     delete assetsFlags['api-version'];
     delete assetsFlags['retry-failed'];
     delete assetsFlags['folder-uid'];
     delete assetsFlags['bulk-publish'];
+    delete assetsFlags['backup-dir'];
 
     let updatedFlags;
     try {
@@ -111,12 +113,18 @@ class AssetsPublishCommand extends Command {
     }
   }
 
-  validate({ environments, retryFailed, locales, 'source-env': sourceEnv, 'delivery-token': deliveryToken }) {
+  validate({ environments, retryFailed, locales, backupDir, 'source-env': sourceEnv, 'delivery-token': deliveryToken }) {
     let missing = [];
     if (retryFailed) {
       return true;
     }
 
+    // In backup-dir mode, environments and locales are derived per-asset from the
+    // backup publish_details, so they are not required on the command line.
+    if (backupDir) {
+      return true;
+    }
+
     if (sourceEnv && !deliveryToken) {
       this.error('Specify the source environment delivery token. Run --help for more details.', { exit: 2 });
     }
@@ -181,6 +189,11 @@ AssetsPublishCommand.flags = {
       '(optional) The UID of the Assets’ folder from which the assets need to be published. The default value is cs_root.',
     exclusive: ['source-env'],
   }),
+  'backup-dir': flags.string({
+    description:
+      '(optional) Path to the import backup directory. When set, each imported asset is published only to the environments and locales it was published to in the source stack (read from the backup’s publish details and asset UID mapping), with asset-scan gating applied. Intended for the post-import publish flow.',
+    exclusive: ['source-env', 'folder-uid', 'environments', 'locales'],
+  }),
   'bulk-publish': flags.string({
     description: 'Set this flag to use Contentstack’s Bulk Publish APIs. It is true, by default.',
     default: 'true',
@@ -259,11 +272,14 @@ AssetsPublishCommand.examples = [
   '',
   'Using --stack-api-key flag',
   'csdx cm:assets:publish --environments [ENVIRONMENT 1] [ENVIRONMENT 2] --locales [LOCALE] --stack-api-key [STACK API KEY]',
+  '',
+  'Using --backup-dir flag (publish imported assets to their original environments after asset scanning)',
+  'csdx cm:assets:publish --backup-dir [PATH TO IMPORT BACKUP DIR] --stack-api-key [STACK API KEY]',
 ];
 
 AssetsPublishCommand.aliases = ['cm:bulk-publish:assets'];
 
 AssetsPublishCommand.usage =
-  'cm:assets:publish [-a <value>] [--retry-failed <value>] [-e <value>] [--folder-uid <value>] [--bulk-publish <value>] [-c <value>] [-y] [--locales <value>] [--branch <value>] [--delivery-token <value>] [--source-env <value>]';
+  'cm:assets:publish [-a <value>] [--retry-failed <value>] [-e <value>] [--folder-uid <value>] [--backup-dir <value>] [--bulk-publish <value>] [-c <value>] [-y] [--locales <value>] [--branch <value>] [--delivery-token <value>] [--source-env <value>]';
 
 module.exports = AssetsPublishCommand;

packages/contentstack-bulk-publish/src/consumer/publish.js

@@ -61,12 +61,12 @@ function displayEntriesDetails(sanitizedData, action, mapping = []) {
 function displayAssetsDetails(sanitizedData, action, mapping) {
   if (action === 'bulk_publish') {
     sanitizedData.forEach((asset) => {
-      asset?.publish_details.forEach((pd) => {
+      asset?.publish_details?.forEach((pd) => {
         if (Object.keys(mapping).includes(pd.environment)) {
         console.log(
           chalk.green(
             `Asset UID: '${asset.uid}'${pd.version ? `, Version: '${pd.version}'` : ''}${
-              asset.locale ? `, Locale: '${asset.locale}'` : ''
+              asset.locale ? `, Locale: '${asset.locale}'` : ''}
             }, Environment: ${pd.environment}`,
           ),
         );