changelog.md for @serve.zone/nupst

2026-03-30 - 5.4.1 - fix(deps)

bump tsdeno and net-snmp patch dependencies

• update @git.zone/tsdeno from ^1.2.0 to ^1.3.1
• update net-snmp import from 3.26.0 to 3.26.1 in the SNMP manager

2026-03-30 - 5.4.0 - feat(snmp)

add configurable SNMP runtime units with v4.3 migration support

• Adds explicit runtimeUnit support for SNMP devices with minutes, seconds, and ticks options.
• Updates runtime processing to prefer configured units over UPS model heuristics.
• Introduces a v4.2 to v4.3 migration that populates runtimeUnit for existing SNMP device configs based on upsModel.
• Extends the CLI setup and device summary output to configure and display the selected runtime unit.
• Updates default config version to 4.3 and documents the new SNMP runtime unit setting in the README.

2026-03-18 - 5.3.3 - fix(deps)

add @git.zone/tsdeno as a development dependency

• Adds @git.zone/tsdeno@^1.2.0 to devDependencies in package.json.

2026-03-18 - 5.3.2 - fix(build)

replace manual release compilation workflows with tsdeno-based build configuration

• removes obsolete CI and npm publish workflows
• switches the Deno compile task to use tsdeno
• adds reusable multi-platform compile targets in npmextra.json
• updates the release workflow to install Node.js and pnpm before building binaries
• deletes the custom compile-all.sh script in favor of centralized build tooling

2026-03-15 - 5.3.1 - fix(cli)

rename the update command references to upgrade across the CLI and documentation

• Updates command parsing and help output to use upgrade instead of update.
• Revises user-facing upgrade prompts in daemon, systemd, and runtime status messages.
• Aligns README and command migration documentation with the renamed command.

2026-02-20 - 5.3.0 - feat(daemon)

Add UPSD (NUT) protocol support, Proxmox VM shutdown action, pause/resume monitoring, and network-loss/unreachable handling; bump config version to 4.2

• Add UPSD client (ts/upsd) and ProtocolResolver (ts/protocol) to support protocol-agnostic UPS queries (snmp or upsd).
• Introduce new TProtocol and IUpsdConfig types, wire up Nupst to initialize & expose UPSD client, and route status requests through ProtocolResolver.
• Add 'unreachable' TPowerStatus plus consecutiveFailures and unreachableSince tracking; mark UPS as unreachable after NETWORK.CONSECUTIVE_FAILURE_THRESHOLD failures and suppress shutdown actions while unreachable.
• Implement pause/resume feature: PAUSE.FILE_PATH state file, CLI commands (pause/resume), daemon pause-state polling, auto-resume, and include pause state in HTTP API responses.
• Add ProxmoxAction (ts/actions/proxmox-action.ts) with Proxmox API interaction, configuration options (token, node, timeout, force, insecure) and CLI prompts to configure proxmox actions.
• CLI and UI updates: protocol selection when adding UPS, protocol/host shown in lists, action details column supports proxmox, and status displays include protocol and unreachable state.
• Add migration MigrationV4_1ToV4_2 to set protocol:'snmp' for existing devices and bump config.version to '4.2'.
• Add new constants (NETWORK, UPSD, PAUSE, PROXMOX), update package.json scripts (test/build/lint/format), and wire protocol support across daemon, systemd, http-server, and various handlers.

2026-01-29 - 5.2.4 - fix()

no changes

• No files changed in the provided git diff; no commit or version bump required.

2026-01-29 - 5.2.3 - fix(core)

fix lint/type issues and small refactors

• Add missing node:process imports in bin and scripts to ensure process is available
• Remove unused imports and unused type imports (e.g. writeFileSync, IActionConfig) to reduce noise
• Make some methods synchronous (service update, webhook call) to match actual usage
• Tighten SNMP typings and linting: added deno-lint-ignore comments, renamed unused params with leading underscore, and use as const for securityLevel fallbacks
• Improve error handling variable naming in systemd (use error instead of _error)
• Annotate ANSI regex with deno-lint-ignore no-control-regex and remove unused color/symbol imports across CLI/daemon/logger

2026-01-29 - 5.2.2 - fix(core)

tidy formatting and minor fixes across CLI, SNMP, HTTP server, migrations and packaging

• Normalize import ordering and improve logger/string formatting across many CLI handlers, daemon, systemd, actions and tests
• Apply formatting tidies: trailing commas, newline fixes, and more consistent multiline strings
• Allow BaseMigration methods to return either sync or async results (shouldRun/migrate signatures updated)
• Improve SNMP manager and HTTP server logging/error messages and tighten some typings (raw SNMP types, server error typing)
• Small robustness and messaging improvements in npm installer and wrapper (platform/arch mapping, error outputs)
• Update tests and documentation layout/formatting for readability

2026-01-29 - 5.2.1 - fix(cli(ups-handler), systemd)

add type guards and null checks for UPS configs; improve SNMP handling and prompts; guard version display

