sfdx-browserforce-plugin 5.1.1 → 5.1.3

package/lib/browserforce-command.d.ts

@@ -0,0 +1,15 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Browserforce } from './browserforce.js';
+export declare abstract class BrowserforceCommand<T> extends SfCommand<T> {
+    static baseFlags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        definitionfile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        planfile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        statefile: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'flags-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected bf: Browserforce;
+    protected settings: any[];
+    init(): Promise<void>;
+    finally(err?: Error): Promise<void>;
+}

package/lib/browserforce-command.js

@@ -0,0 +1,64 @@
+import { Flags, SfCommand, Ux, requiredOrgFlagWithDeprecations, } from '@salesforce/sf-plugins-core';
+import { promises } from 'fs';
+import * as path from 'path';
+import { Browserforce } from './browserforce.js';
+import { ConfigParser } from './config-parser.js';
+import { handleDeprecations } from './plugins/deprecated.js';
+import * as DRIVERS from './plugins/index.js';
+export class BrowserforceCommand extends SfCommand {
+    static baseFlags = {
+        ...SfCommand.baseFlags,
+        'target-org': requiredOrgFlagWithDeprecations,
+        definitionfile: Flags.string({
+            char: 'f',
+            description: 'path to a browserforce state file',
+        }),
+        planfile: Flags.string({
+            char: 'p',
+            name: 'plan',
+            description: 'path to a browserforce plan file',
+        }),
+        statefile: Flags.string({
+            char: 's',
+            name: 'state',
+            description: 'path to a browserforce definition file\nThe schema is similar to the scratch org definition file.\nSee https://github.com/amtrack/sfdx-browserforce-plugin#supported-org-preferences for supported values.',
+        }),
+    };
+    bf;
+    settings;
+    async init() {
+        await super.init();
+        const { flags } = await this.parse({
+            baseFlags: BrowserforceCommand.baseFlags,
+        });
+        let definition;
+        if (flags.definitionfile) {
+            const definitionFileData = await promises.readFile(path.resolve(flags.definitionfile), 'utf8');
+            try {
+                definition = JSON.parse(definitionFileData);
+            }
+            catch (err) {
+                throw new Error('Failed parsing definitionfile');
+            }
+        }
+        handleDeprecations(definition);
+        // TODO: use require.resolve to dynamically load plugins from npm packages
+        this.settings = ConfigParser.parse(DRIVERS, definition);
+        this.bf = new Browserforce(flags['target-org'], new Ux({ jsonEnabled: this.jsonEnabled() }));
+        this.spinner.start('logging in');
+        await this.bf.login();
+        this.spinner.stop();
+    }
+    async finally(err) {
+        this.spinner.stop(err?.toString());
+        if (err?.cause instanceof Error) {
+            this.logToStderr(`Cause: ${err.cause.toString()}`);
+        }
+        if (this.bf) {
+            this.spinner.start('logging out');
+            await this.bf.logout();
+            this.spinner.stop();
+        }
+    }
+}
+//# sourceMappingURL=browserforce-command.js.map

package/lib/browserforce-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserforce-command.js","sourceRoot":"","sources":["../src/browserforce-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,SAAS,EACT,EAAE,EACF,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,MAAM,OAAgB,mBAAuB,SAAQ,SAAY;IAC/D,MAAM,CAAC,SAAS,GAAG;QACjB,GAAG,SAAS,CAAC,SAAS;QACtB,YAAY,EAAE,+BAA+B;QAC7C,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,mCAAmC;SACjD,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,kCAAkC;SAChD,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,OAAO;YACb,WAAW,EACT,4MAA4M;SAC/M,CAAC;KACH,CAAC;IACQ,EAAE,CAAe;IACjB,QAAQ,CAAQ;IAEnB,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;YACjC,SAAS,EAAE,mBAAmB,CAAC,SAAS;SACzC,CAAC,CAAC;QACH,IAAI,UAAU,CAAC;QACf,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,kBAAkB,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAChD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAClC,MAAM,CACP,CAAC;YACF,IAAI,CAAC;gBACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC/B,0EAA0E;QAC1E,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CACxB,KAAK,CAAC,YAAY,CAAC,EACnB,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAC5C,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,GAAW;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnC,IAAI,GAAG,EAAE,KAAK,YAAY,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAClC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;IACH,CAAC"}

package/lib/browserforce.d.ts

