hap-nodejs 1.0.0-beta.2 → 1.0.0-beta.3

package/dist/lib/controller/CameraController.d.ts

@@ -1,14 +1,20 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { EventEmitter } from "events";
 import { SessionIdentifier } from "../../types";
-import { CameraStreamingOptions, PrepareStreamRequest, PrepareStreamResponse, RTPStreamManagement, SnapshotRequest, StreamingRequest } from "../camera";
-import type { Doorbell, Microphone, Speaker } from "../definitions";
+import { CameraRecordingConfiguration, CameraRecordingOptions, CameraStreamingOptions, EventTriggerOption, PrepareStreamRequest, PrepareStreamResponse, RecordingManagement, RecordingManagementState, RecordingPacket, RTPStreamManagement, RTPStreamManagementState, SnapshotRequest, StreamingRequest } from "../camera";
+import { HDSProtocolSpecificErrorReason } from "../datastream";
+import { CameraOperatingMode, CameraRecordingManagement, DataStreamTransportManagement, Doorbell, Microphone, MotionSensor, OccupancySensor, Speaker } from "../definitions";
 import { HAPStatus } from "../HAPServer";
-import { Controller, ControllerIdentifier, ControllerServiceMap } from "./Controller";
+import { Service } from "../Service";
+import { ControllerIdentifier, ControllerServiceMap, SerializableController, StateChangeDelegate } from "./Controller";
+/**
+ * @group Camera
+ */
 export interface CameraControllerOptions {
     /**
      * Amount of parallel camera streams the accessory is capable of running.
-     * As of the official HAP specification non Secure Video cameras have a minimum required amount of 2 (but 1 is also fine).
+     * As of the official HAP specification non SecureVideo cameras have a minimum required amount of 2 (but 1 is also fine).
      * Secure Video cameras just expose 1 stream.
      *
      * Default value: 1
@@ -22,10 +28,89 @@ export interface CameraControllerOptions {
      * Options regarding video/audio streaming
      */
     streamingOptions: CameraStreamingOptions;
+    /**
+     * When supplying this option, it will enable support for HomeKit Secure Video.
+     * This will create the {@link Service.CameraRecordingManagement}, {@link Service.CameraOperatingMode}
+     * and {@link Service.DataStreamTransportManagement} services.
+     *
+     * NOTE: The controller only initializes the required characteristics for the {@link Service.CameraOperatingMode}.
+     *   You may add optional characteristics, if required, by accessing the service directly `CameraController.recordingManagement.operatingModeService`.
+     */
+    recording?: {
+        /**
+         * Options regarding Recordings (Secure Video)
+         */
+        options: CameraRecordingOptions;
+        /**
+          * Delegate which handles the audio/video recording data streaming on motion.
+          */
+        delegate: CameraRecordingDelegate;
+    };
+    /**
+     * This config section configures optional sensors for the camera.
+     * It e.g. may be used to set up a {@link EventTriggerOption.MOTION} trigger when configuring Secure Video.
+     *
+     * You may either specify and provide the desired {@link Service}s or specify their creation and maintenance using a `boolean` flag.
+     * In this case the controller will create and maintain the service for you.
+     * Otherwise, when you supply an already created instance of the {@link Service}, you are responsible yourself to manage the service
+     * (e.g. creating, restoring, adding to the accessory, ...).
+     *
+     * The services can be accessed through the documented property after the call to {@link Accessory.configureController} has returned.
+     */
+    sensors?: {
+        /**
+         * Define if a {@link Service.MotionSensor} should be created/associated with the controller.
+         *
+         * You may access the created service via the {@link CameraController.motionService} property to configure listeners.
+         *
+         * ## HomeKit Secure Video:
+         *
+         * If supplied, this sensor will be used as a {@link EventTriggerOption.MOTION} trigger.
+         * The characteristic {@link Characteristic.StatusActive} will be added, which is used to enable or disable the sensor.
+         */
+        motion?: Service | boolean;
+        /**
+         * Define if a {@link Service.OccupancySensor} should be created/associated with the controller.
+         *
+         * You may access the created service via the {@link CameraController.occupancyService} property to configure listeners.
+         *
+         * ## HomeKit Secure Video:
+         *
+         * The characteristic {@link Characteristic.StatusActive} will be added, which is used to enable or disable the sensor.
+         */
+        occupancy?: Service | boolean;
+    };
+}
+/**
+ * @group Camera
+ */
+export type SnapshotRequestCallback = (error?: Error | HAPStatus, buffer?: Buffer) => void;
+/**
+ * @group Camera
+ */
+export type PrepareStreamCallback = (error?: Error, response?: PrepareStreamResponse) => void;
+/**
+ * @group Camera
+ */
+export type StreamRequestCallback = (error?: Error) => void;
+/**
+ * @group Camera
+ */
+export declare const enum ResourceRequestReason {
+    /**
+     * The reason describes periodic resource requests.
+     * In the example of camera image snapshots those are the typical preview images every 10 seconds.
+     */
+    PERIODIC = 0,
+    /**
+     * The resource request is the result of some event.
+     * In the example of camera image snapshots, requests are made due to e.g. a motion event or similar.
+     */
+    EVENT = 1
 }