• Introduce a type guard ('id' in config && 'name' in config) to distinguish IUpsConfig from legacy INupstConfig and route fields (snmp, checkInterval, name, id) accordingly.
• displayTestConfig now handles missing SNMP by logging 'Not configured' and returning, computes checkInterval/upsName/upsId correctly, and uses groups only for true UPS configs.
• testConnection now safely derives snmpConfig for both config types, throws if SNMP is missing, and caps test timeout to 10s for probes.
• Clear auth/priv credentials by setting undefined (instead of empty strings) when disabling security levels to avoid invalid/empty string values.
• Expanded customOIDs to include OUTPUT_LOAD, OUTPUT_POWER, OUTPUT_VOLTAGE, OUTPUT_CURRENT with defaults; trim prompt input and document RFC 1628 fallbacks.
• systemd.displayVersionInfo: guard against missing nupst (silent return) and avoid errors when printing version info; use ignored catch variables for clarity.

2026-01-29 - 5.2.0 - feat(core)

Centralize timeouts/constants, add CLI prompt helpers, and introduce webhook/script actions with safety and SNMP refactors

• Add ts/constants.ts to centralize timing, SNMP, webhook, script, shutdown and UI constants and replace magic numbers across the codebase
• Introduce helpers/prompt.ts with createPrompt() and withPrompt() and refactor CLI handlers to use these helpers (cleaner prompt lifecycle)
• Add webhook action support: ts/actions/webhook-action.ts, IWebhookPayload type, and export from ts/actions/index.ts
• Enhance ShutdownAction safety checks (only trigger onBattery, stricter transition rules) and use constants/UI widths for displays
• Refactor SNMP manager to use logger instead of console, pull SNMP defaults from constants, improved debug output, and add INupstAccessor interface to break circular dependency (Nupst now implements the interface)
• Update many CLI and core types (stronger typing for configs/actions), expand tests and update README and npmextra.json to document new features

2025-11-09 - 5.1.11 - fix(readme)

Update README installation instructions to recommend automated installer script and clarify npm installation

• Replace the previous 'Via npm (NEW! - Recommended)' section with a clear 'Automated Installer Script (Recommended)' section and example curl installer.
• Move npm installation instructions into an 'Alternative: Via npm' subsection and clarify that the npm package downloads the appropriate pre-compiled binary for the platform during installation.
• Remove the 'NEW!' badge and streamline notes about binary downloads and installation methods.

2025-10-23 - 5.1.10 - fix(config)

Synchronize deno.json version with package.json, tidy formatting, and add local tooling settings

• Bumped deno.json version to 5.1.9 to match package.json/commitinfo
• Reformatted deno.json arrays (lint, fmt, compilerOptions) for readability
• Added .claude/settings.local.json for local development/tooling permissions (no runtime behaviour changes)

2025-10-23 - 5.1.9 - fix(dev)

Add local assistant permissions/settings file (.claude/settings.local.json)

• Added .claude/settings.local.json containing local assistant permission configuration used for development tasks (deno check, deno lint/format, npm/pack, running packaged binaries, etc.)
• This is a development/local configuration file and does not change runtime behavior or product code paths
• Patch version bump recommended

2025-10-23 - 5.1.2 - fix(scripts)

Add build script to package.json and include local dev tool settings

• Add a 'build' script to package.json (no-op placeholder) to provide an explicit build step
• Minor scripts section formatting tidy in package.json
• Add a hidden local settings file for development tooling permissions to the repository (local-only configuration)

2025-10-23 - 5.1.1 - fix(tooling)

Add .claude/settings.local.json with local automation permissions

• Add .claude/settings.local.json to specify allowed permissions for local automated tasks
• Grants permissions for various developer/CI actions (deno check/lint/fmt, npm/npm pack, selective Bash commands, WebFetch to docs.deno.com and code.foss.global, and file/read/replace helpers)
• This is a developer/local tooling config only and does not change runtime code or package behavior

2025-10-22 - 5.1.0 - feat(packaging)

Add npm packaging and installer: wrapper, postinstall downloader, publish workflow, and packaging files

• Add package.json (v5.0.5) and npm packaging metadata to publish @serve.zone/nupst
• Include a small Node.js wrapper (bin/nupst-wrapper.js) to execute platform-specific precompiled binaries
• Add postinstall script (scripts/install-binary.js) that downloads the correct binary for the current platform and sets executable permissions
• Add GitHub Actions workflow (.github/workflows/npm-publish.yml) to build binaries, pack and publish to npm, and create releases
• Add .npmignore to keep source, tests and dev files out of npm package; keep only runtime installer and wrapper
• Move example action script into docs (docs/example-action.sh) and remove the top-level example-action.sh
• Include generated npm package artifact (serve.zone-nupst-5.0.5.tgz) and npmextra.json

2025-10-18 - 4.0.0 - BREAKING CHANGE(core): Complete migration to Deno runtime

MAJOR RELEASE: NUPST v4.0 is a complete rewrite powered by Deno