@@ -0,0 +1,25 @@
+import { Org } from '@salesforce/core';
+import { type Ux } from '@salesforce/sf-plugins-core';
+import { Browser, Frame, Page, WaitForOptions } from 'puppeteer';
+export declare class Browserforce {
+    org: Org;
+    logger?: Ux;
+    browser: Browser;
+    page: Page;
+    lightningSetupUrl: string;
+    constructor(org: Org, logger?: Ux);
+    login(): Promise<Browserforce>;
+    logout(): Promise<Browserforce>;
+    throwPageErrors(page: Page): Promise<void>;
+    getNewPage(): Promise<Page>;
+    openPage(urlPath: string, options?: WaitForOptions): Promise<Page>;
+    waitForSelectorInFrameOrPage(page: Page, selector: string): Promise<Page | Frame>;
+    getMyDomain(): string | null;
+    getInstanceUrl(): string;
+    /**
+     * @returns the setup url (e.g. https://[MyDomainName].my.salesforce-setup.com)
+     */
+    getLightningSetupUrl(): Promise<string>;
+}
+export declare function throwPageErrors(page: Page): Promise<void>;
+export declare function retry<T>(input: (attemptCount: number) => PromiseLike<T> | T): Promise<T>;

package/lib/browserforce.js

@@ -0,0 +1,169 @@
+import pRetry from 'p-retry';
+import { launch } from 'puppeteer';
+import { LoginPage } from './pages/login.js';
+const ERROR_DIV_SELECTOR = '#errorTitle';
+const ERROR_DIVS_SELECTOR = 'div.errorMsg';
+const VF_IFRAME_SELECTOR = 'force-aloha-page iframe[name^=vfFrameId]';
+export class Browserforce {
+    org;
+    logger;
+    browser;
+    page;
+    lightningSetupUrl;
+    constructor(org, logger) {
+        this.org = org;
+        this.logger = logger;
+    }
+    async login() {
+        this.browser = await launch({
+            args: [
+                '--no-sandbox',
+                '--disable-setuid-sandbox',
+                // workaround for navigating frames https://github.com/puppeteer/puppeteer/issues/5123
+                '--disable-features=site-per-process',
+            ],
+            headless: !(process.env.BROWSER_DEBUG === 'true'),
+            slowMo: parseInt(process.env.BROWSER_SLOWMO, 10) ?? 0,
+        });
+        const page = await this.getNewPage();
+        try {
+            const loginPage = new LoginPage(page);
+            await loginPage.login(this.org);
+        }
+        finally {
+            await page.close();
+        }
+        return this;
+    }
+    async logout() {
+        if (this.browser) {
+            await this.browser.close();
+        }
+        return this;
+    }
+    async throwPageErrors(page) {
+        await throwPageErrors(page);
+    }
+    async getNewPage() {
+        const page = await this.browser.newPage();
+        page.setDefaultNavigationTimeout(parseInt(process.env.BROWSERFORCE_NAVIGATION_TIMEOUT_MS ?? '90000', 10));
+        await page.setViewport({ width: 1024, height: 768 });
+        return page;
+    }
+    // path instead of url
+    async openPage(urlPath, options) {
+        let page;
+        const result = await pRetry(async () => {
+            page = await this.getNewPage();
+            const setupUrl = urlPath.startsWith('lightning')
+                ? await this.getLightningSetupUrl()
+                : this.getInstanceUrl();
+            const url = `${setupUrl}/${urlPath}`;
+            const response = await page.goto(url, options);
+            if (response) {
+                if (!response.ok()) {
+                    await this.throwPageErrors(page);
+                    throw new Error(`${response.status()}: ${response.statusText()}`);
+                }
+            }
+            return page;
+        }, {
+            onFailedAttempt: async (context) => {
+                if (this.logger) {
+                    this.logger.warn(`retrying ${context.retriesLeft} more time(s) because of "${context.error}"`);
+                }
+                if (page) {
+                    try {
+                        await page.close();
+                    }
+                    catch (e) {
+                        // not handled
+                    }
+                }
+            },
+            retries: parseInt(process.env.BROWSERFORCE_RETRY_MAX_RETRIES ?? '4', 10),
+            minTimeout: parseInt(process.env.BROWSERFORCE_RETRY_TIMEOUT_MS ?? '4000', 10),
+        });
+        return result;
+    }
+    // If LEX is enabled, the classic url will be opened in an iframe.
+    // Wait for either the selector in the page or in the iframe.
+    // returns the page or the frame
+    async waitForSelectorInFrameOrPage(page, selector) {
+        await page.locator(`${selector}, ${VF_IFRAME_SELECTOR}`).wait();
+        const frameElementHandle = await page.$(VF_IFRAME_SELECTOR);
+        let frameOrPage = page;
+        if (frameElementHandle) {
+            const frame = await page.waitForFrame(async (f) => f.name().startsWith('vfFrameId') &&
+                f.url()?.length > 0 &&
+                f.url() !== 'about:blank');
+            frameOrPage = frame;
+        }
+        await frameOrPage.locator(selector).wait();
+        return frameOrPage;
+    }
+    getMyDomain() {
+        const instanceUrl = this.getInstanceUrl();
+        // acme.my.salesforce.com
+        // acme--<sandboxName>.csN.my.salesforce.com
+        const matches = instanceUrl.match(/https:\/\/(.*)\.my\.salesforce\.com/);
+        if (matches) {
+            return matches[1];
+        }
+        return null;
+    }
+    getInstanceUrl() {
+        // sometimes the instanceUrl includes a trailing slash
+        return this.org.getConnection().instanceUrl?.replace(/\/$/, '');
+    }
+    /**
+     * @returns the setup url (e.g. https://[MyDomainName].my.salesforce-setup.com)
+     */
+    async getLightningSetupUrl() {
+        if (!this.lightningSetupUrl) {
+            const page = await this.getNewPage();
+            try {
+                const lightningResponse = await page.goto(`${this.getInstanceUrl()}/lightning/setup/SetupOneHome/home`, { waitUntil: ['load', 'networkidle2'] });
+                this.lightningSetupUrl = new URL(lightningResponse.url()).origin;
+            }
+            finally {
+                await page.close();
+            }
+        }
+        return this.lightningSetupUrl;
+    }
+}
+export async function throwPageErrors(page) {
+    const errorHandle = await page.$(ERROR_DIV_SELECTOR);
+    if (errorHandle) {
+        const errorMsg = await page.evaluate((div) => div.innerText, errorHandle);
+        await errorHandle.dispose();
+        if (errorMsg && errorMsg.trim()) {
+            throw new Error(errorMsg.trim());
+        }
+    }
+    const errorElements = await page.$$(ERROR_DIVS_SELECTOR);
+    if (errorElements.length) {
+        const errorMessages = await page.evaluate((...errorDivs) => {
+            return errorDivs.map((div) => div.innerText);
+        }, ...errorElements);
+        const errorMsg = errorMessages
+            .map((m) => m.trim())
+            .join(' ')
+            .trim();
+        if (errorMsg) {
+            throw new Error(errorMsg);
+        }
+    }
+}
+export async function retry(input) {
+    const res = await pRetry(input, {
+        onFailedAttempt: (context) => {
+            console.warn(`retrying ${context.retriesLeft} more time(s) because of "${context.error}"`);
+        },
+        retries: parseInt(process.env.BROWSERFORCE_RETRY_MAX_RETRIES ?? '6', 10),
+        minTimeout: parseInt(process.env.BROWSERFORCE_RETRY_TIMEOUT_MS ?? '4000', 10),
+    });
+    return res;
+}
+//# sourceMappingURL=browserforce.js.map

