ultimatedarktower 2.1.1 → 2.1.2

package/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [2.1.2] - 2026-02-19
+
+### Fixed
+
+-   **ESM named imports broken** — `import { UltimateDarkTower } from 'ultimatedarktower'` previously threw `SyntaxError: The requested module does not provide an export named 'UltimateDarkTower'` in Node.js ESM projects because the `"import"` export condition pointed to the CommonJS build. The package now ships a true ES Module bundle so named imports work correctly.
+
+### Added
+
+-   **ESM build** (`dist/esm/index.mjs`) — a native ES Module bundle produced by esbuild, included in the published package alongside the existing CommonJS build
+
+### Changed
+
+-   `package.json` `exports["import"]` condition now points to `dist/esm/index.mjs` instead of the CommonJS output; `exports["require"]` is unchanged
+-   `package.json` `files` now includes `dist/esm/**/*`
+
+## [2.1.1] - 2026-02-19
+
+### Added
+
+-   Integration test for tower calibration using Node.js Bluetooth adapter, located in `tests/integration/calibration.integration.ts`
+-   `npm run test:integration` script to run integration tests requiring real hardware
+-   Integration tests are now organized under `tests/integration/` and are not run by default with unit tests or during publish
+
 ## [2.1.0] - 2026-02-19
 
 ### Added
@@ -56,6 +79,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 -   Tower Game ("The Tower's Challenge") example web app
 -   Complete API reference documentation
 
+[2.1.2]: https://github.com/ChessMess/UltimateDarkTower/compare/v2.1.1...v2.1.2
+[2.1.1]: https://github.com/ChessMess/UltimateDarkTower/compare/v2.1.0...v2.1.1
 [2.1.0]: https://github.com/ChessMess/UltimateDarkTower/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/ChessMess/UltimateDarkTower/compare/v1.0.0...v2.0.0
 [1.0.0]: https://github.com/ChessMess/UltimateDarkTower/releases/tag/v1.0.0

package/README.md

@@ -44,6 +44,7 @@ I have spent many hours reverse engineering the Tower's protocol in order to cre
 -   **Tower Control** - Complete control over lights, sounds, and drum rotation
 -   **Game State Tracking** - Track glyph positions, broken seals, and skull counts
 -   **Event System** - Callback-based event handling for tower events
+-   **ESM + CJS** - Ships both an ES Module build and a CommonJS build; works with `import` and `require` without configuration
 -   **TypeScript Support** - Full TypeScript definitions and type safety
 -   **Comprehensive Logging** - Multi-output logging system for debugging
 -   **Battery Monitoring** - Real-time battery level tracking and low battery warnings
@@ -143,6 +144,25 @@ Comprehensive documentation with TypeScript examples, best practices, and troubl
 -   **Best Practices** - Performance tips, error handling, and common patterns
 -   **Troubleshooting** - Solutions for common issues and debugging techniques
 
+## Integration Testing
+
+Integration tests that require real hardware are located in `tests/integration/` and are not run by default with the main test suite. These tests use the Node.js Bluetooth adapter and require a physical Return to Dark Tower device in range.
+
+To run the calibration integration test:
+
+```bash
+npm run test:integration
+```
+
+-   This will connect to the tower, perform a full calibration sequence, and print the resulting glyph positions.
+-   The test will fail if the tower is not available or calibration does not complete within 60 seconds.
+-   Integration tests are not included in automated test runs or npm publish.
+
+**Prerequisites:**
+
+-   Tower must be powered on and in Bluetooth range
+-   `@stoprocent/noble` must be installed (it is a peer dependency)
+
 ## Development
 
 ### Building and Testing