This release fundamentally changes NUPST's architecture from Node.js-based to Deno-based, distributed as pre-compiled binaries. This is a breaking change in terms of installation and distribution, but configuration files from v3.x are fully compatible.

Breaking Changes

Installation & Distribution:

• Removed: Node.js runtime dependency - NUPST no longer requires Node.js
• Removed: npm package distribution (no longer published to npmjs.org)
• Removed: bin/nupst wrapper script
• Removed: setup.sh dependency installation
• Removed: All Node.js-related files (package.json, tsconfig.json, pnpm-lock.yaml, npmextra.json)
• Changed: Installation now downloads pre-compiled binaries instead of cloning repository
• Changed: Binary-based distribution (~340MB self-contained executables)

CLI Structure (Backward Compatible):

• Changed: Commands now use subcommand structure (e.g., nupst service enable instead of nupst enable)
• Maintained: Old command format still works with deprecation warnings for smooth migration
• Added: Aliases for common commands (nupst ls, nupst rm)

New Features

Distribution & Installation:

• Pre-compiled binaries for 5 platforms:
  • Linux x86_64
  • Linux ARM64
  • macOS x86_64 (Intel)
  • macOS ARM64 (Apple Silicon)
  • Windows x86_64
• Automated binary releases via Gitea Actions
• SHA256 checksum verification for all releases
• Installation from Gitea releases via updated install.sh
• Zero dependencies - completely self-contained binaries
• Cross-platform compilation from single codebase

CI/CD Automation:

• Gitea Actions workflows for continuous integration
• Automated release workflow triggered by git tags
• Automatic binary compilation for all platforms on release
• Type checking and linting in CI pipeline
• Build verification on every push

CLI Improvements:

• New hierarchical command structure with subcommands
• nupst service - Service management (enable, disable, start, stop, restart, status, logs)
• nupst ups - UPS device management (add, edit, remove, list, test)
• nupst group - Group management (add, edit, remove, list)
• nupst config show - Display configuration
• nupst --version - Show version information
• Better help messages organized by category
• Backward compatibility maintained with deprecation warnings

Technical Improvements:

• Deno runtime for modern TypeScript/JavaScript execution
• Native TypeScript support without compilation step
• Faster startup and execution compared to Node.js
• Smaller memory footprint
• Built-in permissions system
• No build step required for development

Migration Guide

For Users:

1. Stop existing v3.x service: sudo nupst disable
2. Install v4.0 using new installer: curl -sSL https://code.foss.global/serve.zone/nupst/raw/branch/main/install.sh | sudo bash -s -- -y
3. Your configuration at /etc/nupst/config.json is preserved and fully compatible
4. Enable service with new CLI: sudo nupst service enable && sudo nupst service start
5. Update systemd commands to use new syntax (old syntax still works with warnings)

Configuration Compatibility:

• All configuration files from v3.x work without modification
• No changes to /etc/nupst/config.json format
• All SNMP settings, thresholds, and group configurations preserved

Command Mapping:

# Old (v3.x)              → New (v4.0)
nupst enable              → nupst service enable
nupst disable             → nupst service disable
nupst start               → nupst service start
nupst stop                → nupst service stop
nupst status              → nupst service status
nupst logs                → nupst service logs
nupst add                 → nupst ups add
nupst edit [id]           → nupst ups edit [id]
nupst delete <id>         → nupst ups remove <id>
nupst list                → nupst ups list
nupst test                → nupst ups test
nupst group add           → nupst group add (unchanged)
nupst group edit <id>     → nupst group edit <id> (unchanged)
nupst group delete <id>   → nupst group remove <id>
nupst group list          → nupst group list (unchanged)
nupst config              → nupst config show

Technical Details

Commit History:

• df6a44d: Complete migration with Gitea Actions workflows and install.sh updates
• 9efcc4b: CLI reorganization with subcommand structure
• 5903ae7: Cross-platform compilation scripts
• a649c59: Deno migration with npm: and node: specifiers
• 5f4f3ec: Initial migration to Deno

Files Changed:

• Removed: 11 files (package.json, tsconfig.json, pnpm-lock.yaml, npmextra.json, bin/nupst, setup.sh)
• Added: 3 Gitea Actions workflows (ci.yml, release.yml, README.md)
• Modified: 14 TypeScript files for Deno compatibility
• Updated: install.sh, .gitignore, readme.md
• Net reduction: -10,242 lines (93% reduction in repository size)

Dependencies:

• Runtime: Deno v1.x (bundled in binary, no installation required)
• SNMP: npm:net-snmp@3.20.0 (bundled in binary via npm: specifier)
• Node.js built-ins: Accessed via node: specifier (node:fs, node:child_process, etc.)

Benefits

For Users:

• Faster Installation: Download single binary instead of cloning repo + installing Node.js + npm dependencies
• Zero Dependencies: No Node.js or npm required on target system
• Smaller Footprint: Single binary vs repo + Node.js + node_modules
• Easier Updates: Download new binary instead of git pull + npm install
• Better Security: No npm supply chain risks, binary checksums provided
• Platform Support: Official binaries for all major platforms