package/lib/browserforce.js.map

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

package/lib/commands/browserforce/apply.d.ts

@@ -0,0 +1,10 @@
+import { BrowserforceCommand } from '../../browserforce-command.js';
+type BrowserforceApplyResponse = {
+    success: boolean;
+};
+export declare class BrowserforceApply extends BrowserforceCommand<BrowserforceApplyResponse> {
+    static description: string;
+    static examples: string[];
+    run(): Promise<BrowserforceApplyResponse>;
+}
+export {};

package/lib/commands/browserforce/apply.js

@@ -0,0 +1,54 @@
+import { BrowserforceCommand } from '../../browserforce-command.js';
+export class BrowserforceApply extends BrowserforceCommand {
+    static description = 'apply a plan from a definition file';
+    static examples = [
+        `$ <%= config.bin %> <%= command.id %> -f ./config/currency.json --target-org myOrg@example.com
+  logging in... done
+  Applying definition file ./config/currency.json to org myOrg@example.com
+  [CompanyInformation] retrieving state... done
+  [CompanyInformation] changing 'defaultCurrencyIsoCode' to '"English (South Africa) - ZAR"'... done
+  logging out... done
+  `,
+    ];
+    async run() {
+        const { flags } = await this.parse(BrowserforceApply);
+        this.log(`Applying definition file ${flags.definitionfile} to org ${flags['target-org'].getUsername()}`);
+        for (const setting of this.settings) {
+            const driver = setting.Driver;
+            const instance = new driver(this.bf);
+            this.spinner.start(`[${driver.name}] retrieving state`);
+            let state;
+            try {
+                state = await instance.retrieve(setting.value);
+            }
+            catch (err) {
+                this.spinner.stop('failed');
+                throw err;
+            }
+            this.spinner.stop();
+            const diff = instance.diff(state, setting.value);
+            if (diff !== undefined) {
+                this.spinner.start(`[${driver.name}] ${Object.keys(diff)
+                    .map((key) => {
+                    return `changing '${key}' to '${JSON.stringify(diff[key])}'`;
+                })
+                    .join('\n')}`);
+                try {
+                    await instance.apply(diff);
+                }
+                catch (err) {
+                    this.spinner.stop('failed');
+                    throw err;
+                }
+                this.spinner.stop();
+            }
+            else {
+                this.log(`[${driver.name}] no action necessary`);
+            }
+        }
+        return {
+            success: true,
+        };
+    }
+}
+//# sourceMappingURL=apply.js.map

