advanced-camera-card/tests/camera-manager/utils/ptz.test.ts

import { describe, expect, it } from 'vitest';

import {
  getConfiguredPTZAction,
  getConfiguredPTZMovementType,
  getPTZCapabilitiesFromCameraConfig,
  mergePTZCapabilities,
} from '../../../src/camera-manager/utils/ptz';
import type { PTZAction } from '../../../src/config/schema/actions/custom/ptz';
import { PTZMovementType } from '../../../src/types';
import { createCameraConfig } from '../../config/test-utils';

const action = {
  action: 'perform-action' as const,
  perform_action: 'action',
  data: {
    device: '048123',
    cmd: 'preset',
    preset: 'window',
  },
};

describe('getConfiguredPTZAction', () => {
  describe('should return preset', () => {
    it('with preset', () => {
      expect(
        getConfiguredPTZAction(
          createCameraConfig({
            ptz: {
              presets: {
                window: action,
              },
            },
          }),
          'preset',
          {
            preset: 'window',
          },
        ),
      ).toEqual(action);
    });

    it('without preset', () => {
      expect(
        getConfiguredPTZAction(
          createCameraConfig({
            ptz: {
              presets: {
                window: action,
              },
            },
          }),
          'preset',
        ),
      ).toBeNull();
    });
  });

  describe('should return continuous action', () => {
    it('with action', () => {
      expect(
        getConfiguredPTZAction(
          createCameraConfig({
            ptz: {
              actions_left_start: action,
            },
          }),
          'left',
          {
            phase: 'start',
          },
        ),
      ).toEqual(action);
    });

    it('without action', () => {
      expect(
        getConfiguredPTZAction(
          createCameraConfig({
            ptz: {},
          }),
          'left',
          {
            phase: 'start',
          },
        ),
      ).toBeNull();
    });
  });
});

describe('getConfiguredPTZMovementType', () => {
  it('with continuous', () => {
    expect(
      getConfiguredPTZMovementType(
        createCameraConfig({
          ptz: {
            actions_left_start: action,
            actions_left_stop: action,
          },
        }),
        'left',
      ),
    )?.toEqual(['continuous']);
  });

  it('with relative', () => {
    expect(
      getConfiguredPTZMovementType(
        createCameraConfig({
          ptz: {
            actions_left: action,
          },
        }),
        'left',
      ),
    )?.toEqual(['relative']);
  });

  it('with continuous and relative', () => {
    expect(
      getConfiguredPTZMovementType(
        createCameraConfig({
          ptz: {
            actions_left: action,
            actions_left_start: action,
            actions_left_stop: action,
          },
        }),
        'left',
      ),
    )?.toEqual(['continuous', 'relative']);
  });

  it('with no actions', () => {
    expect(
      getConfiguredPTZMovementType(
        createCameraConfig({
          ptz: {},
        }),
        'left',
      ),
    )?.toBeNull();
  });
});

describe('getPTZCapabilitiesFromCameraConfig', () => {
  it('with nothing', () => {
    expect(getPTZCapabilitiesFromCameraConfig(createCameraConfig()))?.toBeNull();
  });

  describe('with individual actions', () => {
    it.each([
      ['left' as const, 'left'],
      ['right' as const, 'right'],
      ['up' as const, 'up'],
      ['down' as const, 'down'],
      ['zoom_in' as const, 'zoomIn'],
      ['zoom_out' as const, 'zoomOut'],
    ])('%s', async (actionName: PTZAction, capabilityName: string) => {
      expect(
        getPTZCapabilitiesFromCameraConfig(
          createCameraConfig({
            ptz: {
              ['actions_' + actionName]: action,
            },
          }),
        ),
      )?.toEqual({
        [capabilityName]: ['relative'],
      });
    });
  });

  it('with preset', () => {
    expect(
      getPTZCapabilitiesFromCameraConfig(
        createCameraConfig({
          ptz: {
            presets: {
              window: action,
            },
          },
        }),
      ),
    )?.toEqual({
      presets: ['window'],
    });
  });
});

describe('mergePTZCapabilities', () => {
  it('should return null when both are null', () => {
    expect(mergePTZCapabilities(null, null)).toBeNull();
  });

  it('should return engine capabilities when no config capabilities', () => {
    expect(
      mergePTZCapabilities(
        { left: [PTZMovementType.Continuous], presets: ['Staw', 'Piwnica'] },
        null,
      ),
    ).toEqual({
      left: [PTZMovementType.Continuous],
      presets: ['Staw', 'Piwnica'],
    });
  });

  it('should return config capabilities when no engine capabilities', () => {
    expect(mergePTZCapabilities(null, { presets: ['home'] })).toEqual({
      presets: ['home'],
    });
  });

  it('should union presets with configured presets first', () => {
    expect(
      mergePTZCapabilities(
        { left: [PTZMovementType.Continuous], presets: ['Staw', 'Piwnica'] },
        { presets: ['home'] },
      ),
    ).toEqual({
      left: [PTZMovementType.Continuous],
      presets: ['home', 'Staw', 'Piwnica'],
    });
  });

  it('should not duplicate presets present in both sources', () => {
    expect(
      mergePTZCapabilities({ presets: ['home', 'Staw'] }, { presets: ['home'] }),
    ).toEqual({
      presets: ['home', 'Staw'],
    });
  });

  it('should let configured movement actions override engine equivalents', () => {
    expect(
      mergePTZCapabilities(
        { left: [PTZMovementType.Continuous] },
        { left: [PTZMovementType.Relative] },
      ),
    ).toEqual({
      left: [PTZMovementType.Relative],
    });
  });

  it('should omit presets when neither source has any', () => {
    expect(mergePTZCapabilities({ left: [PTZMovementType.Continuous] }, null)).toEqual({
      left: [PTZMovementType.Continuous],
    });
  });
});