For Developers:

• Modern Tooling: Native TypeScript support without build configuration
• Faster Development: No compilation step during development
• CI/CD Automation: Automated releases and testing
• Cleaner Codebase: 93% reduction in configuration files
• Cross-Platform: Compile for all platforms from any platform

Known Issues

• Windows ARM64 not supported (Deno limitation)
• Binary sizes are larger (~340MB) due to bundled runtime (trade-off for zero dependencies)
• First-time execution may be slower on some systems (binary extraction)

Acknowledgments

This release represents a complete modernization of NUPST's infrastructure while maintaining full backward compatibility for user configurations. Special thanks to the Deno team for creating an excellent runtime that made this migration possible.

---

2025-03-28 - 3.1.2 - fix(cli/ups-handler)

Improve UPS device listing table formatting for better column alignment

• Adjusted header spacing for the Host column and overall table alignment in the UPS handler output.

2025-03-28 - 3.1.1 - fix(cli)

Improve table header formatting in group and UPS listings

• Adjusted column padding in group listing for proper alignment
• Fixed UPS table header spacing for consistent CLI output

2025-03-28 - 3.1.0 - feat(cli)

Refactor CLI commands to use dedicated handlers for UPS, group, and service management

• Extracted UPS-related CLI logic into a new UpsHandler
• Introduced GroupHandler to manage UPS groups commands
• Added ServiceHandler for systemd service operations
• Updated CLI routing in cli.ts to delegate commands to the new handlers
• Exposed getters for the new handlers in the Nupst class

2025-03-28 - 3.0.1 - fix(cli)

Simplify UPS ID generation by removing the redundant promptForUniqueUpsId function in the CLI module and replacing it with the shortId helper.

• Deleted the unused promptForUniqueUpsId method from ts/cli.ts.
• Updated UPS configuration to generate a unique ID directly using helpers.shortId().
• Improved code clarity by removing unnecessary interactive prompts for UPS IDs.

2025-03-28 - 3.0.0 - BREAKING CHANGE(core)

Add multi-UPS support and group management; update CLI, configuration and documentation to support multiple UPS devices with group modes

• Implemented multi-UPS configuration with an array of UPS devices and groups in the configuration file
• Added group management commands (group add, edit, delete, list) with redundant and non-redundant modes
• Revamped CLI command parsing for UPS management (add, edit, delete, list, setup) and group subcommands
• Updated readme and documentation to reflect new configuration structure and features
• Enhanced logging and status display for multiple UPS devices

2025-03-26 - 2.6.17 - fix(logger)

Preserve logbox width after logBoxEnd so that subsequent logBoxLine calls continue using the set width.

• Removed the reset of currentBoxWidth in logBoxEnd to allow persistent width across logbox calls.
• Ensures that logBoxLine uses the previously set width when no new width is provided.

2025-03-26 - 2.6.16 - fix(cli)

Improve CLI logging consistency by replacing direct console output with unified logger calls.

• Replaced console.log and console.error with logger.log and logger.error in CLI commands
• Standardized debug, error, and status messages using logger's logbox utilities
• Enhanced consistency of log output throughout the ts/cli.ts file

2025-03-26 - 2.6.15 - fix(logger)

Replace direct console logging with unified logger interface for consistent formatting

• Substitute console.log, console.error, and related calls with logger methods in cli, daemon, systemd, nupst, and index modules
• Integrate logBox formatting for structured output and consistent log presentation
• Update test expectations in test.logger.ts to check for standardized error messages
• Refactor logging calls throughout the codebase for improved clarity and maintainability

2025-03-26 - 2.6.14 - fix(systemd)

Shorten closing log divider in systemd service installation output for consistent formatting.

• Replaced the overly long footer with a shorter one in ts/systemd.ts.
• This change improves log readability without affecting functionality.

2025-03-26 - 2.6.13 - fix(cli)

Fix CLI update output box formatting

• Adjusted the closing box line in the update process log messages for consistent visual formatting

2025-03-26 - 2.6.12 - fix(systemd)

Adjust logging border in systemd service installation output

• Updated the closing border line for consistent output formatting in ts/systemd.ts

2025-03-26 - 2.6.11 - fix(cli, systemd)

Adjust log formatting for consistent output in CLI and systemd commands

• Fixed spacing issues in service installation and status log messages in the systemd module.
• Revised output formatting in the CLI to improve message clarity.

2025-03-26 - 2.6.10 - fix(daemon)

Adjust console log box formatting for consistent output in daemon status messages

• Updated closing box borders to align properly in configuration error, periodic updates, and UPS status logs
• Improved visual consistency in log messages

2025-03-26 - 2.6.9 - fix(cli)

Improve console output formatting for status banners and logging messages

• Standardize banner messages in daemon status updates
• Refine version information banner in nupst logging
• Update UPS connection and status banners in systemd

2025-03-26 - 2.6.8 - fix(cli)

