nut-client
TypeScript icon, indicating that this package has built-in type declarations

0.0.8 • Public • Published

nut-client

NPM version CI Coverage Downloads License Known Vulnerabilities nut-client-snyk Donate GitHub stars Package Quality

Bugs Code Smells Duplicated Lines (%) Lines of Code Maintainability Rating Quality Gate Status Reliability Rating Security Rating Technical Debt Vulnerabilities

Dependencies update - renovate

NPM

Description

nut-client is a Node.js client for Network UPS Tools (NUT), enabling advanced communication with NUT servers for UPS management. It is built to be robust, performant, and easy to integrate, supporting parallel requests and event-based monitoring via Promises.

Installation

npm install nut-client

Features

  • NUT Command Support : Most NUT commands are supported, with automatic parsing of responses to simplify integration. Additionally, a manual mode is available for full control.

    import { NUTClient } from 'nut-client'
    
    const client = new NUTClient('127.0.0.1', 3493);
    
    console.log(client.listUps());
    console.log(client.listVariables('ups'));
    
    //manual command
    console.log(client.send(['LOGIN', "myups"]))
  • Parallel Request Handling : Unlike other NUT libraries, nut-client manages an internal queue to handle parallel requests without conflicts, using Promises for efficient request handling.

    import { NUTClient } from 'nut-client'
    
    const client = new NUTClient('127.0.0.1', 3493);
    
    const [ups1, ups2, ups3] = await Promise.all([
      client.getUPS('ups1'),
      client.getUPS('ups2'),
      client.getUPS('ups3'),
    ])
  • StartTLS Support : Communicate securely with the NUT server using StartTLS for encryption.

    import { NUTClient } from 'nut-client'
    
    const client = new NUTClient('127.0.0.1', 3493);
    
    //use clear tcp connection
    console.log(await client.version());
    
    await client.startTLS({
      // allow self signed certificate
      rejectUnauthorized: false
    });
    
    //use encrypted tcp connection
    console.log(await client.version());
  • Built-in Monitor : A Monitor module reads variables at regular intervals, emitting UPS events similar to upsmon (plus some additional ones).

    const client = new NUTClient('127.0.0.1', 3493);
    const monitor = new Monitor(client, 'myUps');
    
    //use events like UPSMON
    monitor.on('ONBATT', () => {
      console.log('UPS "myUps" lost power and is now on battery');
    });
    
    // listen on specific variable changed
    monitor.on('VARIABLE_CHANGED', (key: string, oldValue: number, newValue: number) => {
      if(key !== "battery.charge" || isNaN(oldValue) || isNaN(newValue)) {
        return;
      }
    
      console.log(`battery is ${oldValue > newValue ? 'dis':''}charging`)
    })
    
    // listen on all events
    monitor.on('*', (event: string, ...args) => {
      console.log(`receive event ${event} with args`, args);
    })
    
    // other events available in the technical documentation
    // https://thib3113.github.io/nut/interfaces/IMonitorEvents.html
    
    await monitor.start();
  • Fully Typed with TypeScript (ESM + CJS) : Built with TypeScript, nut-client is distributed in both ESM and CommonJS modules for maximum compatibility.

Debug

this library include debug, to debug, you can set the env variable :

DEBUG=nut-client:*

Contributing

Contributions are welcome! If you have suggestions, feel free to open an issue or a pull request.

/nut-client/

    Package Sidebar

    Install

    npm i nut-client

    Weekly Downloads

    6

    Version

    0.0.8

    License

    MIT

    Unpacked Size

    241 kB

    Total Files

    49

    Last publish

    Collaborators

    • thib3113