amaran-light-cli 1.10.0 → 1.11.0

package/docs/CHANGELOG.md

@@ -0,0 +1,134 @@
+## [1.11.0] - 2026-05-03
+
+- **Feature**: Added public library entrypoints for the root SDK, device control APIs, circadian scheduling utilities, command registration, and CLI embedding.
+- **Feature**: Made `ScheduleMaker` usable as a standalone library API without requiring full CLI dependency wiring.
+- **Fix**: Corrected `cct --get <device>` and `intensity --get <device>` so they target the named device instead of all lights.
+- **Docs**: Added README examples for importing and using the package as a library.
+- **Test**: Added package export smoke coverage and getter-targeting regression tests.
+
+## [1.9.0] - 2025-12-24
+
+- **Feature**: Consolidated all schedule-related commands (`print-schedule`, `graph-schedule`, `simulate-schedule`) under a unified `schedule` namespace:
+  - `schedule print`: Display a table of the day's circadian values.
+  - `schedule graph`: Generate a visual graph of the lighting curve.
+  - `schedule simulate`: Run a high-speed simulation of the schedule on your physical lights.
+- **Feature**: Added `-g, --get` support to `on`, `off`, `cct`, `hsi`, and `color` commands to retrieve current device status.
+- **Feature**: Enhanced `info` command to support all devices when no device name is provided.
+- **Feature**: Added privacy redaction for location data in service logs.
+- **Improvement**: Replaced `info device` with a more direct `info` command structure.
+- **Improvement**: Better alignment and formatting for CLI help output and auto-cct time display.
+- **Fix**: Resolved issue where HSI retrieval was failing or hanging.
+- **Fix**: Improved `schedule simulate` to ensure lights are turned on before starting the simulation.
+- **Fix**: Corrected intensity clamping logic for `auto-cct` with `maxLux` settings.
+
+## [1.8.1] - 2025-12-23
+
+- **Fix**: Resolved issue where max/min intensity boundaries were not being respected when `maxLux` setting was active.
+
+## [1.8.0] - 2025-12-22
+
+- **Feature**: Added global timestamp logging for service runs to improve traceability.
+- **Refactor**: Centralized curve data and metadata for better consistency across the CLI.
+- **Breaking Change**: Removed `intensityMultiplier` per-light configuration (superseded by `maxLux` mapping).
+- **Cleanup**: General codebase refactoring and type safety improvements.
+
+## [1.7.0] - 2025-12-21
+
+- **Feature**: Added Weather Modifiers (`--cloud-cover`, `--precipitation`) to `auto-cct` and schedule commands for realistic simulation of weather conditions.
+- **Feature**: Enhanced Max Lux Mapping to support CCT-dependent values and interpolation (e.g., `--max-lux "2700:8000, 5600:10000"`).
+- **Doc**: Comprehensive README updates including new weather and advanced max lux features.
+
+## [1.6.0] - 2025-12-21
+
+- **Feature**: Implemented Group Management commands (`create-group`, `delete-group`, `list-groups`, `group-control`).
+- **Feature**: Added Quickshot functionality (`quickshot`, `save-quickshot`, `delete-quickshot`, `list-quickshots`).
+- **Feature**: Added `lightOutput` parameter to sunlight curves for seasonal lux variation.
+- **Improvement**: Added `intensity` control to more device commands.
+- **Refactor**: Major refactoring of `lightControl` module for better maintainability.
+- **Refactor**: Moved `graphSchedule` logic to `daylightSimulation` directory.
+- **Fix**: Resolved CLI hang issues after device commands.
+- **Doc**: Updated API documentation and usage guides.
+
+## [1.5.0] - 2025-12-21
+
+- **Refactor**: Major architectural improvements and code reorganization.
+    - Centralized daylight simulation logic into `ScheduleMaker` and `Schedule` objects.
+    - Modularized CCT utilities into specialized sub-modules for better maintainability.
+    - Separated rendering logic into dedicated `textSchedule` and `graphSchedule` modules.
+    - Standardized device control commands using a shared execution utility.
+- **Feature**: Added `-C, --curves` option to specify subsets of curves in `print-schedule` and `graph-schedule`.
+- **Feature**: Added CSV export support to the `print-schedule` command.
+- **Improvement**: Optimized `graph-schedule` by automatically trimming inactive periods for cleaner visualization.
+- **Improvement**: Enhanced `print-schedule` table with shortened headers and better formatting for small terminals.
+- **Fix**: Resolved issue where the CLI would hang after executing device control commands.
+- **Fix**: Improved WebSocket connection management and closing logic.
+- **Chore**: Migrated to Biome for faster linting and formatting.
+- **Chore**: Integrated ESLint for better deprecation tracking in TypeScript.
+
+## [1.4.0] - 2025-12-15
+
+- **Feature**: Added `graph-schedule` command to generate visual graphs of the lighting schedule.
+
+## [1.3.6] - 2025-12-14
+
+- **Fix**: Updated workflow to use latest `npm` version for better OIDC support.
+
+## [1.3.5] - 2025-12-14
+
+- **Fix**: Re-applied `registry-url` configuration fix (previous attempt in v1.3.4 failed to update workflow).
+
+## [1.3.4] - 2025-12-14
+
+- **Fix**: Restored `registry-url` configuration (required for OIDC `ENEEDAUTH` fix).
+
+## [1.3.3] - 2025-12-14
+
+- **Fix**: Removed conflicting `registry-url` configuration to enable OIDC authentication.
+
+## [1.3.2] - 2025-12-14
+
+- **Fix**: Updated release workflow to use NPM Trusted Publishing (OIDC) instead of auth tokens.
+
+## [1.3.1] - 2025-12-14
+
+- **Fix**: Resolved timezone issue in integration tests causing CI failures.
+
+## [1.3.0] - 2025-12-14
+
+- **Breaking**: Migrated project to ESM (`type: module`).
+- **Breaking**: Migrated testing framework from Jest to Vitest.
+- **Feature**: Added `intensityMultiplier` support to `auto-cct`.
+- **Feature**: `auto-cct` command now accepts a device argument (defaults to 'all').
+- **Refactor**: Renamed `schedule` command to `print-schedule`.
+- **Fix**: Resolved `suncalc` import issues.
+- **Fix**: Improved CLI output styling for light mode terminals.
+- **Chore**: Comprehensive linting and formatting fixes.
+
+## [1.1.4] - 2025-11-02
+
+- test token config
+
+## [1.1.3] - 2025-11-02
+
+- curve config and refactors
+
+## [1.1.2] - 2025-11-01
+
+- Enhanced CLI help output and documentation
+
+## [1.1.0] - 2025-10-31
+
+- Added more curves for auto-cct
+- Improved schedule table display with all curves
+- Better range for start/stop times for curves
+- Added simulation of full day curve in seconds
+- Added auto-start for the desktop app if closed
+- Added more special times in schedule (e.g., Nautical Dawn)
+- Various tests and refactoring
+
+## [1.0.3] - 2025-10-30
+
+- Initial stable release with full CLI functionality
+- WebSocket control for Aputure Amaran lights
+- Auto-CCT circadian lighting feature
+- Service automation for continuous lighting adjustment