Improve CLI formatting, refine debug option filtering, and remove unused dgram import in SNMP manager

• Standardize whitespace and formatting in ts/cli.ts for consistency
• Refine argument filtering for debug mode and prompt messages
• Remove unused 'dgram' import from ts/snmp/manager.ts

2025-03-26 - 2.6.7 - fix(setup.sh)

Clarify net-snmp dependency installation message in setup.sh

• Updated echo statement to indicate installation of net-snmp along with 2 subdependencies
• Improves clarity on dependency installation during setup

2025-03-26 - 2.6.6 - fix(setup.sh)

Improve setup script to detect and execute npm-cli.js directly using the Node.js binary

• Replace use of the npm binary with direct execution of npm-cli.js
• Add fallback logic to locate npm-cli.js when not found at the expected path
• Simplify cleanup by removing unnecessary PATH modifications

2025-03-26 - 2.6.5 - fix(daemon, setup)

Improve shutdown command detection and fallback logic; update setup script to use absolute Node/npm paths

• Use execFileAsync to execute shutdown commands reliably
• Add multiple fallback alternatives for shutdown and emergency shutdown handling
• Update setup.sh to log the Node and NPM versions using absolute paths without modifying PATH

2025-03-26 - 2.6.4 - fix(setup)

Improve installation process in setup script by cleaning up package files and ensuring a minimal net-snmp dependency installation.

• Remove existing package-lock.json along with node_modules to prevent stale artifacts.
• Back up the original package.json before modifying it.
• Create a minimal package.json with only the net-snmp dependency based on the backed-up version.
• Use a clean install to guarantee that only net-snmp is installed.
• Restore the original package.json if the installation fails.

2025-03-26 - 2.6.3 - fix(setup)

Update setup script to install only net-snmp dependency and create a minimal package-lock.json for better dependency control.

• Removed full production dependency install in favor of installing only net-snmp@3.20.0
• Added verification step to confirm net-snmp installation
• Generate a minimal package-lock.json if one does not exist

2025-03-26 - 2.6.2 - fix(setup/readme)

Improve force update instructions and dependency installation process in setup.sh and readme.md

• Clarify force update commands with explicit paths in readme.md
• Remove existing node_modules before installing dependencies in setup.sh
• Switch from 'npm ci --only=production' to 'npm install --omit=dev' with updated error instructions

2025-03-26 - 2.6.1 - fix(setup)

Update setup.sh to temporarily add vendor Node.js binary to PATH for dependency installation, log Node and npm versions, and restore the original PATH afterwards.

• Temporarily prepend vendor Node.js binary directory to PATH to ensure proper npm execution.
• Log Node.js and npm versions for debugging purposes.
• Restore the original PATH after installing dependencies.

2025-03-26 - 2.6.0 - feat(setup)

Add --force update flag to setup script and update installation instructions

• Implemented --force option in setup.sh to force-update Node.js binary and dependencies
• Updated readme.md to document the --force flag and revised update steps
• Modified ts/cli.ts update command to pass the --force flag to setup.sh

2025-03-26 - 2.5.2 - fix(installer)

Improve Node.js binary detection, dependency management, and SNMPv3 fallback logic

• Enhanced bin/nupst to detect OS and architecture (Linux and Darwin) and fall back to system Node.js for unsupported platforms
• Moved net-snmp from devDependencies to dependencies in package.json
• Updated setup.sh to install production dependencies and handle installation errors gracefully
• Refined SNMPv3 user configuration and fallback mechanism in ts/snmp/manager.ts
• Revised README to clarify minimal runtime dependencies and secure SNMP features

2025-03-25 - 2.5.1 - fix(snmp)

Fix Eaton UPS support by updating power status OID and adjusting battery runtime conversion.

• Updated Eaton UPS power status OID to '1.3.6.1.4.1.534.1.4.4.0' to correctly detect online/battery status.
• Added conversion for Eaton UPS battery runtime from seconds to minutes in SNMP manager.

2025-03-25 - 2.5.0 - feat(cli)

Automatically restart running NUPST service after configuration changes in interactive setup

• Added restartServiceIfRunning() to check and restart the service if it's active.
• Invoked the restart function post-setup to apply configuration changes immediately.

2025-03-25 - 2.4.8 - fix(installer)

Improve Git dependency handling and repository cloning in install.sh

• Add explicit check for git installation and prompt the user interactively if git is missing.
• Auto-install git when '-y' flag is provided in non-interactive mode.
• Ensure proper cloning of the repository when running the installer outside the repo.

2025-03-25 - 2.4.7 - fix(readme)

Update installation instructions to combine download and execution into a single command for clarity

• Method 1 now uses a unified one-line command to download and run the install script

2025-03-25 - 2.4.6 - fix(installer)

Improve installation instructions for interactive and non-interactive setups

• Changed install.sh to require explicit download of the install script and updated error messages for non-interactive modes
• Updated readme.md to include three distinct installation methods with clear command examples