package/lib/commands/browserforce/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/commands/browserforce/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMpE,MAAM,OAAO,iBAAkB,SAAQ,mBAA8C;IAC5E,MAAM,CAAC,WAAW,GAAG,qCAAqC,CAAC;IAC3D,MAAM,CAAC,QAAQ,GAAG;QACvB;;;;;;GAMD;KACA,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,CACN,4BAA4B,KAAK,CAAC,cAAc,WAAW,KAAK,CAC9D,YAAY,CACb,CAAC,WAAW,EAAE,EAAE,CAClB,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,oBAAoB,CAAC,CAAC;YACxD,IAAI,KAAK,CAAC;YACV,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5B,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,KAAK,CAChB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;qBAClC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oBACX,OAAO,aAAa,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;gBAC/D,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;gBACF,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC5B,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,uBAAuB,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC"}

package/lib/commands/browserforce/plan.d.ts

@@ -0,0 +1,10 @@
+import { BrowserforceCommand } from '../../browserforce-command.js';
+type BrowserforceApplyResponse = {
+    success: boolean;
+};
+export declare class BrowserforcePlanCommand extends BrowserforceCommand<BrowserforceApplyResponse> {
+    static description: string;
+    static examples: string[];
+    run(): Promise<BrowserforceApplyResponse>;
+}
+export {};

package/lib/commands/browserforce/plan.js

@@ -0,0 +1,56 @@
+import { writeFile } from 'fs/promises';
+import * as path from 'path';
+import { BrowserforceCommand } from '../../browserforce-command.js';
+export class BrowserforcePlanCommand extends BrowserforceCommand {
+    static description = 'retrieve state and generate plan file';
+    static examples = [
+        `$ <%= config.bin %> <%= command.id %> -f ./config/currency.json --target-org myOrg@example.com
+  logging in... done
+  Generating plan with definition file ./config/currency.json from org myOrg@example.com
+  [CompanyInformation] retrieving state... done
+  [CompanyInformation] generating plan... done
+  logging out... done
+  `,
+    ];
+    async run() {
+        const { flags } = await this.parse(BrowserforcePlanCommand);
+        this.log(`Generating plan with definition file ${flags.definitionfile} from org ${flags['target-org'].getUsername()}`);
+        const state = {
+            settings: {},
+        };
+        const plan = {
+            settings: {},
+        };
+        for (const setting of this.settings) {
+            const driver = setting.Driver;
+            const instance = new driver(this.bf);
+            this.spinner.start(`[${driver.name}] retrieving state`);
+            let driverState;
+            try {
+                driverState = await instance.retrieve(setting.value);
+                state.settings[setting.key] = driverState;
+            }
+            catch (err) {
+                this.spinner.stop('failed');
+                throw err;
+            }
+            this.spinner.stop();
+            this.spinner.start(`[${driver.name}] generating plan`);
+            const driverPlan = instance.diff(driverState, setting.value);
+            plan.settings[setting.key] = driverPlan;
+            this.spinner.stop();
+        }
+        if (flags.statefile) {
+            this.spinner.start('writing state file');
+            await writeFile(path.resolve(flags.statefile), JSON.stringify(state, null, 2));
+            this.spinner.stop();
+        }
+        if (flags.planfile) {
+            this.spinner.start('writing plan file');
+            await writeFile(path.resolve(flags.planfile), JSON.stringify(plan, null, 2));
+            this.spinner.stop();
+        }
+        return { success: true };
+    }
+}
+//# sourceMappingURL=plan.js.map

