camstreamerlib 4.0.34 → 4.0.35-9984935

package/cjs/types/PlaneTrackerAPI.test.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const PlaneTrackerAPI_1 = require("./PlaneTrackerAPI");
+const globals_1 = require("@jest/globals");
+const AIRCRAFT_LABEL = {
+    firstRow: 'icao',
+    secondRow: 'call_sign',
+    thirdRow: 'blank',
+    fourthRow: 'registration',
+    opacity: 50,
+};
+const DEFAULT_DRONE_LABEL = { firstRow: 'remote_id', opacity: 30 };
+(0, globals_1.describe)('cameraSettingsSchema identificationLabel', () => {
+    (0, globals_1.test)('defaults both aircraft and drone labels', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({}).identificationLabel).toEqual({
+            aircraft: {
+                firstRow: 'icao',
+                secondRow: 'call_sign',
+                thirdRow: 'blank',
+                fourthRow: 'blank',
+                opacity: 30,
+            },
+            drone: DEFAULT_DRONE_LABEL,
+        });
+    });
+    (0, globals_1.test)('parses the aircraft and drone label', () => {
+        const identificationLabel = { aircraft: AIRCRAFT_LABEL, drone: { firstRow: 'blank', opacity: 70 } };
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({ identificationLabel }).identificationLabel).toEqual(identificationLabel);
+    });
+    (0, globals_1.test)('defaults a missing drone label', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({ identificationLabel: { aircraft: AIRCRAFT_LABEL } }).identificationLabel).toEqual({ aircraft: AIRCRAFT_LABEL, drone: DEFAULT_DRONE_LABEL });
+    });
+    (0, globals_1.test)('converts the legacy flat label to the aircraft label', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({ identificationLabel: AIRCRAFT_LABEL }).identificationLabel).toEqual({
+            aircraft: AIRCRAFT_LABEL,
+            drone: DEFAULT_DRONE_LABEL,
+        });
+    });
+    (0, globals_1.test)('returns an independent drone label for each legacy parse', () => {
+        const first = PlaneTrackerAPI_1.cameraSettingsSchema.parse({ identificationLabel: AIRCRAFT_LABEL });
+        first.identificationLabel.drone.opacity = 90;
+        const second = PlaneTrackerAPI_1.cameraSettingsSchema.parse({ identificationLabel: AIRCRAFT_LABEL });
+        (0, globals_1.expect)(second.identificationLabel.drone).toEqual(DEFAULT_DRONE_LABEL);
+    });
+    (0, globals_1.test)('rejects an unknown drone label row', () => {
+        const identificationLabel = { aircraft: AIRCRAFT_LABEL, drone: { firstRow: 'icao', opacity: 30 } };
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.safeParse({ identificationLabel }).success).toBe(false);
+    });
+});
+const CAPTURE_CONFIG = { defaultCaptureSizeMeters: 50, captureSizeExtensionMeters: 20 };
+const DEFAULT_CAPTURE_CONFIG = { defaultCaptureSizeMeters: 120, captureSizeExtensionMeters: 80 };
+(0, globals_1.describe)('cameraSettingsSchema cameraConfig', () => {
+    (0, globals_1.test)('defaults both aircraft and drone capture config', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({}).cameraConfig).toEqual({
+            aircraft: DEFAULT_CAPTURE_CONFIG,
+            drone: DEFAULT_CAPTURE_CONFIG,
+        });
+    });
+    (0, globals_1.test)('parses independent aircraft and drone capture config', () => {
+        const cameraConfig = {
+            aircraft: CAPTURE_CONFIG,
+            drone: { defaultCaptureSizeMeters: 5, captureSizeExtensionMeters: 3 },
+        };
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({ cameraConfig }).cameraConfig).toEqual(cameraConfig);
+    });
+    (0, globals_1.test)('defaults a missing drone capture config', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({ cameraConfig: { aircraft: CAPTURE_CONFIG } }).cameraConfig).toEqual({
+            aircraft: CAPTURE_CONFIG,
+            drone: DEFAULT_CAPTURE_CONFIG,
+        });
+    });
+    (0, globals_1.test)('copies the legacy flat capture config to both aircraft and drone', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({ cameraConfig: CAPTURE_CONFIG }).cameraConfig).toEqual({
+            aircraft: CAPTURE_CONFIG,
+            drone: CAPTURE_CONFIG,
+        });
+    });
+    (0, globals_1.test)('returns independent aircraft and drone objects', () => {
+        const legacy = PlaneTrackerAPI_1.cameraSettingsSchema.parse({ cameraConfig: CAPTURE_CONFIG }).cameraConfig;
+        legacy.drone.defaultCaptureSizeMeters = 1;
+        (0, globals_1.expect)(legacy.aircraft).toEqual(CAPTURE_CONFIG);
+        const first = PlaneTrackerAPI_1.cameraSettingsSchema.parse({}).cameraConfig;
+        first.drone.defaultCaptureSizeMeters = 1;
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.parse({}).cameraConfig.drone).toEqual(DEFAULT_CAPTURE_CONFIG);
+    });
+    (0, globals_1.test)('rejects a non-positive drone capture size', () => {
+        const cameraConfig = { aircraft: CAPTURE_CONFIG, drone: { ...CAPTURE_CONFIG, defaultCaptureSizeMeters: 0 } };
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.safeParse({ cameraConfig }).success).toBe(false);
+    });
+});
+(0, globals_1.describe)('cameraSettingsSchema widget units', () => {
+    const WIDGET = { coord: 'top_left', posX: 10, posY: 10, scale: 100 };
+    (0, globals_1.test)('defaults all widget units to rotate', () => {
+        const settings = PlaneTrackerAPI_1.cameraSettingsSchema.parse({});
+        (0, globals_1.expect)(settings.widget.units).toBe('rotate');
+        (0, globals_1.expect)(settings.airportWidget.windSpeedUnits).toBe('rotate');
+        (0, globals_1.expect)(settings.airportWidget.temperatureUnits).toBe('rotate');
+    });
+    (0, globals_1.test)('defaults missing units of saved widgets to rotate', () => {
+        const settings = PlaneTrackerAPI_1.cameraSettingsSchema.parse({ widget: WIDGET, airportWidget: WIDGET });
+        (0, globals_1.expect)(settings.widget.units).toBe('rotate');
+        (0, globals_1.expect)(settings.airportWidget.windSpeedUnits).toBe('rotate');
+        (0, globals_1.expect)(settings.airportWidget.temperatureUnits).toBe('rotate');
+    });
+    (0, globals_1.test)('parses independent widget units', () => {
+        const settings = PlaneTrackerAPI_1.cameraSettingsSchema.parse({
+            widget: { ...WIDGET, units: 'imperial' },
+            airportWidget: { ...WIDGET, windSpeedUnits: 'rotate', temperatureUnits: 'metric' },
+        });
+        (0, globals_1.expect)(settings.widget.units).toBe('imperial');
+        (0, globals_1.expect)(settings.airportWidget.windSpeedUnits).toBe('rotate');
+        (0, globals_1.expect)(settings.airportWidget.temperatureUnits).toBe('metric');
+    });
+    (0, globals_1.test)('rejects an unknown widget unit', () => {
+        (0, globals_1.expect)(PlaneTrackerAPI_1.cameraSettingsSchema.safeParse({ widget: { ...WIDGET, units: 'kelvin' } }).success).toBe(false);
+    });
+});

