Skip to content

Commit 07e4f21

Browse files
committed
chore(release): 4.4.0 [skip ci]
1 parent 34ed97f commit 07e4f21

File tree

3 files changed

+10
-94
lines changed

3 files changed

+10
-94
lines changed

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1+
# [4.4.0](https://github.com/salesforcecli/plugin-lightning-dev/compare/4.3.3...4.4.0) (2025-07-15)
2+
3+
### Features
4+
5+
- off-core integration test on your local @W-18852148@ ([#435](https://github.com/salesforcecli/plugin-lightning-dev/issues/435)) ([34ed97f](https://github.com/salesforcecli/plugin-lightning-dev/commit/34ed97f136a8da520e037add61027a7ef6a68ffa))
6+
17
## [4.3.3](https://github.com/salesforcecli/plugin-lightning-dev/compare/4.3.2...4.3.3) (2025-07-13)
28

39
### Bug Fixes

README.md

Lines changed: 3 additions & 93 deletions
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,7 @@ EXAMPLES
201201
$ sf lightning dev app --target-org myOrg --device-type ios --device-id "iPhone 15 Pro Max"
202202
```
203203

204-
_See code: [src/commands/lightning/dev/app.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/4.3.3/src/commands/lightning/dev/app.ts)_
204+
_See code: [src/commands/lightning/dev/app.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/4.4.0/src/commands/lightning/dev/app.ts)_
205205

206206
## `sf lightning dev component`
207207

@@ -248,7 +248,7 @@ EXAMPLES
248248
$ sf lightning dev component --name myComponent
249249
```
250250

251-
_See code: [src/commands/lightning/dev/component.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/4.3.3/src/commands/lightning/dev/component.ts)_
251+
_See code: [src/commands/lightning/dev/component.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/4.4.0/src/commands/lightning/dev/component.ts)_
252252

253253
## `sf lightning dev site`
254254

@@ -304,96 +304,6 @@ EXAMPLES
304304
$ sf lightning dev site --name "Partner Central" --target-org myOrg --get-latest
305305
```
306306

307-
_See code: [src/commands/lightning/dev/site.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/4.3.3/src/commands/lightning/dev/site.ts)_
308-
309-
## Integration Testing
310-
311-
This plugin includes integration (NUT) tests for verifying the Lightning Dev Server functionality using SFDX projects and components. Test data like SFDX projects are created at runtime by the testkit.
312-
313-
### Prerequisites
314-
315-
**Salesforce CLI Installation**
316-
The Salesforce CLI must be installed and accessible in your system PATH before running integration tests locally. The plugin expects the `sf` command to be available during local test execution.
317-
318-
- Install the Salesforce CLI: https://developer.salesforce.com/tools/sfdxcli
319-
- Verify installation: `sf --version`
320-
321-
**Connected App Setup**
322-
Follow the [Connected App Setup Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_auth_connected_app.htm) to:
323-
324-
- Create a connected app
325-
- Enable JWT OAuth
326-
- Configure callback URL and OAuth scopes
327-
328-
**JWT Credentials**
329-
Follow the [Private Key and Certificate Setup Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_auth_key_and_cert.htm) to:
330-
331-
- Generate a private key and certificate
332-
- Upload certificate to the connected app
333-
334-
Set the environment variables (copy from `.env.template` to `.env`):
335-
336-
- `TESTKIT_JWT_CLIENT_ID` - Your connected app client ID
337-
- `TESTKIT_JWT_KEY` - Your private key contents
338-
- `TESTKIT_HUB_INSTANCE` - Salesforce instance URL
339-
- `TESTKIT_ORG_USERNAME` - Your org username for testing
340-
- `OPEN_BROWSER` - Control browser opening (true/false)
341-
342-
### Running Tests
343-
344-
Run all or specific integration tests (NUTs) via:
345-
346-
```bash
347-
# Run all integration tests
348-
yarn test:nuts
349-
350-
# Run component local preview test (local development only)
351-
yarn test:nut:local
352-
353-
# Run by category
354-
yarn test:nuts "test/commands/lightning/dev/component*.nut.ts"
355-
356-
# Run with environment variables
357-
OPEN_BROWSER=false NODE_ENV=production yarn test:nuts
358-
```
359-
360-
### Local-Only Tests
361-
362-
Some NUT tests are designed to run only in local development environments and are automatically skipped in CI pipelines. These tests typically:
363-
364-
- Require specific local setup or resources
365-
- Are too slow for CI environments
366-
- Need manual verification or debugging
367-
- Test features that aren't suitable for automated testing
368-
369-
**Component Local Preview Test**
370-
The `componentLocalPreview.nut.ts` test verifies that the Lightning Dev Server starts correctly and responds to component URLs. This test:
371-
372-
- Runs only locally (skipped when `CI=true`)
373-
- Tests server startup and HTTP response
374-
- Verifies component URL routing (`/c-hello-world/`)
375-
- Can be run with: `yarn test:nut:local`
376-
377-
### Test Data Structure
378-
379-
The testkit creates SFDX projects and test data at runtime:
380-
381-
```
382-
test/
383-
├── testdata/
384-
│ ├── lwc/
385-
│ │ └── helloWorld/
386-
│ └── project-definition.json
387-
```
388-
389-
### Automation with TestKit
390-
391-
Tests use [@salesforce/cli-plugins-testkit](https://github.com/salesforcecli/cli-plugins-testkit) for:
392-
393-
- Temporary project creation at runtime
394-
- JWT-based org login
395-
- Cleanup after each run
396-
397-
No manual authentication is needed. Set the required environment variables once and run tests headlessly.
307+
_See code: [src/commands/lightning/dev/site.ts](https://github.com/salesforcecli/plugin-lightning-dev/blob/4.4.0/src/commands/lightning/dev/site.ts)_
398308

399309
<!-- commandsstop -->

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@salesforce/plugin-lightning-dev",
33
"description": "Lightning development tools for LEX, Mobile, and Experience Sites",
4-
"version": "4.3.3",
4+
"version": "4.4.0",
55
"author": "Salesforce",
66
"bugs": "https://github.com/forcedotcom/cli/issues",
77
"dependencies": {

0 commit comments

Comments
 (0)