mcdev 6.0.1 → 7.0.0

package/lib/metadataTypes/MobileCode.js

@@ -1,8 +1,20 @@
 'use strict';
 
-import TYPE from '../../types/mcdev.d.js';
 import MetadataType from './MetadataType.js';
 
+/**
+ * @typedef {import('../../types/mcdev.d.js').BuObject} BuObject
+ * @typedef {import('../../types/mcdev.d.js').CodeExtract} CodeExtract
+ * @typedef {import('../../types/mcdev.d.js').CodeExtractItem} CodeExtractItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItem} MetadataTypeItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemDiff} MetadataTypeItemDiff
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemObj} MetadataTypeItemObj
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMap} MetadataTypeMap
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMapObj} MetadataTypeMapObj
+ * @typedef {import('../../types/mcdev.d.js').SoapRequestParams} SoapRequestParams
+ * @typedef {import('../../types/mcdev.d.js').TemplateMap} TemplateMap
+ */
+
 /**
  * MobileCode MetadataType
  *
@@ -14,10 +26,10 @@ class MobileCode extends MetadataType {
      * Endpoint /legacy/v1/beta/mobile/code/ return all Mobile Codes with all details.
      *
      * @param {string} retrieveDir Directory where retrieved metadata directory will be saved
-     * @param {void} [_] unused parameter
-     * @param {void} [__] unused parameter
+     * @param {void | string[]} [_] unused parameter
+     * @param {void | string[]} [__] unused parameter
      * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
      */
     static retrieve(retrieveDir, _, __, key) {
         return super.retrieveREST(
@@ -31,7 +43,7 @@ class MobileCode extends MetadataType {
     /**
      * Retrieves event definition metadata for caching
      *
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
      */
     static retrieveForCache() {
         return super.retrieveREST(null, '/legacy/v1/beta/mobile/code/');

package/lib/metadataTypes/MobileKeyword.js

@@ -1,11 +1,23 @@
 'use strict';
 
-import TYPE from '../../types/mcdev.d.js';
 import MetadataType from './MetadataType.js';
 import { Util } from '../util/util.js';
 import File from '../util/file.js';
 import cache from '../util/cache.js';
 
+/**
+ * @typedef {import('../../types/mcdev.d.js').BuObject} BuObject
+ * @typedef {import('../../types/mcdev.d.js').CodeExtract} CodeExtract
+ * @typedef {import('../../types/mcdev.d.js').CodeExtractItem} CodeExtractItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItem} MetadataTypeItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemDiff} MetadataTypeItemDiff
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemObj} MetadataTypeItemObj
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMap} MetadataTypeMap
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMapObj} MetadataTypeMapObj
+ * @typedef {import('../../types/mcdev.d.js').SoapRequestParams} SoapRequestParams
+ * @typedef {import('../../types/mcdev.d.js').TemplateMap} TemplateMap
+ */
+
 /**
  * MobileKeyword MetadataType
  *
@@ -17,10 +29,10 @@ class MobileKeyword extends MetadataType {
      * Endpoint /legacy/v1/beta/mobile/keyword/ return all Mobile Keywords with all details.
      *
      * @param {string} retrieveDir Directory where retrieved metadata directory will be saved
-     * @param {void} [_] unused parameter
-     * @param {void} [__] unused parameter
+     * @param {void | string[]} [_] unused parameter
+     * @param {void | string[]} [__] unused parameter
      * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj> | void} Promise of metadata
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
      */
     static retrieve(retrieveDir, _, __, key) {
         try {
@@ -43,14 +55,15 @@ class MobileKeyword extends MetadataType {
                 throw ex;
             }
         }
+        return;
     }
 
     /**
      * Builds map of metadata entries mapped to their keyfields
      *
      * @param {object} body json of response body
-     * @param {string|number} [singleRetrieve] key of single item to filter by
-     * @returns {TYPE.MetadataTypeMap} keyField => metadata map
+     * @param {string} [singleRetrieve] key of single item to filter by
+     * @returns {MetadataTypeMap} keyField => metadata map
      */
     static parseResponseBody(body, singleRetrieve) {
         const bodyIteratorField = this.definition.bodyIteratorField;
@@ -98,8 +111,7 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MobileKeyword.parseResponseBody} that creates a custom key field for this type based on mobileCode and keyword
      *
-     * @private
-     * @param {TYPE.MetadataType} metadata single item
+     * @param {MetadataTypeItem} metadata single item
      */
     static #createCustomKeyField(metadata) {
         metadata.c__codeKeyword = metadata.code.code + '.' + metadata.keyword;
@@ -108,8 +120,7 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MobileKeyword.preDeployTasks} and {@link MobileKeyword.createOrUpdate} to ensure we have code & keyword properly set
      *
-     * @private
-     * @param {TYPE.MetadataType} metadata single item
+     * @param {MetadataTypeItem} metadata single item
      */
     static #setCodeAndKeyword(metadata) {
         const [code, keyword] = metadata.c__codeKeyword.split('.');
@@ -126,15 +137,21 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MetadataType.upsert}
      *
-     * @param {TYPE.MetadataTypeMap} metadataMap list of metadata
+     * @param {MetadataTypeMap} metadataMap list of metadata
      * @param {string} metadataKey key of item we are looking at
      * @param {boolean} hasError error flag from previous code
-     * @param {TYPE.MetadataTypeItemDiff[]} metadataToUpdate list of items to update
-     * @param {TYPE.MetadataTypeItem[]} metadataToCreate list of items to create
-     * @returns {'create' | 'update' | 'skip'} action to take
+     * @param {MetadataTypeItemDiff[]} metadataToUpdate list of items to update
+     * @param {MetadataTypeItem[]} metadataToCreate list of items to create
+     * @returns {Promise.<'create'|'update'|'skip'>} action to take
      */
-    static createOrUpdate(metadataMap, metadataKey, hasError, metadataToUpdate, metadataToCreate) {
-        const createOrUpdateAction = super.createOrUpdate(
+    static async createOrUpdate(
+        metadataMap,
+        metadataKey,
+        hasError,
+        metadataToUpdate,
+        metadataToCreate
+    ) {
+        const createOrUpdateAction = await super.createOrUpdate(
             metadataMap,
             metadataKey,
             hasError,
@@ -151,10 +168,10 @@ class MobileKeyword extends MetadataType {
     /**
      * Retrieves event definition metadata for caching
      *
-     * @param {void} _ parameter not used
-     * @param {void} __ parameter not used
+     * @param {void | string[]} [_] parameter not used
+     * @param {void | string[]} [__] parameter not used
      * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
      */
     static retrieveForCache(_, __, key) {
         return this.retrieve(null, null, null, key);
@@ -165,8 +182,8 @@ class MobileKeyword extends MetadataType {
      *
      * @param {string} templateDir Directory where retrieved metadata directory will be saved
      * @param {string} key name of the metadata file
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
-     * @returns {Promise.<TYPE.MetadataTypeItemObj>} Promise of metadata
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
+     * @returns {Promise.<MetadataTypeItemObj>} Promise of metadata
      */
     static async retrieveAsTemplate(templateDir, key, templateVariables) {
         try {
@@ -194,7 +211,6 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MobileKeyword.retrieve} and {@link MobileKeyword.retrieveAsTemplate}
      *
-     * @private
      * @param {string} key customer key of single item to retrieve / name of the metadata file
      * @returns {Array} key, queryParams
      */
@@ -224,7 +240,7 @@ class MobileKeyword extends MetadataType {
     /**
      * Creates a single item
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single item
+     * @param {MetadataTypeItem} metadata a single item
      * @returns {Promise} Promise
      */
     static create(metadata) {
@@ -233,7 +249,7 @@ class MobileKeyword extends MetadataType {
     /**
      * Updates a single item
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single item
+     * @param {MetadataTypeItem} metadata a single item
      * @returns {Promise} Promise
      */
     static update(metadata) {
@@ -247,8 +263,8 @@ class MobileKeyword extends MetadataType {
     /**
      * manages post retrieve steps
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single item
-     * @returns {TYPE.CodeExtractItem | TYPE.MetadataTypeItem | void} Array with one metadata object and one ssjs string; or single metadata object; nothing if filtered
+     * @param {MetadataTypeItem} metadata a single item
+     * @returns {CodeExtractItem | MetadataTypeItem | void} Array with one metadata object and one ssjs string; or single metadata object; nothing if filtered
      */
     static postRetrieveTasks(metadata) {
         try {
@@ -298,8 +314,8 @@ class MobileKeyword extends MetadataType {
      *
      * @param {string} templateDir Directory where metadata templates are stored
      * @param {string|string[]} targetDir (List of) Directory where built definitions will be saved
-     * @param {TYPE.MetadataTypeItem} metadata main JSON file that was read from file system
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
+     * @param {MetadataTypeItem} metadata main JSON file that was read from file system
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
      * @param {string} templateName name of the template to be built
      * @returns {Promise.<string[][]>} list of extracted files with path-parts provided as an array
      */
@@ -326,8 +342,8 @@ class MobileKeyword extends MetadataType {
      * @example scripts are saved as 1 json and 1 ssjs file. both files need to be run through templating
      * @param {string} templateDir Directory where metadata templates are stored
      * @param {string|string[]} targetDir (List of) Directory where built definitions will be saved
-     * @param {TYPE.MetadataTypeItem} metadata main JSON file that was read from file system
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
+     * @param {MetadataTypeItem} metadata main JSON file that was read from file system
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
      * @param {string} templateName name of the template to be built
      * @returns {Promise.<string[][]>} list of extracted files with path-parts provided as an array
      */
@@ -354,8 +370,8 @@ class MobileKeyword extends MetadataType {
      *
      * @param {string} templateDir Directory where metadata templates are stored
      * @param {string|string[]} targetDir (List of) Directory where built definitions will be saved
-     * @param {TYPE.MetadataTypeItem} metadata main JSON file that was read from file system
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
+     * @param {MetadataTypeItem} metadata main JSON file that was read from file system
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
      * @param {string} templateName name of the template to be built
      * @param {'definition'|'template'} mode defines what we use this helper for
      * @returns {Promise.<string[][]>} list of extracted files with path-parts provided as an array
@@ -373,7 +389,7 @@ class MobileKeyword extends MetadataType {
         if (!code) {
             return null;
         }
-        const file = this.prepExtractedCode(code, metadata.name);
+        const file = this.prepExtractedCode(code);
         const fileExt = file.fileExt;
         code = file.code;
         // apply templating
@@ -419,9 +435,9 @@ class MobileKeyword extends MetadataType {
     /**
      * prepares an event definition for deployment
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single MobileKeyword
+     * @param {MetadataTypeItem} metadata a single MobileKeyword
      * @param {string} deployDir directory of deploy files
-     * @returns {Promise.<TYPE.MetadataTypeItem>} Promise
+     * @returns {Promise.<MetadataTypeItem>} Promise
      */
     static async preDeployTasks(metadata, deployDir) {
         // code
@@ -447,9 +463,9 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MetadataType.createREST}
      *
-     * @param {TYPE.MetadataTypeItem} metadataEntry a single metadata Entry
+     * @param {MetadataTypeItem} metadataEntry a single metadata Entry
      * @param {object} apiResponse varies depending on the API call
-     * @returns {void}
+     * @returns {Promise.<void>} -
      */
     static async postCreateTasks(metadataEntry, apiResponse) {
         await super.postDeployTasks_legacyApi(metadataEntry, apiResponse);
@@ -457,9 +473,9 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MetadataType.updateREST}
      *
-     * @param {TYPE.MetadataTypeItem} metadataEntry a single metadata Entry
+     * @param {MetadataTypeItem} metadataEntry a single metadata Entry
      * @param {object} apiResponse varies depending on the API call
-     * @returns {void}
+     * @returns {Promise.<void>} -
      */
     static async postUpdateTasks(metadataEntry, apiResponse) {
         await super.postDeployTasks_legacyApi(metadataEntry, apiResponse);
@@ -468,7 +484,7 @@ class MobileKeyword extends MetadataType {
     /**
      * helper for {@link MobileKeyword.preDeployTasks} that loads extracted code content back into JSON
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single definition
+     * @param {MetadataTypeItem} metadata a single definition
      * @param {string} deployDir directory of deploy files
      * @param {string} [templateName] name of the template used to built defintion (prior applying templating)
      * @returns {Promise.<string>} content for metadata.script
@@ -518,7 +534,7 @@ class MobileKeyword extends MetadataType {
      * clean up after deleting a metadata item
      *
      * @param {string} customerKey Identifier of metadata item
-     * @returns {void}
+     * @returns {Promise.<void>} -
      */
     static async postDeleteTasks(customerKey) {
         // delete local copy: retrieve/cred/bu/type/...-meta.json
@@ -530,9 +546,9 @@ class MobileKeyword extends MetadataType {
      * additionally, the documentation for dataExtension and automation should be returned
      *
      * @param {string[]} keyArr customerkey of the metadata
-     * @returns {string[]} list of all files that need to be committed in a flat array ['path/file1.ext', 'path/file2.ext']
+     * @returns {Promise.<string[]>} list of all files that need to be committed in a flat array ['path/file1.ext', 'path/file2.ext']
      */
-    static getFilesToCommit(keyArr) {
+    static async getFilesToCommit(keyArr) {
         const path = File.normalizePath([
             this.properties.directories.retrieve,
             this.buObject.credential,

package/lib/metadataTypes/MobileMessage.js

@@ -1,11 +1,23 @@
 'use strict';
 
-import TYPE from '../../types/mcdev.d.js';
 import MetadataType from './MetadataType.js';
 import { Util } from '../util/util.js';
 import File from '../util/file.js';
 import cache from '../util/cache.js';
 
+/**
+ * @typedef {import('../../types/mcdev.d.js').BuObject} BuObject
+ * @typedef {import('../../types/mcdev.d.js').CodeExtract} CodeExtract
+ * @typedef {import('../../types/mcdev.d.js').CodeExtractItem} CodeExtractItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItem} MetadataTypeItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemDiff} MetadataTypeItemDiff
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemObj} MetadataTypeItemObj
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMap} MetadataTypeMap
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMapObj} MetadataTypeMapObj
+ * @typedef {import('../../types/mcdev.d.js').SoapRequestParams} SoapRequestParams
+ * @typedef {import('../../types/mcdev.d.js').TemplateMap} TemplateMap
+ */
+
 /**
  * MobileMessage MetadataType
  *
@@ -16,10 +28,10 @@ class MobileMessage extends MetadataType {
      * Retrieves Metadata of Mobile Keywords
      *
      * @param {string} retrieveDir Directory where retrieved metadata directory will be saved
-     * @param {void} [_] unused parameter
-     * @param {void} [__] unused parameter
+     * @param {void | string[]} [_] unused parameter
+     * @param {void | string[]} [__] unused parameter
      * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj> | void} Promise of metadata
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
      */
     static retrieve(retrieveDir, _, __, key) {
         if (key && key.startsWith('id:')) {
@@ -45,15 +57,16 @@ class MobileMessage extends MetadataType {
                 throw ex;
             }
         }
+        return;
     }
 
     /**
      * Retrieves event definition metadata for caching
      *
-     * @param {void} _ parameter not used
-     * @param {void} __ parameter not used
+     * @param {void | string[]} [_] parameter not used
+     * @param {void | string[]} [__] parameter not used
      * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
      */
     static retrieveForCache(_, __, key) {
         return this.retrieve(null, null, null, key);
@@ -62,7 +75,7 @@ class MobileMessage extends MetadataType {
     /**
      * Updates a single item
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single item
+     * @param {MetadataTypeItem} metadata a single item
      * @returns {Promise} Promise
      */
     static update(metadata) {
@@ -76,7 +89,7 @@ class MobileMessage extends MetadataType {
     /**
      * Creates a single item
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single item
+     * @param {MetadataTypeItem} metadata a single item
      * @returns {Promise} Promise
      */
     static create(metadata) {
@@ -85,7 +98,7 @@ class MobileMessage extends MetadataType {
     /**
      * helper for {@link MobileMessage.preDeployTasks} that loads extracted code content back into JSON
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single definition
+     * @param {MetadataTypeItem} metadata a single definition
      * @param {string} deployDir directory of deploy files
      * @param {string} [templateName] name of the template used to built defintion (prior applying templating)
      * @returns {Promise.<string>} code
@@ -126,9 +139,9 @@ class MobileMessage extends MetadataType {
      * additionally, the documentation for dataExtension and automation should be returned
      *
      * @param {string[]} keyArr customerkey of the metadata
-     * @returns {string[]} list of all files that need to be committed in a flat array ['path/file1.ext', 'path/file2.ext']
+     * @returns {Promise.<string[]>} list of all files that need to be committed in a flat array ['path/file1.ext', 'path/file2.ext']
      */
-    static getFilesToCommit(keyArr) {
+    static async getFilesToCommit(keyArr) {
         const path = File.normalizePath([
             this.properties.directories.retrieve,
             this.buObject.credential,
@@ -146,13 +159,19 @@ class MobileMessage extends MetadataType {
     /**
      * manages post retrieve steps
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single query
-     * @returns {TYPE.CodeExtractItem} Array with one metadata object and one query string
+     * @param {MetadataTypeItem} metadata a single query
+     * @returns {CodeExtractItem} Array with one metadata object and one query string
      */
     static postRetrieveTasks(metadata) {
         // mobileCode
         try {
-            cache.searchForField('mobileCode', metadata.code.code, 'code', 'code');
+            metadata.r__mobileCode_key = cache.searchForField(
+                'mobileCode',
+                metadata.code.code,
+                'code',
+                'code'
+            );
+            delete metadata.code;
         } catch (ex) {
             Util.logger.warn(
                 ` - ${this.definition.type} ${metadata[this.definition.nameField]} (${
@@ -162,11 +181,12 @@ class MobileMessage extends MetadataType {
         }
 
         // mobileKeyword
+
         try {
             for (const attr of ['keyword', 'subscriptionKeyword', 'nextKeyword']) {
                 if (metadata[attr]?.id) {
                     metadata[attr] = {
-                        c__codeKeyword: cache.searchForField(
+                        r__mobileKeyword_key: cache.searchForField(
                             'mobileKeyword',
                             metadata[attr].id,
                             'id',
@@ -185,7 +205,7 @@ class MobileMessage extends MetadataType {
         // campaign
         try {
             if (Array.isArray(metadata.campaigns)) {
-                metadata.c__campaignNames = [];
+                metadata.r__campaign_key = [];
 
                 for (const campaign of metadata.campaigns) {
                     try {
@@ -195,7 +215,7 @@ class MobileMessage extends MetadataType {
                             throw new Error(`campaign ${campaign.name} not found in cache`);
                         }
 
-                        metadata.c__campaignNames.push(campaign.name);
+                        metadata.r__campaign_key.push(campaign.name);
                     } catch (ex) {
                         Util.logger.warn(
                             ` - ${this.definition.type} ${metadata[this.definition.nameField]}: ${
@@ -248,25 +268,32 @@ class MobileMessage extends MetadataType {
     /**
      * prepares an event definition for deployment
      *
-     * @param {TYPE.MetadataTypeItem} metadata a single MobileMessage
+     * @param {MetadataTypeItem} metadata a single MobileMessage
      * @param {string} deployDir directory of deploy files
-     * @returns {TYPE.MetadataTypeItem} Promise
+     * @returns {Promise.<MetadataTypeItem>} Promise
      */
     static async preDeployTasks(metadata, deployDir) {
         // mobileCode
-        const code = cache.getByKey('mobileCode', metadata.code.code);
-        if (!code) {
-            throw new Error(`mobileCode ${metadata.code.code} not found in cache`);
+        if (metadata.r__mobileCode_key) {
+            metadata.code ||= {};
+            const code = cache.getByKey('mobileCode', metadata.r__mobileCode_key);
+            if (!code) {
+                throw new Error(`mobileCode ${metadata.r__mobileCode_key} not found in cache`);
+            }
+            metadata.code = code;
+            delete metadata.r__mobileCode_key;
         }
-        metadata.code = code;
 
         // mobileKeyword
         for (const attr of ['keyword', 'subscriptionKeyword', 'nextKeyword']) {
-            if (metadata[attr]?.c__codeKeyword) {
-                const keywordObj = cache.getByKey('mobileKeyword', metadata[attr].c__codeKeyword);
+            if (metadata[attr]?.r__mobileKeyword_key) {
+                const keywordObj = cache.getByKey(
+                    'mobileKeyword',
+                    metadata[attr].r__mobileKeyword_key
+                );
                 if (!keywordObj) {
                     throw new Error(
-                        `mobileKeyword ${metadata[attr].c__codeKeyword} not found in cache`
+                        `mobileKeyword ${metadata[attr].r__mobileKeyword_key} not found in cache`
                     );
                 }
                 metadata[attr] = keywordObj;
@@ -274,10 +301,10 @@ class MobileMessage extends MetadataType {
         }
 
         // campaign
-        if (Array.isArray(metadata.c__campaignNames)) {
+        if (Array.isArray(metadata.r__campaign_key)) {
             metadata.campaigns = [];
 
-            for (const campaignName of metadata.c__campaignNames) {
+            for (const campaignName of metadata.r__campaign_key) {
                 const campaign = cache.getByKey('campaign', campaignName);
                 if (!campaign) {
                     throw new Error(`campaign ${campaignName} not found in cache`);
@@ -291,7 +318,7 @@ class MobileMessage extends MetadataType {
                     },
                 });
             }
-            delete metadata.c__campaignNames;
+            delete metadata.r__campaign_key;
         }
 
         if (metadata.smsTriggeredSendDefinitionId !== '00000000-0000-0000-0000-000000000000') {
@@ -306,9 +333,9 @@ class MobileMessage extends MetadataType {
     /**
      * helper for {@link MetadataType.createREST}
      *
-     * @param {TYPE.MetadataTypeItem} metadataEntry a single metadata Entry
+     * @param {MetadataTypeItem} metadataEntry a single metadata Entry
      * @param {object} apiResponse varies depending on the API call
-     * @returns {void}
+     * @returns {Promise.<void>} -
      */
     static async postCreateTasks(metadataEntry, apiResponse) {
         await super.postDeployTasks_legacyApi(metadataEntry, apiResponse);
@@ -316,9 +343,9 @@ class MobileMessage extends MetadataType {
     /**
      * helper for {@link MetadataType.updateREST}
      *
-     * @param {TYPE.MetadataTypeItem} metadataEntry a single metadata Entry
+     * @param {MetadataTypeItem} metadataEntry a single metadata Entry
      * @param {object} apiResponse varies depending on the API call
-     * @returns {void}
+     * @returns {Promise.<void>} -
      */
     static async postUpdateTasks(metadataEntry, apiResponse) {
         await super.postDeployTasks_legacyApi(metadataEntry, apiResponse);
@@ -329,8 +356,8 @@ class MobileMessage extends MetadataType {
      *
      * @param {string} templateDir Directory where metadata templates are stored
      * @param {string|string[]} targetDir (List of) Directory where built definitions will be saved
-     * @param {TYPE.MetadataTypeItem} metadata main JSON file that was read from file system
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
+     * @param {MetadataTypeItem} metadata main JSON file that was read from file system
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
      * @param {string} templateName name of the template to be built
      * @returns {Promise.<string[][]>} list of extracted files with path-parts provided as an array
      */
@@ -357,8 +384,8 @@ class MobileMessage extends MetadataType {
      * @example scripts are saved as 1 json and 1 ssjs file. both files need to be run through templating
      * @param {string} templateDir Directory where metadata templates are stored
      * @param {string|string[]} targetDir (List of) Directory where built definitions will be saved
-     * @param {TYPE.MetadataTypeItem} metadata main JSON file that was read from file system
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
+     * @param {MetadataTypeItem} metadata main JSON file that was read from file system
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
      * @param {string} templateName name of the template to be built
      * @returns {Promise.<string[][]>} list of extracted files with path-parts provided as an array
      */
@@ -385,8 +412,8 @@ class MobileMessage extends MetadataType {
      *
      * @param {string} templateDir Directory where metadata templates are stored
      * @param {string|string[]} targetDir (List of) Directory where built definitions will be saved
-     * @param {TYPE.MetadataTypeItem} metadata main JSON file that was read from file system
-     * @param {TYPE.TemplateMap} templateVariables variables to be replaced in the metadata
+     * @param {MetadataTypeItem} metadata main JSON file that was read from file system
+     * @param {TemplateMap} templateVariables variables to be replaced in the metadata
      * @param {string} templateName name of the template to be built
      * @param {'definition'|'template'} mode defines what we use this helper for
      * @returns {Promise.<string[][]>} list of extracted files with path-parts provided as an array