sfdx-browserforce-plugin 5.1.1 → 5.1.3

package/lib/plugins/slack/index.e2e-spec.js

@@ -0,0 +1,47 @@
+import assert from 'assert';
+import { Slack } from './index.js';
+describe.skip(Slack.name, function () {
+    let plugin;
+    before(() => {
+        plugin = new Slack(global.bf);
+    });
+    const configEnable = {
+        agreeToTermsAndConditions: true,
+        enableSalesCloudForSlack: true,
+    };
+    const configDisabledSalesCloud = {
+        agreeToTermsAndConditions: true,
+        enableSalesCloudForSlack: false,
+    };
+    const configDisabled = {
+        agreeToTermsAndConditions: false,
+        enableSalesCloudForSlack: false,
+    };
+    it('should accept terms and conditions and enable Sales Cloud for Slack', async () => {
+        await plugin.run(configEnable);
+    });
+    it('should already be accepted and enabled', async () => {
+        const res = await plugin.run(configEnable);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should disable Sales Cloud for Slack', async () => {
+        await plugin.run(configDisabledSalesCloud);
+    });
+    it('should already be disabled', async () => {
+        const res = await plugin.run(configDisabledSalesCloud);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should fail to unaccept terms and conditions', async () => {
+        let err;
+        try {
+            await plugin.apply(configDisabled);
+        }
+        catch (e) {
+            err = e;
+        }
+        assert.throws(() => {
+            throw err;
+        }, /cannot be unaccepted/);
+    });
+});
+//# sourceMappingURL=index.e2e-spec.js.map

package/lib/plugins/slack/index.e2e-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.e2e-spec.js","sourceRoot":"","sources":["../../../src/plugins/slack/index.e2e-spec.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAe,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;IACxB,IAAI,MAAa,CAAC;IAClB,MAAM,CAAC,GAAG,EAAE;QACV,MAAM,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAW;QAC3B,yBAAyB,EAAE,IAAI;QAC/B,wBAAwB,EAAE,IAAI;KAC/B,CAAC;IACF,MAAM,wBAAwB,GAAW;QACvC,yBAAyB,EAAE,IAAI;QAC/B,wBAAwB,EAAE,KAAK;KAChC,CAAC;IACF,MAAM,cAAc,GAAW;QAC7B,yBAAyB,EAAE,KAAK;QAChC,wBAAwB,EAAE,KAAK;KAChC,CAAC;IACF,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACvD,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,GAAG,CAAC,CAAC;QACV,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;YACjB,MAAM,GAAG,CAAC;QACZ,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/plugins/slack/index.js