package/cjs/types/common.d.ts

@@ -26,6 +26,19 @@ export declare const keyboardShortcutSchema: z.ZodNullable<z.ZodString>;
 export declare const keyboardShortcutsSchema: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
 export type TKeyboardShortcut = z.infer<typeof keyboardShortcutSchema>;
 export type TKeyboardShortcuts = z.infer<typeof keyboardShortcutsSchema>;
+export declare const wsAliasResponseSchema: z.ZodObject<{
+    alias: z.ZodString;
+    ws: z.ZodString;
+    ws_initial_message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    alias: string;
+    ws: string;
+    ws_initial_message: string;
+}, {
+    alias: string;
+    ws: string;
+    ws_initial_message: string;
+}>;
 export type TProxyTarget = {
     ip: string;
     mdnsName: string;

package/cjs/types/common.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fileSchema = exports.bitrateVapixParamsSchema = exports.bitrateModeSchema = exports.keyboardShortcutsSchema = exports.keyboardShortcutSchema = exports.networkCameraListSchema = exports.storageTypeSchema = exports.sdCardStorageTypeSchema = exports.flashStorageTypeSchema = exports.h264ProfileSchema = exports.audioChannelCountSchema = exports.audioChannelSchema = exports.booleanSchema = void 0;
+exports.fileSchema = exports.bitrateVapixParamsSchema = exports.bitrateModeSchema = exports.wsAliasResponseSchema = exports.keyboardShortcutsSchema = exports.keyboardShortcutSchema = exports.networkCameraListSchema = exports.storageTypeSchema = exports.sdCardStorageTypeSchema = exports.flashStorageTypeSchema = exports.h264ProfileSchema = exports.audioChannelCountSchema = exports.audioChannelSchema = exports.booleanSchema = void 0;
 const zod_1 = require("zod");
 exports.booleanSchema = zod_1.z.union([zod_1.z.literal(0), zod_1.z.literal(1)]);
 exports.audioChannelSchema = zod_1.z.union([zod_1.z.literal('mono'), zod_1.z.literal('stereo')]);
@@ -15,6 +15,11 @@ exports.networkCameraListSchema = zod_1.z.array(zod_1.z.object({
 }));
 exports.keyboardShortcutSchema = zod_1.z.string().nullable();
 exports.keyboardShortcutsSchema = zod_1.z.record(exports.keyboardShortcutSchema);
+exports.wsAliasResponseSchema = zod_1.z.object({
+    alias: zod_1.z.string(),
+    ws: zod_1.z.string(),
+    ws_initial_message: zod_1.z.string(),
+});
 exports.bitrateModeSchema = zod_1.z.union([zod_1.z.literal('VBR'), zod_1.z.literal('MBR'), zod_1.z.literal('ABR')]);
 exports.bitrateVapixParamsSchema = zod_1.z.object({
     bitrateMode: exports.bitrateModeSchema,

package/esm/CamOverlayAPI.js

@@ -1,5 +1,5 @@
 import { ErrorWithResponse, ServiceNotFoundError, StorageDataFetchError } from './errors/errors';
-import { networkCameraListSchema } from './types/common';
+import { networkCameraListSchema, wsAliasResponseSchema } from './types/common';
 import { z } from 'zod';
 import { ImageType, serviceListSchema, servicesSchema, wsResponseSchema, getStorageDataListSchema, getFileListSchema, } from './types/CamOverlayAPI';
 import { BasicAPI } from './internal/BasicAPI';
@@ -26,6 +26,22 @@ export class CamOverlayAPI extends BasicAPI {
     async getMjpegStreamImage(mjpegUrl, options) {
         return await this._getBlob(`${BASE_PATH}/fetch_mjpeg_image.cgi`, { mjpeg_url: decodeURIComponent(mjpegUrl) }, options);
     }
+    async isViewerPassValid(pass, options) {
+        const res = await this._getJson(`${BASE_PATH}/check_pass.cgi`, { pass }, options);
+        if (res.status !== 200) {
+            throw new Error(res.message);
+        }
+        return res.data === '1';
+    }
+    async getLiveViewAlias(rtspUrl, options) {
+        const agent = this.getClient(options?.proxyParams);
+        const res = await agent.get({
+            path: `${BASE_PATH}/getLiveViewAlias.cgi`,
+            parameters: { rtsp_url: rtspUrl },
+            timeout: options?.timeout,
+        });
+        return wsAliasResponseSchema.parse(await res.json());
+    }
     async listFiles(fileType, options) {
         const res = await this._getJson(`${BASE_PATH}/upload_${fileType}.cgi`, { action: 'list' }, options);
         return getFileListSchema(fileType).parse(res.list);

package/esm/PlaneTrackerAPI.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
-import { blackListSchema, cameraSettingsSchema, domainListSchema, flightInfoSchema, getIcaoSchema, mapInfoSchema, milestoneCameraListSchema, priorityListSchema, serverSettingsSchema, trackingModeSchema, whiteListSchema, wsAliasResponseSchema, zonesSchema, } from './types/PlaneTrackerAPI';
+import { blackListSchema, cameraSettingsSchema, domainListSchema, flightInfoSchema, getIcaoSchema, mapInfoSchema, milestoneCameraListSchema, priorityListSchema, serverSettingsSchema, trackingModeSchema, whiteListSchema, zonesSchema, } from './types/PlaneTrackerAPI';
 import { CannotSetCoordsInAutoModeError, ImportSettingsError, InvalidAltitudeError, InvalidLatLngError, ResetCalibrationError, ServerError, BadRequestError, } from './errors/errors';
+import { wsAliasResponseSchema } from './types/common';
 import { BasicAPI } from './internal/BasicAPI';
 import { apiUserInputSchema } from './types/ws/PlaneTrackerEvents';
 const BASE_PATH = '/local/planetracker';

package/esm/VapixAPI.js

@@ -90,7 +90,9 @@ export class VapixAPI extends BasicAPI {
             };
             await this._postJsonEncoded('/axis-cgi/opticscontrol.cgi', data, undefined, options);
         }
-        catch {
+        catch (error) {
+            console.warn('Failed to perform autofocus: ', error instanceof Error ? error.message : String(error));
+            console.warn('Falling back to deprecated optics setup API');
             await this._postUrlEncoded('/axis-cgi/opticssetup.cgi', {
                 autofocus: 'perform',
                 source: '1',
@@ -141,7 +143,7 @@ export class VapixAPI extends BasicAPI {
             return data.data.activeTimeZone;
         }
         catch (error) {
-            console.warn('Failed to fetch time zone data from time API v2:', error instanceof Error ? error.message : JSON.stringify(error));
+            console.warn('Failed to fetch time zone data from time API v2:', error instanceof Error ? error.message : String(error));
             console.warn('Falling back to deprecated time API v1');
         }
         try {

package/esm/errors/errors.js

@@ -20,7 +20,7 @@ export class ServiceNotFoundError extends Error {
 }
 export class ParsingBlobError extends Error {
     constructor(err) {
-        super('Error parsing response as Blob: ' + err);
+        super('Error parsing response as Blob: ' + String(err));
         this.name = 'ParsingBlobError';
     }
 }
@@ -84,7 +84,7 @@ export class NoDeviceInfoError extends Error {
 }
 export class FetchDeviceInfoError extends Error {
     constructor(err) {
-        super('Error fetching remote camera data: ' + err);
+        super('Error fetching remote camera data: ' + String(err));
         this.name = 'NoDeviceInfoFromCameraError';
     }
 }
@@ -108,7 +108,7 @@ export class PtzNotSupportedError extends Error {
 }
 export class StorageDataFetchError extends Error {
     constructor(err) {
-        super('Error fetching storage data: ' + err);
+        super('Error fetching storage data: ' + String(err));
         this.name = 'StorageDataFetchError';
     }
 }
@@ -132,7 +132,7 @@ export class TimezoneNotSetupError extends Error {
 }
 export class TimezoneFetchError extends Error {
     constructor(err) {
-        super('Error fetching time zone information: ' + err);
+        super('Error fetching time zone information: ' + String(err));
         this.name = 'TimezoneFetchError';
     }
 }

package/esm/types/PlaneTrackerAPI.js

@@ -1,9 +1,4 @@
 import { z } from 'zod';
-export const wsAliasResponseSchema = z.object({
-    alias: z.string(),
-    ws: z.string(),
-    ws_initial_message: z.string(),
-});
 export const connectionSchema = z.object({
     protocol: z.union([z.literal('http'), z.literal('https'), z.literal('https_insecure')]),
     ip: z.union([z.string().ip(), z.literal('')]),
@@ -30,6 +25,7 @@ export const widgetSchema = z.object({
     posY: z.number().nonnegative(),
     scale: z.number().positive(),
 });
+const widgetUnitsSchema = z.union([z.literal('metric'), z.literal('imperial'), z.literal('rotate')]);
 const labelOptionsSchema = z.union([
     z.literal('blank'),
     z.literal('registration'),
@@ -37,13 +33,59 @@ const labelOptionsSchema = z.union([
     z.literal('flight_number'),
     z.literal('icao'),
 ]);
-const identificationLabelSchema = z.object({
+const aircraftIdentificationLabelSchema = z.object({
     firstRow: labelOptionsSchema,
     secondRow: labelOptionsSchema,
     thirdRow: labelOptionsSchema,
     fourthRow: labelOptionsSchema,
-    opacity: z.number().positive(),
+    opacity: z.number().nonnegative(),
+});
+const droneLabelOptionsSchema = z.union([z.literal('blank'), z.literal('remote_id')]);
+const droneIdentificationLabelSchema = z.object({
+    firstRow: droneLabelOptionsSchema,
+    opacity: z.number().nonnegative(),
 });
+const DEFAULT_DRONE_IDENTIFICATION_LABEL = {
+    firstRow: 'remote_id',
+    opacity: 30,
+};
+const identificationLabelSchema = z.union([
+    z.object({
+        aircraft: aircraftIdentificationLabelSchema,
+        drone: droneIdentificationLabelSchema.default(DEFAULT_DRONE_IDENTIFICATION_LABEL),
+    }),
+    aircraftIdentificationLabelSchema.transform((aircraft) => ({
+        aircraft,
+        drone: { ...DEFAULT_DRONE_IDENTIFICATION_LABEL },
+    })),
+]);
+const captureConfigSchema = z.object({
+    defaultCaptureSizeMeters: z.number().positive(),
+    captureSizeExtensionMeters: z.number().positive(),
+});
+const DEFAULT_CAPTURE_CONFIG = {
+    defaultCaptureSizeMeters: 120,
+    captureSizeExtensionMeters: 80,
+};
+const cameraConfigSchema = z.union([
+    z.object({
+        aircraft: captureConfigSchema,
+        drone: captureConfigSchema.default(() => ({ ...DEFAULT_CAPTURE_CONFIG })),
+    }),
+    z
+        .object({
+        defaultCaptureSizeMeters: z.number().positive().default(DEFAULT_CAPTURE_CONFIG.defaultCaptureSizeMeters),
+        captureSizeExtensionMeters: z
+            .number()
+            .positive()
+            .default(DEFAULT_CAPTURE_CONFIG.captureSizeExtensionMeters),
+    })
+        .strict()
+        .transform((captureConfig) => ({
+        aircraft: captureConfig,
+        drone: { ...captureConfig },
+    })),
+]);
 export const cameraSettingsSchema = z.object({
     units: z.union([z.literal('metric'), z.literal('imperial')]).default('imperial'),
     adsbSource: z
@@ -81,15 +123,10 @@ export const cameraSettingsSchema = z.object({
         nightSkyCalibrationFocusValue: 9000,
         focusCalibrationPoints: '',
     }),
-    cameraConfig: z
-        .object({
-        defaultCaptureSizeMeters: z.number().positive().default(120),
-        captureSizeExtensionMeters: z.number().positive().default(80),
-    })
-        .default({
-        defaultCaptureSizeMeters: 120,
-        captureSizeExtensionMeters: 80,
-    }),
+    cameraConfig: cameraConfigSchema.default(() => ({
+        aircraft: { ...DEFAULT_CAPTURE_CONFIG },
+        drone: { ...DEFAULT_CAPTURE_CONFIG },
+    })),
     stream: z
         .object({
         width: z.number().positive(),
@@ -150,18 +187,25 @@ export const cameraSettingsSchema = z.object({
         displaySystemInfo: z.boolean().optional(),
     })
         .optional(),
-    widget: widgetSchema.default({
+    widget: widgetSchema
+        .extend({
+        units: widgetUnitsSchema.default('rotate'),
+    })
+        .default({
         enabled: true,
         coord: 'top_right',
         posX: 10,
         posY: 10,
         scale: 100,
+        units: 'rotate',
     }),
     airportWidget: widgetSchema
         .extend({
         showWeather: z.boolean().default(false),
         weatherLocationKey: z.string().default(''),
         weatherLocationName: z.string().default(''),
+        windSpeedUnits: widgetUnitsSchema.default('rotate'),
+        temperatureUnits: widgetUnitsSchema.default('rotate'),
     })
         .default({
         enabled: true,
@@ -172,6 +216,8 @@ export const cameraSettingsSchema = z.object({
         showWeather: false,
         weatherLocationKey: '',
         weatherLocationName: '',
+        windSpeedUnits: 'rotate',
+        temperatureUnits: 'rotate',
     }),
     fr24FlightInfoSource: z
         .object({
@@ -200,11 +246,14 @@ export const cameraSettingsSchema = z.object({
         port: 80,
     }),
     identificationLabel: identificationLabelSchema.default({
-        firstRow: 'registration',
-        secondRow: 'blank',
-        thirdRow: 'blank',
-        fourthRow: 'blank',
-        opacity: 30,
+        aircraft: {
+            firstRow: 'icao',
+            secondRow: 'call_sign',
+            thirdRow: 'blank',
+            fourthRow: 'blank',
+            opacity: 30,
+        },
+        drone: DEFAULT_DRONE_IDENTIFICATION_LABEL,
     }),
     acs: connectionSchema
         .extend({

package/esm/types/PlaneTrackerAPI.test.js

@@ -0,0 +1,115 @@
+import { cameraSettingsSchema } from './PlaneTrackerAPI';
+import { describe, test, expect } from '@jest/globals';
+const AIRCRAFT_LABEL = {
+    firstRow: 'icao',
+    secondRow: 'call_sign',
+    thirdRow: 'blank',
+    fourthRow: 'registration',
+    opacity: 50,
+};
+const DEFAULT_DRONE_LABEL = { firstRow: 'remote_id', opacity: 30 };
+describe('cameraSettingsSchema identificationLabel', () => {
+    test('defaults both aircraft and drone labels', () => {
+        expect(cameraSettingsSchema.parse({}).identificationLabel).toEqual({
+            aircraft: {
+                firstRow: 'icao',
+                secondRow: 'call_sign',
+                thirdRow: 'blank',
+                fourthRow: 'blank',
+                opacity: 30,
+            },
+            drone: DEFAULT_DRONE_LABEL,
+        });
+    });
+    test('parses the aircraft and drone label', () => {
+        const identificationLabel = { aircraft: AIRCRAFT_LABEL, drone: { firstRow: 'blank', opacity: 70 } };
+        expect(cameraSettingsSchema.parse({ identificationLabel }).identificationLabel).toEqual(identificationLabel);
+    });
+    test('defaults a missing drone label', () => {
+        expect(cameraSettingsSchema.parse({ identificationLabel: { aircraft: AIRCRAFT_LABEL } }).identificationLabel).toEqual({ aircraft: AIRCRAFT_LABEL, drone: DEFAULT_DRONE_LABEL });
+    });
+    test('converts the legacy flat label to the aircraft label', () => {
+        expect(cameraSettingsSchema.parse({ identificationLabel: AIRCRAFT_LABEL }).identificationLabel).toEqual({
+            aircraft: AIRCRAFT_LABEL,
+            drone: DEFAULT_DRONE_LABEL,
+        });
+    });
+    test('returns an independent drone label for each legacy parse', () => {
+        const first = cameraSettingsSchema.parse({ identificationLabel: AIRCRAFT_LABEL });
+        first.identificationLabel.drone.opacity = 90;
+        const second = cameraSettingsSchema.parse({ identificationLabel: AIRCRAFT_LABEL });
+        expect(second.identificationLabel.drone).toEqual(DEFAULT_DRONE_LABEL);
+    });
+    test('rejects an unknown drone label row', () => {
+        const identificationLabel = { aircraft: AIRCRAFT_LABEL, drone: { firstRow: 'icao', opacity: 30 } };
+        expect(cameraSettingsSchema.safeParse({ identificationLabel }).success).toBe(false);
+    });
+});
+const CAPTURE_CONFIG = { defaultCaptureSizeMeters: 50, captureSizeExtensionMeters: 20 };
+const DEFAULT_CAPTURE_CONFIG = { defaultCaptureSizeMeters: 120, captureSizeExtensionMeters: 80 };
+describe('cameraSettingsSchema cameraConfig', () => {
+    test('defaults both aircraft and drone capture config', () => {
+        expect(cameraSettingsSchema.parse({}).cameraConfig).toEqual({
+            aircraft: DEFAULT_CAPTURE_CONFIG,
+            drone: DEFAULT_CAPTURE_CONFIG,
+        });
+    });
+    test('parses independent aircraft and drone capture config', () => {
+        const cameraConfig = {
+            aircraft: CAPTURE_CONFIG,
+            drone: { defaultCaptureSizeMeters: 5, captureSizeExtensionMeters: 3 },
+        };
+        expect(cameraSettingsSchema.parse({ cameraConfig }).cameraConfig).toEqual(cameraConfig);
+    });
+    test('defaults a missing drone capture config', () => {
+        expect(cameraSettingsSchema.parse({ cameraConfig: { aircraft: CAPTURE_CONFIG } }).cameraConfig).toEqual({
+            aircraft: CAPTURE_CONFIG,
+            drone: DEFAULT_CAPTURE_CONFIG,
+        });
+    });
+    test('copies the legacy flat capture config to both aircraft and drone', () => {
+        expect(cameraSettingsSchema.parse({ cameraConfig: CAPTURE_CONFIG }).cameraConfig).toEqual({
+            aircraft: CAPTURE_CONFIG,
+            drone: CAPTURE_CONFIG,
+        });
+    });
+    test('returns independent aircraft and drone objects', () => {
+        const legacy = cameraSettingsSchema.parse({ cameraConfig: CAPTURE_CONFIG }).cameraConfig;
+        legacy.drone.defaultCaptureSizeMeters = 1;
+        expect(legacy.aircraft).toEqual(CAPTURE_CONFIG);
+        const first = cameraSettingsSchema.parse({}).cameraConfig;
+        first.drone.defaultCaptureSizeMeters = 1;
+        expect(cameraSettingsSchema.parse({}).cameraConfig.drone).toEqual(DEFAULT_CAPTURE_CONFIG);
+    });
+    test('rejects a non-positive drone capture size', () => {
+        const cameraConfig = { aircraft: CAPTURE_CONFIG, drone: { ...CAPTURE_CONFIG, defaultCaptureSizeMeters: 0 } };
+        expect(cameraSettingsSchema.safeParse({ cameraConfig }).success).toBe(false);
+    });
+});
+describe('cameraSettingsSchema widget units', () => {
+    const WIDGET = { coord: 'top_left', posX: 10, posY: 10, scale: 100 };
+    test('defaults all widget units to rotate', () => {
+        const settings = cameraSettingsSchema.parse({});
+        expect(settings.widget.units).toBe('rotate');
+        expect(settings.airportWidget.windSpeedUnits).toBe('rotate');
+        expect(settings.airportWidget.temperatureUnits).toBe('rotate');
+    });
+    test('defaults missing units of saved widgets to rotate', () => {
+        const settings = cameraSettingsSchema.parse({ widget: WIDGET, airportWidget: WIDGET });
+        expect(settings.widget.units).toBe('rotate');
+        expect(settings.airportWidget.windSpeedUnits).toBe('rotate');
+        expect(settings.airportWidget.temperatureUnits).toBe('rotate');
+    });
+    test('parses independent widget units', () => {
+        const settings = cameraSettingsSchema.parse({
+            widget: { ...WIDGET, units: 'imperial' },
+            airportWidget: { ...WIDGET, windSpeedUnits: 'rotate', temperatureUnits: 'metric' },
+        });
+        expect(settings.widget.units).toBe('imperial');
+        expect(settings.airportWidget.windSpeedUnits).toBe('rotate');
+        expect(settings.airportWidget.temperatureUnits).toBe('metric');
+    });
+    test('rejects an unknown widget unit', () => {
+        expect(cameraSettingsSchema.safeParse({ widget: { ...WIDGET, units: 'kelvin' } }).success).toBe(false);
+    });
+});

package/esm/types/common.js

@@ -12,6 +12,11 @@ export const networkCameraListSchema = z.array(z.object({
 }));
 export const keyboardShortcutSchema = z.string().nullable();
 export const keyboardShortcutsSchema = z.record(keyboardShortcutSchema);
+export const wsAliasResponseSchema = z.object({
+    alias: z.string(),
+    ws: z.string(),
+    ws_initial_message: z.string(),
+});
 export const bitrateModeSchema = z.union([z.literal('VBR'), z.literal('MBR'), z.literal('ABR')]);
 export const bitrateVapixParamsSchema = z.object({
     bitrateMode: bitrateModeSchema,