package/package.json

@@ -1,10 +1,32 @@
 {
   "name": "amaran-light-cli",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "type": "module",
   "description": "Command line tool for controlling Aputure Amaran lights via WebSocket to a local Amaran desktop app.",
-  "main": "dist/lightControl.js",
-  "types": "dist/lightControl.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./device-control": {
+      "types": "./dist/device-control.d.ts",
+      "import": "./dist/device-control.js"
+    },
+    "./circadian": {
+      "types": "./dist/circadian.d.ts",
+      "import": "./dist/circadian.js"
+    },
+    "./commands": {
+      "types": "./dist/commands-api.d.ts",
+      "import": "./dist/commands-api.js"
+    },
+    "./cli": {
+      "import": "./dist/cli.js"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "amaran-cli": "dist/cli.js"
   },
@@ -24,6 +46,9 @@
     "format:check": "biome format .",
     "check": "biome check .",
     "check:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "verify": "npm run check && npm run lint:deprecations && npm run build && npm test",
+    "prepare": "lefthook install",
     "release": "node scripts/release.js"
   },
   "files": [
@@ -31,7 +56,7 @@
     "scripts",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "docs/CHANGELOG.md"
   ],
   "repository": {
     "type": "git",
@@ -54,7 +79,7 @@
   "author": "Mahyar McDonald <github@hmmfn.com>",
   "license": "MIT",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=20.0.0"
   },
   "dependencies": {
     "chalk": "^5.3.0",
@@ -63,7 +88,8 @@
     "commander": "^14.0.0",
     "geoip-lite": "^1.4.10",
     "suncalc": "^1.9.0",
-    "ws": "^8.14.2"
+    "ws": "^8.14.2",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.8",
@@ -76,6 +102,7 @@
     "cheerio": "^1.1.2",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.2",
+    "lefthook": "^2.1.6",
     "node-localstorage": "^3.0.5",
     "tsx": "^4.7.1",
     "typescript": "^5.2.2",