sf-browserforce 1.0.0

package/lib/plugins/history-tracking/index.e2e-spec.js

@@ -0,0 +1,128 @@
+import assert from 'assert';
+import * as child from 'child_process';
+import { fileURLToPath } from 'node:url';
+import * as path from 'path';
+import { HistoryTracking } from './index.js';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+describe(HistoryTracking.name, function () {
+    let plugin;
+    before(() => {
+        plugin = new HistoryTracking(global.browserforce);
+    });
+    const enableHistoryTracking = [
+        {
+            objectApiName: 'Account',
+            enableHistoryTracking: true,
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'PersonBirthdate',
+                    enableHistoryTracking: true,
+                },
+                {
+                    fieldApiName: 'Test__pc',
+                    enableHistoryTracking: true,
+                },
+            ],
+        },
+        {
+            objectApiName: 'Opportunity',
+            enableHistoryTracking: true,
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'Type',
+                    enableHistoryTracking: true,
+                },
+            ],
+        },
+        {
+            objectApiName: 'Test__c',
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'Owner',
+                    enableHistoryTracking: true,
+                },
+                {
+                    fieldApiName: 'Test__c',
+                    enableHistoryTracking: true,
+                },
+            ],
+        },
+        {
+            objectApiName: 'Task',
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'Test__c',
+                    enableHistoryTracking: true,
+                },
+            ],
+        },
+    ];
+    const disableHistoryTracking = [
+        {
+            objectApiName: 'Account',
+            enableHistoryTracking: true,
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'PersonBirthdate',
+                    enableHistoryTracking: false,
+                },
+                {
+                    fieldApiName: 'Test__pc',
+                    enableHistoryTracking: true,
+                },
+            ],
+        },
+        {
+            objectApiName: 'Opportunity',
+            enableHistoryTracking: false,
+        },
+        {
+            objectApiName: 'Test__c',
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'Owner',
+                    enableHistoryTracking: true,
+                },
+                {
+                    fieldApiName: 'Test__c',
+                    enableHistoryTracking: false,
+                },
+            ],
+        },
+        {
+            objectApiName: 'Task',
+            fieldHistoryTracking: [
+                {
+                    fieldApiName: 'Test__c',
+                    enableHistoryTracking: false,
+                },
+            ],
+        },
+    ];
+    it('should create custom object and fields as a prerequisite', () => {
+        const sourceDeployCmd = child.spawnSync('sf', [
+            'project',
+            'deploy',
+            'start',
+            '-d',
+            path.join(__dirname, 'sfdx-source'),
+            '--json',
+        ]);
+        assert.deepStrictEqual(sourceDeployCmd.status, 0, sourceDeployCmd.output.toString());
+    });
+    it('should enable history tracking for objects and fields', async () => {
+        await plugin.run(enableHistoryTracking);
+        const res = await plugin.retrieve(enableHistoryTracking);
+        assert.deepStrictEqual(res, enableHistoryTracking);
+    });
+    it('should disable history tracking for objects and fields', async () => {
+        await plugin.run(disableHistoryTracking);
+        const res = await plugin.retrieve(disableHistoryTracking);
+        assert.deepStrictEqual(res, disableHistoryTracking);
+    });
+    it('should remove the CustomObject and field', async () => {
+        await global.browserforce.connection.metadata.delete('CustomObject', ['Test__c']);
+        await global.browserforce.connection.metadata.delete('CustomField', ['Contact.Test__c']);
+    });
+});
+//# sourceMappingURL=index.e2e-spec.js.map

package/lib/plugins/history-tracking/index.e2e-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.e2e-spec.js","sourceRoot":"","sources":["../../../src/plugins/history-tracking/index.e2e-spec.ts"],"names":[],"mappings":"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"}

package/lib/plugins/history-tracking/index.js