package/lib/commands/browserforce/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/commands/browserforce/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMpE,MAAM,OAAO,uBAAwB,SAAQ,mBAA8C;IAClF,MAAM,CAAC,WAAW,GAAG,uCAAuC,CAAC;IAC7D,MAAM,CAAC,QAAQ,GAAG;QACvB;;;;;;GAMD;KACA,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,CACN,wCACE,KAAK,CAAC,cACR,aAAa,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,EAAE,CACjD,CAAC;QACF,MAAM,KAAK,GAAG;YACZ,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,EAAE;SACb,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,oBAAoB,CAAC,CAAC;YACxD,IAAI,WAAW,CAAC;YAChB,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACrD,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YAC5C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5B,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,mBAAmB,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACzC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAC7B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAC/B,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACxC,MAAM,SAAS,CACb,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAC9B,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC"}

package/lib/config-parser.d.ts

@@ -0,0 +1,16 @@
+import { BrowserforcePlugin } from './plugin.js';
+type Drivers = {
+    [key: string]: typeof BrowserforcePlugin;
+};
+type Data = {
+    settings?: unknown;
+};
+type Config = {
+    Driver: typeof BrowserforcePlugin;
+    key: string;
+    value: unknown;
+};
+export declare class ConfigParser {
+    static parse(drivers: Drivers, data: Data): Config[];
+}
+export {};

package/lib/config-parser.js

@@ -0,0 +1,24 @@
+export class ConfigParser {
+    static parse(drivers, data) {
+        const settings = [];
+        if (data?.settings) {
+            for (const driverName of Object.keys(data.settings)) {
+                if (drivers[driverName]) {
+                    settings.push({
+                        Driver: drivers[driverName],
+                        key: driverName,
+                        value: data.settings[driverName],
+                    });
+                }
+                else {
+                    throw new Error(`Could not find plugin named '${driverName}' in definition: ${JSON.stringify(data)}`);
+                }
+            }
+        }
+        else {
+            throw new Error(`Missing 'settings' attribute in definition: ${JSON.stringify(data)}`);
+        }
+        return settings;
+    }
+}
+//# sourceMappingURL=config-parser.js.map

package/lib/config-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-parser.js","sourceRoot":"","sources":["../src/config-parser.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,YAAY;IAChB,MAAM,CAAC,KAAK,CAAC,OAAgB,EAAE,IAAU;QAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpD,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;wBAC3B,GAAG,EAAE,UAAU;wBACf,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;qBACjC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,oBAAoB,IAAI,CAAC,SAAS,CAC1E,IAAI,CACL,EAAE,CACJ,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/lib/index.d.ts

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

package/lib/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/lib/jsforce-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * workaround as the Metadata API (converted from XML) returns an object instead of an array of length 1
+ * @param prop result of a Metadata API call (array or object)
+ */
+export declare function ensureArray<T>(prop: T | T[]): T[];

package/lib/jsforce-utils.js

@@ -0,0 +1,14 @@
+/**
+ * workaround as the Metadata API (converted from XML) returns an object instead of an array of length 1
+ * @param prop result of a Metadata API call (array or object)
+ */
+export function ensureArray(prop) {
+    if (Array.isArray(prop)) {
+        return prop;
+    }
+    if (prop === undefined || prop === null) {
+        return [];
+    }
+    return [prop];
+}
+//# sourceMappingURL=jsforce-utils.js.map

package/lib/jsforce-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsforce-utils.js","sourceRoot":"","sources":["../src/jsforce-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,IAAa;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/lib/pages/login.d.ts

@@ -0,0 +1,8 @@
+import { type Org } from '@salesforce/core';
+import { type Page } from 'puppeteer';
+export declare class LoginPage {
+    private page;
+    constructor(page: Page);
+    login(org: Org): Promise<this>;
+    throwPageErrors(): Promise<void>;
+}

package/lib/pages/login.js

