@octoberswimmer/aer-sf-plugin 0.0.3 → 0.0.4

package/README.md

@@ -1,21 +1,21 @@
 # @octoberswimmer/aer-sf-plugin
 
 A [Salesforce CLI](https://developer.salesforce.com/tools/salesforcecli) plugin
-that runs Apex tests locally using [aer](https://github.com/octoberswimmer/aer-dist).
+that runs Apex tests and previews Lightning Web Components locally using
+[aer](https://github.com/octoberswimmer/aer-dist).
 
 ```
 sf aer apex run test
 ```
 
-works the same way as
+works the same way as `sf apex run test`, but runs tests locally via `aer test`.
 
 ```
-sf apex run test
+sf aer lightning dev component
 ```
 
-but instead of submitting tests to a Salesforce org, it stages your project's
-Apex source into a temp directory and invokes `aer test` against the staged
-copy.
+works the same way as `sf lightning dev component`, but previews LWC components
+locally via `aer server`.
 
 ## Requirements
 
@@ -35,6 +35,8 @@ sf plugins install @octoberswimmer/aer-sf-plugin
 
 ## Usage
 
+### Apex tests
+
 Run every test in the project:
 
 ```
@@ -65,6 +67,30 @@ With code coverage:
 sf aer apex run test --code-coverage --output-dir test-results
 ```
 
+### LWC component preview
+
+Select a component interactively and launch the preview:
+
+```
+sf aer lightning dev component
+```
+
+Preview a specific component by name:
+
+```
+sf aer lightning dev component --name myComponent
+```
+
+Open the component list in the browser instead of selecting interactively:
+
+```
+sf aer lightning dev component --client-select
+```
+
+The development server uses `aer server --watch` to serve your project's
+source directly (no staging), so changes to component HTML, CSS, and
+JavaScript are reflected immediately via hot module replacement.
+
 ## Locating the aer binary
 
 When the plugin needs to invoke `aer`, it tries these sources in order:
@@ -173,5 +199,4 @@ node bin/dev.js aer apex run test --help
 This plugin is open source, licensed under BSD-3-Clause.
 
 Note that [aer](https://github.com/octoberswimmer/aer-dist) itself is not open
-source — it is distributed as a binary under its own license. You must obtain
-and install aer separately for the plugin to do anything useful.
+source — it is distributed as a binary under its own license.

package/lib/commands/aer/lightning/dev/component.d.ts

@@ -0,0 +1,17 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type AerLightningDevComponentResult = {
+    exitCode: number;
+};
+export default class AerLightningDevComponent extends SfCommand<AerLightningDevComponentResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'client-select': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<AerLightningDevComponentResult>;
+    private runServer;
+    private maybePromptForUpdate;
+}

package/lib/commands/aer/lightning/dev/component.js

@@ -0,0 +1,160 @@
+import { spawn, exec } from 'node:child_process';
+import { resolve } from 'node:path';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages, SfProject } from '@salesforce/core';
+import select from '@inquirer/select';
+import { discoverLwcComponents } from '../../../../lwc.js';
+import { checkForUpdate, ensureAerBinary, installAerVersion, recordPromptedVersion, } from '../../../../aerBinary.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@octoberswimmer/aer-sf-plugin', 'aer.lightning.dev.component');
+export default class AerLightningDevComponent extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.string({
+            char: 'o',
+            summary: messages.getMessage('flags.target-org.summary'),
+        }),
+        name: Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.name.summary'),
+        }),
+        'client-select': Flags.boolean({
+            char: 'c',
+            summary: messages.getMessage('flags.client-select.summary'),
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AerLightningDevComponent);
+        const project = await SfProject.resolve();
+        const projectRoot = project.getPath();
+        const contents = project.getSfProjectJson().getContents();
+        const packageDirectories = contents.packageDirectories ?? [];
+        if (flags['target-org']) {
+            this.warn(messages.getMessage('warn.ignoredFlags', ['--target-org']));
+        }
+        const interactive = Boolean(process.stdin.isTTY);
+        const aerPath = await ensureAerBinary({
+            allowPrompt: interactive,
+            confirm: (message) => this.confirm({ message, ms: 5 * 60 * 1000, defaultAnswer: false }),
+            log: (m) => this.log(m),
+            warn: (m) => this.warn(m),
+        });
+        const updateCheck = interactive
+            ? checkForUpdate({ aerPath, log: (m) => this.log(m) }).catch(() => null)
+            : Promise.resolve(null);
+        let componentName = flags.name;
+        const clientSelect = flags['client-select'] ?? false;
+        if (!clientSelect) {
+            const components = await discoverLwcComponents(projectRoot, packageDirectories);
+            if (components.length === 0) {
+                throw messages.createError('error.noLwcComponents');
+            }
+            if (componentName) {
+                const match = components.find((c) => c.name === componentName);
+                if (!match) {
+                    const available = components.map((c) => c.name).join(', ');
+                    throw messages.createError('error.componentNotFound', [componentName, available]);
+                }
+            }
+            else {
+                componentName = await select({
+                    message: messages.getMessage('prompt.selectComponent'),
+                    choices: components.map((c) => ({ name: c.name, value: c.name })),
+                });
+            }
+        }
+        const sourcePaths = packageDirectories.map((pd) => resolve(projectRoot, pd.path));
+        const args = ['server', ...sourcePaths, '--watch'];
+        const previewPath = componentName ? `/dev/lwc/${componentName}` : '/dev/lwc';
+        const exitCode = await this.runServer(aerPath, args, projectRoot, previewPath);
+        if (exitCode !== 0) {
+            this.warn(messages.getMessage('warn.aerExit', [String(exitCode)]));
+        }
+        await this.maybePromptForUpdate(updateCheck);
+        return { exitCode };
+    }
+    runServer(binaryPath, args, cwd, previewPath) {
+        return new Promise((resolvePromise, rejectPromise) => {
+            const child = spawn(binaryPath, args, {
+                cwd,
+                stdio: ['inherit', 'inherit', 'pipe'],
+                env: {
+                    ...process.env,
+                    AER_AUTOUPDATE_DISABLED: '1',
+                },
+            });
+            let opened = false;
+            let stderrBuf = '';
+            child.stderr?.on('data', (chunk) => {
+                const text = chunk.toString();
+                process.stderr.write(text);
+                if (!opened) {
+                    stderrBuf += text;
+                    const match = stderrBuf.match(/server listening on (\S+)/);
+                    if (match) {
+                        opened = true;
+                        const addr = match[1];
+                        const url = `http://${addr}${previewPath}`;
+                        this.log(messages.getMessage('info.serverUrl', [url]));
+                        openBrowser(url);
+                    }
+                }
+            });
+            child.on('error', (err) => {
+                if (err.code === 'ENOENT') {
+                    rejectPromise(new Error(`Could not execute aer at ${binaryPath}. The file may have been moved or deleted.`));
+                    return;
+                }
+                rejectPromise(err);
+            });
+            child.on('exit', (code, signal) => {
+                if (signal) {
+                    resolvePromise(128 + (signal === 'SIGINT' ? 2 : signal === 'SIGTERM' ? 15 : 1));
+                }
+                else {
+                    resolvePromise(code ?? 0);
+                }
+            });
+        });
+    }
+    async maybePromptForUpdate(check) {
+        let update;
+        try {
+            update = await check;
+        }
+        catch {
+            return;
+        }
+        if (!update)
+            return;
+        this.log('');
+        const yes = await this.confirm({
+            message: messages.getMessage('prompt.updateAvailable', [update.installed, update.latest]),
+            ms: 5 * 60 * 1000,
+            defaultAnswer: false,
+        });
+        if (!yes) {
+            await recordPromptedVersion(update.latest).catch(() => { });
+            this.log(messages.getMessage('info.updateDeferred'));
+            return;
+        }
+        try {
+            const newPath = await installAerVersion(update.latest, { log: (m) => this.log(m) });
+            this.log(messages.getMessage('info.updateInstalled', [update.latest, newPath]));
+        }
+        catch (err) {
+            this.warn(messages.getMessage('warn.updateFailed', [err.message]));
+        }
+    }
+}
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin'
+        ? 'open'
+        : process.platform === 'win32'
+            ? 'start'
+            : 'xdg-open';
+    exec(`${cmd} ${JSON.stringify(url)}`);
+}
+//# sourceMappingURL=component.js.map