@@ -0,0 +1,272 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { waitForPageErrors } from '../../browserforce.js';
+import { BrowserforcePlugin } from '../../plugin.js';
+const BASE_PATH = `/ui/setup/layout/FieldHistoryTracking?pEntity={APINAME}&retURL=${encodeURIComponent('/setup/forcecomHomepage.apexp')}`;
+const ENABLE_HISTORY_SELECTOR = 'input[type="checkbox"][id="enable"]';
+const ENABLE_FIELD_HISTORY_SELECTOR = 'input[id="{APINAME}_fht"]';
+const SAVE_BUTTON_SELECTOR = 'input[type="submit"][name="save"]';
+const UNSUPPORTED_HISTORY_TRACKING_OBJECTS = new Set(['Task']);
+export class HistoryTracking extends BrowserforcePlugin {
+    async retrieve(definition) {
+        const historyTrackingConfigs = [];
+        // We first need to retrieve the corresponding CustomField.TableOrEnumId for all objects
+        // This is in case we have field tracking configured for custom fields
+        const tableEnumOrIdByObjectApiName = await this.getTableEnumOrIdByObjectApiName(definition);
+        // Now we can iterate over all history tracking configurations in the definition
+        for (const historyTrackingConfig of definition) {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const historyTrackingResult = { ...historyTrackingConfig };
+                // Open the object history tracking setup page
+                const page = __addDisposableResource(env_1, await this.browserforce.openPage(BASE_PATH.replace('{APINAME}', tableEnumOrIdByObjectApiName.get(historyTrackingConfig.objectApiName))), true);
+                // Retrieve the object history tracking
+                // If this is a custom object, this checkbox does not exist, so skip
+                if (!historyTrackingConfig.objectApiName.includes('__c') &&
+                    !UNSUPPORTED_HISTORY_TRACKING_OBJECTS.has(historyTrackingConfig.objectApiName)) {
+                    historyTrackingResult.enableHistoryTracking = await page.locator(ENABLE_HISTORY_SELECTOR).isChecked();
+                }
+                // If we have no field history tracking, there is nothing more to do
+                if (!historyTrackingConfig.fieldHistoryTracking) {
+                    historyTrackingConfigs.push(historyTrackingResult);
+                    continue;
+                }
+                const fieldHistoryTrackingConfigs = [];
+                // If the object history tracking is false, then we already know all field history tracking is false
+                // Only so long as this is a standard object
+                if (!historyTrackingResult.enableHistoryTracking &&
+                    !historyTrackingConfig.objectApiName.includes('__c') &&
+                    !UNSUPPORTED_HISTORY_TRACKING_OBJECTS.has(historyTrackingConfig.objectApiName)) {
+                    for (const fieldHistoryTracking of historyTrackingConfig.fieldHistoryTracking) {
+                        fieldHistoryTrackingConfigs.push({
+                            ...fieldHistoryTracking,
+                            enableHistoryTracking: false,
+                        });
+                    }
+                    historyTrackingResult.fieldHistoryTracking = fieldHistoryTrackingConfigs;
+                    historyTrackingConfigs.push(historyTrackingResult);
+                    continue;
+                }
+                // We need to determine the correct html selector for each field that is configured
+                // This is because custom fields are identified using their CustomField.Id value
+                const fieldSelectorByFieldApiName = await this.getFieldSelectorByFieldApiName(tableEnumOrIdByObjectApiName.get(historyTrackingConfig.objectApiName), historyTrackingConfig.fieldHistoryTracking);
+                // We can now retrieve the field history settings for the fields specified for the object
+                for (const fieldHistoryTracking of historyTrackingConfig.fieldHistoryTracking) {
+                    const fieldHistoryTrackingResult = { ...fieldHistoryTracking };
+                    const fieldApiName = fieldSelectorByFieldApiName.get(fieldHistoryTracking.fieldApiName);
+                    fieldHistoryTrackingResult.enableHistoryTracking = await page
+                        .locator(ENABLE_FIELD_HISTORY_SELECTOR.replace('{APINAME}', fieldApiName))
+                        .isChecked();
+                    fieldHistoryTrackingConfigs.push(fieldHistoryTrackingResult);
+                }
+                historyTrackingResult.fieldHistoryTracking = fieldHistoryTrackingConfigs;
+                historyTrackingConfigs.push(historyTrackingResult);
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                const result_1 = __disposeResources(env_1);
+                if (result_1)
+                    await result_1;
+            }
+        }
+        return historyTrackingConfigs;
+    }
+    async apply(plan) {
+        // We first need to retrieve the corresponding CustomField.TableOrEnumId for all objects
+        // This is in case we are configuring field tracking for custom fields
+        const tableEnumOrIdByObjectApiName = await this.getTableEnumOrIdByObjectApiName(plan);
+        // Now we can iterate over all history tracking configurations in the plan
+        for (const historyTrackingConfig of plan) {
+            const env_2 = { stack: [], error: void 0, hasError: false };
+            try {
+                // Open the object history tracking setup page
+                const page = __addDisposableResource(env_2, await this.browserforce.openPage(BASE_PATH.replace('{APINAME}', tableEnumOrIdByObjectApiName.get(historyTrackingConfig.objectApiName))), true);
+                // Retrieve the object history tracking
+                // If this is a custom object, this checkbox does not exist, so skip
+                if (!historyTrackingConfig.objectApiName.includes('__c') &&
+                    !UNSUPPORTED_HISTORY_TRACKING_OBJECTS.has(historyTrackingConfig.objectApiName)) {
+                    const historyTrackingEnabled = await page.locator(ENABLE_HISTORY_SELECTOR).isChecked();
+                    if (historyTrackingConfig.enableHistoryTracking !== historyTrackingEnabled) {
+                        // Click the checkbox
+                        await page.locator(ENABLE_HISTORY_SELECTOR).click();
+                    }
+                }
+                if (historyTrackingConfig.fieldHistoryTracking) {
+                    // We need to determine the correct html selector for each field that is configured
+                    // This is because custom fields are identified using their CustomField.Id value
+                    const fieldSelectorByFieldApiName = await this.getFieldSelectorByFieldApiName(tableEnumOrIdByObjectApiName.get(historyTrackingConfig.objectApiName), historyTrackingConfig.fieldHistoryTracking);
+                    // We can now retrieve the field history settings for the fields specified for the object
+                    for (const fieldHistoryTracking of historyTrackingConfig.fieldHistoryTracking) {
+                        const fieldApiName = fieldSelectorByFieldApiName.get(fieldHistoryTracking.fieldApiName);
+                        const fieldSelector = ENABLE_FIELD_HISTORY_SELECTOR.replace('{APINAME}', fieldApiName);
+                        const fieldHistoryTrackingEnabled = await page.locator(fieldSelector).isChecked();
+                        if (fieldHistoryTracking.enableHistoryTracking !== fieldHistoryTrackingEnabled) {
+                            // Click the checkbox
+                            await page.locator(fieldSelector).click();
+                        }
+                    }
+                }
+                // Save the settings
+                await page
+                    .locator(SAVE_BUTTON_SELECTOR)
+                    .filter({ visible: true }) // there are three save buttons [not visible, top row, bottom row]
+                    .first()
+                    .click();
+                await Promise.race([
+                    page.waitForURL((url) => url.pathname.startsWith('/setup/forcecomHomepage.apexp')),
+                    waitForPageErrors(page),
+                ]);
+            }
+            catch (e_2) {
+                env_2.error = e_2;
+                env_2.hasError = true;
+            }
+            finally {
+                const result_2 = __disposeResources(env_2);
+                if (result_2)
+                    await result_2;
+            }
+        }
+    }
+    async queryCustomFieldsAndPopulateMap(fieldApiNameTuples, tableEnumOrId, suffix, fieldSelectorByFieldApiName) {
+        const developerNameConditions = fieldApiNameTuples.map(([apiname, namespace]) => namespace
+            ? `(DeveloperName ='${apiname}' AND NamespacePrefix ='${namespace}')`
+            : `(DeveloperName = '${apiname}')`);
+        const customFieldsQuery = await this.browserforce.connection.tooling.query(`SELECT Id, DeveloperName, NamespacePrefix FROM CustomField WHERE (${developerNameConditions.join(' OR ')}) AND TableEnumOrId = '${tableEnumOrId}' ORDER By CreatedDate ASC`);
+        for (const customField of customFieldsQuery.records) {
+            const fieldApiName = `${customField.NamespacePrefix ? `${customField.NamespacePrefix}__` : ''}${customField.DeveloperName}${suffix}`;
+            fieldSelectorByFieldApiName.set(fieldApiName, customField.Id.substring(0, 15));
+        }
+    }
+    parseNamespacedFieldApiName(fieldApiName, suffix) {
+        const fieldNameWithoutSuffix = fieldApiName.replace(suffix, '');
+        const parts = fieldNameWithoutSuffix.split('__');
+        const namespace = parts.length > 1 ? parts[0] : undefined;
+        const apiname = parts.length > 1 ? parts.slice(1).join('__') : parts[0];
+        return [apiname, namespace];
+    }
+    async getFieldSelectorByFieldApiName(tableEnumOrId, fieldHistoryTrackingConfigs) {
+        const fieldSelectorByFieldApiName = new Map();
+        const customFieldApiNames = [];
+        const personAccountFieldApiNames = [];
+        const activityFieldApiNames = [];
+        for (const fieldHistoryTrackingConfig of fieldHistoryTrackingConfigs) {
+            // If this is a person account field, we must do special handling for this
+            if (tableEnumOrId === 'Account' && fieldHistoryTrackingConfig.fieldApiName.includes('__pc')) {
+                personAccountFieldApiNames.push(this.parseNamespacedFieldApiName(fieldHistoryTrackingConfig.fieldApiName, '__pc'));
+                continue;
+            }
+            // If this is a Task field, we must do special handling for this
+            if (tableEnumOrId === 'Task' && fieldHistoryTrackingConfig.fieldApiName.includes('__c')) {
+                activityFieldApiNames.push(this.parseNamespacedFieldApiName(fieldHistoryTrackingConfig.fieldApiName, '__c'));
+                continue;
+            }
+            // If this is a custom field, we must query for the Field Id
+            if (fieldHistoryTrackingConfig.fieldApiName.includes('__c')) {
+                customFieldApiNames.push(this.parseNamespacedFieldApiName(fieldHistoryTrackingConfig.fieldApiName, '__c'));
+                continue;
+            }
+            // Otherwise, if this is a standard field, the Selector is the Field API Name
+            fieldSelectorByFieldApiName.set(fieldHistoryTrackingConfig.fieldApiName, fieldHistoryTrackingConfig.fieldApiName);
+        }
+        if (customFieldApiNames.length === 0 &&
+            personAccountFieldApiNames.length === 0 &&
+            activityFieldApiNames.length === 0) {
+            return fieldSelectorByFieldApiName;
+        }
+        if (personAccountFieldApiNames.length > 0) {
+            // NOTE: Unfortunately this includes deleted records
+            // WORKAROUND: ORDER BY CreatedDate
+            await this.queryCustomFieldsAndPopulateMap(personAccountFieldApiNames, 'Contact', '__pc', fieldSelectorByFieldApiName);
+        }
+        if (customFieldApiNames.length > 0) {
+            // NOTE: Unfortunately this includes deleted records
+            // WORKAROUND: ORDER BY CreatedDate
+            await this.queryCustomFieldsAndPopulateMap(customFieldApiNames, tableEnumOrId, '__c', fieldSelectorByFieldApiName);
+        }
+        if (activityFieldApiNames.length > 0) {
+            await this.queryCustomFieldsAndPopulateMap(activityFieldApiNames, 'Activity', '__c', fieldSelectorByFieldApiName);
+        }
+        return fieldSelectorByFieldApiName;
+    }
+    async getTableEnumOrIdByObjectApiName(historyTrackingConfigs) {
+        const tableEnumOrIdByObjectApiName = new Map();
+        const customObjectApiNames = [];
+        for (const historyTrackingConfig of historyTrackingConfigs) {
+            // If it is a custom object, the CustomField.TableEnumOrId is the Object Id
+            if (historyTrackingConfig.objectApiName.includes('__c')) {
+                customObjectApiNames.push(this.parseNamespacedFieldApiName(historyTrackingConfig.objectApiName, '__c'));
+                continue;
+            }
+            // Otherwise, if this is a standard object, the CustomField.TableEnumOrId is the Object API Name
+            tableEnumOrIdByObjectApiName.set(historyTrackingConfig.objectApiName, historyTrackingConfig.objectApiName);
+        }
+        if (customObjectApiNames.length === 0) {
+            return tableEnumOrIdByObjectApiName;
+        }
+        // NOTE: Unfortunately this includes deleted records
+        // WORKAROUND: ORDER BY CreatedDate
+        const customObjectDeveloperNames = customObjectApiNames.map(([apiname, namespace]) => namespace
+            ? `(DeveloperName = '${apiname}' AND NamespacePrefix = '${namespace}')`
+            : `(DeveloperName = '${apiname}')`);
+        const customObjectsQuery = await this.browserforce.connection.tooling.query(`SELECT Id, DeveloperName FROM CustomObject WHERE (${customObjectDeveloperNames.join(' OR ')}) ORDER BY CreatedDate ASC`);
+        for (const customObject of customObjectsQuery.records) {
+            tableEnumOrIdByObjectApiName.set(`${customObject.DeveloperName}__c`, customObject.Id);
+        }
+        return tableEnumOrIdByObjectApiName;
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/history-tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/history-tracking/index.ts"],"names":[],"mappings":"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"}

package/lib/plugins/home-page-layouts/index.d.ts

@@ -0,0 +1,14 @@
+import { BrowserforcePlugin } from '../../plugin.js';
+type Config = {
+    homePageLayoutAssignments: HomePageLayoutAssignment[];
+};
+type HomePageLayoutAssignment = {
+    profile: string;
+    layout: string;
+};
+export declare class HomePageLayouts extends BrowserforcePlugin {
+    retrieve(): Promise<Config>;
+    diff(source: Config, target: Config): Config | undefined;
+    apply(config: Config): Promise<void>;
+}
+export {};

package/lib/plugins/home-page-layouts/index.e2e-spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/plugins/home-page-layouts/index.e2e-spec.js

@@ -0,0 +1,47 @@
+import assert from 'assert';
+import { HomePageLayouts } from './index.js';
+describe(HomePageLayouts.name, function () {
+    let plugin;
+    before(() => {
+        plugin = new HomePageLayouts(global.browserforce);
+    });
+    const configPageDefault = {
+        homePageLayoutAssignments: [
+            {
+                profile: 'Standard User',
+                layout: '',
+            },
+            {
+                profile: 'System Administrator',
+                layout: '',
+            },
+        ],
+    };
+    const configOrgDefault = {
+        homePageLayoutAssignments: [
+            {
+                profile: 'Standard User',
+                layout: 'DE Default',
+            },
+            {
+                profile: 'System Administrator',
+                layout: 'DE Default',
+            },
+        ],
+    };
+    it('should assign some layouts', async () => {
+        await plugin.run(configPageDefault);
+    });
+    it('should be assigned', async () => {
+        const res = await plugin.run(configPageDefault);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should unassign some layouts', async () => {
+        await plugin.apply(configOrgDefault);
+    });
+    it('should be unassigned', async () => {
+        const res = await plugin.run(configOrgDefault);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+});
+//# sourceMappingURL=index.e2e-spec.js.map

package/lib/plugins/home-page-layouts/index.e2e-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.e2e-spec.js","sourceRoot":"","sources":["../../../src/plugins/home-page-layouts/index.e2e-spec.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE;IAC7B,IAAI,MAAuB,CAAC;IAC5B,MAAM,CAAC,GAAG,EAAE;QACV,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG;QACxB,yBAAyB,EAAE;YACzB;gBACE,OAAO,EAAE,eAAe;gBACxB,MAAM,EAAE,EAAE;aACX;YACD;gBACE,OAAO,EAAE,sBAAsB;gBAC/B,MAAM,EAAE,EAAE;aACX;SACF;KACF,CAAC;IACF,MAAM,gBAAgB,GAAG;QACvB,yBAAyB,EAAE;YACzB;gBACE,OAAO,EAAE,eAAe;gBACxB,MAAM,EAAE,YAAY;aACrB;YACD;gBACE,OAAO,EAAE,sBAAsB;gBAC/B,MAAM,EAAE,YAAY;aACrB;SACF;KACF,CAAC;IACF,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAChD,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QACpC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC/C,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/plugins/home-page-layouts/index.js

@@ -0,0 +1,145 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { waitForPageErrors } from '../../browserforce.js';
+import { BrowserforcePlugin } from '../../plugin.js';
+const BASE_PATH = `/setup/ui/assignhomelayoutedit.jsp?retURL=${encodeURIComponent('/setup/forcecomHomepage.apexp')}`;
+const BASE_SELECTOR = 'table.detailList';
+const SAVE_BUTTON_SELECTOR = 'input[name="save"]';
+export class HomePageLayouts extends BrowserforcePlugin {
+    async retrieve() {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            const page = __addDisposableResource(env_1, await this.browserforce.openPage(BASE_PATH), true);
+            await page.locator(BASE_SELECTOR).waitFor();
+            const profiles = (await page.locator('table.detailList tbody tr td label').allTextContents()).map((label) => label.replace(/^\*/, '')); // removing * from assistiveText
+            const layouts = (await page.locator('table.detailList tbody tr td select option:checked').allTextContents()).map((layout) => (layout === 'Home Page Default' ? '' : layout)); // value is "default" instead of an id
+            const homePageLayoutAssignments = profiles.map((profile, i) => ({
+                profile,
+                layout: layouts[i],
+            }));
+            return {
+                homePageLayoutAssignments,
+            };
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            const result_1 = __disposeResources(env_1);
+            if (result_1)
+                await result_1;
+        }
+    }
+    diff(source, target) {
+        target.homePageLayoutAssignments.sort(compareAssignment);
+        const profileNames = target.homePageLayoutAssignments.map((assignment) => assignment.profile);
+        source.homePageLayoutAssignments = source.homePageLayoutAssignments
+            .filter((assignment) => profileNames.includes(assignment.profile))
+            .sort(compareAssignment);
+        return super.diff(source, target);
+    }
+    async apply(config) {
+        const env_2 = { stack: [], error: void 0, hasError: false };
+        try {
+            const profilesList = config.homePageLayoutAssignments
+                .map((assignment) => {
+                return `'${assignment.profile}'`;
+            })
+                .join(',');
+            const layoutsList = config.homePageLayoutAssignments
+                .map((assignment) => {
+                return `'${assignment.layout}'`;
+            })
+                .join(',');
+            const profiles = await this.browserforce.connection.tooling.query(`SELECT Id, Name FROM Profile WHERE Name IN (${profilesList})`);
+            const homePageLayouts = await this.browserforce.connection.tooling.query(`SELECT Id, Name FROM HomePageLayout WHERE Name IN (${layoutsList})`);
+            const page = __addDisposableResource(env_2, await this.browserforce.openPage(BASE_PATH), true);
+            await page.locator(BASE_SELECTOR).waitFor();
+            for (const assignment of config.homePageLayoutAssignments) {
+                const homePageLayoutName = assignment.layout;
+                const profile = profiles.records.find((p) => p.Name === assignment.profile);
+                if (!profile) {
+                    throw new Error(`could not find profile '${assignment.profile}'`);
+                }
+                let homePageLayout = homePageLayouts.records.find((l) => l.Name === homePageLayoutName);
+                if (homePageLayoutName === '') {
+                    homePageLayout = { Id: 'default', Name: 'default' };
+                }
+                if (homePageLayout === undefined) {
+                    throw new Error(`Could not find home page layout "${homePageLayoutName}" in list of home page layouts: ${homePageLayouts.records.map((l) => l.Name)}`);
+                }
+                const profileSelector = `select[id='${profile.Id.substring(0, 15)}']`;
+                await page.locator(profileSelector).selectOption(homePageLayout.Id.substring(0, 15));
+            }
+            await page.locator(SAVE_BUTTON_SELECTOR).first().click();
+            await Promise.race([
+                page.waitForURL((url) => url.pathname === '/setup/forcecomHomepage.apexp'),
+                waitForPageErrors(page),
+            ]);
+        }
+        catch (e_2) {
+            env_2.error = e_2;
+            env_2.hasError = true;
+        }
+        finally {
+            const result_2 = __disposeResources(env_2);
+            if (result_2)
+                await result_2;
+        }
+    }
+}
+function compareAssignment(a, b) {
+    return `${a.profile}:${a.layout}`.localeCompare(`${b.profile}:${b.layout}`, 'en', { numeric: true });
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/home-page-layouts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/home-page-layouts/index.ts"],"names":[],"mappings":"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"}

package/lib/plugins/home-page-layouts/index.test.d.ts

@@ -0,0 +1 @@
+export {};