mcdev 8.1.0 → 8.2.0

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

@@ -0,0 +1,211 @@
+export default {
+    bodyIteratorField: 'Results',
+    dependencies: [
+        'triggeredSend',
+        'folder-hidden',
+        'folder-triggered_send',
+        'folder-triggered_send_journeybuilder',
+    ],
+    dependencyGraph: {
+        triggeredSend: ['r__triggeredSend_key'],
+    },
+    filter: {},
+    hasExtended: false,
+    idField: 'ObjectID',
+    keepId: false,
+    keyIsFixed: true,
+    keyField: 'CustomerKey',
+    nameField: 'r__triggeredSend_name',
+    folderIdField: 'TriggeredSend.CategoryID',
+    createdDateField: null,
+    createdNameField: null,
+    lastmodDateField: null,
+    lastmodNameField: null,
+    restPagination: null,
+    maxKeyLength: 36,
+    type: 'triggeredSendSummary',
+    soapType: 'triggeredSendSummary',
+    typeDescription: 'Summary data for a Triggered Send',
+    typeRetrieveByDefault: false,
+    typeCdpByDefault: false,
+    typeName: 'Triggered Send Summary',
+    fields: {
+        Bounces: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        Clicks: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        'Client.ID': {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        Conversions: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        CustomerKey: {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            templating: true,
+        },
+        FTAFEmailsSent: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        FTAFOptIns: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        FTAFRequests: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        ID: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        InProcess: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        NotSentDueToError: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        NotSentDueToOptOut: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        NotSentDueToUndeliverable: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        ObjectID: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        /* ObjectState: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        }, */ // according to the documentation"Reserved for future use"
+        Opens: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        OptOuts: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        Owner: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        PartnerKey: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        PartnerProperties: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        Queued: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        Sent: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        SurveyResponses: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        UniqueClicks: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        UniqueConversions: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        UniqueOpens: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        CorrelationID: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        CreatedDate: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false /** Listed in the type documentation but not retrievable */,
+            templating: false,
+        },
+        ModifiedDate: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false /** Listed in the type documentation but not retrievable */,
+            templating: false,
+        },
+        r__triggeredSend_name: { skipValidation: true },
+        r__triggeredSend_key: { skipValidation: true },
+        r__folder_Path: { skipValidation: true },
+    },
+};

package/lib/util/devops.js

@@ -195,10 +195,13 @@ const DevOps = {
                         // - retrieve/cred/bu/asset/block/016aecc7-7063-4b78-93f4-aa119ea933c7.asset-block-meta.html
                         // - retrieve/cred/bu/asset/message/003c1ef5-f538-473a-91da-26942024a64a/blocks/views.html.slots.[bottom-8frq7iw2k99].asset-message-meta.html
                         // - retrieve/cred/bu/query/03efd5f1-ba1f-487a-9c9a-36aeb2ae5192.query-meta.sql
-                        file.externalKey =
-                            file.type === 'asset'
-                                ? file.file.split('/')[5].split('.')[0] // assets have an additional folder level for their subtype
-                                : file.file.split('/')[4].split('.')[0];
+                        // assets have an additional folder level for their subtype
+                        // keys could contain dots themselves
+                        file.externalKey = file.file
+                            .split('/')
+                            [file.type === 'asset' ? 5 : 4].split('.')
+                            .slice(0, -2)
+                            .join('.');
                         file.name = null;
                     }
 
@@ -267,8 +270,14 @@ const DevOps = {
         }
         // Write into delta.json to serve as documentation
         const directoryDeltaPkg = 'logs/';
-        await File.writeJSONToFile(directoryDeltaPkg, Util.logFileName + '-delta_package', delta);
-        this.document(directoryDeltaPkg, delta);
+        await File.writeJSONToFile(
+            directoryDeltaPkg,
+            Util.logFileName +
+                '-delta_package-' +
+                filterPathsCSV.replaceAll(',', '-').replaceAll('/', '-'),
+            delta
+        );
+        this.document(directoryDeltaPkg, filterPathsCSV, delta);
         Util.logger.info(
             `- ✔️  Identified changes: Add/Update=${gitActionsCounter['add/update']}, Move=${gitActionsCounter['move']}, Delete=${gitActionsCounter['delete']}`
         );
