Registry / devops / homebridge-hatch-baby-rest

homebridge-hatch-baby-rest

library6.2.2jsnpmunverified

Homebridge plugin for controlling Hatch Rest, Rest+, Rest Mini, Restore, and their 2nd gen variants via WiFi. Stable v6.2.2 with active development; integrates directly with Hatch's cloud API using email/password authentication. Key differentiators: supports multiple device generations (WiFi-based, not Bluetooth), exposes light, sound, and volume as HomeKit accessories, and handles complex routines on Restore devices as simple on/off switches. Requires Node.js ^20 || ^22 || ^24 and Homebridge ^1.5.1 or ^2.0.0-beta.0.

devops

npm install homebridge-hatch-baby-rest

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · HOMEBRIDGE-HATCH-B

homebridge-hatch-baby-rest

devopsjavascriptv6.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import HatchBabyRest from 'homebridge-hatch-baby-rest';

✗ const HatchBabyRest = require('homebridge-hatch-baby-rest');

ESM-only module; CommonJS require is not supported.

HatchBabyRest

✓ import { HatchBabyRest } from 'homebridge-hatch-baby-rest';

✗ import HatchBabyRest from 'homebridge-hatch-baby-rest';

Named import is the correct way if using destructuring, but default import works too as it re-exports the same class.

PlatformConfig

✓ import type { PlatformConfig } from 'homebridge-hatch-baby-rest';

Type-only import for configuration types.

Minimal Homebridge config.json snippet to set up HatchBabyRest platform with email and password.

{ "platforms": [ { "platform": "HatchBabyRest", "email": "someone@gmail.com", "password": "secret password" } ] }

Debug

Known issues

gotchaRest Mini lacks a light; only audio controls work (fan service).

fix

Do not expect brightness or color controls for Rest Mini.

affects: >=1.0.0

gotchaRestore and 2nd gen devices expose only as on/off switch for bedtime routine; not full control.

fix

Use switch to trigger first step of routine; turn off to stop all routines.

affects: >=6.0.0

gotchaVolume control is not available in Apple Home app, only in third-party HomeKit apps.

fix

Use a third-party HomeKit app like Eve or Controller to adjust volume.

affects: >=1.0.0

breakingDropped support for Node.js <=18; requires ^20 || ^22 || ^24.

fix

Upgrade Node.js to version 20, 22, or 24.

affects: >=6.0.0

gotchaIf encountering 'Unsupported Product Found', device is not yet supported.

fix

Enable debug mode in config to log device details and open an issue on GitHub.

affects: >=1.0.0

Errors

Common errors & fixes

Unsupported Product Found: restoreV4

Plugin does not yet support the specific device model returned by Hatch API.

fix

Add '"debug": true' to config, restart Homebridge, and open a GitHub issue with the logged IoT state.

TypeError: Cannot read properties of undefined (reading 'accessory')

Occurs if platform config is missing required fields like 'email' or 'password'.

fix

Ensure config includes '"email": "..."' and '"password": "..."'.

Error: Request failed with status code 401

Invalid Hatch Baby account credentials.

fix

Verify email and password are correct; if issue persists, reset password via Hatch app.

Error: No devices found

Hatch account has no WiFi-connected Rest/Restore devices, or all devices are Bluetooth-only.

fix

Confirm devices are registered to the account and are WiFi models; use the Bluetooth plugin for older models.

Upgrade

Version history

6.2.2latest on npm

Audit

Dependencies

homebridgerequiredrequired peer dependency for Homebridge plugin interface

Agent activity

6 hits · last 30 days

node

Resources

githubgit://github.com/dgreif/homebridge-hatch-baby-rest ↗

packagehomebridge-hatch-baby-rest ↗

homepagehttps://github.com/dgreif/homebridge-hatch-baby-rest/tree/main/packages/homebridge-hatch-baby-rest#readme ↗