v1.0.0

[donavanbecker]

Breaking Changes

• The minimum Node.js version required is now v18.
• Important notice: Because of the cleanup of the Deprecated code, you will need to migrate you code base.
  • Remove the long-deprecated init().
  • Deprecate Core, BridgedCore, legacy Camera characteristics. (Deprecate Core, BridgedCore, legacy Camera characteristics. #1058) (@hjdhjd)
    • For deprecated Core and BridgedCore see: https://github.com/homebridge/HAP-NodeJS/wiki/Deprecation-of-Core-and-BridgeCore
  • Legacy code deprecation cleanup. (Legacy code deprecation cleanup #1059) (@hjdhjd)
    • For deprecated storagePath switch to HAPStorage.setCustomStoragePath, AudioCodec switch to AudioStreamingCodec, VideoCodec switch to H264CodecParameters,StreamAudioParams switch to AudioStreamingOptions, StreamVideoParams switch to VideoStreamingOptions,cameraSource switch to CameraController.
  • Others deprecated code to highlight removed: useLegacyAdvertiser, AccessoryLoader.
• Fix: Naming for Characteristic.ProgramMode has been corrected from PROGRAM_SCHEDULED_MANUAL_MODE_ to PROGRAM_SCHEDULED_MANUAL_MODE

Fixed

• Fix: Build Issues (Build issues - https://github.com/homebridge/HAP-NodeJS/actions/runs/9630265250/job/26560643600 #1041) (@NorthernMan54)
• Fix: Ensure data is only transmitted on open and ready connections. (fix: Ensure data is only transmitted on open and ready connections. #1051) (@hjdhjd)
• Fix: Ensure we check names using the full UTF-8 character set. (fix: ensure we check names using the full UTF-8 character set. #1052) (@hjdhjd)
• Fix: ConfiguredName (Fix ConfiguredName #1049) (@donavanbecker)
• Fix: Manufacturer looking at checkName but should look at checkValue. (Fix Manufacturer looking at checkName but should look at checkValue #1053) (@donavanbecker)

Other Changes

• Implement warning messages for invalid characters in names (Implement warning messages for invalid characters in names #1009) (@NorthernMan54)
• Mitigate event emitter "memory leak" warnings when a significant number of camera streaming events occur simultaneously (Mitigate event emitter "memory leak" warnings when a significant number of camera streaming events occur simultaneously. #1037) (@hjdhjd)
• AdaptiveLightingController fix & improvement (AdaptiveLightingController fix & improvement #1038) (@Shaquu)
• Minor fixes to recording logging and one change in logging. (Minor fixes to recording logging and one change in logging. #1040) (@hjdhjd)
• Bridged core and core cleanup (Bridged core and core cleanup #1048) (@Shaquu)
• Increase snapshot handler warning timeout to 8000ms. (Increase snapshot handler warning timeout to 8000ms. #1055) (@hjdhjd)
• Cleanup and refactor getLocalNetworkInterface and address a potential edge case. (Cleanup and refactor getLocalNetworkInterface and address a potential edge case. #1056) (@hjdhjd)
• Correct log spacing
• Updated and fixed typedoc config file
• Updated dependencies

Homebridge Dependencies

• @homebridge/ciao @ v1.3.0
• bonjour-hap @ v3.8.0

---

This discussion was created from the release v1.0.0.

[grzegorz914]

Latest Homebridge beta.16 with HAP 1.0 break my custom characteristics,

const Service = api.hap.Service;
  const Characteristic = api.hap.Characteristic;
  const Units = Characteristic.Units;
  const Formats = Characteristic.Formats;
  const Perms = Characteristic.Perms;

  //Envoy
  class enphaseEnvoyAlerts extends Characteristic {
    constructor() {
      super('Alerts', '00000001-000B-1000-8000-0026BB765291');
      this.setProps({
        format: Formats.STRING,
        perms: [Perms.READ, Perms.NOTIFY]
      });
      this.value = this.getDefaultValue();
    }
  }
  Characteristic.enphaseEnvoyAlerts = enphaseEnvoyAlerts;

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

also posted here

[donavanbecker]

Latest Homebridge beta.16 with HAP 1.0 break my custom characteristics,

const Service = api.hap.Service;

  const Characteristic = api.hap.Characteristic;

  const Units = Characteristic.Units;

  const Formats = Characteristic.Formats;

  const Perms = Characteristic.Perms;



  //Envoy

  class enphaseEnvoyAlerts extends Characteristic {

    constructor() {

      super('Alerts', '00000001-000B-1000-8000-0026BB765291');

      this.setProps({

        format: Formats.STRING,

        perms: [Perms.READ, Perms.NOTIFY]

      });

      this.value = this.getDefaultValue();

    }

  }

  Characteristic.enphaseEnvoyAlerts = enphaseEnvoyAlerts;

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

also posted here

Please open an issue on the hap-nodejs or Homebridge repo with a Homebridge plugin to reference and the line of code effected, thanks!

[bauer-andreas]

Just remove these lines. Does indirections seem to be removed with the latest release. Units, Formats and Perms are top level types (like Characteristic).

const Units = Characteristic.Units;
const Formats = Characteristic.Formats;
const Perms = Characteristic.Perms;

EDIT: Judging by the code fragment, you will need to migrate to something like this:

const Units = api.hap.Units;
const Formats = api.hap.Formats;
const Perms = api.hap.Perms;