@@ -572,10 +581,11 @@ const DevOps = {
      * create markdown file for deployment listing
      *
      * @param {string} directory -
+     * @param {string} filterPathsCSV -
      * @param {object} jsonReport -
      * @returns {void}
      */
-    document(directory, jsonReport) {
+    document(directory, filterPathsCSV, jsonReport) {
         const tabled = jsonToTable(jsonReport);
         let output = `# Deployment Report\n\n`;
         let tableSeparator = '';
@@ -597,7 +607,14 @@ const DevOps = {
         }
         try {
             // write to disk (asynchronously)
-            File.writeToFile(directory, Util.logFileName + '-delta_package', 'md', output);
+            File.writeToFile(
+                directory,
+                Util.logFileName +
+                    '-delta_package-' +
+                    filterPathsCSV.replaceAll(',', '-').replaceAll('/', '-'),
+                'md',
+                output
+            );
         } catch (ex) {
             Util.logger.error(`DevOps.document():: error | ` + ex.message);
         }

package/lib/util/util.js

@@ -1143,14 +1143,17 @@ export const Util = {
      * returns true if no LIKE filter is defined or if all filters match
      *
      * @param {MetadataTypeItem} metadata a single metadata item
+     * @param {object} definition type definition
      * @param {object} [filters] only used in recursive calls
      * @returns {boolean} true if no LIKE filter is defined or if all filters match
      */
-    fieldsLike(metadata, filters) {
+    fieldsLike(metadata, definition, filters) {
         if (metadata.json && metadata.codeArr) {
             // Compensate for CodeExtractItem format
             metadata = metadata.json;
         }
+        // ensure we only convert "key" and "name" fields on the first call to this method
+        const checkDefaultKeyAndName = filters ? false : true;
         filters ||= Util.OPTIONS.like;
         if (!filters) {
             return true;
@@ -1163,14 +1166,20 @@ export const Util = {
                     ? filters[field].split(',')
                     : filters[field];
             if (Array.isArray(metadata[field])) {
-                return metadata[field].some((f) => Util.fieldsLike(f, filter));
+                return metadata[field].some((f) => Util.fieldsLike(f, definition, filter));
             } else {
+                let fieldName;
+                if (field === 'key' && checkDefaultKeyAndName) {
+                    fieldName = definition.keyField;
+                } else if (field === 'name' && checkDefaultKeyAndName) {
+                    fieldName = definition.nameField;
+                }
                 if (typeof filter === 'string') {
-                    return Util.stringLike(metadata[field], filter);
+                    return Util.stringLike(metadata[fieldName || field], filter);
                 } else if (Array.isArray(filter)) {
                     return filter.some((f) => Util.stringLike(metadata[field], f));
                 } else if (typeof filter === 'object') {
-                    return Util.fieldsLike(metadata[field], filter);
+                    return Util.fieldsLike(metadata[field], definition, filter);
                 }
             }
             return false;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mcdev",
-    "version": "8.1.0",
+    "version": "8.2.0",
     "description": "Accenture Salesforce Marketing Cloud DevTools",
     "author": "Accenture: joern.berkefeld, douglas.midgley, robert.zimmermann, maciej.barnas",
     "license": "MIT",
@@ -80,21 +80,21 @@
         "p-limit": "6.2.0",
         "prettier": "3.5.3",
         "prettier-plugin-sql": "0.19.0",
-        "semver": "7.7.1",
+        "semver": "7.7.3",
         "sfmc-sdk": "2.1.2",
-        "simple-git": "3.27.0",
+        "simple-git": "3.29.0",
         "toposort": "2.0.2",
         "update-notifier": "7.3.1",
         "winston": "3.17.0",
         "yargs": "17.7.2",
-        "yocto-spinner": "0.2.2"
+        "yocto-spinner": "1.0.0"
     },
     "devDependencies": {
         "@eslint/js": "9.28.0",
         "@types/fs-extra": "11.0.4",
         "@types/inquirer": "9.0.7",
         "@types/mocha": "10.0.8",
-        "@types/node": "22.15.29",
+        "@types/node": "24.9.1",
         "@types/yargs": "17.0.33",
         "assert": "2.1.0",
         "axios-mock-adapter": "2.0.0",
@@ -104,17 +104,17 @@
         "eslint": "9.28.0",
         "eslint-config-ssjs": "2.0.0",
         "eslint-plugin-jsdoc": "50.7.1",
-        "eslint-plugin-mocha": "11.0.0",
+        "eslint-plugin-mocha": "11.2.0",
         "eslint-plugin-prettier": "5.4.1",
         "eslint-plugin-unicorn": "59.0.1",
-        "fast-xml-parser": "5.2.3",
+        "fast-xml-parser": "5.3.0",
         "globals": "16.2.0",
         "husky": "9.1.7",
-        "lint-staged": "15.5.1",
-        "mocha": "11.5.0",
+        "lint-staged": "16.2.6",
+        "mocha": "11.7.4",
         "mock-fs": "5.3.0",
         "npm-run-all": "4.1.5",
-        "prettier-eslint": "16.4.1",
+        "prettier-eslint": "16.4.2",
         "typescript": "5.8.3"
     },
     "optionalDependencies": {

package/test/mockRoot/.mcdevrc.json

@@ -175,5 +175,5 @@
             "verification"
         ]
     },
-    "version": "8.1.0"
+    "version": "8.2.0"
 }

package/test/resources/1111111/dataFolder/retrieve-ContentTypeINdataextension,hidden,queryactivity,salesforcedataextension,shared_data,shared_dataextension,shared_salesforcedataextension,synchronizeddataextension-response.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+    xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"
+    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
+    xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
+    <soap:Header>
+        <wsa:Action>RetrieveResponse</wsa:Action>
+        <wsa:MessageID>urn:uuid:998a6923-b781-40be-abad-0506f0f97477</wsa:MessageID>
+        <wsa:RelatesTo>urn:uuid:a5d518cc-9bfb-45f1-a4a7-5d11cc1a8d44</wsa:RelatesTo>
+        <wsa:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
+        <wsse:Security>
+            <wsu:Timestamp wsu:Id="Timestamp-a6c00a2f-fcfa-4882-a72d-8b8983a8cc7e">
+                <wsu:Created>2025-09-05T16:29:03Z</wsu:Created>
+                <wsu:Expires>2025-09-05T16:34:03Z</wsu:Expires>
+            </wsu:Timestamp>
+        </wsse:Security>
+    </soap:Header>
+    <soap:Body>
+        <RetrieveResponseMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
+            <OverallStatus>OK</OverallStatus>
+            <RequestID>ac40bccd-e8cd-4232-b1ee-e3cfbbfd0b89</RequestID>
+        </RetrieveResponseMsg>
+    </soap:Body>
+</soap:Envelope>

package/test/resources/9999999/automation/create-testNew_automation-expected.md

@@ -13,7 +13,7 @@
 * Start: 2020-05-13 18:30:32.11-06:00 +01:00
 * End: 2079-06-06 21:00:00-06:00 +01:00
 * Timezone: W. Europe Standard Time
-* Recurrance: every 5 minutes until end date
+* Recurrence: every 5 minutes until end date
 
 **Notifications:** _none_
 

package/test/resources/9999999/automation/retrieve-testExisting_automation-expected.md

@@ -13,7 +13,7 @@
 * Start: 2022-07-30 00:00:00 +01:00
 * End: 2022-07-30 00:00:00 +01:00
 * Timezone: W. Europe Standard Time
-* Recurrance: run only once
+* Recurrence: run only once
 
 **Notifications:**
 

package/test/resources/9999999/automation/update-testExisting_automation-expected.md

@@ -13,7 +13,7 @@
 * Start: 2022-07-30 00:00:00 +01:00
 * End: 2022-07-30 00:00:00 +01:00
 * Timezone: W. Europe Standard Time
-* Recurrance: run only once
+* Recurrence: run only once
 
 **Notifications:**
 

package/test/resources/9999999/triggeredSendSummary/get-expected.json

@@ -0,0 +1,24 @@
+{
+    "CustomerKey": "testExisting_triggeredSend",
+    "Sent": 10,
+    "NotSentDueToOptOut": 0,
+    "NotSentDueToUndeliverable": 0,
+    "Bounces": 0,
+    "Opens": 0,
+    "Clicks": 0,
+    "UniqueOpens": 0,
+    "UniqueClicks": 0,
+    "OptOuts": 0,
+    "SurveyResponses": 0,
+    "FTAFRequests": 0,
+    "FTAFEmailsSent": 0,
+    "FTAFOptIns": 0,
+    "Conversions": 0,
+    "UniqueConversions": 0,
+    "InProcess": 0,
+    "NotSentDueToError": 0,
+    "Queued": 0,
+    "r__folder_Path": "Triggered Sends",
+    "r__triggeredSend_name": "testExisting_triggeredSend",
+    "r__triggeredSend_key": "testExisting_triggeredSend"
+}

package/test/resources/9999999/triggeredSendSummary/retrieve-response.xml

@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+    xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"
+    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
+    xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
+    <soap:Header>
+        <wsa:Action>RetrieveResponse</wsa:Action>
+        <wsa:MessageID>urn:uuid:8fe86c01-56d5-4c56-8ac2-991578c79485</wsa:MessageID>
+        <wsa:RelatesTo>urn:uuid:592f71ac-78a0-45a2-8cfe-37a91fc6cfd5</wsa:RelatesTo>
+        <wsa:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
+        <wsse:Security>
+            <wsu:Timestamp wsu:Id="Timestamp-675af14a-b6a1-44a5-b7e7-4a76c6d18424">
+                <wsu:Created>2023-02-01T10:29:21Z</wsu:Created>
+                <wsu:Expires>2023-02-01T10:34:21Z</wsu:Expires>
+            </wsu:Timestamp>
+        </wsse:Security>
+    </soap:Header>
+    <soap:Body>
+        <RetrieveResponseMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
+            <OverallStatus>OK</OverallStatus>
+            <RequestID>a90dda5e-aeba-440a-82ce-74fb2abf5eb2</RequestID>
+            <Results xsi:type="TriggeredSendSummary">
+                <PartnerKey xsi:nil="true" />
+                <ObjectID>b3150cf0-6e78-e811-80d4-1402ec721c9d</ObjectID>
+                <CustomerKey>testExisting_triggeredSend</CustomerKey>
+                <Sent>10</Sent>
+                <NotSentDueToOptOut>0</NotSentDueToOptOut>
+                <NotSentDueToUndeliverable>0</NotSentDueToUndeliverable>
+                <Bounces>0</Bounces>
+                <Opens>0</Opens>
+                <Clicks>0</Clicks>
+                <UniqueOpens>0</UniqueOpens>
+                <UniqueClicks>0</UniqueClicks>
+                <OptOuts>0</OptOuts>
+                <SurveyResponses>0</SurveyResponses>
+                <FTAFRequests>0</FTAFRequests>
+                <FTAFEmailsSent>0</FTAFEmailsSent>
+                <FTAFOptIns>0</FTAFOptIns>
+                <Conversions>0</Conversions>
+                <UniqueConversions>0</UniqueConversions>
+                <InProcess>0</InProcess>
+                <NotSentDueToError>0</NotSentDueToError>
+                <Queued>0</Queued>
+            </Results>
+        </RetrieveResponseMsg>
+    </soap:Body>
+</soap:Envelope>

package/test/type.dataExtension.test.js

@@ -91,6 +91,47 @@ describe('type: dataExtension', () => {
             );
             return;
         });
+
+        it('Should not fail if shared dataExtension cannot be retrieved', async () => {
+            // WHEN
+            await handler.retrieve('testInstance/_ParentBU_', ['dataExtension', 'query']);
+            // THEN
+            assert.equal(process.exitCode, 0, 'retrieve should not have thrown an error');
+            // get results from cache
+            const result = cache.getCache();
+            assert.equal(
+                result.dataExtension ? Object.keys(result.dataExtension).length : 0,
+                1,
+                'only one dataExtension expected'
+            );
+            assert.deepEqual(
+                await testUtils.getActualJson(
+                    'testExisting_dataExtensionShared',
+                    'dataExtension',
+                    '_ParentBU_'
+                ),
+                await testUtils.getExpectedJson('1111111', 'dataExtension', 'retrieve'),
+
+                'returned metadata was not equal expected'
+            );
+            // check if MD file was created and equals expectations
+            expect(
+                await testUtils.getActualDoc(
+                    'testExisting_dataExtensionShared',
+                    'dataExtension',
+                    '_ParentBU_'
+                )
+            ).to.equal(
+                await testUtils.getExpectedFile('1111111', 'dataExtension', 'retrieve', 'md')
+            );
+
+            assert.equal(
+                testUtils.getAPIHistoryLength(),
+                7,
+                'Unexpected number of requests made. Run testUtils.logAPIHistoryDebug() to see the requests'
+            );
+            return;
+        });
     });
 
     describe('Deploy ================', () => {

package/test/type.journey.test.js

@@ -1132,13 +1132,19 @@ describe('type: journey', () => {
         it('Should not validate a transactional journey by key', async () => {
             handler.setOptions({ skipStatusCheck: true });
             // WHEN
-            await handler.validate(
+            const validate = await handler.validate(
                 'testInstance/testBU',
                 ['journey'],
                 ['testExisting_temail_notPublished']
             );
             // THEN
-            assert.equal(process.exitCode, 1, 'validate should not have thrown an error');
+            assert.equal(process.exitCode, 0, 'validate should not have thrown an error');
+            // retrieve result
+            assert.deepEqual(
+                validate['testInstance/testBU']?.journey,
+                [],
+                'should not have validated any journey'
+            );
 
             assert.equal(
                 testUtils.getAPIHistoryLength(),
@@ -1148,6 +1154,35 @@ describe('type: journey', () => {
             return;
         });
 
+        it('Should validate a multi-step journey but not the transactional journey by key', async () => {
+            await testUtils.copyFile(
+                'interaction/v1/interactions/validateStatus/45f06c0a-3ed2-48b2-a6a8-b5119253f01c/get-response-success.json',
+                'interaction/v1/interactions/validateStatus/45f06c0a-3ed2-48b2-a6a8-b5119253f01c/get-response.json'
+            );
+            handler.setOptions({ skipStatusCheck: true });
+            // WHEN
+            const validate = await handler.validate(
+                'testInstance/testBU',
+                ['journey'],
+                ['testExisting_temail_notPublished', 'testExisting_journey_Multistep']
+            );
+            // THEN
+            assert.equal(process.exitCode, 0, 'validate should not have thrown an error');
+            // retrieve result
+            assert.deepEqual(
+                validate['testInstance/testBU']?.journey,
+                ['testExisting_journey_Multistep'],
+                'should not have validated any journey'
+            );
+
+            assert.equal(
+                testUtils.getAPIHistoryLength(),
+                3,
+                'Unexpected number of requests made. Run testUtils.logAPIHistoryDebug() to see the requests'
+            );
+            return;
+        });
+
         it('Should validate a journey by id but w/o version (auto-picks latest version)', async () => {
             await testUtils.copyFile(
                 'interaction/v1/interactions/validateStatus/45f06c0a-3ed2-48b2-a6a8-b5119253f01c/get-response-success.json',

package/test/type.triggeredSendSummary.test.js

@@ -0,0 +1,45 @@
+import * as chai from 'chai';
+const assert = chai.assert;
+
+import chaiFiles from 'chai-files';
+import cache from '../lib/util/cache.js';
+import * as testUtils from './utils.js';
+import handler from '../lib/index.js';
+chai.use(chaiFiles);
+
+describe('type: triggeredSendSummary', () => {
+    beforeEach(() => {
+        testUtils.mockSetup();
+    });
+
+    afterEach(() => {
+        testUtils.mockReset();
+    });
+
+    describe('Retrieve ================', () => {
+        it('Should retrieve a triggeredSendSummary', async () => {
+            // WHEN
+            await handler.retrieve('testInstance/testBU', ['triggeredSendSummary']);
+            // THEN
+            assert.equal(process.exitCode, 0, 'retrieve should not have thrown an error');
+            // get results from cache
+            const result = cache.getCache();
+            assert.equal(
+                result.triggeredSendSummary ? Object.keys(result.triggeredSendSummary).length : 0,
+                1,
+                'only 1 triggeredSendSummary expected'
+            );
+            assert.deepEqual(
+                await testUtils.getActualJson('testExisting_triggeredSend', 'triggeredSendSummary'),
+                await testUtils.getExpectedJson('9999999', 'triggeredSendSummary', 'get'),
+                'returned JSON was not equal expected'
+            );
+            assert.equal(
+                testUtils.getAPIHistoryLength(),
+                3,
+                'Unexpected number of requests made. Run testUtils.logAPIHistoryDebug() to see the requests'
+            );
+            return;
+        });
+    });
+});