mcdev 4.3.4 → 5.0.0

package/test/utils.js

@@ -17,10 +17,11 @@ const resourceFactory = require('./resourceFactory');
  *
  * @param {string} customerKey of metadata
  * @param {string} type of metadata
+ * @param {string} [buName] used when we need to test on ParentBU
  * @returns {Promise.<string>} file in string form
  */
-exports.getActualJson = (customerKey, type) =>
-    File.readJSON(`./retrieve/testInstance/testBU/${type}/${customerKey}.${type}-meta.json`);
+exports.getActualJson = (customerKey, type, buName = 'testBU') =>
+    File.readJSON(`./retrieve/testInstance/${buName}/${type}/${customerKey}.${type}-meta.json`);
 /**
  * gets file from Retrieve folder
  *
@@ -36,10 +37,11 @@ exports.getActualFile = (customerKey, type, ext) =>
  *
  * @param {string} customerKey of metadata
  * @param {string} type of metadata
+ * @param {string} [buName] used when we need to test on ParentBU
  * @returns {Promise.<string>} file in string form
  */
-exports.getActualDeployJson = (customerKey, type) =>
-    File.readJSON(`./deploy/testInstance/testBU/${type}/${customerKey}.${type}-meta.json`);
+exports.getActualDeployJson = (customerKey, type, buName = 'testBU') =>
+    File.readJSON(`./deploy/testInstance/${buName}/${type}/${customerKey}.${type}-meta.json`);
 /**
  * gets file from Deploy folder
  *
@@ -143,6 +145,9 @@ exports.mockSetup = (isDeploy) => {
         fsMockConf.deploy = fsmock.load(path.resolve(__dirname, 'mockRoot/deploy'));
     }
     fsmock(fsMockConf);
+
+    // ! reset exitCode or else tests could influence each other; do this in mockSetup to to ensure correct starting value
+    process.exitCode = 0;
 };
 
 /**
@@ -151,6 +156,13 @@ exports.mockSetup = (isDeploy) => {
  * @returns {void}
  */
 exports.mockReset = () => {
+    // remove all options that might have been set by previous tests
+    for (const key in Util.OPTIONS) {
+        if (Object.prototype.hasOwnProperty.call(Util.OPTIONS, key)) {
+            delete Util.OPTIONS[key];
+        }
+    }
+    // reset sfmc login
     auth.clearSessions();
     fsmock.restore();
     apimock.restore();
@@ -202,5 +214,5 @@ exports.logAPIHistoryDebug = () => {
  * @returns {string} escaped string
  */
 function escapeRegExp(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
+    return str.replaceAll(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
 }

package/types/mcdev.d.js

@@ -12,7 +12,7 @@ const SDK = require('sfmc-sdk');
  */
 /**
  * @typedef {Object.<string, string>} TemplateMap
- * @typedef {'accountUser'|'asset'|'asset-archive'|'asset-asset'|'asset-audio'|'asset-block'|'asset-code'|'asset-document'|'asset-image'|'asset-message'|'asset-other'|'asset-rawimage'|'asset-template'|'asset-textfile'|'asset-video'|'attributeGroup'|'automation'|'campaign'|'contentArea'|'dataExtension'|'dataExtensionField'|'dataExtensionTemplate'|'dataExtract'|'dataExtractType'|'discovery'|'email'|'emailSendDefinition'|'eventDefinition'|'fileTransfer'|'filter'|'folder'|'ftpLocation'|'importFile'|'interaction'|'list'|'mobileCode'|'mobileKeyword'|'query'|'role'|'script'|'setDefinition'|'triggeredSendDefinition'} SupportedMetadataTypes
+ * @typedef {'accountUser'|'asset'|'asset-archive'|'asset-asset'|'asset-audio'|'asset-block'|'asset-code'|'asset-document'|'asset-image'|'asset-message'|'asset-other'|'asset-rawimage'|'asset-template'|'asset-textfile'|'asset-video'|'attributeGroup'|'automation'|'campaign'|'contentArea'|'dataExtension'|'dataExtensionField'|'dataExtensionTemplate'|'dataExtract'|'dataExtractType'|'discovery'|'email'|'emailSend'|'event'|'fileTransfer'|'filter'|'folder'|'fileLocation'|'importFile'|'interaction'|'list'|'mobileCode'|'mobileKeyword'|'query'|'role'|'script'|'setDefinition'|'triggeredSend'} SupportedMetadataTypes
  * @typedef {Object.<SupportedMetadataTypes, string[]>} TypeKeyCombo object-key=metadata type, value=array of external keys
  */
 
@@ -21,10 +21,10 @@ const SDK = require('sfmc-sdk');
  * @typedef {Object.<string, MetadataTypeItem>} MetadataTypeMap key=customer key
  * @typedef {Object.<string, MetadataTypeMap>} MultiMetadataTypeMap key=Supported MetadataType
  * @typedef {Object.<string, MetadataTypeItem[]>} MultiMetadataTypeList key=Supported MetadataType
- * @typedef {{metadata:MetadataTypeMap,type:SupportedMetadataTypes}} MetadataTypeMapObj
- * @typedef {{metadata:MetadataTypeItem,type:SupportedMetadataTypes}} MetadataTypeItemObj
+ * @typedef {{metadata: MetadataTypeMap, type: SupportedMetadataTypes}} MetadataTypeMapObj
+ * @typedef {{metadata: MetadataTypeItem, type: SupportedMetadataTypes}} MetadataTypeItemObj
  * @typedef {Object.<number, MultiMetadataTypeMap>} Cache key=MID
- * @typedef {{before: TYPE.MetadataTypeItem, after: TYPE.MetadataTypeItem}} MetadataTypeItemDiff used during update
+ * @typedef {{before: MetadataTypeItem, after: MetadataTypeItem}} MetadataTypeItemDiff used during update
  */
 
 /**
@@ -119,24 +119,57 @@ const SDK = require('sfmc-sdk');
  * @typedef {Object.<string, DataExtensionItem>} DataExtensionMap
  */
 /**
- * @typedef {object} AccountUserDocument
- * @property {string} TYPE user.type__c
- * @property {string} UserID user.UserID
- * @property {string} AccountUserID user.AccountUserID
+ * @typedef {object} UserDocument
+ * @property {string} [ID] equal to UserID; optional in update/create calls
+ * @property {string} UserID equal to ID; required in update/create calls
+ * @property {number} [AccountUserID] user.AccountUserID
+ * @property {number} c__AccountUserID copy of AccountUserID
  * @property {string} CustomerKey user.CustomerKey
  * @property {string} Name user.Name
  * @property {string} Email user.Email
  * @property {string} NotificationEmailAddress user.NotificationEmailAddress
- * @property {string} ActiveFlag user.ActiveFlag === true ? '✓' : '-'
- * @property {string} IsAPIUser user.IsAPIUser === true ? '✓' : '-'
- * @property {string} MustChangePassword user.MustChangePassword === true ? '✓' : '-'
- * @property {string} DefaultBusinessUnit defaultBUName
- * @property {string} AssociatedBusinessUnits__c associatedBus
- * @property {string} Roles roles
- * @property {string} UserPermissions userPermissions
+ * @property {boolean} ActiveFlag user.ActiveFlag === true ? '✓' : '-'
+ * @property {boolean} IsAPIUser user.IsAPIUser === true ? '✓' : '-'
+ * @property {boolean} MustChangePassword user.MustChangePassword === true ? '✓' : '-'
+ * @property {number} DefaultBusinessUnit defaultBUName
+ * @property {number[]} c__AssociatedBusinessUnits associatedBus
+ * @property {object} [Roles] (API only)
+ * @property {object[]} [Roles.Role] roles (API only)
+ * @property {string[]} c__RoleNamesGlobal roles
+ * @property {string[]} UserPermissions userPermissions
  * @property {string} LastSuccessfulLogin this.timeSinceDate(user.LastSuccessfulLogin)
  * @property {string} CreatedDate user.CreatedDate
  * @property {string} ModifiedDate user.ModifiedDate
+ * @property {object} Client -
+ * @property {number} [Client.ID] EID e.g:7281698
+ * @property {number} Client.ModifiedBy AccountUserID of user who last modified this user
+ * @property {'User'|'Installed Package'} c__type -
+ * @property {boolean} [IsLocked] (API only)
+ * @property {boolean} [Unlock] used to unlock a user that has IsLocked === true
+ * @property {boolean} c__IsLocked_readOnly copy of IsLocked
+ * @property {string} c__TimeZoneName name of timezone
+ * @property {object} [TimeZone] (API only)
+ * @property {string} [TimeZone.Name] (API only)
+ * @property {string} [TimeZone.ID] (API only)
+ * @property {'en-US'|'fr-CA'|'fr-FR'|'de-DE'|'it-IT'|'ja-JP'|'pt-BR'|'es-419'|'es-ES'} c__LocaleCode fr-CA, en-US, ...
+ * @property {object} [Locale] (API only)
+ * @property {'en-US'|'fr-CA'|'fr-FR'|'de-DE'|'it-IT'|'ja-JP'|'pt-BR'|'es-419'|'es-ES'} [Locale.LocaleCode] (API only)
+ * @typedef {{before:UserDocument,after:UserDocument}} UserDocumentDiff
+ * @typedef {Object.<string, UserDocument>} UserDocumentMap key=customer key
+ */
+/**
+ * @typedef {object} AccountUserConfiguration
+ * @property {object} Client wrapper
+ * @property {number} Client.ID EID e.g:7281698
+ * @property {string} [PartnerKey] empty string
+ * @property {number} ID User ID e.g:717133502
+ * @property {string} [ObjectID] empty string
+ * @property {number} [Delete] 0,1
+ * @property {BusinessUnitAssignmentConfiguration} BusinessUnitAssignmentConfiguration -
+ * @typedef {object} BusinessUnitAssignmentConfiguration
+ * @property {object} BusinessUnitIds wrapper
+ * @property {number[]|number} BusinessUnitIds.BusinessUnitId e.g:[518003624]
+ * @property {boolean} IsDelete assign BU if false, remove assignment if true
  */
 
 /**

package/.github/workflows/code-analysis.yml

@@ -1,57 +0,0 @@
-# For most projects, this workflow file will not need changing; you simply need
-# to commit it to your repository.
-#
-# You may wish to alter this file to override the set of languages analyzed,
-# or to provide custom queries or build logic.
-#
-# ******** NOTE ********
-# We have attempted to detect the languages in your repository. Please check
-# the `language` matrix defined below to confirm you have the correct set of
-# supported CodeQL languages.
-#
-name: 'CodeAnalysis'
-
-on:
-    push:
-        branches: [main, develop, hotfix]
-    pull_request:
-        # The branches below must be a subset of the branches above
-        branches: [main, develop, hotfix]
-
-jobs:
-    analyzeAndTest:
-        name: Analyze & Test
-        runs-on: ubuntu-latest
-        permissions:
-            actions: read
-            contents: read
-            security-events: write
-
-        strategy:
-            fail-fast: false
-            matrix:
-                language: ['javascript']
-
-        steps:
-            - name: Checkout repository
-              uses: actions/checkout@v3
-
-            - uses: actions/setup-node@v3
-              with:
-                  node-version: 16
-                  registry-url: https://registry.npmjs.org/
-
-            - run: npm ci --ignore-scripts
-
-            - run: npm run lint
-
-            # Initializes the CodeQL tools for scanning.
-            - name: Initialize CodeQL
-              uses: github/codeql-action/init@v2
-              with:
-                  languages: ${{ matrix.language }}
-            - name: Perform CodeQL Analysis
-              uses: github/codeql-action/analyze@v2
-
-            # Assuming code passes, run tests
-            - run: npm run test

package/lib/metadataTypes/AccountUser.js

@@ -1,426 +0,0 @@
-'use strict';
-
-const TYPE = require('../../types/mcdev.d');
-const MetadataType = require('./MetadataType');
-const Util = require('../util/util');
-const File = require('../util/file');
-
-/**
- * MessageSendActivity MetadataType
- *
- * @augments MetadataType
- */
-class AccountUser extends MetadataType {
-    /**
-     * Retrieves SOAP based metadata of metadata type into local filesystem. executes callback with retrieved metadata
-     *
-     * @param {string} retrieveDir Directory where retrieved metadata directory will be saved
-     * @param {void} _ unused parameter
-     * @param {void} [__] unused parameter
-     * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
-     */
-    static async retrieve(retrieveDir, _, __, key) {
-        if (this.buObject.eid !== this.buObject.mid) {
-            Util.logger.info(' - Skipping User retrieval on non-parent BU');
-            return;
-        }
-        return this._retrieve(retrieveDir, key);
-    }
-    /**
-     * Retrieves SOAP based metadata of metadata type into local filesystem. executes callback with retrieved metadata
-     *
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
-     */
-    static async retrieveChangelog() {
-        return this._retrieve();
-    }
-    /**
-     * Retrieves SOAP based metadata of metadata type into local filesystem. executes callback with retrieved metadata
-     *
-     * @private
-     * @param {string} retrieveDir Directory where retrieved metadata directory will be saved
-     * @param {string} [key] customer key of single item to retrieve
-     * @returns {Promise.<TYPE.MetadataTypeMapObj>} Promise of metadata
-     */
-    static async _retrieve(retrieveDir, key) {
-        Util.logger.info(' - Caching dependent Metadata: AccountUserAccount');
-
-        // get BUs that each users have access to
-        const optionsBUs = {};
-
-        const resultsBatch = (
-            await this.client.soap.retrieveBulk(
-                'AccountUserAccount',
-                ['AccountUser.AccountUserID', 'AccountUser.UserID', 'Account.ID', 'Account.Name'],
-                optionsBUs
-            )
-        ).Results;
-        this.userIdBuMap = {};
-        for (const item of resultsBatch) {
-            this.userIdBuMap[item.AccountUser.AccountUserID] =
-                this.userIdBuMap[item.AccountUser.AccountUserID] || [];
-            // push to array if not already in array
-            if (
-                !this.userIdBuMap[item.AccountUser.AccountUserID].some(
-                    (bu) => bu.ID === item.Account.ID
-                )
-            ) {
-                this.userIdBuMap[item.AccountUser.AccountUserID].push({
-                    ID: item.Account.ID,
-                    Name: item.Account.Name,
-                });
-            }
-        }
-        // get actual user details
-        /** @type {TYPE.SoapRequestParams} */
-        let requestParams = {
-            QueryAllAccounts: true,
-
-            filter: {
-                leftOperand: {
-                    // normal users
-                    leftOperand: 'Email',
-                    operator: 'like',
-                    rightOperand: '@',
-                },
-                operator: 'OR',
-                rightOperand: {
-                    // installed packages
-                    leftOperand: {
-                        leftOperand: 'Name',
-                        operator: 'like',
-                        rightOperand: ' app user', // ! will not work if the name was too long as "app user" might be cut off
-                    },
-                    operator: 'AND',
-                    rightOperand: {
-                        // this is used to filter out system generated installed packages. in our testing, at least those installed packages created in the last few years have hat set this to false while additional (hidden) installed packages have it set to true.
-                        leftOperand: 'MustChangePassword',
-                        operator: 'equals',
-                        rightOperand: 'false',
-                    },
-                },
-            },
-        };
-        if (key) {
-            // move original filter down one level into rightOperand and add key filter into leftOperand
-            requestParams = {
-                filter: {
-                    leftOperand: {
-                        leftOperand: 'CustomerKey',
-                        operator: 'equals',
-                        rightOperand: key,
-                    },
-                    operator: 'AND',
-                    rightOperand: requestParams.filter,
-                },
-            };
-        }
-        Util.logger.info(` - Loading ${this.definition.type}. This might take a while...`);
-        return super.retrieveSOAP(retrieveDir, requestParams);
-    }
-    /**
-     *
-     * @private
-     * @param {string} date first date
-     * @returns {number} time difference
-     */
-    static _timeSinceDate(date) {
-        const interval = 'days';
-        const second = 1000,
-            minute = second * 60,
-            hour = minute * 60,
-            day = hour * 24,
-            week = day * 7;
-        date = new Date(date);
-        const now = new Date();
-        const timediff = now - date;
-        if (Number.isNaN(timediff)) {
-            return Number.NaN;
-        }
-        let result;
-        switch (interval) {
-            case 'years': {
-                result = now.getFullYear() - date.getFullYear();
-                break;
-            }
-            case 'months': {
-                result =
-                    now.getFullYear() * 12 +
-                    now.getMonth() -
-                    (date.getFullYear() * 12 + date.getMonth());
-                break;
-            }
-            case 'weeks': {
-                result = Math.floor(timediff / week);
-                break;
-            }
-            case 'days': {
-                result = Math.floor(timediff / day);
-                break;
-            }
-            case 'hours': {
-                result = Math.floor(timediff / hour);
-                break;
-            }
-            case 'minutes': {
-                result = Math.floor(timediff / minute);
-                break;
-            }
-            case 'seconds': {
-                result = Math.floor(timediff / second);
-                break;
-            }
-            default: {
-                return;
-            }
-        }
-        return result + ' ' + interval;
-    }
-    /**
-     * helper to print bu names
-     *
-     * @private
-     * @param {number} id bu id
-     * @returns {string} "bu name (bu id)""
-     */
-    static _getBuName(id) {
-        const name = this.buObject.eid == id ? '_ParentBU_' : this.buIdName[id];
-        return `<nobr>${name} (${id})</nobr>`;
-    }
-
-    /**
-     * helper that gets BU names from config
-     *
-     * @private
-     */
-    static _getBuNames() {
-        this.buIdName = {};
-        for (const cred in this.properties.credentials) {
-            for (const buName in this.properties.credentials[cred].businessUnits) {
-                this.buIdName[this.properties.credentials[cred].businessUnits[buName]] = buName;
-            }
-        }
-    }
-    /**
-     * Creates markdown documentation of all roles
-     *
-     * @param {TYPE.MetadataTypeMap} [metadata] user list
-     * @returns {Promise.<void>} -
-     */
-    static async document(metadata) {
-        if (this.buObject.eid !== this.buObject.mid) {
-            Util.logger.error(
-                `Users can only be retrieved & documented for the ${Util.parentBuName}`
-            );
-            return;
-        }
-        if (!metadata) {
-            // load users from disk if document was called directly and not part of a retrieve
-            try {
-                metadata = this.readBUMetadataForType(
-                    File.normalizePath([
-                        this.properties.directories.retrieve,
-                        this.buObject.credential,
-                        Util.parentBuName,
-                    ]),
-                    true
-                ).accountUser;
-            } catch (ex) {
-                Util.logger.error(ex.message);
-                return;
-            }
-        }
-        // init map of BU Ids > BU Name
-        this._getBuNames();
-
-        // initialize permission object
-        this.allPermissions = {};
-        /**
-         * @type {TYPE.AccountUserDocument[]}
-         */
-        const users = [];
-        // traverse all permissions recursively and write them into allPermissions object once it has reached the end
-        for (const id in metadata) {
-            const user = metadata[id];
-            // TODO resolve user permissions to something readable
-            let userPermissions = '';
-            if (user.UserPermissions) {
-                if (!user.UserPermissions.length) {
-                    // 1 single user permission found, normalize it
-                    user.UserPermissions = [user.UserPermissions];
-                }
-                userPermissions = user.UserPermissions.map((item) => item.ID * 1)
-                    .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))
-                    .join(', ');
-            }
-            // user roles
-            // TODO think about what to do with "individual role" entries
-            let roles = '';
-            if (user.Roles) {
-                roles =
-                    '<nobr>' +
-                    user.Roles.map((item) => item.Name)
-                        .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))
-                        .join(',</nobr><br> <nobr>') +
-                    '</nobr>';
-            }
-            let associatedBus = '';
-            if (user.AssociatedBusinessUnits__c) {
-                user.AssociatedBusinessUnits__c.push({
-                    ID: user.DefaultBusinessUnit,
-                });
-                // ensure associatedBus have no duplicates
-                associatedBus = [
-                    ...new Set(
-                        user.AssociatedBusinessUnits__c.map((item) => this._getBuName(item.ID))
-                    ),
-                ]
-                    .sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))
-                    .join(',<br> ');
-            }
-            const defaultBUName = this._getBuName(user.DefaultBusinessUnit);
-            users.push({
-                TYPE: user.type__c,
-                UserID: user.UserID,
-                AccountUserID: user.AccountUserID,
-                CustomerKey: user.CustomerKey,
-                Name: user.Name,
-                Email: user.Email,
-                NotificationEmailAddress: user.NotificationEmailAddress,
-                ActiveFlag: user.ActiveFlag === true ? '✓' : '-',
-                IsAPIUser: user.IsAPIUser === true ? '✓' : '-',
-                MustChangePassword: user.MustChangePassword === true ? '✓' : '-',
-                DefaultBusinessUnit: defaultBUName,
-                AssociatedBusinessUnits__c: associatedBus,
-                Roles: roles,
-                UserPermissions: userPermissions,
-                LastSuccessfulLogin: this._timeSinceDate(user.LastSuccessfulLogin),
-                CreatedDate: user.CreatedDate.split('T').join(' '),
-                ModifiedDate: user.ModifiedDate.split('T').join(' '),
-            });
-        }
-        users.sort((a, b) => (a.Name < b.Name ? -1 : a.Name > b.Name ? 1 : 0));
-        const columnsToPrint = [
-            ['Name', 'Name'],
-            ['Last successful Login', 'LastSuccessfulLogin'],
-            ['Active', 'ActiveFlag'],
-            ['API User', 'IsAPIUser'],
-            ['Must change PW', 'MustChangePassword'],
-            ['Default BU', 'DefaultBusinessUnit'],
-            ['BU Access', 'AssociatedBusinessUnits__c'],
-            ['Roles', 'Roles'],
-            ['User Permissions', 'UserPermissions'],
-            ['Login', 'UserID'],
-            ['ID', 'AccountUserID'],
-            ['Key', 'CustomerKey'],
-            ['E-Mail', 'Email'],
-            ['Notification E-Mail', 'NotificationEmailAddress'],
-            ['Modified Date', 'ModifiedDate'],
-            ['Created Date', 'CreatedDate'],
-        ];
-        let output = `# User Overview - ${this.buObject.credential}`;
-        output += this._generateDocMd(
-            users.filter((user) => user.TYPE === 'User' && user.ActiveFlag === '✓'),
-            'User',
-            columnsToPrint
-        );
-        output += this._generateDocMd(
-            users.filter((user) => user.TYPE === 'User' && user.ActiveFlag === '-'),
-            'Inactivated User',
-            columnsToPrint
-        );
-        output += this._generateDocMd(
-            users.filter((user) => user.TYPE === 'Installed Package'),
-            'Installed Package',
-            columnsToPrint
-        );
-        const docPath = File.normalizePath([this.properties.directories.docs, 'user']);
-
-        try {
-            const filename = this.buObject.credential;
-            // write to disk
-            await File.writeToFile(docPath, filename + '.accountUsers', 'md', output);
-            Util.logger.info(`Created ${File.normalizePath([docPath, filename])}.accountUsers.md`);
-            if (['html', 'both'].includes(this.properties.options.documentType)) {
-                Util.logger.warn(
-                    ' - HTML-based documentation of accountUser currently not supported.'
-                );
-            }
-        } catch (ex) {
-            Util.logger.error(`AccountUser.document():: error | `, ex.message);
-        }
-    }
-    /**
-     *
-     * @private
-     * @param {object[]} users list of users and installed package
-     * @param {'Installed Package'|'User'} type choose what sub type to print
-     * @param {Array[]} columnsToPrint helper array
-     * @returns {string} markdown
-     */
-    static _generateDocMd(users, type, columnsToPrint) {
-        let output = `\n\n## ${type}s (${users.length})\n\n`;
-        let tableSeparator = '';
-        for (const column of columnsToPrint) {
-            output += `| ${column[0]} `;
-            tableSeparator += '| --- ';
-        }
-        output += `|\n${tableSeparator}|\n`;
-        for (const user of users) {
-            for (const column of columnsToPrint) {
-                output += `| ${user[column[1]]} `;
-            }
-            output += `|\n`;
-        }
-        return output;
-    }
-
-    /**
-     * manages post retrieve steps
-     *
-     * @param {TYPE.MetadataTypeItem} metadata a single query
-     * @returns {TYPE.MetadataTypeItem} Array with one metadata object and one query string
-     */
-    static postRetrieveTasks(metadata) {
-        return this.parseMetadata(metadata);
-    }
-    /**
-     * parses retrieved Metadata before saving
-     *
-     * @param {TYPE.MetadataTypeItem} metadata a single query activity definition
-     * @returns {TYPE.MetadataTypeItem} Array with one metadata object and one sql string
-     */
-    static parseMetadata(metadata) {
-        metadata.type__c = 'Installed Package';
-        if (metadata.Email.includes('@') && !metadata.Name.endsWith('app user')) {
-            metadata.type__c = 'User';
-        }
-
-        metadata.AssociatedBusinessUnits__c = this.userIdBuMap[metadata.ID] || [];
-
-        let roles;
-        if (metadata.Roles?.Role) {
-            // normalize to always use array
-            if (!metadata.Roles.Role.length) {
-                metadata.Roles.Role = [metadata.Roles.Role];
-            }
-            // convert complex object into basic set of info
-            roles = metadata.Roles.Role.map((item) => ({
-                Name: item.Name,
-                CustomerKey: item.CustomerKey,
-            })).sort((a, b) => (a.Name < b.Name ? -1 : a.Name > b.Name ? 1 : 0));
-        } else {
-            // set to empty array
-            roles = [];
-        }
-        metadata.Roles = roles;
-
-        return metadata;
-    }
-}
-
-// Assign definition to static attributes
-AccountUser.definition = require('../MetadataTypeDefinitions').accountUser;
-
-module.exports = AccountUser;