package/lib/commands/aer/lightning/dev/component.js.map

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

package/lib/lwc.d.ts

@@ -0,0 +1,7 @@
+export type LwcComponent = {
+    name: string;
+    path: string;
+};
+export declare function discoverLwcComponents(projectRoot: string, packageDirectories: {
+    path: string;
+}[]): Promise<LwcComponent[]>;

package/lib/lwc.js

@@ -0,0 +1,67 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+export async function discoverLwcComponents(projectRoot, packageDirectories) {
+    const seen = new Map();
+    for (const pd of packageDirectories) {
+        const absPdRoot = resolve(projectRoot, pd.path);
+        const lwcDirs = await findLwcDirs(absPdRoot);
+        for (const lwcDir of lwcDirs) {
+            let entries;
+            try {
+                entries = await readdir(lwcDir, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const name = entry.name;
+                if (name.startsWith('__'))
+                    continue;
+                const componentDir = join(lwcDir, name);
+                const hasMetaXml = await fileExists(join(componentDir, `${name}.js-meta.xml`));
+                if (!hasMetaXml)
+                    continue;
+                seen.set(name, { name, path: componentDir });
+            }
+        }
+    }
+    return [...seen.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+async function findLwcDirs(root) {
+    const results = [];
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.name === 'lwc') {
+                results.push(full);
+            }
+            else {
+                stack.push(full);
+            }
+        }
+    }
+    return results;
+}
+async function fileExists(filePath) {
+    try {
+        const s = await stat(filePath);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=lwc.js.map

package/lib/lwc.js.map

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

package/messages/aer.lightning.dev.component.md

@@ -0,0 +1,87 @@
+# summary
+
+Preview Lightning Web Components locally using aer.
+
+# description
+
+Start a local development server powered by aer to preview Lightning Web Components in isolation with hot module replacement (HMR).
+
+When running the development server, changes to component templates (HTML), styles (CSS), and JavaScript logic are automatically reflected in the browser.
+
+If you run the command without flags, it displays a list of components found in your local DX project for you to choose to preview. Use the --name flag to bypass the prompt. Use --client-select to open the component list in the browser instead.
+
+The `aer` binary is resolved in the same order as `<%= config.bin %> aer apex run test` — see that command's help for details.
+
+# examples
+
+- Select a component interactively and launch the preview:
+
+  <%= config.bin %> <%= command.id %>
+
+- Preview a specific component:
+
+  <%= config.bin %> <%= command.id %> --name myComponent
+
+- Open the component list in the browser:
+
+  <%= config.bin %> <%= command.id %> --client-select
+
+# flags.target-org.summary
+
+Username or alias of the target org. Accepted for compatibility with `sf lightning dev component`; aer runs locally and ignores this flag.
+
+# flags.name.summary
+
+Name of a component to preview.
+
+# flags.client-select.summary
+
+Open the component list in the browser instead of selecting interactively.
+
+# prompt.selectComponent
+
+Select a component to preview:
+
+# info.serverListening
+
+aer server listening. Opening browser…
+
+# info.serverUrl
+
+Preview available at %s
+
+# info.serverStopped
+
+aer server stopped.
+
+# error.noLwcComponents
+
+No Lightning Web Components found in the project's package directories.
+
+# error.componentNotFound
+
+Component "%s" was not found. Available components: %s
+
+# warn.ignoredFlags
+
+The following flags were accepted for compatibility but have no effect when running locally with aer: %s
+
+# warn.aerExit
+
+aer exited with non-zero status %s.
+
+# prompt.updateAvailable
+
+A newer aer release is available (installed: %s, latest: %s). Update now?
+
+# info.updateDeferred
+
+Skipping aer update. You'll be prompted again the next time a new release is published.
+
+# info.updateInstalled
+
+Installed aer %s to %s. The new version will be used on the next run.
+
+# warn.updateFailed
+
+Failed to update aer: %s

package/oclif.manifest.json

@@ -195,7 +195,102 @@
         "test:run:aer:apex",
         "test:run:apex:aer"
       ]
+    },
+    "aer:lightning:dev:component": {
+      "aliases": [],
+      "args": {},
+      "description": "Start a local development server powered by aer to preview Lightning Web Components in isolation with hot module replacement (HMR).\n\nWhen running the development server, changes to component templates (HTML), styles (CSS), and JavaScript logic are automatically reflected in the browser.\n\nIf you run the command without flags, it displays a list of components found in your local DX project for you to choose to preview. Use the --name flag to bypass the prompt. Use --client-select to open the component list in the browser instead.\n\nThe `aer` binary is resolved in the same order as `<%= config.bin %> aer apex run test` — see that command's help for details.",
+      "examples": [
+        "Select a component interactively and launch the preview:\n<%= config.bin %> <%= command.id %>",
+        "Preview a specific component:\n<%= config.bin %> <%= command.id %> --name myComponent",
+        "Open the component list in the browser:\n<%= config.bin %> <%= command.id %> --client-select"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "summary": "Username or alias of the target org. Accepted for compatibility with `sf lightning dev component`; aer runs locally and ignores this flag.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "name": "name",
+          "summary": "Name of a component to preview.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "client-select": {
+          "char": "c",
+          "name": "client-select",
+          "summary": "Open the component list in the browser instead of selecting interactively.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "aer:lightning:dev:component",
+      "pluginAlias": "@octoberswimmer/aer-sf-plugin",
+      "pluginName": "@octoberswimmer/aer-sf-plugin",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Preview Lightning Web Components locally using aer.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "aer",
+        "lightning",
+        "dev",
+        "component.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "aer:lightning:dev:component",
+        "lightning:aer:dev:component",
+        "lightning:dev:aer:component",
+        "lightning:dev:component:aer",
+        "aer:dev:lightning:component",
+        "dev:aer:lightning:component",
+        "dev:lightning:aer:component",
+        "dev:lightning:component:aer",
+        "aer:dev:component:lightning",
+        "dev:aer:component:lightning",
+        "dev:component:aer:lightning",
+        "dev:component:lightning:aer",
+        "aer:lightning:component:dev",
+        "lightning:aer:component:dev",
+        "lightning:component:aer:dev",
+        "lightning:component:dev:aer",
+        "aer:component:lightning:dev",
+        "component:aer:lightning:dev",
+        "component:lightning:aer:dev",
+        "component:lightning:dev:aer",
+        "aer:component:dev:lightning",
+        "component:aer:dev:lightning",
+        "component:dev:aer:lightning",
+        "component:dev:lightning:aer"
+      ]
     }
   },
-  "version": "0.0.3"
+  "version": "0.0.4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@octoberswimmer/aer-sf-plugin",
-	"description": "Salesforce CLI plugin that runs Apex tests locally using aer.",
-	"version": "0.0.3",
+	"description": "Salesforce CLI plugin that runs Apex tests and previews LWC components locally using aer.",
+	"version": "0.0.4",
 	"author": "Christian G. Warden",
 	"bugs": "https://github.com/octoberswimmer/aer-sf-plugin/issues",
 	"homepage": "https://github.com/octoberswimmer/aer-sf-plugin",
@@ -51,6 +51,14 @@
 								"description": "Run Apex code or tests locally via aer."
 							}
 						}
+					},
+					"lightning": {
+						"description": "Work with Lightning Web Components locally via aer.",
+						"subtopics": {
+							"dev": {
+								"description": "Develop Lightning Web Components locally via aer."
+							}
+						}
 					}
 				}
 			}