mcdev 7.10.1 → 8.0.0

package/lib/metadataTypes/MetadataType.js

@@ -1251,9 +1251,10 @@ class MetadataType {
      * @param {MetadataTypeItem} metadataEntry a single metadata Entry
      * @param {string} uri rest endpoint for PATCH
      * @param {'patch'|'post'|'put'} [httpMethod] defaults to 'patch'; some update requests require PUT instead of PATCH
+     * @param {boolean} [handleOutside] if the API reponse is irregular this allows you to handle it outside of this generic method
      * @returns {Promise.<object> | null} Promise of API response or null in case of an error
      */
-    static async updateREST(metadataEntry, uri, httpMethod = 'patch') {
+    static async updateREST(metadataEntry, uri, httpMethod = 'patch', handleOutside) {
         const metadataClone = structuredClone(metadataEntry);
         this.removeNotUpdateableFields(metadataEntry);
         try {
@@ -1263,7 +1264,11 @@ class MetadataType {
             this.getErrorsREST(response);
             response = await this.postUpdateTasks(metadataEntry, response, metadataClone);
             // some times, e.g. automation dont return a key in their update response and hence we need to fall back to name
-            Util.logger.info(` - updated ${Util.getTypeKeyName(this.definition, metadataEntry)}`);
+            if (!handleOutside) {
+                Util.logger.info(
+                    ` - updated ${Util.getTypeKeyName(this.definition, metadataEntry)}`
+                );
+            }
             return response;
         } catch (ex) {
             const parsedErrors = this.getErrorsREST(ex);
@@ -1435,15 +1440,35 @@ class MetadataType {
         const results = this.parseResponseBody(response, singleRetrieve);
         // get extended metadata if applicable
         if (this.definition.hasExtended) {
-            Util.logger.debug(' - retrieving extended metadata');
-            const extended = await this.client.rest.getCollection(
+            const amount = Object.keys(results).length;
+            if (amount > 100) {
+                Util.logger.info(
+                    Util.getGrayMsg(
+                        ` - retrieving extended metadata for ${amount} ${this.definition.type}s...`
+                    )
+                );
+            } else {
+                Util.logger.debug(' - retrieving extended metadata');
+            }
+            const rateLimit = pLimit(this.definition.restConcurrentLimit || 5);
+            const extended = await Promise.all(
                 Object.keys(results)
-                    .map((key) =>
-                        uri.endsWith(results[key][this.definition.idField])
+                    .map((key) => {
+                        const url = uri.endsWith(results[key][this.definition.idField])
                             ? null
-                            : uri + results[key][this.definition.idField]
-                    )
+                            : uri + results[key][this.definition.idField];
+                        return url ? { url, key } : null;
+                    })
                     .filter(Boolean)
+                    .map((el) =>
+                        rateLimit(async () => {
+                            try {
+                                return await this.client.rest.get(el.url);
+                            } catch (ex) {
+                                return await this.handleRESTErrors(ex, el.key, el.url);
+                            }
+                        })
+                    )
             );
             for (const ext of extended) {
                 const key = ext[this.definition.keyField];
@@ -1501,7 +1526,7 @@ class MetadataType {
                           try {
                               return await this.client.rest.get(item.uri);
                           } catch (ex) {
-                              return this.handleRESTErrors(ex, item.id);
+                              return await this.handleRESTErrors(ex, item.id, item.uri);
                           }
                       })
                   )
@@ -1523,12 +1548,13 @@ class MetadataType {
      * helper for {@link this.retrieveRESTcollection}
      *
      * @param {RestError} ex exception
-     * @param {string} id id or key of item
+     * @param {string} key id or key of item
+     * @param {string} url url to call for retry
      * @returns {Promise.<any>} -
      */
-    static async handleRESTErrors(ex, id) {
+    static async handleRESTErrors(ex, key, url) {
         // if the ID is too short, the system will throw the 400 error
-        Util.logger.debug(` ☇ skipping ${this.definition.type} ${id}: ${ex.message} ${ex.code}`);
+        Util.logger.debug(` ☇ skipping ${this.definition.type} ${key}: ${ex.message} ${ex.code}`);
 
         return null;
     }

package/lib/metadataTypes/definitions/Asset.definition.js

@@ -1,7 +1,7 @@
 // asset types https://developer.salesforce.com/docs/atlas.en-us.noversion.mc-apis.meta/mc-apis/base-asset-types.htm
 export default {
     bodyIteratorField: 'items',
-    dependencies: ['folder-asset', 'folder-asset-shared'],
+    dependencies: ['folder-asset', 'folder-asset-shared', 'folder-cloudpages'],
     dependencyGraph: { asset: ['views.html.template.r__asset_key'] },
     folderType: 'asset',
     hasExtended: false,
@@ -18,7 +18,16 @@ export default {
     maxKeyLength: 36, // confirmed max length
     type: 'asset',
     typeDescription: 'Assets from Content Builder grouped into subtypes.',
-    typeRetrieveByDefault: ['asset', 'code', 'textfile', 'block', 'message', 'template', 'other'],
+    typeRetrieveByDefault: [
+        'asset',
+        'code',
+        'coderesource',
+        'textfile',
+        'block',
+        'message',
+        'template',
+        'other',
+    ],
     typeCdpByDefault: true,
     typeName: 'Asset-[Subtype]',
     stringifyFieldsBeforeTemplate: ['memberId', 'enterpriseId'],
@@ -156,6 +165,12 @@ export default {
             retrieving: true,
             template: true,
         },
+        'content.url': {
+            isCreateable: false,
+            isUpdateable: true,
+            retrieving: true,
+            template: true,
+        },
         contentType: {
             isCreateable: true,
             isUpdateable: true,
@@ -234,7 +249,24 @@ export default {
             retrieving: false,
             template: false,
         },
-
+        'data.site': {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            template: true,
+        },
+        'data.site.content': {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            template: true,
+        },
+        'data.site.content.url': {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            template: true,
+        },
         description: {
             isCreateable: true,
             isUpdateable: true,
@@ -509,7 +541,9 @@ export default {
         'asset',
         'audio',
         'block',
+        'cloudpage',
         'code',
+        'coderesource',
         'document',
         'image',
         'message',
@@ -524,7 +558,136 @@ export default {
 
     binarySubtypes: ['archive', 'audio', 'document', 'image', 'rawimage', 'video'],
     extendedSubTypes: {
+        archive: [
+            '7z',
+            'arj',
+            'bz2',
+            'cab',
+            'gz',
+            'gzip',
+            'iso',
+            'lha',
+            'sit',
+            'tgz',
+            'jar',
+            'rar',
+            'tar',
+            'zip',
+            'gpg',
+            'archive',
+        ],
         asset: ['webpage', 'webtemplate', 'jsonmessage', 'icemailformblock', 'asset'],
+        audio: [
+            'aac',
+            'm4a',
+            'au',
+            'aif',
+            'aiff',
+            'aifc',
+            'mp3',
+            'wav',
+            'wma',
+            'midi',
+            'oga',
+            'ogg',
+            'ra',
+            'vox',
+            'voc',
+            'audio',
+        ],
+        block: [
+            'freeformblock',
+            'textblock',
+            'htmlblock',
+            'textplusimageblock',
+            'imageblock',
+            'abtestblock',
+            'dynamicblock',
+            'stylingblock',
+            'einsteincontentblock',
+            'socialshareblock',
+            'socialfollowblock',
+            'buttonblock',
+            'layoutblock',
+            'block',
+        ],
+        cloudpage: ['cloudpages', 'landingpage', 'microsite', 'interactivecontent'],
+        code: [
+            'htm',
+            'html',
+            'xhtml',
+            'xht',
+            'css',
+            'less',
+            'sass',
+            'js',
+            'json',
+            'atom',
+            'rss',
+            'xml',
+            'xsl',
+            'xslt',
+            'md',
+            'markdown',
+            'as',
+            'fla',
+            'eml',
+            'code',
+        ],
+        coderesource: [
+            'jscoderesource',
+            'csscoderesource',
+            'jsoncoderesource',
+            'rsscoderesource',
+            'textcoderesource',
+            'xmlcoderesource',
+        ],
+        document: [
+            'indd',
+            'indt',
+            'incx',
+            'wwcx',
+            'doc',
+            'docx',
+            'dot',
+            'dotx',
+            'mdb',
+            'mpp',
+            'ics',
+            'xls',
+            'xlsx',
+            'xlk',
+            'xlsm',
+            'xlt',
+            'xltm',
+            'csv',
+            'tsv',
+            'tab',
+            'pps',
+            'ppsx',
+            'ppt',
+            'pptx',
+            'pot',
+            'thmx',
+            'pdf',
+            'ps',
+            'qxd',
+            'rtf',
+            'sxc',
+            'sxi',
+            'sxw',
+            'odt',
+            'ods',
+            'ots',
+            'odp',
+            'otp',
+            'epub',
+            'dvi',
+            'key',
+            'keynote',
+            'pez',
+            'document',
+        ],
         image: [
             'ai',
             'psd',
@@ -552,6 +715,23 @@ export default {
             'svg',
             'image',
         ],
+        message: ['templatebasedemail', 'htmlemail', 'textonlyemail', 'message'],
+        other: [
+            'smartcaptureblock',
+            'smartcaptureformfieldblock',
+            'smartcapturesubmitoptionsblock',
+            'slotpropertiesblock',
+            'externalcontentblock',
+            'codesnippetblock',
+            'rssfeedblock',
+            'formstylingblock',
+            'referenceblock',
+            'imagecarouselblock',
+            'customblock',
+            'liveimageblock',
+            'livesettingblock',
+            'contentmap',
+        ],
         rawimage: [
             '3fr',
             'ari',
@@ -590,6 +770,8 @@ export default {
             'x3f',
             'rawimage',
         ],
+        template: ['defaulttemplate', 'template'],
+        textfile: ['text', 'txt', 'textfile'],
         video: [
             '3gp',
             '3gpp',
@@ -619,145 +801,6 @@ export default {
             'ogv',
             'video',
         ],
-        document: [
-            'indd',
-            'indt',
-            'incx',
-            'wwcx',
-            'doc',
-            'docx',
-            'dot',
-            'dotx',
-            'mdb',
-            'mpp',
-            'ics',
-            'xls',
-            'xlsx',
-            'xlk',
-            'xlsm',
-            'xlt',
-            'xltm',
-            'csv',
-            'tsv',
-            'tab',
-            'pps',
-            'ppsx',
-            'ppt',
-            'pptx',
-            'pot',
-            'thmx',
-            'pdf',
-            'ps',
-            'qxd',
-            'rtf',
-            'sxc',
-            'sxi',
-            'sxw',
-            'odt',
-            'ods',
-            'ots',
-            'odp',
-            'otp',
-            'epub',
-            'dvi',
-            'key',
-            'keynote',
-            'pez',
-            'document',
-        ],
-        audio: [
-            'aac',
-            'm4a',
-            'au',
-            'aif',
-            'aiff',
-            'aifc',
-            'mp3',
-            'wav',
-            'wma',
-            'midi',
-            'oga',
-            'ogg',
-            'ra',
-            'vox',
-            'voc',
-            'audio',
-        ],
-        archive: [
-            '7z',
-            'arj',
-            'bz2',
-            'cab',
-            'gz',
-            'gzip',
-            'iso',
-            'lha',
-            'sit',
-            'tgz',
-            'jar',
-            'rar',
-            'tar',
-            'zip',
-            'gpg',
-            'archive',
-        ],
-        code: [
-            'htm',
-            'html',
-            'xhtml',
-            'xht',
-            'css',
-            'less',
-            'sass',
-            'js',
-            'json',
-            'atom',
-            'rss',
-            'xml',
-            'xsl',
-            'xslt',
-            'md',
-            'markdown',
-            'as',
-            'fla',
-            'eml',
-            'code',
-        ],
-        textfile: ['text', 'txt', 'textfile'],
-        block: [
-            'freeformblock',
-            'textblock',
-            'htmlblock',
-            'textplusimageblock',
-            'imageblock',
-            'abtestblock',
-            'dynamicblock',
-            'stylingblock',
-            'einsteincontentblock',
-            'socialshareblock',
-            'socialfollowblock',
-            'buttonblock',
-            'layoutblock',
-            'block',
-        ],
-        template: ['defaulttemplate', 'template'],
-        message: ['templatebasedemail', 'htmlemail', 'textonlyemail', 'message'],
-        other: [
-            'smartcaptureblock',
-            'smartcaptureformfieldblock',
-            'smartcapturesubmitoptionsblock',
-            'slotpropertiesblock',
-            'externalcontentblock',
-            'codesnippetblock',
-            'rssfeedblock',
-            'formstylingblock',
-            'referenceblock',
-            'imagecarouselblock',
-            'customblock',
-            'liveimageblock',
-            'livesettingblock',
-            'contentmap',
-        ],
     },
     typeMapping: {
         asset: 1,
@@ -989,5 +1032,16 @@ export default {
         contentmap: 228,
         jsonmessage: 230,
         icemailformblock: 232,
+        coderesource: 239,
+        jscoderesource: 240,
+        csscoderesource: 241,
+        jsoncoderesource: 242,
+        rsscoderesource: 243,
+        textcoderesource: 244,
+        xmlcoderesource: 245,
+        cloudpages: 246,
+        landingpage: 247,
+        microsite: 248,
+        interactivecontent: 249,
     },
 };

package/lib/metadataTypes/definitions/Automation.definition.js

@@ -551,6 +551,12 @@ export default {
             retrieving: false,
             template: false,
         },
+        'schedule.description': {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            template: false,
+        },
         status: {
             isCreateable: true,
             isUpdateable: true,

package/lib/metadataTypes/definitions/DataExtension.definition.js

@@ -136,6 +136,7 @@ export default {
             template: true,
         },
         DataRetentionPeriod: {
+            // not used
             isCreateable: false,
             isUpdateable: false,
             retrieving: false,
@@ -143,19 +144,19 @@ export default {
         },
         DataRetentionPeriodLength: {
             isCreateable: true,
-            isUpdateable: false,
+            isUpdateable: true,
             retrieving: true,
             template: true,
         },
         DataRetentionPeriodUnitOfMeasure: {
             isCreateable: true,
-            isUpdateable: false,
+            isUpdateable: true,
             retrieving: true,
             template: true,
         },
         DeleteAtEndOfRetentionPeriod: {
             isCreateable: true,
-            isUpdateable: false,
+            isUpdateable: true,
             retrieving: true,
             template: true,
         },
@@ -215,19 +216,19 @@ export default {
         },
         ResetRetentionPeriodOnImport: {
             isCreateable: true,
-            isUpdateable: false,
+            isUpdateable: true,
             retrieving: true,
             template: true,
         },
         RetainUntil: {
             isCreateable: true,
-            isUpdateable: false,
+            isUpdateable: true,
             retrieving: true,
             template: true,
         },
         RowBasedRetention: {
             isCreateable: true,
-            isUpdateable: false,
+            isUpdateable: true,
             retrieving: true,
             template: true,
         },

package/lib/metadataTypes/definitions/Event.definition.js

@@ -1001,6 +1001,12 @@ export default {
             retrieving: true,
             template: true,
         },
+        entrySourceGroupConfigUrl: {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            template: true,
+        },
         type: {
             isCreateable: true,
             isUpdateable: true,