# Changelog

All notable changes to js-message are documented here.

## Unreleased

## 3.1.1 - 2026-08-23

### Added

- A seven-scenario Behavioral suite for request/reply, object-transport, payload-free signal, diagnostic, long-lived receiver, cross-entry consumer, and native no-bundler journeys.
- Native Chrome evidence that the shared suite and playground resolve the bare `js-message` package import through explicit checked-in import maps.
- Packed-consumer metadata and dependency-tree assertions plus production and full npm audits in CI.

### Changed

- js-message works with bundlers and without a bundler. Bundlers resolve the bare package import normally; native browser ESM uses a standard import map with no build or transpilation step. Browser-facing documentation now provides the complete map, HTTP(S) serving requirements, and the unsupported `file://` boundary.
- Static documentation and deployment checks now protect import-map ordering, package mappings, CSP authorization, and the package's zero-runtime-dependency contract.

### Fixed

- The recovery playground recipe now sends genuinely malformed JSON and is executed in real Chrome to prove the observable error envelope and subsequent recovery.

## 3.1.0 - 2026-08-21

### Added

- An editable, time-limited GitHub Pages playground using the canonical checked-in module, with focused recipe pages and real-Chrome integration coverage.
- Unit, Functional, Integration, and Regression vanilla-test catalogs with unique case IDs and per-suite commands.
- Synchronous CommonJS loading from the same native ES-module source used by `import`.
- Reproducible 3.0-versus-3.1 benchmarks, accessible charts, recorded results, and focused Performance and Why pages.

### Changed

- The Node.js runtime floor is now 22.13.0, where synchronous `require(ESM)` no longer emits an experimental warning by default.
- Shared runtime requirements are divided into 76 smaller nonduplicated checks, plus eleven distinct Chrome-only playground checks.
- Packed-artifact verification now enforces the exact npm file set.
- Loading uses assignment semantics instead of a duplicate schema-validation pass, improving direct-object throughput while preserving native JSON behavior.

### Fixed

- Messages may once again omit `type`, `data`, or both; missing fields remain `undefined` instead of becoming error envelopes.

## 3.0.0 - 2026-08-16

### Added

- A canonical `index.js` entry with matching default and named `Message` exports.
- Constructor and `load()` support for existing `{ type, data }` objects.
- Compatibility parsing for Buffer, boxed strings, typed views, and other JSON-coercible text inputs accepted by earlier releases.
- A public `toJSON()` method for structured-clone transports and native `JSON.stringify` integration.
- A shared vanilla-test protocol suite for Node and real-browser coverage.
- Package compatibility, documentation, local-link, and packed-artifact verification.
- Focused, accessible GitHub Pages documentation for getting started, API, protocol, browsers, examples, testing, and migration.
- A generated three-to-one repository header and social preview.

### Changed

- Valid JSON values without own `type` and `data` keys now become error envelopes instead of silently producing undefined fields.
- The legacy browser-global implementation now matches the ES-module contract and targets `globalThis`.
- Package metadata uses an explicit file allowlist and supported export map while preserving both legacy deep paths.
- Local documentation serving no longer needs `node-http-server`.

### Fixed

- Serialized parse and validation errors now retain stable `name` and `message` fields when the preserved response is JSON-safe.
- The package lock metadata, scripts, homepage, description, and dependency classification now match `package.json`.
- Browser examples use valid closing script tags and standard WebSocket event APIs.

## 2.1.0 - 2024-01-11

### Changed

- Updated the ES-module release after a message-loading behavior correction.

## 2.0.1 - 2024-01-11

### Fixed

- Corrected README and package-root documentation details.

## 2.0.0 - 2024-01-11

### Changed

- Converted the package to native ES modules for Node.js and browsers.