norn-cli 1.3.0 → 1.3.2

package/CHANGELOG.md

@@ -2,10 +2,41 @@
 
 All notable changes to the "Norn" extension will be documented in this file.
 
+## [1.3.2] - 2026-02-08
+
+### Improved
+- **Contract Report View**: Enhanced property highlighting in the annotated JSON view
+  - Color-coded property highlights (green=valid, yellow=warning, red=error)
+  - Highlights wrap only the property content, not the entire line
+  - Selection-style highlighting similar to assert hover
+  - Improved indentation and spacing
+
+### Fixed
+- **Syntax Highlighting**: Fixed JSON body coloring after nested objects
+  - Properties following `{ }` objects now correctly colored
+- **matchesSchema Keyword**: Fixed partial coloring issue
+  - Entire keyword now highlights as operator (was matching "matches" first)
+
+## [1.3.1] - 2026-02-08
+
+- **Clickable JSON Properties**: Click any JSON value in the response panel to generate an assertion
+  - Hover over any value (string, number, boolean, null) to highlight it
+  - Click to automatically insert `assert $var.body.path == value` at the end of the sequence
+  - Works with nested objects and arrays (e.g., `body.user.address.city`, `body.items[0].name`)
+  - String values are properly escaped with quotes
+  - Toast notification confirms assertion added
+
+- **Response Comparison**: Compare any two API responses with VS Code's built-in diff view
+  - New "⇄ Compare" button next to "📋 Copy" on response bodies
+  - Click on first response, then click another to open side-by-side diff
+  - Responses are pretty-printed JSON for easy comparison
+  - Toast notification guides user: "Select another response to compare"
+  - Works in both sequence results and single request views
+  - State resets automatically after diff opens
+
 ## [1.3.0] - 2026-02-07
 
-### Added
-- **Retry and Backoff**: Automatically retry failed HTTP requests with configurable backoff
+### Added- **Retry and Backoff**: Automatically retry failed HTTP requests with configurable backoff
   - Syntax: `GET url retry 3 backoff 200 ms` (retry up to 3 times with 200ms linear backoff)
   - Works with direct URLs, named endpoints, and named requests
   - Supports time units: `ms`, `s`, `seconds`, `milliseconds`

package/README.md

@@ -22,11 +22,14 @@ A powerful REST client extension for VS Code with sequences, assertions, environ
 - **Named Requests**: Define reusable requests with `[RequestName]` and call them with `run RequestName`
 - **Conditionals**: Control flow with `if/end if` blocks based on response data
 - **Wait Commands**: Add delays between requests with `wait 1s` or `wait 500ms`
+- **Retry and Backoff**: Automatically retry failed requests with `retry 3 backoff 200 ms`
 - **JSON File Loading**: Load test data from JSON files with `run readJson ./file.json`
 - **Property Updates**: Modify loaded JSON data inline with `config.property = value`
 - **Script Execution**: Run bash, PowerShell, or JavaScript scripts within sequences
 - **Print Statements**: Debug and log messages during sequence execution
 - **Cookie Support**: Automatic cookie jar with persistence across requests
+- **Response Comparison**: Compare any two API responses side-by-side with VS Code's diff view
+- **Clickable JSON**: Click any JSON value in the response panel to auto-generate assertions
 - **Syntax Highlighting**: Full syntax highlighting for requests, headers, JSON bodies
 - **IntelliSense**: Autocomplete for HTTP methods, headers, variables, and keywords
 - **Diagnostics**: Error highlighting for undefined variables
@@ -606,6 +609,37 @@ sequence RateLimitedFlow
 end sequence
 ```
 
+### Retry and Backoff
+
+Automatically retry failed HTTP requests with configurable backoff:
+
+```bash
+sequence RetryExample
+    # Retry up to 3 times with 200ms linear backoff (200ms, 400ms, 600ms)
+    var result = GET "https://api.example.com/flaky-endpoint" retry 3 backoff 200 ms
+    
+    # Works with named endpoints from .nornapi files
+    var user = GET UserEndpoint retry 2 backoff 500 ms
+    
+    # Works with named requests
+    var data = run FlakyRequest retry 3 backoff 100 ms
+    
+    # Retry only (uses default 1 second backoff)
+    var simple = GET "https://api.example.com/status" retry 2
+end sequence
+```
+
+**Retries trigger on:**
+- 5xx server errors (500, 502, 503, etc.)
+- 429 rate limiting
+- Network failures and timeouts
+
+**Time units:**
+- `ms` or `milliseconds` - e.g., `backoff 200 ms`
+- `s` or `seconds` - e.g., `backoff 2 s`
+
+The response panel shows a retry indicator (🔄 retried 2x) when retries occurred.
+
 ### JSON File Loading
 
 Load test data from external JSON files:
@@ -710,6 +744,37 @@ end sequence
 
 Use `print "Title" | "Body content"` for expandable messages in the result view.
 
+### Response Panel Tools
+
+The response panel provides interactive tools that accelerate test development:
+
+#### Response Comparison
+
+Compare any two API responses side-by-side using VS Code's built-in diff view:
+
+1. Click **⇄ Compare** on the first response body
+2. Click **⇄ Compare** on the second response
+3. VS Code opens a diff view showing differences between the two responses
+
+This is useful for comparing responses across environments, before/after changes, or expected vs actual results.
+
+#### Clickable JSON Values
+
+Generate assertions instantly by clicking on JSON values in the response:
+
+1. Expand a response body in the panel
+2. Hover over any value (string, number, boolean, null) - it highlights with a **+** badge
+3. Click to automatically insert an assertion at the end of your sequence
+
+For example, clicking on `"active"` in `{"status": "active"}` generates:
+```bash
+assert $response.body.status == "active"
+```
+
+Works with nested paths and arrays:
+- `body.user.email` → `assert $user.body.user.email == "john@example.com"`
+- `body.items[0].id` → `assert $order.body.items[0].id == 123`
+
 ## CLI Usage
 
 Run tests from the command line for CI/CD pipelines. Only sequences marked with `test` are executed.