2025-03-25 - 2.4.5 - fix(install)

Improve interactive terminal detection and update installation instructions

• Enhanced install.sh to better detect non-interactive environments and provide clearer guidance for both interactive and non-interactive installations
• Updated README.md quick install instructions to recommend process substitution and clarify auto-yes usage

2025-03-25 - 2.4.4 - fix(install)

Improve interactive mode detection and non-interactive installation handling in install.sh

• Detect and warn when running without a controlling terminal
• Attempt to use /dev/tty for user input when possible
• Update prompts and error messages for auto-installation of dependencies
• Clarify installation instructions in readme for interactive and non-interactive modes

2025-03-25 - 2.4.3 - fix(readme)

Update Quick Install command syntax in readme for auto-yes installation

• Changed installation command to use: curl -sSL https://code.foss.global/serve.zone/nupst/raw/branch/main/install.sh | sudo bash -c "bash -s -- -y"

2025-03-25 - 2.4.2 - fix(daemon)

Refactor shutdown initiation logic in daemon by moving the initiateShutdown and monitorDuringShutdown methods from the SNMP manager to the daemon, and update calls accordingly

• Moved initiateShutdown and monitorDuringShutdown to the daemon class for improved cohesion
• Updated references in the daemon to call its own shutdown method instead of the SNMP manager
• Removed redundant initiateShutdown method from the SNMP manager

2025-03-25 - 2.4.1 - fix(docs)

Update readme with detailed legal and trademark guidance

• Clarified legal section by adding trademark and company information
• Ensured users understand that licensing terms do not imply endorsement by the company

2025-03-25 - 2.4.0 - feat(installer)

Add auto-yes flag to installer and update installation documentation

• Enhance install.sh to parse -y/--yes and -h/--help options, automating git installation when auto-yes is provided
• Improve user prompts for dependency installation and provide clearer instructions
• Update readme.md to document new installer options and enhanced file system and service changes details

2025-03-25 - 2.3.0 - feat(installer/cli)

Add OS detection and git auto-installation support to install.sh and improve service setup prompt in CLI

• Implemented helper functions in install.sh to detect OS type and automatically install git if missing
• Prompt user for git installation if not present before cloning the repository
• Enhanced CLI service setup flow to offer starting the NUPST service immediately after installation

2025-03-25 - 2.2.0 - feat(cli)

Add 'config' command to display current configuration and update CLI help

• Introduce new 'config' command to show SNMP settings, thresholds, and configuration file location
• Update help text to include details for 'nupst config' command

2025-03-25 - 2.1.0 - feat(cli)

Add uninstall command to CLI and update shutdown delay for graceful VM shutdown

• Implement uninstall command in ts/cli.ts that locates and executes uninstall.sh with user prompts
• Update uninstall.sh to support environment variables for configuration and repository removal
• Increase shutdown delay in ts/snmp/manager.ts from 1 minute to 5 minutes to allow VMs more time to shut down

2025-03-25 - 2.0.1 - fix(cli/systemd)

Fix status command to pass debug flag and improve systemd status logging output

• ts/cli.ts: Now extracts debug options from process arguments and passes debug mode to getStatus.
• ts/systemd.ts: Updated getStatus to accept a debugMode parameter, enabling detailed SNMP debug logging, explicitly reloading configuration, and printing connection details.

2025-03-25 - 2.0.0 - BREAKING CHANGE(snmp)

refactor: update SNMP type definitions and interface names for consistency

• Renamed SnmpConfig to ISnmpConfig, OIDSet to IOidSet, UpsStatus to IUpsStatus, and UpsModel to TUpsModel in ts/snmp/types.ts.
• Updated internal references in ts/daemon.ts, ts/snmp/index.ts, ts/snmp/manager.ts, ts/snmp/oid-sets.ts, ts/snmp/packet-creator.ts, and ts/snmp/packet-parser.ts to use the new interface names.

2025-03-25 - 1.10.1 - fix(systemd/readme)

Improve README documentation and fix UPS status retrieval in systemd service

• Updated README features and installation instructions to clarify SNMP version support, UPS models, and configuration
• Modified default SNMP host to '192.168.1.100' and added 'upsModel' property in configuration examples
• Enhanced instructions for real-time log viewing and update process in README
• Fixed systemd.ts to use a test configuration with an appropriate timeout when fetching UPS status

2025-03-25 - 1.10.0 - feat(core)

Add update checking and version logging across startup components

• In daemon.ts, log version info on startup and check for updates in the background using npm registry response
• In nupst.ts, implement getVersion, checkForUpdates, getUpdateStatus, and compareVersions functions with update notifications
• Establish bidirectional reference between Nupst and NupstSnmp to support version logging
• Update systemd service status output to include version information

2025-03-25 - 1.9.0 - feat(cli)

Add update command to CLI to update NUPST from repository and refresh the systemd service

• Integrate 'update' subcommand in CLI command parser
• Update documentation and help output to include new command
• Implement update process that fetches changes from git, runs install.sh/setup.sh, and refreshes systemd service if installed