-export declare type SnapshotRequestCallback = (error?: Error | HAPStatus, buffer?: Buffer) => void;
-export declare type PrepareStreamCallback = (error?: Error, response?: PrepareStreamResponse) => void;
-export declare type StreamRequestCallback = (error?: Error) => void;
+/**
+ * @group Camera
+ */
 export interface CameraStreamingDelegate {
     /**
      * This method is called when a HomeKit controller requests a snapshot image for the given camera.
@@ -42,13 +127,163 @@ export interface CameraStreamingDelegate {
     handleStreamRequest(request: StreamingRequest, callback: StreamRequestCallback): void;
 }
 /**
- * @private
+ * A `CameraRecordingDelegate` is responsible for handling recordings of a HomeKit Secure Video camera.
+ *
+ * It is responsible for maintaining the prebuffer (see {@link CameraRecordingOptions.prebufferLength},
+ * once recording was activated (see {@link updateRecordingActive}).
+ *
+ * Before recording is considered enabled two things must happen:
+ * - Recording must be enabled by the user. Signaled through {@link updateRecordingActive}.
+ * - Recording configurations must be selected by a HomeKit controller through {@link updateRecordingConfiguration}.
+ *
+ * A typical recording event scenario happens as follows:
+ * - The camera is in idle mode, maintaining the prebuffer (the duration of the prebuffer depends on the selected {@link CameraRecordingConfiguration}).
+ * - A recording event is triggered (e.g. motion or doorbell button press) and the camera signals it through
+ *   the respective characteristics (e.g. {@link Characteristic.MotionDetected} or {@link Characteristic.ProgrammableSwitchEvent}).
+ *   Further, the camera saves the content of the prebuffer and starts recording the video.
+ *   The camera should continue to store the recording until it runs out of space.
+ *   In any case the camera should preserve recordings which are nearest to the triggered event.
+ *   A stored recording might be completely deleted if a stream request wasn't initiated for eight seconds.
+ * - A HomeKit Controller will open a new recording session to download the next recording.
+ *   This results in a call to {@link handleRecordingStreamRequest}.
+ * - Once the recording event is finished the camera will reset the state accordingly
+ *   (e.g. in the {@link Service.MotionSensor} or {@link Service.Doorbell} service).
+ *   It will continue to send the remaining fragments of the currently ongoing recording stream request.
+ * - The camera will either reach the end of the recording (and signal this via {@link RecordingPacket.isLast}. Also see {@link acknowledgeStream})
+ *   or it will continue to stream til the HomeKit Controller closes
+ *   the stream {@link closeRecordingStream} with reason {@link HDSProtocolSpecificErrorReason.NORMAL}.
+ * - The camera goes back into idle mode.
+ *
+ * @group Camera
+ */
+export interface CameraRecordingDelegate {
+    /**
+     * A call to this method notifies the `CameraRecordingDelegate` about a change to the
+     * `CameraRecordingManagement.Active` characteristic. This characteristic controls
+     * if the camera should react to recording events.
+     *
+     * If recording is disabled the camera can stop maintaining its prebuffer.
+     * If recording is enabled the camera should start recording into its prebuffer.
+     *
+     * A `CameraRecordingDelegate` should assume active to be `false` on startup.
+     * HAP-NodeJS will persist the state of the `Active` characteristic across reboots
+     * and will call {@link updateRecordingActive} accordingly on startup, if recording was previously enabled.
+     *
+     * NOTE: HAP-NodeJS cannot guarantee that a {@link CameraRecordingConfiguration} is present
+     * when recording is activated (e.g. the selected configuration might be erased due to changes
+     * in the supplied {@link CameraRecordingOptions}, but the camera is still `active`; or we can't otherwise
+     * influence the order which a HomeKit Controller might call those characteristics).
+     * However, HAP-NodeJS guarantees that if there is a valid {@link CameraRecordingConfiguration},
+     * {@link updateRecordingConfiguration} is called before {@link updateRecordingActive} (when enabling)
+     * to avoid any unnecessary and potentially expensive reconfigurations.
+     *
+     * @param active - Specifies if recording is active or not.
+     */
+    updateRecordingActive(active: boolean): void;
+    /**
+     * A call to this method signals that the selected (by the HomeKit Controller)
+     * recording configuration of the camera has changed.
+     *
+     * On startup the delegate should assume `configuration = undefined`.
+     * HAP-NodeJS will persist the state of both across reboots and will call
+     * {@link updateRecordingConfiguration} on startup if there is a **selected configuration** present.
+     *
+     * NOTE: An update to the recording configuration might happen while there is still a running
+     * recording stream. The camera MUST continue to use the previous configuration for the
+     * currently running stream and only apply the updated configuration to the next stream.
+     *
+     * @param configuration - The {@link CameraRecordingConfiguration}. Reconfigure your recording pipeline accordingly.
+     *  The parameter might be `undefined` when the selected configuration became invalid. This typically ony happens
+     *  e.g. due to a factory reset (when all pairings are removed). Disable the recording pipeline in such a case
+     *  even if recording is still enabled for the camera.
+     */
+    updateRecordingConfiguration(configuration: CameraRecordingConfiguration | undefined): void;
+    /**
+     * This method is called to stream the next recording event.
+     * It is guaranteed that there is only ever one ongoing recording stream request at a time.
+     *
+     * When this method is called return the currently ongoing (or next in case of a potentially queued)
+     * recording via a `AsyncGenerator`. Every `yield` of the generator represents a complete recording `packet`.
+     * The first packet MUST always be the {@link PacketDataType.MEDIA_INITIALIZATION} packet.
+     * Any following packet will transport the actual mp4 fragments in {@link PacketDataType.MEDIA_FRAGMENT} packets,
+     * starting with the content of the prebuffer. Every {@link PacketDataType.MEDIA_FRAGMENT} starts with a key frame
+     * and must not be longer than the specified duration set via the `CameraRecordingConfiguration.mediaContainerConfiguration.fragmentLength`
+     * **selected** by the HomeKit Controller in {@link updateRecordingConfiguration}.
+     *
+     * NOTE: You MUST respect the value of {@link Characteristic.RecordingAudioActive} characteristic of the {@link Service.CameraOperatingMode}
+     *   service. When the characteristic is set to false you MUST NOT include audio in the mp4 fragments. You can access the characteristic via
+     *   the `CameraController.recordingManagement.operatingModeService` property.
+     *
+     * You might throw an error in this method if encountering a non-recoverable state.
+     * You may throw a {@link HDSProtocolError} to manually define the {@link HDSProtocolSpecificErrorReason} for the `DATA_SEND` `CLOSE` event.
+     *
+     * There are three ways an ongoing recording stream can be closed:
+     * - Closed by the Accessory: There are no further fragments to transmit. The delegate MUST signal this by setting {@link RecordingPacket.isLast}
+     *   to `true`. Once the HomeKit Controller receives this last fragment it will call {@link acknowledgeStream} to notify the accessory about
+     *   the successful transmission.
+     * - Closed by the HomeKit Controller (expectedly): After the event trigger has been reset, the accessory continues to stream fragments.
+     *   At some point the HomeKit Controller will decide to shut down the stream by calling {@link closeRecordingStream} with a reason
+     *   of {@link HDSProtocolSpecificErrorReason.NORMAL}.
+     * - Closed by the HomeKit Controller (unexpectedly): A HomeKit Controller might at any point decide to close a recording stream
+     *   if it encounters erroneous state. This is signaled by a call to {@link closeRecordingStream} with the respective reason.
+     *
+     * Once a close of stream is signaled, the `AsyncGenerator` function must return gracefully.
+     *
+     * For more information about `AsyncGenerator`s you might have a look at:
+     * * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of
+     *
+     * NOTE: HAP-NodeJS guarantees that this method is only called with a valid selected {@link CameraRecordingConfiguration}.
+     *
+     * NOTE: Don't rely on the streamId for unique identification. Two {@link DataStreamConnection}s might share the same identifier space.
+     *
+     * @param streamId - The streamId of the currently ongoing stream.
+     */
+    handleRecordingStreamRequest(streamId: number): AsyncGenerator<RecordingPacket>;
+    /**
+     * This method is called once the HomeKit Controller acknowledges the `endOfStream`.
+     * A `endOfStream` is sent by the accessory by setting {@link RecordingPacket.isLast} to `true` in the last packet yielded
+     * by the {@link handleRecordingStreamRequest} `AsyncGenerator`.
+     *
+     * @param streamId - The streamId of the acknowledged stream.
+     */
+    acknowledgeStream?(streamId: number): void;
+    /**
+     * This method is called to notify the delegate that a recording stream started via {@link handleRecordingStreamRequest} was closed.
+     *
+     * The method is also called if an ongoing recording stream is closed gracefully (using {@link HDSProtocolSpecificErrorReason.NORMAL}).
+     * In either case, the delegate should stop supplying further fragments to the recording stream.
+     * The `AsyncGenerator` function must return without yielding any further {@link RecordingPacket}s.
+     * HAP-NodeJS won't send out any fragments from this point onwards.
+     *
+     * @param streamId - The streamId for which the close event was sent.
+     * @param reason - The reason with which the stream was closed.
+     *  NOTE: This method is also called in case of a closed connection. This is encoded by setting the `reason` to undefined.
+     */
+    closeRecordingStream(streamId: number, reason: HDSProtocolSpecificErrorReason | undefined): void;
+}
+/**
+ * @group Camera
  */
 export interface CameraControllerServiceMap extends ControllerServiceMap {
     microphone?: Microphone;
     speaker?: Speaker;
+    cameraEventRecordingManagement?: CameraRecordingManagement;
+    cameraOperatingMode?: CameraOperatingMode;
+    dataStreamTransportManagement?: DataStreamTransportManagement;
+    motionService?: MotionSensor;
+    occupancyService?: OccupancySensor;
     doorbell?: Doorbell;
 }
+/**
+ * @group Camera
+ */
+export interface CameraControllerState {
+    streamManagements: RTPStreamManagementState[];
+    recordingManagement?: RecordingManagementState;
+}
+/**
+ * @group Camera
+ */
 export declare const enum CameraControllerEvents {
     /**
      *  Emitted when the mute state or the volume changed. The Apple Home App typically does not set those values
@@ -62,6 +297,9 @@ export declare const enum CameraControllerEvents {
      */
     SPEAKER_PROPERTIES_CHANGED = "speaker-change"
 }
+/**
+ * @group Camera
+ */
 export declare interface CameraController {
     on(event: "microphone-change", listener: (muted: boolean, volume: number) => void): this;
     on(event: "speaker-change", listener: (muted: boolean, volume: number) => void): this;
@@ -70,23 +308,45 @@ export declare interface CameraController {
 }
 /**
  * Everything needed to expose a HomeKit Camera.
+ *
+ * @group Camera
  */
-export declare class CameraController extends EventEmitter implements Controller<CameraControllerServiceMap> {
+export declare class CameraController extends EventEmitter implements SerializableController<CameraControllerServiceMap, CameraControllerState> {
     private static readonly STREAM_MANAGEMENT;
+    private stateChangeDelegate?;
     private readonly streamCount;
     private readonly delegate;
     private readonly streamingOptions;
+    /**
+     * **Temporary** storage for {@link CameraRecordingOptions} and {@link CameraRecordingDelegate}.
+     * This property is reset to `undefined` after the CameraController was fully initialized.
+     * You can still access those values via the {@link CameraController.recordingManagement}.
+     */
+    private recording?;
+    /**
+     * Temporary storage for the sensor option.
+     */
+    private sensorOptions?;
     private readonly legacyMode;
     /**
      * @private
      */
     streamManagements: RTPStreamManagement[];
+    /**
+     * The {@link RecordingManagement} which is responsible for handling HomeKit Secure Video.
+     * This property is only present if recording was configured.
+     */
+    recordingManagement?: RecordingManagement;
     private microphoneService?;
     private speakerService?;
     private microphoneMuted;
     private microphoneVolume;
     private speakerMuted;
     private speakerVolume;
+    motionService?: MotionSensor;
+    private motionServiceExternallySupplied;
+    occupancyService?: OccupancySensor;
+    private occupancyServiceExternallySupplied;
     constructor(options: CameraControllerOptions, legacyMode?: boolean);
     /**
      * @private
@@ -94,9 +354,9 @@ export declare class CameraController extends EventEmitter implements Controller
     controllerId(): ControllerIdentifier;
     /**
      * Call this method if you want to forcefully suspend an ongoing streaming session.
-     * This would be adequate if the the rtp server or media encoding encountered an unexpected error.
+     * This would be adequate if the rtp server or media encoding encountered an unexpected error.
      *
-     * @param sessionId {SessionIdentifier} - id of the current ongoing streaming session
+     * @param sessionId - id of the current ongoing streaming session
      */
     forceStopStreamingSession(sessionId: SessionIdentifier): void;
     static generateSynchronisationSource(): number;
@@ -114,11 +374,17 @@ export declare class CameraController extends EventEmitter implements Controller
      * @private
      */
     initWithServices(serviceMap: CameraControllerServiceMap): void | CameraControllerServiceMap;
+    protected _initWithServices(serviceMap: CameraControllerServiceMap): {
+        serviceMap: CameraControllerServiceMap;
+        updated: boolean;
+    };
     protected migrateFromDoorbell(serviceMap: ControllerServiceMap): boolean;
+    protected retrieveEventTriggerOptions(): Set<EventTriggerOption>;
     /**
      * @private
      */
     configureServices(): void;
+    private rtpStreamManagementDisabledThroughOperatingMode;
     /**
      * @private
      */
@@ -130,7 +396,19 @@ export declare class CameraController extends EventEmitter implements Controller
     /**
      * @private
      */
-    handleSnapshotRequest(height: number, width: number, accessoryName?: string): Promise<Buffer>;
+    serialize(): CameraControllerState | undefined;
+    /**
+     * @private
+     */
+    deserialize(serialized: CameraControllerState): void;
+    /**
+     * @private
+     */
+    setupStateChangeDelegate(delegate?: StateChangeDelegate): void;
+    /**
+     * @private
+     */
+    handleSnapshotRequest(height: number, width: number, accessoryName?: string, reason?: ResourceRequestReason): Promise<Buffer>;
     /**
      * @private
      */

package/dist/lib/controller/CameraController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CameraController.d.ts","sourceRoot":"","sources":["../../../src/lib/controller/CameraController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CameraController.d.ts","sourceRoot":"","sources":["../../../src/lib/controller/CameraController.ts"],"names":[],"mappings":"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"}