@@ -0,0 +1,39 @@
+const FRONT_DOOR_PATH = 'secur/frontdoor.jsp';
+const POST_LOGIN_PATH = 'setup/forcecomHomepage.apexp';
+const ERROR_DIV_SELECTOR = '#error';
+export class LoginPage {
+    page;
+    constructor(page) {
+        this.page = page;
+    }
+    async login(org) {
+        try {
+            await org.refreshAuth();
+        }
+        catch (_) {
+            throw new Error('login failed');
+        }
+        const conn = org.getConnection();
+        const response = await this.page.goto(`${conn.instanceUrl.replace(/\/$/, '')}/${FRONT_DOOR_PATH}?sid=${conn.accessToken}&retURL=${encodeURIComponent(POST_LOGIN_PATH)}`, {
+            // should have waited at least 500ms for network connections, redirects should probably have happened already
+            waitUntil: ['load', 'networkidle2'],
+        });
+        const url = new URL(response.url());
+        if (url.searchParams.has('startURL')) {
+            // when query param startURL exists, the login failed
+            // e.g. /?ec=302&startURL=https...
+            await this.throwPageErrors();
+        }
+        return this;
+    }
+    async throwPageErrors() {
+        const errorHandle = await this.page.$(ERROR_DIV_SELECTOR);
+        if (errorHandle) {
+            const errorMessage = (await this.page.evaluate((div) => div.innerText, errorHandle))?.trim();
+            if (errorMessage) {
+                throw new Error(errorMessage);
+            }
+        }
+    }
+}
+//# sourceMappingURL=login.js.map

package/lib/pages/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/pages/login.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,eAAe,GAAG,8BAA8B,CAAC;AAEvD,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAEpC,MAAM,OAAO,SAAS;IACZ,IAAI,CAAO;IAEnB,YAAY,IAAU;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAQ;QAClB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CACnC,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,eAAe,QACvD,IAAI,CAAC,WACP,WAAW,kBAAkB,CAAC,eAAe,CAAC,EAAE,EAChD;YACE,6GAA6G;YAC7G,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC;SACpC,CACF,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,qDAAqD;YACrD,kCAAkC;YAClC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC1D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,YAAY,GAAG,CACnB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CACtB,CAAC,GAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EACtC,WAAW,CACZ,CACF,EAAE,IAAI,EAAE,CAAC;YACV,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/lib/plugin.d.ts

@@ -0,0 +1,17 @@
+import { Org } from '@salesforce/core';
+import { Browserforce } from './browserforce.js';
+export declare abstract class BrowserforcePlugin {
+    protected browserforce: Browserforce;
+    protected org: Org;
+    constructor(browserforce: Browserforce);
+    abstract retrieve(definition?: unknown): Promise<unknown>;
+    /**
+     * deep diff
+     * @param state
+     * @param definition
+     * @returns undefined when there is no diff
+     */
+    diff(state: unknown, definition: unknown): unknown;
+    abstract apply(plan: unknown): Promise<unknown>;
+    run(definition: unknown): Promise<unknown>;
+}

package/lib/plugin.js

@@ -0,0 +1,30 @@
+import { deepDiff } from './plugins/utils.js';
+export class BrowserforcePlugin {
+    browserforce;
+    org;
+    constructor(browserforce) {
+        this.browserforce = browserforce;
+        this.org = browserforce?.org;
+    }
+    /**
+     * deep diff
+     * @param state
+     * @param definition
+     * @returns undefined when there is no diff
+     */
+    diff(state, definition) {
+        return deepDiff(state, definition);
+    }
+    async run(definition) {
+        const state = await this.retrieve(definition);
+        const diff = this.diff(state, definition);
+        if (diff !== undefined) {
+            const result = await this.apply(diff);
+            return result;
+        }
+        return {
+            message: 'no action necessary',
+        };
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/lib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,OAAgB,kBAAkB;IAC5B,YAAY,CAAe;IAC3B,GAAG,CAAM;IAEnB,YAAmB,YAA0B;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,GAAG,GAAG,YAAY,EAAE,GAAG,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACI,IAAI,CAAC,KAAc,EAAE,UAAmB;QAC7C,OAAO,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,UAAmB;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO;YACL,OAAO,EAAE,qBAAqB;SAC/B,CAAC;IACJ,CAAC;CACF"}

package/lib/plugins/activity-settings/index.d.ts

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

package/lib/plugins/activity-settings/index.e2e-spec.d.ts

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