2025-03-25 - 1.8.2 - fix(cli)

Refactor logs command to use child_process spawn for real-time log tailing

• Replaced execSync call with spawn to properly follow logs
• Forward SIGINT to the spawned process for graceful termination
• Await the child process exit to ensure clean shutdown of the CLI log command

2025-03-25 - 1.8.1 - fix(systemd)

Update ExecStart in systemd service template to use /opt/nupst/bin/nupst for daemon startup

• Changed ExecStart from '/usr/bin/nupst daemon-start' to '/opt/nupst/bin/nupst daemon-start' in the systemd service file
• Ensures the service uses the correct binary installation path

2025-03-25 - 1.8.0 - feat(core)

Enhance SNMP module and interactive CLI setup for UPS shutdown

• Refactored SNMP packet parsing and encoding utilities for clearer error handling and debugging
• Improved systemd service management with detailed logging during installation and control
• Enhanced interactive CLI setup process for configuring SNMP settings and UPS models
• Expanded test coverage with simulated SNMP responses for various response types

2025-03-25 - 1.7.6 - fix(core)

Refactor SNMP, systemd, and CLI modules to improve error handling, logging, and code clarity

• Removed unused dependency 'net-snmp' from package.json
• Extracted helper functions for SNMP packet creation and parsing (using SnmpEncoder, SnmpPacketCreator and SnmpPacketParser)
• Improved debug logging and added detailed documentation comments across SNMP, systemd, CLI and daemon modules
• Refactored systemd service management to extract status display and service disabling logic
• Updated test suite to use proper modular methods from the new SNMP utilities

2025-03-25 - 1.7.5 - fix(cli)

Enable SNMP debug mode in CLI commands and update debug flag handling in daemon-start and test; bump version to 1.7.4

• Call enableDebug() on SNMP client earlier in command parsing
• Pass debug flag to 'daemon-start' and 'test' commands for consistent debug output
• Update package version from 1.7.3 to 1.7.4

2025-03-25 - 1.7.3 - fix(SNMP)

Refine SNMP packet creation and response parsing for more reliable UPS status monitoring

• Improve error handling and fallback logic when parsing SNMP responses
• Optimize TimeTicks conversion for CyberPower UPS devices
• Enhance test coverage for various UPS scenarios

2025-03-25 - 1.7.2 - fix(core)

Refactor internal SNMP response parsing and enhance daemon logging for improved error reporting and clarity.

• Improved fallback and error handling in SNMP response parsing
• Enhanced logging messages in daemon and systemd service management
• Minor refactoring for better maintainability without functional changes

2025-03-25 - 1.7.1 - fix(snmp-cli)

Improve SNMP response parsing and CLI UPS connection timeout handling

• Expand parsing loop in SNMP responses to capture Gauge32 and Timeticks values
• Add detailed debug logging for both SNMP v1/v2 and v3 responses
• Configure CLI test commands to use a shortened timeout for UPS connection tests

2025-03-25 - 1.7.0 - feat(SNMP/UPS)

Add UPS model selection and custom OIDs support to handle different UPS brands

• Introduce distinct OID sets for CyberPower, APC, Eaton, TrippLite, Liebert, and a custom option
• Update interactive setup to prompt for UPS model selection and custom OID entry when needed
• Refactor SNMP status retrieval to dynamically select the appropriate OIDs based on the configured UPS model
• Extend default configuration with an upsModel property for consistent behavior

2025-03-25 - 1.6.0 - feat(cli,snmp)

Enhance debug logging and add debug mode support in CLI and SNMP modules

• Enable debug flags (--debug, -d) in CLI to trigger detailed SNMP logging
• Pass debug mode options to daemonStart and test commands for improved diagnostics
• Add enableDebug method to the SNMP module for on-demand debug logging
• Improve timeout and discovery logging details for streamlined troubleshooting

2025-03-25 - 1.5.0 - feat(cli)

Enhance CLI output: display SNMPv3 auth/priv details and support timeout customization during setup

• Display authentication and privacy protocol details when SNMP version is 3
• Show timeout value in the configuration test output
• Clear out unused authentication or privacy settings based on selected security level
• Allow users to customize SNMP timeout during interactive setup

2025-03-25 - 1.4.1 - fix(version)

Bump patch version for consistency with commit info

2025-03-25 - 1.4.0 - feat(snmp)

Implement native SNMPv3 support with simulated encryption and enhanced authentication handling.

• Add fully native SNMPv3 GET request implementation replacing the snmpwalk fallback
• Simulate encryption for authPriv using AES and DES protocols
• Enhance SNMP response parser to properly handle SNMPv3 responses
• Introduce detailed security parameter management for SNMPv3

2025-03-25 - 1.3.1 - fix(cli)

Remove redundant SNMP tools checks in CLI and Systemd modules

• Eliminate unnecessary snmpwalk dependency checks in the test command and interactive setup flow.
• Adjust systemd configuration file check to avoid external dependency verification.