@@ -0,0 +1,47 @@
+import { BrowserforcePlugin } from '../../plugin.js';
+const BASE_PATH = 'lightning/setup/SlackSetupAssistant/home';
+const TOS_CHECKBOX = 'setup_service-slack-agree-to-terms input[type="checkbox"]';
+const SALES_CLOUD_FOR_SLACK_CHECKBOX = 'input[type="checkbox"][name="SlkSetupStepSalesCloudForSlack"]';
+const TOAST_MESSAGE = 'div[id^="toastDescription"]';
+export class Slack extends BrowserforcePlugin {
+    async retrieve(definition) {
+        const page = await this.browserforce.openPage(BASE_PATH);
+        const response = {
+            agreeToTermsAndConditions: await page
+                .locator(TOS_CHECKBOX)
+                .map((checkbox) => checkbox.checked)
+                .wait(),
+            enableSalesCloudForSlack: await page
+                .locator(SALES_CLOUD_FOR_SLACK_CHECKBOX)
+                .map((checkbox) => checkbox.checked)
+                .wait(),
+        };
+        await page.close();
+        return response;
+    }
+    async apply(config) {
+        if (config.agreeToTermsAndConditions === false) {
+            throw new Error('terms and conditions cannot be unaccepted once accepted');
+        }
+        const state = await this.retrieve();
+        const page = await this.browserforce.openPage(BASE_PATH);
+        if (state.agreeToTermsAndConditions !== config.agreeToTermsAndConditions) {
+            await Promise.all([
+                page.locator(TOAST_MESSAGE).wait(),
+                // NOTE: Unfortunately a simple click() on the locator does not work here
+                (await page.locator(TOS_CHECKBOX).waitHandle()).evaluate((checkbox) => checkbox.click()),
+            ]);
+            await page.waitForSelector(TOAST_MESSAGE, { hidden: true });
+        }
+        if (state.enableSalesCloudForSlack !== config.enableSalesCloudForSlack) {
+            await Promise.all([
+                page.locator(TOAST_MESSAGE).wait(),
+                // NOTE: Unfortunately a simple click() on the locator does not work here
+                (await page.locator(SALES_CLOUD_FOR_SLACK_CHECKBOX).waitHandle()).evaluate((checkbox) => checkbox.click()),
+            ]);
+            await page.waitForSelector(TOAST_MESSAGE, { hidden: true });
+        }
+        await page.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/slack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/slack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,SAAS,GAAG,0CAA0C,CAAC;AAE7D,MAAM,YAAY,GAChB,2DAA2D,CAAC;AAC9D,MAAM,8BAA8B,GAClC,+DAA+D,CAAC;AAClE,MAAM,aAAa,GAAG,6BAA6B,CAAC;AAOpD,MAAM,OAAO,KAAM,SAAQ,kBAAkB;IACpC,KAAK,CAAC,QAAQ,CAAC,UAAmB;QACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG;YACf,yBAAyB,EAAE,MAAM,IAAI;iBAClC,OAAO,CAAC,YAAY,CAAC;iBACrB,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;iBACnC,IAAI,EAAE;YACT,wBAAwB,EAAE,MAAM,IAAI;iBACjC,OAAO,CAAC,8BAA8B,CAAC;iBACvC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;iBACnC,IAAI,EAAE;SACV,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,MAAc;QAC/B,IAAI,MAAM,CAAC,yBAAyB,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,yBAAyB,KAAK,MAAM,CAAC,yBAAyB,EAAE,CAAC;YACzE,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE;gBAClC,yEAAyE;gBACzE,CACE,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAC9C,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;aAC3C,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,KAAK,CAAC,wBAAwB,KAAK,MAAM,CAAC,wBAAwB,EAAE,CAAC;YACvE,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE;gBAClC,yEAAyE;gBACzE,CACE,MAAM,IAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,UAAU,EAAE,CAChE,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;aAC3C,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/lib/plugins/user-access-policies/index.d.ts

@@ -0,0 +1,19 @@
+import { BrowserforcePlugin } from '../../plugin.js';
+export type PolicyTriggerType = 'Create' | 'Update' | 'CreateAndUpdate';
+type AccessPolicy = {
+    apiName: string;
+    active: boolean;
+    on?: PolicyTriggerType;
+};
+export type Config = {
+    accessPolicies?: AccessPolicy[];
+};
+export declare class UserAccessPolicies extends BrowserforcePlugin {
+    private queryPolicies;
+    retrieve(definition?: Config): Promise<Config>;
+    apply(config: Config): Promise<void>;
+    private isValidTriggerType;
+    private needsPolicyChange;
+    private applyPolicyChange;
+}
+export {};

package/lib/plugins/user-access-policies/index.e2e-spec.d.ts

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

package/lib/plugins/user-access-policies/index.e2e-spec.js

@@ -0,0 +1,63 @@
+import assert from 'assert';
+import * as child from 'child_process';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import * as path from 'path';
+import { UserAccessPolicies } from './index.js';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const readJsonFile = function (u) {
+    return JSON.parse(readFileSync(new URL(u, import.meta.url), 'utf8'));
+};
+describe.skip(UserAccessPolicies.name, function () {
+    this.timeout('10m');
+    let plugin;
+    before(() => {
+        plugin = new UserAccessPolicies(global.bf);
+    });
+    const configActivate = readJsonFile('./activate.json').settings.userAccessPolicies;
+    const configDeactivate = readJsonFile('./deactivate.json').settings.userAccessPolicies;
+    const multiConfig = readJsonFile('./multiple-policies.json').settings
+        .userAccessPolicies;
+    const changeTriggerConfig = readJsonFile('./change-trigger-type.json')
+        .settings.userAccessPolicies;
+    it('should deploy a CustomObject for testing', () => {
+        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 activate policy', async () => {
+        await plugin.run(configActivate);
+    });
+    it('should already be activated on default trigger type', async () => {
+        const res = await plugin.run(configActivate);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should deactivate policy', async () => {
+        await plugin.run(configDeactivate);
+    });
+    it('should already be deactivated', async () => {
+        const res = await plugin.run(configDeactivate);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should handle multiple policies', async () => {
+        await plugin.run(multiConfig);
+    });
+    it('should already have activated multiple policies on provided trigger types', async () => {
+        const res = await plugin.run(multiConfig);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should change trigger type of an already active policy', async () => {
+        await plugin.run(changeTriggerConfig);
+    });
+    it('should already be activated with the new trigger type', async () => {
+        const res = await plugin.run(changeTriggerConfig);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+});
+//# sourceMappingURL=index.e2e-spec.js.map

package/lib/plugins/user-access-policies/index.e2e-spec.js.map

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

package/lib/plugins/user-access-policies/index.js

@@ -0,0 +1,107 @@
+import { BrowserforcePlugin } from '../../plugin.js';
+import { UserAccessPoliciesPage } from './page.js';
+const DEFAULT_TRIGGER_TYPE = 'CreateAndUpdate';
+export class UserAccessPolicies extends BrowserforcePlugin {
+    async queryPolicies(policyApiNames) {
+        const quotedNames = policyApiNames.map((name) => `'${name}'`);
+        const query = `SELECT Id, DeveloperName, Status, TriggerType FROM UserAccessPolicy WHERE DeveloperName IN (${quotedNames.join(',')})`;
+        const queryResult = await this.org.getConnection().tooling.query(query);
+        const policyStateMap = new Map();
+        const policyIdMap = new Map();
+        const policyTriggerTypeMap = new Map();
+        for (const record of queryResult.records) {
+            policyStateMap.set(record.DeveloperName, record.Status === 'Active');
+            policyIdMap.set(record.DeveloperName, record.Id);
+            policyTriggerTypeMap.set(record.DeveloperName, record.TriggerType);
+        }
+        return { policyStateMap, policyIdMap, policyTriggerTypeMap };
+    }
+    async retrieve(definition) {
+        const response = {
+            accessPolicies: [],
+        };
+        if (!definition?.accessPolicies || definition.accessPolicies.length === 0) {
+            return response;
+        }
+        const policyApiNames = definition.accessPolicies.map((policy) => policy.apiName);
+        const { policyStateMap, policyTriggerTypeMap } = await this.queryPolicies(policyApiNames);
+        for (const policy of definition.accessPolicies) {
+            const isActive = policyStateMap.get(policy.apiName) ?? false;
+            const triggerType = policyTriggerTypeMap.get(policy.apiName);
+            const retrievedPolicy = {
+                apiName: policy.apiName,
+                active: isActive,
+            };
+            if (policy.on !== undefined && isActive && triggerType) {
+                if (this.isValidTriggerType(triggerType)) {
+                    retrievedPolicy.on = triggerType;
+                }
+            }
+            response.accessPolicies.push(retrievedPolicy);
+        }
+        return response;
+    }
+    async apply(config) {
+        if (!config.accessPolicies || config.accessPolicies.length === 0) {
+            return;
+        }
+        const policyApiNames = config.accessPolicies.map((policy) => policy.apiName);
+        const { policyStateMap, policyIdMap, policyTriggerTypeMap } = await this.queryPolicies(policyApiNames);
+        for (const policy of config.accessPolicies) {
+            const currentState = policyStateMap.get(policy.apiName) ?? false;
+            const policyId = policyIdMap.get(policy.apiName);
+            const currentTriggerType = policyTriggerTypeMap.get(policy.apiName);
+            if (!policyId) {
+                throw new Error(`User Access Policy "${policy.apiName}" not found`);
+            }
+            await this.applyPolicyChange(policy, policyId, currentState, currentTriggerType);
+        }
+    }
+    isValidTriggerType(value) {
+        return (value === 'Create' || value === 'Update' || value === 'CreateAndUpdate');
+    }
+    needsPolicyChange(policy, currentState, currentTriggerType) {
+        if (currentState !== policy.active) {
+            return true;
+        }
+        if (!policy.active) {
+            return false;
+        }
+        if (policy.on && currentTriggerType) {
+            return currentTriggerType !== policy.on;
+        }
+        return false;
+    }
+    async applyPolicyChange(policy, policyId, currentState, currentTriggerType) {
+        const needsChange = this.needsPolicyChange(policy, currentState, currentTriggerType);
+        if (!needsChange) {
+            return;
+        }
+        const page = await this.browserforce.openPage(UserAccessPoliciesPage.getPolicyUrl(policyId));
+        const policiesPage = new UserAccessPoliciesPage(page);
+        if (policy.active) {
+            const needsTriggerTypeChange = currentState && policy.on && currentTriggerType !== policy.on;
+            if (needsTriggerTypeChange) {
+                await policiesPage.deactivatePolicy();
+                await page.close();
+                const newPage = await this.browserforce.openPage(UserAccessPoliciesPage.getPolicyUrl(policyId));
+                const newPoliciesPage = new UserAccessPoliciesPage(newPage);
+                await newPoliciesPage.activatePolicy(policy.on);
+                await newPage.close();
+            }
+            else {
+                const triggerOn = policy.on ||
+                    (this.isValidTriggerType(currentTriggerType)
+                        ? currentTriggerType
+                        : DEFAULT_TRIGGER_TYPE);
+                await policiesPage.activatePolicy(triggerOn);
+                await page.close();
+            }
+        }
+        else {
+            await policiesPage.deactivatePolicy();
+            await page.close();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/user-access-policies/index.js.map

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

package/lib/plugins/user-access-policies/page.d.ts

@@ -0,0 +1,29 @@
+import type { Page } from 'puppeteer';
+export declare class UserAccessPoliciesPage {
+    private page;
+    constructor(page: Page);
+    static getPolicyUrl(policyId: string): string;
+    /**
+     * Activate a policy from its detail page
+     * @param triggerOn - When to trigger the policy: 'Create', 'Update', or 'CreateAndUpdate' (default)
+     */
+    activatePolicy(triggerOn?: 'Create' | 'Update' | 'CreateAndUpdate'): Promise<void>;
+    /**
+     * Deactivate a policy from its detail page
+     */
+    deactivatePolicy(): Promise<void>;
+    /**
+     * Handle the activation modal (select trigger option and click Activate)
+     */
+    private handleActivationModal;
+    /**
+     * Handle confirmation modal that may appear after deactivation
+     */
+    private handleConfirmationModal;
+    /**
+     * Wait for a button to become enabled
+     * @param button - The button element to wait for
+     * @param timeout - Maximum time to wait in milliseconds (default: 10000)
+     */
+    private waitForButtonEnabled;
+}

package/lib/plugins/user-access-policies/page.js

@@ -0,0 +1,140 @@
+import { throwPageErrors } from '../../browserforce.js';
+export class UserAccessPoliciesPage {
+    page;
+    constructor(page) {
+        this.page = page;
+    }
+    static getPolicyUrl(policyId) {
+        return `lightning/setup/UserAccessPolicies/${policyId}/view`;
+    }
+    /**
+     * Activate a policy from its detail page
+     * @param triggerOn - When to trigger the policy: 'Create', 'Update', or 'CreateAndUpdate' (default)
+     */
+    async activatePolicy(triggerOn = 'CreateAndUpdate') {
+        try {
+            const xpath = '//button[contains(., "Automate Policy")]';
+            let automateButton = null;
+            await this.page.waitForSelector(`::-p-xpath(${xpath})`, {
+                timeout: 5000,
+            });
+            const buttons = await this.page.$$(`xpath/.${xpath}`);
+            if (buttons.length > 0) {
+                automateButton = buttons[0];
+            }
+            if (!automateButton) {
+                throw new Error('Automate Policy button not found on page');
+            }
+            await this.waitForButtonEnabled(automateButton);
+            await automateButton.click();
+            await this.handleActivationModal(triggerOn);
+            await throwPageErrors(this.page);
+        }
+        catch (error) {
+            throw new Error(`Failed to activate policy: ${error.message}`);
+        }
+    }
+    /**
+     * Deactivate a policy from its detail page
+     */
+    async deactivatePolicy() {
+        try {
+            const xpath = '//button[contains(., "Deactivate")]';
+            let deactivateButton = null;
+            await this.page.waitForSelector(`::-p-xpath(${xpath})`, {
+                timeout: 5000,
+            });
+            const buttons = await this.page.$$(`xpath/.${xpath}`);
+            if (buttons.length > 0) {
+                deactivateButton = buttons[0];
+            }
+            if (!deactivateButton) {
+                throw new Error('Deactivate button not found on page');
+            }
+            await deactivateButton.click();
+            await this.handleConfirmationModal();
+            await throwPageErrors(this.page);
+        }
+        catch (error) {
+            throw new Error(`Failed to deactivate policy: ${error.message}`);
+        }
+    }
+    /**
+     * Handle the activation modal (select trigger option and click Activate)
+     */
+    async handleActivationModal(triggerOn) {
+        const modalHeaderXpath = '//lightning-modal-header[contains(@class, "automate_policy_modal")]';
+        await this.page.waitForSelector(`::-p-xpath(${modalHeaderXpath})`, {
+            timeout: 10000,
+        });
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        const radioButtons = await this.page.$$('input[type="radio"]');
+        if (radioButtons.length < 3) {
+            throw new Error('Modal did not load - radio buttons not found');
+        }
+        let radioButton = null;
+        for (const button of radioButtons) {
+            const value = await this.page.evaluate((radio) => radio.value, button);
+            if (value === triggerOn) {
+                radioButton = button;
+                break;
+            }
+        }
+        if (!radioButton) {
+            throw new Error(`Radio button with value "${triggerOn}" not found`);
+        }
+        const radioId = await this.page.evaluate((radio) => radio.id, radioButton);
+        if (radioId) {
+            const label = await this.page.$(`label[for="${radioId}"]`);
+            await label.click();
+        }
+        const xpath = '//button[text()="Activate"] | //button[contains(text(), "Activate")]';
+        await this.page.waitForSelector(`::-p-xpath(${xpath})`, { timeout: 5000 });
+        const buttons = await this.page.$$(`xpath/.${xpath}`);
+        if (buttons.length === 0) {
+            throw new Error('Activate button not found in modal');
+        }
+        await buttons[0].click();
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+    /**
+     * Handle confirmation modal that may appear after deactivation
+     */
+    async handleConfirmationModal() {
+        try {
+            await new Promise((resolve) => setTimeout(resolve, 500));
+            const xpath = '//lightning-modal-footer//button[text()="Deactivate"]';
+            await this.page.waitForSelector(`::-p-xpath(${xpath})`, {
+                timeout: 5000,
+            });
+            const buttons = await this.page.$$(`xpath/.${xpath}`);
+            if (buttons.length === 0) {
+                throw new Error('Deactivate button not found in confirmation modal');
+            }
+            await buttons[0].click();
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+        }
+        catch (e) {
+            throw new Error(`Failed to handle deactivation confirmation modal: ${e.message}`);
+        }
+    }
+    /**
+     * Wait for a button to become enabled
+     * @param button - The button element to wait for
+     * @param timeout - Maximum time to wait in milliseconds (default: 10000)
+     */
+    async waitForButtonEnabled(button, timeout = 10000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const isDisabled = await this.page.evaluate((btn) => {
+                return btn.disabled;
+            }, button);
+            if (!isDisabled) {
+                return;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+        throw new Error(`Button did not become enabled within ${timeout}ms`);
+    }
+}
+//# sourceMappingURL=page.js.map

package/lib/plugins/user-access-policies/page.js.map

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

package/lib/plugins/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function semanticallyCleanObject<T extends unknown>(obj: T, id?: string): T | undefined;
+export declare function isEmptyObjectOrArray(arg: unknown): boolean;
+export declare function deepDiff<T extends unknown>(source: T | undefined, target: T | undefined): T | undefined;

package/lib/plugins/utils.js

@@ -0,0 +1,47 @@
+import { isDeepStrictEqual } from 'util';
+// an object only containing an id is semantically empty
+export function semanticallyCleanObject(obj, id = 'id') {
+    if (typeof obj === 'object' && obj !== null) {
+        if (Object.keys(obj).length === 1 && Object.keys(obj)[0] === id) {
+            return undefined;
+        }
+    }
+    return obj;
+}
+export function isEmptyObjectOrArray(arg) {
+    if (typeof arg === 'object' && arg !== null) {
+        return Object.keys(arg).length === 0;
+    }
+    return false;
+}
+export function deepDiff(source, target) {
+    if (isDeepStrictEqual(source, target)) {
+        return undefined;
+    }
+    if (typeof target === 'object' &&
+        target !== null &&
+        typeof source === 'object' &&
+        source !== null) {
+        let objectOrArray;
+        if (Array.isArray(target)) {
+            objectOrArray = target
+                .map((item, i) => deepDiff(source?.[i], item))
+                .filter((x) => x !== undefined);
+        }
+        else {
+            const targetKeys = Object.keys(target);
+            const minSource = Object.fromEntries(Object.entries(source).filter(([key, value]) => targetKeys.includes(key)));
+            if (!isDeepStrictEqual(minSource, source)) {
+                return deepDiff(minSource, target);
+            }
+            objectOrArray = target;
+        }
+        if (isEmptyObjectOrArray(objectOrArray)) {
+            return undefined;
+        }
+        return objectOrArray;
+    }
+    // simple value
+    return target;
+}
+//# sourceMappingURL=utils.js.map

package/lib/plugins/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/plugins/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAEzC,wDAAwD;AACxD,MAAM,UAAU,uBAAuB,CACrC,GAAM,EACN,EAAE,GAAG,IAAI;IAET,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAChE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,MAAqB,EACrB,MAAqB;IAErB,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI,EACf,CAAC;QACD,IAAI,aAA4B,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,aAAa,GAAG,MAAM;iBACnB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;iBAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAkB,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAClC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAC7C,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CACzB,CACQ,CAAC;YACZ,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC1C,OAAO,QAAQ,CAAC,SAAc,EAAE,MAAM,CAAC,CAAC;YAC1C,CAAC;YACD,aAAa,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,IAAI,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,eAAe;IACf,OAAO,MAAM,CAAC;AAChB,CAAC"}