sf-browserforce 1.0.0

package/lib/plugins/density-settings/index.js

@@ -0,0 +1,101 @@
+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 = '/lightning/setup/DensitySetup/home';
+const availableOptions = ['Comfy', 'Compact'];
+export class DensitySettings 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);
+            const density = (await page.locator('input[name="options"]:checked').getAttribute('value'));
+            return {
+                density,
+            };
+        }
+        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;
+        }
+    }
+    async apply(config) {
+        const env_2 = { stack: [], error: void 0, hasError: false };
+        try {
+            if (!availableOptions.includes(config.density)) {
+                throw new Error(`Could not find density "${config.density}". Available options: ${availableOptions.join(', ')}`);
+            }
+            const page = __addDisposableResource(env_2, await this.browserforce.openPage(BASE_PATH), true);
+            const densityPickerItem = page.locator(`one-density-visual-picker-item:has(input[name="options"][value="${config.density}"])`);
+            await Promise.all([
+                Promise.race([page.waitForResponse(/DensityUserSettings\.setDefaultDensitySetting=1/), waitForPageErrors(page)]),
+                densityPickerItem.click(),
+            ]);
+        }
+        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;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/density-settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/density-settings/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAOvD,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAE9C,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IAC9C,KAAK,CAAC,QAAQ;;;YACnB,MAAY,IAAI,kCAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAA,CAAC;YAC/D,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAY,CAAC;YACvG,OAAO;gBACL,OAAO;aACR,CAAC;;;;;;;;;;;KACH;IAEM,KAAK,CAAC,KAAK,CAAC,MAAc;;;YAC/B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,OAAO,yBAAyB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnH,CAAC;YACD,MAAY,IAAI,kCAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAA,CAAC;YAC/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CACpC,mEAAmE,MAAM,CAAC,OAAO,KAAK,CACvF,CAAC;YACF,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,iDAAiD,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChH,iBAAiB,CAAC,KAAK,EAAE;aAC1B,CAAC,CAAC;;;;;;;;;;;KACJ;CACF"}

package/lib/plugins/deprecated.d.ts

@@ -0,0 +1,4 @@
+export declare const DEPRECATED_DRIVERS: string[];
+export declare const handleDeprecations: (definition: {
+    settings: unknown;
+}) => void;

package/lib/plugins/deprecated.js

@@ -0,0 +1,28 @@
+export const DEPRECATED_DRIVERS = ['communities', 'defer-sharing-calculation'];
+export const handleDeprecations = (definition) => {
+    for (const driverName of Object.keys(definition.settings)) {
+        if (DEPRECATED_DRIVERS.includes(driverName)) {
+            throw new Error(`The sfdx-browserforce-plugin setting '${driverName}' is deprecated and has been removed.
+✅ Salesforce now supports this setting in the Metadata API.
+👉 Please see the instructions at https://github.com/amtrack/sfdx-browserforce-plugin/wiki/Hall-of-Fame#${driverName}.`);
+        }
+        if (driverName === 'security') {
+            if (definition.settings[driverName]?.loginAccessPolicies !== undefined) {
+                throw new Error(`The sfdx-browserforce-plugin setting 'security.loginAccessPolicies' is deprecated and has been removed.
+✅ Salesforce now supports this setting in the Metadata API.
+👉 Please see the instructions at https://github.com/amtrack/sfdx-browserforce-plugin/wiki/Hall-of-Fame#security-loginaccesspolicies-administratorscanloginasanyuser.`);
+            }
+            if (definition.settings[driverName]?.identityProvider !== undefined) {
+                throw new Error(`The sfdx-browserforce-plugin setting 'security.identityProvider' is deprecated and has been removed.
+✅ Salesforce now supports this setting in the Metadata API.
+👉 Please see the instructions at https://github.com/amtrack/sfdx-browserforce-plugin/wiki/Hall-of-Fame#security-identityprovider.`);
+            }
+            if (definition.settings[driverName]?.sharing !== undefined) {
+                throw new Error(`The sfdx-browserforce-plugin setting 'security.sharing' is deprecated and has been removed.
+✅ Salesforce now supports this setting in the Metadata API.
+👉 Please see the instructions at https://github.com/amtrack/sfdx-browserforce-plugin/wiki/Hall-of-Fame#security-sharing.`);
+            }
+        }
+    }
+};
+//# sourceMappingURL=deprecated.js.map

package/lib/plugins/deprecated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.js","sourceRoot":"","sources":["../../src/plugins/deprecated.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,2BAA2B,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAiC,EAAE,EAAE;IACtE,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,IAAI,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU;;0GAE+C,UAAU,GAAG,CAChH,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBACvE,MAAM,IAAI,KAAK,CACb;;sKAE4J,CAC7J,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CACb;;mIAEyH,CAC1H,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CACb;;0HAEgH,CACjH,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/lib/plugins/email-deliverability/index.d.ts

@@ -0,0 +1,9 @@
+import { BrowserforcePlugin } from '../../plugin.js';
+type Config = {
+    accessLevel: string;
+};
+export declare class EmailDeliverability extends BrowserforcePlugin {
+    retrieve(definition?: Config): Promise<Config>;
+    apply(config: Config): Promise<void>;
+}
+export {};

package/lib/plugins/email-deliverability/index.e2e-spec.d.ts

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

package/lib/plugins/email-deliverability/index.e2e-spec.js

@@ -0,0 +1,55 @@
+import assert from 'assert';
+import { EmailDeliverability } from './index.js';
+describe(EmailDeliverability.name, function () {
+    let plugin;
+    before(() => {
+        plugin = new EmailDeliverability(global.browserforce);
+    });
+    const configNone = {
+        accessLevel: 'No access',
+    };
+    const configAll = {
+        accessLevel: 'All email',
+    };
+    const configSystem = {
+        accessLevel: 'System email only',
+    };
+    const configInvalid = {
+        accessLevel: 'Invalid',
+    };
+    // Note order is important here, the scratch org will be created with all access set, I have placed last so if a scratch is reused at least it is in the same state
+    it('should set "no access"', async () => {
+        await plugin.run(configNone);
+    });
+    it('should already be set to "no access"', async () => {
+        const res = await plugin.retrieve();
+        assert.deepStrictEqual(res, configNone);
+    });
+    it('should set "system only"', async () => {
+        await plugin.apply(configSystem);
+    });
+    it('should be set to "system only"', async () => {
+        const res = await plugin.retrieve();
+        assert.deepStrictEqual(res, configSystem);
+    });
+    it('should apply all email', async () => {
+        await plugin.apply(configAll);
+    });
+    it('should already be have all enabled', async () => {
+        const res = await plugin.retrieve();
+        assert.deepStrictEqual(res, configAll);
+    });
+    it('should error on invalid input', async () => {
+        let err;
+        try {
+            await plugin.apply(configInvalid);
+        }
+        catch (e) {
+            err = e;
+        }
+        assert.throws(() => {
+            throw err;
+        }, /Invalid email access level/);
+    });
+});
+//# sourceMappingURL=index.e2e-spec.js.map

package/lib/plugins/email-deliverability/index.e2e-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.e2e-spec.js","sourceRoot":"","sources":["../../../src/plugins/email-deliverability/index.e2e-spec.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,QAAQ,CAAC,mBAAmB,CAAC,IAAI,EAAE;IACjC,IAAI,MAA2B,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE;QACV,MAAM,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG;QACjB,WAAW,EAAE,WAAW;KACzB,CAAC;IACF,MAAM,SAAS,GAAG;QAChB,WAAW,EAAE,WAAW;KACzB,CAAC;IACF,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,mBAAmB;KACjC,CAAC;IACF,MAAM,aAAa,GAAG;QACpB,WAAW,EAAE,SAAS;KACvB,CAAC;IAEF,mKAAmK;IACnK,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,IAAI,GAAG,CAAC;QACR,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACpC,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,4BAA4B,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/plugins/email-deliverability/index.js

@@ -0,0 +1,109 @@
+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 { BrowserforcePlugin } from '../../plugin.js';
+const BASE_PATH = '/email-admin/editOrgEmailSettings.apexp';
+const ACCESS_LEVEL_SELECTOR = 'select[id$=":sendEmailAccessControlSelect"]';
+const CONFIRM_MESSAGE_SELECTOR = 'span[id$=":successText"]';
+const SAVE_BUTTON_SELECTOR = 'input[id$=":saveBtn"]';
+const ACCESS_LEVEL_VALUES = new Map([
+    ['No access', '0'],
+    ['System email only', '1'],
+    ['All email', '2'],
+]);
+export class EmailDeliverability extends BrowserforcePlugin {
+    async retrieve(definition) {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            const page = __addDisposableResource(env_1, await this.browserforce.openPage(BASE_PATH), true);
+            const selectedOption = await page.locator(`${ACCESS_LEVEL_SELECTOR} > option[selected]`).textContent();
+            if (!selectedOption) {
+                throw new Error('Selected access level not found...');
+            }
+            return {
+                accessLevel: selectedOption,
+            };
+        }
+        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;
+        }
+    }
+    async apply(config) {
+        const env_2 = { stack: [], error: void 0, hasError: false };
+        try {
+            const accessLevelNumber = ACCESS_LEVEL_VALUES.get(config.accessLevel);
+            if (accessLevelNumber === undefined) {
+                throw new Error(`Invalid email access level ${config.accessLevel}`);
+            }
+            const page = __addDisposableResource(env_2, await this.browserforce.openPage(BASE_PATH), true);
+            await page.locator(ACCESS_LEVEL_SELECTOR).selectOption(accessLevelNumber);
+            await page.locator(SAVE_BUTTON_SELECTOR).click();
+            await page.locator(CONFIRM_MESSAGE_SELECTOR).waitFor();
+        }
+        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;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/email-deliverability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/email-deliverability/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAE5D,MAAM,qBAAqB,GAAG,6CAA6C,CAAC;AAC5E,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AAC5D,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAErD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,CAAC,WAAW,EAAE,GAAG,CAAC;IAClB,CAAC,mBAAmB,EAAE,GAAG,CAAC;IAC1B,CAAC,WAAW,EAAE,GAAG,CAAC;CACnB,CAAC,CAAC;AAMH,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IAClD,KAAK,CAAC,QAAQ,CAAC,UAAmB;;;YACvC,MAAY,IAAI,kCAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAA,CAAC;YAC/D,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,qBAAqB,qBAAqB,CAAC,CAAC,WAAW,EAAE,CAAC;YACvG,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,OAAO;gBACL,WAAW,EAAE,cAAc;aAC5B,CAAC;;;;;;;;;;;KACH;IAEM,KAAK,CAAC,KAAK,CAAC,MAAc;;;YAC/B,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACtE,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,MAAY,IAAI,kCAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAA,CAAC;YAC/D,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;YAC1E,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC;;;;;;;;;;;KACxD;CACF"}

package/lib/plugins/high-velocity-sales-settings/index.d.ts

@@ -0,0 +1,10 @@
+import { Connection } from '@salesforce/core';
+import { BrowserforcePlugin } from '../../plugin.js';
+export type Config = {
+    setUpAndEnable: boolean;
+};
+export declare class HighVelocitySalesSettings extends BrowserforcePlugin {
+    retrieve(definition?: Config): Promise<Config>;
+    apply(config: Config): Promise<void>;
+}
+export declare function disableHighVelocitySalesUsingMetadata(connection: Connection): Promise<void>;

package/lib/plugins/high-velocity-sales-settings/index.e2e-spec.d.ts

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

package/lib/plugins/high-velocity-sales-settings/index.e2e-spec.js

@@ -0,0 +1,29 @@
+import assert from 'assert';
+import { HighVelocitySalesSettings } from './index.js';
+describe(HighVelocitySalesSettings.name, function () {
+    let plugin;
+    before(() => {
+        plugin = new HighVelocitySalesSettings(global.browserforce);
+    });
+    const configEnabled = {
+        setUpAndEnable: true,
+    };
+    const configDisabled = {
+        setUpAndEnable: false,
+    };
+    it('should enable', async () => {
+        await plugin.run(configEnabled);
+    });
+    it('should already be enabled', async () => {
+        const res = await plugin.run(configEnabled);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+    it('should disable', async () => {
+        await plugin.run(configDisabled);
+    });
+    it('should already be disabled', async () => {
+        const res = await plugin.run(configDisabled);
+        assert.deepStrictEqual(res, { message: 'no action necessary' });
+    });
+});
+//# sourceMappingURL=index.e2e-spec.js.map

package/lib/plugins/high-velocity-sales-settings/index.e2e-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.e2e-spec.js","sourceRoot":"","sources":["../../../src/plugins/high-velocity-sales-settings/index.e2e-spec.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAU,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE/D,QAAQ,CAAC,yBAAyB,CAAC,IAAI,EAAE;IACvC,IAAI,MAAiC,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE;QACV,MAAM,GAAG,IAAI,yBAAyB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAW;QAC5B,cAAc,EAAE,IAAI;KACrB,CAAC;IACF,MAAM,cAAc,GAAG;QACrB,cAAc,EAAE,KAAK;KACtB,CAAC;IAEF,EAAE,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;QAC7B,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/plugins/high-velocity-sales-settings/index.js

@@ -0,0 +1,105 @@
+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 { BrowserforcePlugin } from '../../plugin.js';
+import { HighVelocitySalesSetupPage } from './page.js';
+const MSG_NOT_AVAILABLE = `HighVelocitySales is not available in this organization.
+Please add 'HighVelocitySales' to your Scratch Org Features or purchase a license.`;
+export class HighVelocitySalesSettings extends BrowserforcePlugin {
+    async retrieve(definition) {
+        const result = { setUpAndEnable: false };
+        try {
+            const settings = await this.browserforce.connection.metadata.read('HighVelocitySalesSettings', 'HighVelocitySales');
+            result.setUpAndEnable = settings['enableHighVelocitySalesSetup'] === true;
+        }
+        catch (e) {
+            if (/INVALID_TYPE: This type of metadata is not available for this organization/.test(e)) {
+                throw new Error(MSG_NOT_AVAILABLE);
+            }
+            else {
+                throw e;
+            }
+        }
+        return result;
+    }
+    async apply(config) {
+        if (config.setUpAndEnable) {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const page = __addDisposableResource(env_1, await this.browserforce.openPage(HighVelocitySalesSetupPage.getUrl()), true);
+                const hvs = new HighVelocitySalesSetupPage(page);
+                await hvs.setUpAndEnable();
+            }
+            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;
+            }
+        }
+        else {
+            await disableHighVelocitySalesUsingMetadata(this.browserforce.connection);
+        }
+    }
+}
+export async function disableHighVelocitySalesUsingMetadata(connection) {
+    const settings = {
+        fullName: 'HighVelocitySales',
+        enableHighVelocitySalesSetup: false,
+        enableHighVelocitySales: false,
+    };
+    await connection.metadata.update('HighVelocitySalesSettings', settings);
+}
+//# sourceMappingURL=index.js.map

package/lib/plugins/high-velocity-sales-settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/high-velocity-sales-settings/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,iBAAiB,GAAG;mFACyD,CAAC;AAMpF,MAAM,OAAO,yBAA0B,SAAQ,kBAAkB;IACxD,KAAK,CAAC,QAAQ,CAAC,UAAmB;QACvC,MAAM,MAAM,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAC/D,2BAA2B,EAC3B,mBAAmB,CACpB,CAAC;YACF,MAAM,CAAC,cAAc,GAAG,QAAQ,CAAC,8BAA8B,CAAC,KAAK,IAAI,CAAC;QAC5E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,4EAA4E,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,MAAc;QAC/B,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;;;gBAC1B,MAAY,IAAI,kCAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,0BAA0B,CAAC,MAAM,EAAE,CAAC,OAAA,CAAC;gBACzF,MAAM,GAAG,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,GAAG,CAAC,cAAc,EAAE,CAAC;;;;;;;;;;;SAC5B;aAAM,CAAC;YACN,MAAM,qCAAqC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,qCAAqC,CAAC,UAAsB;IAChF,MAAM,QAAQ,GAAG;QACf,QAAQ,EAAE,mBAAmB;QAC7B,4BAA4B,EAAE,KAAK;QACnC,uBAAuB,EAAE,KAAK;KAC/B,CAAC;IACF,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/lib/plugins/high-velocity-sales-settings/page.d.ts

@@ -0,0 +1,8 @@
+import type { Page } from 'playwright';
+import { type SalesforceUrlPath } from '../../browserforce.js';
+export declare class HighVelocitySalesSetupPage {
+    private page;
+    constructor(page: Page);
+    static getUrl(): SalesforceUrlPath;
+    setUpAndEnable(): Promise<void>;
+}

package/lib/plugins/high-velocity-sales-settings/page.js

@@ -0,0 +1,27 @@
+import { waitForPageErrors } from '../../browserforce.js';
+const SET_UP_AND_ENABLE_HVS_BUTTON = 'button.setupAndEnableButton';
+const ENABLE_TOGGLE = '#toggleHighVelocitySalesPref';
+const AUTOMATION_TAB_ITEM = 'lightning-tab-bar li[data-tab-value="automationTab"]';
+export class HighVelocitySalesSetupPage {
+    page;
+    constructor(page) {
+        this.page = page;
+    }
+    static getUrl() {
+        return '/lightning/setup/SalesEngagement/home';
+    }
+    async setUpAndEnable() {
+        await Promise.race([
+            this.page.locator(AUTOMATION_TAB_ITEM).waitFor(),
+            // workaround: Starting Spring '26 there is a modal "Event fired" on page load.
+            this.page.locator(`div[role=dialog] button.slds-modal__close`).click(),
+        ]);
+        const tabCount = await this.page.locator(AUTOMATION_TAB_ITEM).count();
+        if (tabCount > 0) {
+            await this.page.locator(AUTOMATION_TAB_ITEM).click();
+        }
+        await this.page.locator(SET_UP_AND_ENABLE_HVS_BUTTON).click();
+        await Promise.race([this.page.locator(ENABLE_TOGGLE).waitFor({ timeout: 90_000 }), waitForPageErrors(this.page)]);
+    }
+}
+//# sourceMappingURL=page.js.map

package/lib/plugins/high-velocity-sales-settings/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/plugins/high-velocity-sales-settings/page.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,4BAA4B,GAAG,6BAA6B,CAAC;AACnE,MAAM,aAAa,GAAG,8BAA8B,CAAC;AACrD,MAAM,mBAAmB,GAAG,sDAAsD,CAAC;AAEnF,MAAM,OAAO,0BAA0B;IAC7B,IAAI,CAAO;IAEnB,YAAY,IAAU;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,MAAM,CAAC,MAAM;QAClB,OAAO,uCAAuC,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,cAAc;QACzB,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE;YAChD,+EAA+E;YAC/E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,KAAK,EAAE;SACvE,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC;QACtE,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9D,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;CACF"}

package/lib/plugins/history-tracking/index.d.ts

@@ -0,0 +1,19 @@
+import { BrowserforcePlugin } from '../../plugin.js';
+type HistoryTrackingConfig = {
+    objectApiName: string;
+    enableHistoryTracking?: boolean;
+    fieldHistoryTracking?: FieldHistoryTrackingConfig[];
+};
+export type FieldHistoryTrackingConfig = {
+    fieldApiName: string;
+    enableHistoryTracking: boolean;
+};
+export declare class HistoryTracking extends BrowserforcePlugin {
+    retrieve(definition?: HistoryTrackingConfig[]): Promise<HistoryTrackingConfig[]>;
+    apply(plan: HistoryTrackingConfig[]): Promise<void>;
+    private queryCustomFieldsAndPopulateMap;
+    private parseNamespacedFieldApiName;
+    private getFieldSelectorByFieldApiName;
+    private getTableEnumOrIdByObjectApiName;
+}
+export {};

package/lib/plugins/history-tracking/index.e2e-spec.d.ts

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