2025-03-25 - 1.3.0 - feat(cli)

add test command to verify UPS SNMP configuration and connectivity

• Introduce a new 'test' command in the CLI to check the SNMP configuration and UPS connection.
• Validate installation of SNMP tools and configuration file before testing.
• Output UPS status details and compare against defined shutdown thresholds.

2025-03-25 - 1.2.6 - fix(cli)

Refactor interactive setup to use dynamic import for readline and ensure proper cleanup

• Replaced synchronous require() with async import for ESM compatibility
• Wrapped interactive setup in try/finally to guarantee readline interface closure
• Enhanced error logging by outputting error.message

2025-03-25 - 1.2.5 - fix(error-handling)

Improve error handling in CLI, daemon, and systemd lifecycle management with enhanced logging for configuration issues

• Wrap daemon and service start commands in try-catch blocks to properly handle and log errors
• Throw explicit errors when configuration file is missing instead of silently defaulting
• Enhance log messages for service installation, startup, and status retrieval for clearer debugging

2025-03-25 - 1.2.4 - fix(cli/daemon)

Improve logging and user feedback in interactive setup and UPS monitoring

• Refactor configuration summary output in the interactive setup for clearer display
• Enhance logging in the daemon to show detailed SNMP settings and UPS status changes
• Improve error messages and user guidance during configuration and monitoring

2025-03-24 - 1.2.3 - fix(nupst)

No changes

2025-03-24 - 1.2.2 - fix(bin/nupst)

Improve symlink resolution in launcher script to correctly determine project root based on execution path.

• Replace directory determination with readlink for accurate symlink resolution
• Set project root to '/opt/nupst' when script is run via symlink from /usr/local/bin
• Add debugging comments to assist with path resolution

2025-03-24 - 1.2.1 - fix(bin)

Simplify Node.js binary detection in installation script

• Directly set Node binary path to vendor/node-linux-x64/bin/node
• Remove redundant architecture-specific detection logic
• Fallback to system Node if vendor binary is not found

2025-03-24 - 1.2.0 - feat(installer)

Improve Node.js binary detection and dynamic LTS version retrieval in setup scripts

• Enhanced bin/nupst to search multiple possible locations for the Node.js binary and fallback to system node if necessary
• Updated setup.sh to fetch the latest LTS Node.js version from nodejs.org and use a fallback version when the request fails

2025-03-24 - 1.1.2 - fix(setup.sh)

Improve error handling in setup.sh: exit immediately when the downloaded npm package lacks the dist_ts directory, removing the fallback build-from-source mechanism.

• Removed BUILD_FROM_SOURCE logic that attempted to build from source on missing dist_ts directory
• Updated error messages to clearly indicate failure in downloading a valid package
• Ensured installation halts if essential files are missing

2025-03-24 - 1.1.1 - fix(package.json)

Remove unused prepublishOnly script and update files field in package.json

• Removed prepublishOnly build trigger
• Updated files list to accurately include intended directories and files

2025-03-24 - 1.1.0 - feat(installer-setup)

Enhance installer and setup scripts for improved global installation and artifact management

• Detect piped installation in install.sh, clone repository automatically, and clean up previous installations
• Update readme.md with correct repository URL and clearer installation instructions
• Improve setup.sh to remove existing dist_ts, download build artifacts from the npm registry, and simplify dependency installation

2025-03-24 - 1.0.1 - fix(version)

Bump version to 1.0.1

• Updated commitinfo data to reflect the new patch version.
• Synchronized version information between commitinfo file and package metadata.

2025-03-24 - 1.0.1 - fix(build)

Update build script to use 'tsbuild tsfolders --allowimplicitany' and adjust distribution paths in .gitignore

• Replaced 'tsc' with 'tsbuild tsfolders --allowimplicitany' in package.json
• Updated .gitignore to reflect new compiled distribution folder pattern
• Updated changelog to document build improvements and regenerated type definitions

2025-03-24 - 1.0.1 - fix(build)

Update build script to use 'tsbuild tsfolders --allowimplicitany' and regenerate distribution type definitions for CLI, daemon, index, nupst, snmp, and systemd modules

• Replaced 'tsc' command with tsbuild in package.json
• Updated .gitignore to reflect new compiled distribution folder pattern
• Added new dist_ts files including .d.ts type definitions and compiled JavaScript for multiple modules

2025-03-24 - 1.0.1 - fix(build)

Update build script to use 'tsbuild tsfolders --allowimplicitany' and regenerate distribution type definitions for CLI, daemon, nupst, snmp, and systemd modules.

• Replaced the 'tsc' command with 'tsbuild tsfolders --allowimplicitany' in package.json.
• Added new dist_ts files including type definitions (d.ts) and compiled JavaScript for CLI, daemon, index, nupst, snmp, and systemd.
• Improved the generated CLI declarations and overall distribution build.

2025-03-23 - 1.0.0 - initial setup

This range covers the early commits that mainly established the repository structure.

• Initial repository commit with basic project initialization.