Add native camera and media service integrations

test/onvif/test.onvif.discovery.node.ts

@@ -0,0 +1,67 @@
+import { expect, tap } from '@git.zone/tstest/tapbundle';
+import { createOnvifDiscoveryDescriptor } from '../../ts/integrations/onvif/index.js';
+
+tap.test('matches ONVIF WS-Discovery camera records', async () => {
+  const descriptor = createOnvifDiscoveryDescriptor();
+  const matcher = descriptor.getMatchers()[0];
+  const result = await matcher.matches({
+    epr: 'urn:uuid:camera-001',
+    xaddrs: ['http://192.168.1.50:8899/onvif/device_service'],
+    types: ['dn:NetworkVideoTransmitter'],
+    scopes: [
+      'onvif://www.onvif.org/Profile/Streaming',
+      'onvif://www.onvif.org/name/Driveway%20Camera',
+      'onvif://www.onvif.org/hardware/IPC-123',
+      'onvif://www.onvif.org/mac/AA-BB-CC-11-22-33',
+    ],
+  }, {});
+
+  expect(result.matched).toBeTrue();
+  expect(result.candidate?.host).toEqual('192.168.1.50');
+  expect(result.candidate?.port).toEqual(8899);
+  expect(result.candidate?.name).toEqual('Driveway Camera');
+  expect(result.normalizedDeviceId).toEqual('aa:bb:cc:11:22:33');
+});
+
+tap.test('matches ONVIF mDNS camera records', async () => {
+  const descriptor = createOnvifDiscoveryDescriptor();
+  const matcher = descriptor.getMatchers()[1];
+  const result = await matcher.matches({
+    type: '_onvif._tcp.local.',
+    name: 'Porch Camera._onvif._tcp.local.',
+    host: 'porch-camera.local',
+    port: 80,
+    txt: {
+      model: 'IPC-321',
+      mac: '00:11:22:33:44:55',
+    },
+  }, {});
+
+  expect(result.matched).toBeTrue();
+  expect(result.candidate?.integrationDomain).toEqual('onvif');
+  expect(result.normalizedDeviceId).toEqual('00:11:22:33:44:55');
+});
+
+tap.test('validates manual ONVIF candidates', async () => {
+  const descriptor = createOnvifDiscoveryDescriptor();
+  const manualMatcher = descriptor.getMatchers()[2];
+  const validator = descriptor.getValidators()[0];
+  const manual = await manualMatcher.matches({
+    host: '192.168.1.51',
+    port: 80,
+    name: 'Garage Camera',
+    deviceInfo: {
+      manufacturer: 'ExampleCam',
+      model: 'Model S',
+      serialNumber: 'SN123',
+    },
+    profiles: [],
+  }, {});
+  const validated = await validator.validate(manual.candidate!, {});
+
+  expect(manual.matched).toBeTrue();
+  expect(validated.matched).toBeTrue();
+  expect(validated.metadata?.manualSupported).toEqual(true);
+});
+
+export default tap.start();

test/onvif/test.onvif.mapper.node.ts

@@ -0,0 +1,106 @@
+import { expect, tap } from '@git.zone/tstest/tapbundle';
+import { OnvifMapper, type IOnvifSnapshot } from '../../ts/integrations/onvif/index.js';
+
+const snapshot: IOnvifSnapshot = {
+  id: 'front-door',
+  name: 'Front Door',
+  host: '192.168.1.60',
+  port: 80,
+  transport: 'http',
+  connected: true,
+  configured: true,
+  cameras: [
+    {
+      id: 'front-door',
+      name: 'Front Door',
+      host: '192.168.1.60',
+      port: 80,
+      online: true,
+      deviceInfo: {
+        manufacturer: 'ExampleCam',
+        model: 'IPC-4K',
+        firmwareVersion: '1.2.3',
+        serialNumber: 'FD1234',
+        macAddress: 'AA:BB:CC:DD:EE:FF',
+      },
+      capabilities: {
+        snapshot: true,
+        stream: true,
+        ptz: true,
+        events: true,
+      },
+      profiles: [
+        {
+          index: 0,
+          token: 'profile_1',
+          name: 'Main',
+          video: {
+            encoding: 'H264',
+            resolution: { width: 1920, height: 1080 },
+          },
+          streamUri: 'rtsp://192.168.1.60/stream1',
+          snapshotUri: 'http://192.168.1.60/snapshot.jpg',
+          ptz: {
+            relative: true,
+            presets: ['1'],
+          },
+        },
+      ],
+      streams: [
+        {
+          profileToken: 'profile_1',
+          uri: 'rtsp://192.168.1.60/stream1',
+          protocol: 'rtsp',
+          encoding: 'H264',
+          resolution: { width: 1920, height: 1080 },
+        },
+      ],
+      events: [
+        {
+          uid: 'front_motion',
+          name: 'Motion',
+          platform: 'binary_sensor',
+          deviceClass: 'motion',
+          value: true,
+        },
+      ],
+    },
+  ],
+};
+
+tap.test('maps ONVIF cameras and profiles to canonical devices and constrained entities', async () => {
+  const devices = OnvifMapper.toDevices(snapshot);
+  const entities = OnvifMapper.toEntities(snapshot);
+
+  expect(devices[0].id).toEqual('onvif.camera.aa_bb_cc_dd_ee_ff');
+  expect(devices[0].features.some((featureArg) => featureArg.capability === 'camera')).toBeTrue();
+  expect(entities.find((entityArg) => entityArg.id === 'sensor.front_door_main_camera')?.platform).toEqual('sensor');
+  expect(entities.find((entityArg) => entityArg.id === 'sensor.front_door_main_camera')?.attributes?.capability).toEqual('camera');
+  expect(entities.find((entityArg) => entityArg.id === 'binary_sensor.front_door_motion')?.state).toEqual('on');
+});
+
+tap.test('maps camera stream, snapshot, and PTZ services to ONVIF commands', async () => {
+  const streamCommand = OnvifMapper.commandForService(snapshot, {
+    domain: 'camera',
+    service: 'stream_metadata',
+    target: { entityId: 'sensor.front_door_main_camera' },
+  });
+  const snapshotCommand = OnvifMapper.commandForService(snapshot, {
+    domain: 'camera',
+    service: 'snapshot_metadata',
+    target: { entityId: 'sensor.front_door_main_camera' },
+  });
+  const ptzCommand = OnvifMapper.commandForService(snapshot, {
+    domain: 'camera',
+    service: 'ptz',
+    target: { entityId: 'sensor.front_door_main_camera' },
+    data: { move_mode: 'RelativeMove', pan: 'LEFT', distance: 0.1 },
+  });
+
+  expect(streamCommand?.type).toEqual('stream_metadata');
+  expect(snapshotCommand?.type).toEqual('snapshot_metadata');
+  expect(ptzCommand?.ptz?.moveMode).toEqual('RelativeMove');
+  expect(ptzCommand?.ptz?.pan).toEqual('LEFT');
+});
+
+export default tap.start();