npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

nubli

v1.0.1

Published

Nuki Bluetooth Library

Downloads

17

Readme

Nubli

Nubli is a Node.JS library for Nuki Smart Locks (Nuki Bluetooth Library) Nubli is very energy efficient when used properly and should't drain more power than a Nuki bridge. It uses the same protocol the App and Bridge uses and therefore communicates securely with the Smart Lock.

NPM

Features

  • Get Lock State of Nuki Smart Lock (including door sensor)
  • Unlock/Lock/Unlatch/LockNGo Door
  • Listen for Lock State and Door Sensor changes
  • Get Authorizations
  • Get Configuration
  • Get Advanced Configuration

Supported devices

  • Nuki Smart Lock v2
  • Nuki Smart Lock v1 (not yet 100% compatible - Please open an issue if something doesn't work)

Requirements

  • Linux-based Server (e.g. Raspberry Pi)
  • Bluetooth 4.x Dongle (Tested with $5 CSR Module)

Note: Do not use the built-in Bluetooth in a Raspberry Pi. Due to bad hardware design it will not reliably connect to your Smart Lock and cause unexpected disconnects. I've been there and invested a whole week into fixing it.

Setup / Installation

  1. npm install nubli --save
  2. See Examples or Usage
  3. Star the repository ;)

Notes

  • You can only run one instance of this library simultaneously with one dongle. If want to integrate this library into multiple applications running at the same time on the same device, either pin the applications to different bluetooth dongles or communicate with a single instance of this library via a webserver/websocket/mqtt instead.

Usage

    const nubli = require('nubli').default;

    nubli.onReadyToScan()
    .then(() => {
        nubli.startScanning();
    })
    .catch((err) => {
        console.log(err);
    });

Actions

Start Scanning for Nuki devices

    nubli.startScanning(): void;

Start Actively Scanning for Nuki devices (Required for pairing)

    nubli.startActiveScanning(): void;

Notes:

  • Scanning requires the bluetooth device to be powered on. This may take a few milliseconds. Make sure to wait for the promise nubli.readyToScan() to resolve first.
  • Only use active scanning when you are trying to pair a new device. Active Scanning will drain your Smart Lock's battery very quickly. Passive Scanning only listens for advertisements from the Smart Lock and does not request additionaly information from the Smart Lock.

Stop Scanning for Nuki devices

    nubli.stopScanning(): void;

Connect to a Smart Lock

    smartlock.connect(): Promise<void>;

Disconnect from a Smart Lock

    smartlock.disconnect(): Promise<void>;

Check if a config for the Smart Lock already exists

    smartlock.configExists(path?: string): boolean;

Read Smart Lock config

    smartlock.readConfig(path?: string): Promise<void>;

Save Smart Lock config

    smartlock.saveConfig(path?: string): Promise<void>;

Pair with a Smart Lock

    smartlock.pair(asBridge = true): Promise<void>;

Note: By default it will pair as bridge. If you do have a bridge, make sure to pass false as a parameter. The reason is, that when no bridge exists, Nuki will not push any state changes automatically via advertisements, so we set ourselves as a bridge instead.

Read lock state from Smart Lock

    smartlock.readLockState(): Promise<SmartLockResponse>;

Unlock door

    smartlock.unlock(updateCallback?: (response: SmartLockResponse) => void): Promise<SmartLockResponse>;

Lock door

    smartlock.lock(updateCallback?: (response: SmartLockResponse) => void): Promise<SmartLockResponse>;

Unlatch Door

    smartlock.unlatch(updateCallback?: (response: SmartLockResponse) => void): Promise<SmartLockResponse>;

Lock N Go Door

    smartlock.lockNGo(updateCallback?: (response: SmartLockResponse) => void): Promise<SmartLockResponse>;

Lock N Go Unlatch Door

    smartlock.lockNGoUnlatch(updateCallback?: (response: SmartLockResponse) => void): Promise<SmartLockResponse>;

Get Config from Smart Lock

    smartlock.requestConfig(): Promise<SmartLockResponse>;

Get Advanced Config from Smart Lock

    smartlock.requestAdvancedConfig(): Promise<SmartLockResponse>;

Properties

Check whether a Smart Lock is already paired

    smartlock.paired: boolean;

Events

Nubli Smart Lock Discovered Event

    nubli.on('smartLockDiscovered', (smartlock: SmartLock) => void);

Nubli started scanning

    nubli.on('startedScanning', () => void);

Nubli stopped scanning

    nubli.on('stoppedScanning', () => void);

Smart Lock Connected Event

    smartlock.on('connected', () => void);

Smart Lock Disconnected Event

    smartlock.on('disconnected', () => void);

Smart Lock Error Event

    smartlock.on('error', (err: string) => void);

Smart Lock Activity Log Changed Event

    smartlock.on('activityLogChanged', () => void);

Note: The activityLogChanged event only works while scanning because the Smart Lock advertises activity log changes via bluetooth. To get notified when the door opens or closes (Door Sensor) make sure to enable 'Log door sensor status' in the Nuki app.

Help

If you have any questions or help please open an issue on the GitHub project page.

Contributing

Pull requests are always welcome. If you have an issue or feature request please open a GitHub issue.

License

The project is subject to the MIT license unless otherwise noted. A copy can be found in the root directory of the project LICENSE.