camstreamerlib 4.0.16 → 4.0.17-dev-milestone.1

package/cjs/PlaneTrackerAPI.d.ts

@@ -1,5 +1,5 @@
 import { IClient, TResponse } from './internal/types';
-import { ICAO, TBlackList, TCameraSettings, TExportDataType, TGetIcaoByOption, TImportDataType, TPriorityList, TTrackingMode, TWhiteList, TZones } from './types/PlaneTrackerAPI';
+import { ICAO, TBlackList, TCameraSettings, TConnection, TExportDataType, TGetIcaoByOption, TImportDataType, TMilestoneCameraOption, TPriorityList, TTrackingMode, TWhiteList, TZones } from './types/PlaneTrackerAPI';
 import { THttpRequestOptions } from './types/common';
 import { BasicAPI } from './internal/BasicAPI';
 import { TApiUser } from './types/ws/PlaneTrackerEvents';
@@ -107,6 +107,15 @@ export declare class PlaneTrackerAPI<Client extends IClient<TResponse, any>> ext
             protocol: "https" | "http" | "https_insecure";
             sourceKey: string;
         };
+        milestone: {
+            ip: string;
+            enabled: boolean;
+            port: number;
+            cameraList: string[];
+            pass: string;
+            user: string;
+            protocol: "https" | "http" | "https_insecure";
+        };
         camstreamerIntegration: {
             adPlacementEnabled: boolean;
             adMinIntervalSec: number;
@@ -250,5 +259,7 @@ export declare class PlaneTrackerAPI<Client extends IClient<TResponse, any>> ext
     }>;
     setZones(zones: TZones, options?: THttpRequestOptions): Promise<void>;
     goToCoordinates(lat: number, lon: number, alt?: number, options?: THttpRequestOptions): Promise<void>;
+    checkMilestoneConnection(params: TConnection, options?: THttpRequestOptions): Promise<boolean>;
+    getMilestoneCameraList(params: TConnection, options?: THttpRequestOptions): Promise<TMilestoneCameraOption[]>;
     downloadReport(options?: THttpRequestOptions): Promise<string>;
 }

package/cjs/PlaneTrackerAPI.js

@@ -196,6 +196,19 @@ class PlaneTrackerAPI extends BasicAPI_1.BasicAPI {
             }
         }
     }
+    async checkMilestoneConnection(params, options) {
+        try {
+            await this._postUrlEncoded(`${BASE_PATH}/package/checkMilestoneConnection.cgi`, { ...params }, options);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getMilestoneCameraList(params, options) {
+        const res = await this._postUrlEncoded(`${BASE_PATH}/package/getMilestoneCameraList.cgi`, { ...params }, options);
+        return PlaneTrackerAPI_1.milestoneCameraListSchema.parse(await res.json());
+    }
     downloadReport(options) {
         return this._getText(`${BASE_PATH}/report.cgi`, undefined, options);
     }

package/cjs/node/events/MilestoneAgent.d.ts

@@ -0,0 +1,14 @@
+import { MilestoneAgentOptions, TBookmark, TMilestoneCamera } from '../../types/MilestoneAgent';
+export declare class MilestoneAgent {
+    private settings;
+    private protocol;
+    private sender;
+    private token?;
+    constructor(options?: MilestoneAgentOptions);
+    checkConnection(): Promise<void>;
+    getAllCameras(): Promise<TMilestoneCamera[]>;
+    sendBookmark(cameraId: string, bookmark: TBookmark): Promise<void>;
+    private getCamerasPage;
+    private getToken;
+    private getRequestOptions;
+}

package/cjs/node/events/MilestoneAgent.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MilestoneAgent = void 0;
+const errors_1 = require("../../errors/errors");
+const HttpRequestSender_1 = require("../HttpRequestSender");
+const MilestoneAgent_1 = require("../../types/MilestoneAgent");
+const CLIENT_ID = 'GrantValidatorClient';
+const PAGE_SIZE = 100;
+const TOKEN_EXPIRY_MARGIN_SEC = 60;
+class MilestoneAgent {
+    settings;
+    protocol;
+    sender;
+    token;
+    constructor(options = {}) {
+        this.settings = {
+            protocol: options.protocol ?? 'https_insecure',
+            ip: options.ip ?? '127.0.0.1',
+            port: options.port ?? 443,
+            user: options.user ?? '',
+            pass: options.pass ?? '',
+            timeout: options.timeout ?? 10000,
+        };
+        this.protocol = this.settings.protocol === 'http' ? 'http:' : 'https:';
+        const tlsInsecure = this.settings.protocol === 'https_insecure';
+        this.sender = new HttpRequestSender_1.HttpRequestSender({ rejectUnaurhorized: !tlsInsecure });
+    }
+    async checkConnection() {
+        await this.getToken(true);
+        await this.getCamerasPage(1, 1);
+    }
+    async getAllCameras() {
+        const cameras = [];
+        let page = 1;
+        for (;;) {
+            const pageCameras = await this.getCamerasPage(page, PAGE_SIZE);
+            cameras.push(...pageCameras);
+            if (pageCameras.length < PAGE_SIZE) {
+                break;
+            }
+            page += 1;
+        }
+        return cameras;
+    }
+    async sendBookmark(cameraId, bookmark) {
+        const token = await this.getToken();
+        const body = JSON.stringify({
+            ...bookmark,
+            devicePath: { type: 'cameras', id: cameraId },
+        });
+        const res = await this.sender.sendRequest(this.getRequestOptions('POST', '/api/rest/v1/bookmarks', token, {
+            'Content-Type': 'application/json',
+        }), body);
+        if (!res.ok) {
+            throw new errors_1.ErrorWithResponse(res);
+        }
+    }
+    async getCamerasPage(page, itemsPerPage) {
+        const token = await this.getToken();
+        const res = await this.sender.sendRequest(this.getRequestOptions('GET', `/api/rest/v1/cameras?page=${page}&itemsPerPage=${itemsPerPage}`, token));
+        if (!res.ok) {
+            throw new errors_1.ErrorWithResponse(res);
+        }
+        const responseBody = await res.text();
+        const result = await MilestoneAgent_1.camerasResponseSchema.safeParseAsync(JSON.parse(responseBody));
+        if (!result.success) {
+            throw new Error('Milestone get cameras failed: ' + JSON.stringify(result.error.issues) + '\n' + responseBody);
+        }
+        return result.data.array;
+    }
+    async getToken(forceRefresh = false) {
+        const nowSec = Date.now() / 1000;
+        if (!forceRefresh && this.token !== undefined && this.token.expiresAt > nowSec) {
+            return this.token.value;
+        }
+        const body = new URLSearchParams({
+            grant_type: 'password',
+            username: this.settings.user,
+            password: this.settings.pass,
+            client_id: CLIENT_ID,
+        }).toString();
+        const res = await this.sender.sendRequest({
+            method: 'POST',
+            protocol: this.protocol,
+            host: this.settings.ip,
+            port: this.settings.port,
+            path: '/idp/connect/token',
+            timeout: this.settings.timeout,
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'Accept': 'application/json',
+            },
+        }, body);
+        if (!res.ok) {
+            throw new errors_1.ErrorWithResponse(res);
+        }
+        const responseBody = await res.text();
+        const result = await MilestoneAgent_1.tokenResponseSchema.safeParseAsync(JSON.parse(responseBody));
+        if (!result.success) {
+            throw new Error('Milestone authorization failed: ' + JSON.stringify(result.error.issues) + '\n' + responseBody);
+        }
+        this.token = {
+            value: result.data.access_token,
+            expiresAt: nowSec + result.data.expires_in - TOKEN_EXPIRY_MARGIN_SEC,
+        };
+        return this.token.value;
+    }
+    getRequestOptions(method, path, token, extraHeaders) {
+        return {
+            method,
+            protocol: this.protocol,
+            host: this.settings.ip,
+            port: this.settings.port,
+            path,
+            timeout: this.settings.timeout,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/json',
+                ...extraHeaders,
+            },
+        };
+    }
+}
+exports.MilestoneAgent = MilestoneAgent;

package/cjs/node/index.d.ts

@@ -6,6 +6,8 @@ export * from './events/AxisCameraStationEvents';
 export * from './TimeZoneDaemon';
 export * from './events/GenetecAgent';
 export * from '../types/GenetecAgent';
+export * from './events/MilestoneAgent';
+export * from '../types/MilestoneAgent';
 export { ResourceManager } from './CamOverlayPainter/ResourceManager';
 export { Painter } from './CamOverlayPainter/Painter';
 export { Frame } from './CamOverlayPainter/Frame';

package/cjs/node/index.js

@@ -23,6 +23,8 @@ __exportStar(require("./events/AxisCameraStationEvents"), exports);
 __exportStar(require("./TimeZoneDaemon"), exports);
 __exportStar(require("./events/GenetecAgent"), exports);
 __exportStar(require("../types/GenetecAgent"), exports);
+__exportStar(require("./events/MilestoneAgent"), exports);
+__exportStar(require("../types/MilestoneAgent"), exports);
 var ResourceManager_1 = require("./CamOverlayPainter/ResourceManager");
 Object.defineProperty(exports, "ResourceManager", { enumerable: true, get: function () { return ResourceManager_1.ResourceManager; } });
 var Painter_1 = require("./CamOverlayPainter/Painter");

package/cjs/types/MilestoneAgent.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+export type MilestoneAgentOptions = {
+    protocol?: 'http' | 'https' | 'https_insecure';
+    ip?: string;
+    port?: number;
+    user?: string;
+    pass?: string;
+    timeout?: number;
+};
+export declare const tokenResponseSchema: z.ZodObject<{
+    access_token: z.ZodString;
+    expires_in: z.ZodNumber;
+    token_type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    access_token: string;
+    expires_in: number;
+    token_type: string;
+}, {
+    access_token: string;
+    expires_in: number;
+    token_type: string;
+}>;
+export type TTokenResponse = z.infer<typeof tokenResponseSchema>;
+export declare const milestoneCameraSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | undefined;
+    enabled?: boolean | undefined;
+    displayName?: string | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    enabled?: boolean | undefined;
+    displayName?: string | undefined;
+}>;
+export type TMilestoneCamera = z.infer<typeof milestoneCameraSchema>;
+export declare const camerasResponseSchema: z.ZodObject<{
+    array: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }, {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    array: {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }[];
+}, {
+    array: {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }[];
+}>;
+export type TCamerasResponse = z.infer<typeof camerasResponseSchema>;
+export type TBookmark = {
+    header: string;
+    description: string;
+    timeBegin: string;
+    timeEnd: string;
+    timeTriggered: string;
+    reference: string;
+};

package/cjs/types/MilestoneAgent.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.camerasResponseSchema = exports.milestoneCameraSchema = exports.tokenResponseSchema = void 0;
+const zod_1 = require("zod");
+exports.tokenResponseSchema = zod_1.z.object({
+    access_token: zod_1.z.string(),
+    expires_in: zod_1.z.number(),
+    token_type: zod_1.z.string(),
+});
+exports.milestoneCameraSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string().optional(),
+    displayName: zod_1.z.string().optional(),
+    enabled: zod_1.z.boolean().optional(),
+});
+exports.camerasResponseSchema = zod_1.z.object({
+    array: zod_1.z.array(exports.milestoneCameraSchema),
+});

package/cjs/types/PlaneTrackerAPI.d.ts

@@ -33,6 +33,21 @@ export declare const connectionSchema: z.ZodObject<{
     user: string;
     protocol: "https" | "http" | "https_insecure";
 }>;
+export type TConnection = z.infer<typeof connectionSchema>;
+export declare const milestoneCameraListSchema: z.ZodArray<z.ZodObject<{
+    index: z.ZodNumber;
+    value: z.ZodString;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+    index: number;
+}, {
+    value: string;
+    label: string;
+    index: number;
+}>, "many">;
+export type TMilestoneCameraOption = z.infer<typeof milestoneCameraListSchema>[number];
 export declare const widgetSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     coord: z.ZodUnion<[z.ZodLiteral<"top_left">, z.ZodLiteral<"top_right">, z.ZodLiteral<"bottom_left">, z.ZodLiteral<"bottom_right">]>;
@@ -358,6 +373,32 @@ export declare const cameraSettingsSchema: z.ZodObject<{
         protocol: "https" | "http" | "https_insecure";
         sourceKey: string;
     }>>;
+    milestone: z.ZodDefault<z.ZodObject<{
+        protocol: z.ZodUnion<[z.ZodLiteral<"http">, z.ZodLiteral<"https">, z.ZodLiteral<"https_insecure">]>;
+        ip: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+        port: z.ZodNumber;
+        user: z.ZodString;
+        pass: z.ZodString;
+    } & {
+        enabled: z.ZodBoolean;
+        cameraList: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        cameraList: string[];
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+    }, {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+        cameraList?: string[] | undefined;
+    }>>;
     camstreamerIntegration: z.ZodDefault<z.ZodObject<{
         adPlacementEnabled: z.ZodBoolean;
         adMinIntervalSec: z.ZodNumber;
@@ -463,6 +504,15 @@ export declare const cameraSettingsSchema: z.ZodObject<{
         protocol: "https" | "http" | "https_insecure";
         sourceKey: string;
     };
+    milestone: {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        cameraList: string[];
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+    };
     camstreamerIntegration: {
         adPlacementEnabled: boolean;
         adMinIntervalSec: number;
@@ -606,6 +656,15 @@ export declare const cameraSettingsSchema: z.ZodObject<{
         protocol: "https" | "http" | "https_insecure";
         sourceKey: string;
     } | undefined;
+    milestone?: {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+        cameraList?: string[] | undefined;
+    } | undefined;
     camstreamerIntegration?: {
         adPlacementEnabled: boolean;
         adMinIntervalSec: number;

package/cjs/types/PlaneTrackerAPI.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REMOTE_ID_CATEGORY_IDS = exports.ADSB_CATEGORY_IDS = exports.domainListSchema = exports.domainIdSchema = exports.zonesSchema = exports.mapInfoSchema = exports.mapTypeSchema = exports.priorityListSchema = exports.blackListSchema = exports.whiteListSchema = exports.priorityListEntrySchema = exports.listEntrySchema = exports.listEntryIdTypeSchema = exports.listEntryDomainSchema = exports.flightInfoSchema = exports.trackingModeSchema = exports.getIcaoSchema = exports.serverSettingsSchema = exports.cameraSettingsSchema = exports.widgetSchema = exports.connectionSchema = exports.wsAliasResponseSchema = void 0;
+exports.REMOTE_ID_CATEGORY_IDS = exports.ADSB_CATEGORY_IDS = exports.domainListSchema = exports.domainIdSchema = exports.zonesSchema = exports.mapInfoSchema = exports.mapTypeSchema = exports.priorityListSchema = exports.blackListSchema = exports.whiteListSchema = exports.priorityListEntrySchema = exports.listEntrySchema = exports.listEntryIdTypeSchema = exports.listEntryDomainSchema = exports.flightInfoSchema = exports.trackingModeSchema = exports.getIcaoSchema = exports.serverSettingsSchema = exports.cameraSettingsSchema = exports.widgetSchema = exports.milestoneCameraListSchema = exports.connectionSchema = exports.wsAliasResponseSchema = void 0;
 const zod_1 = require("zod");
 exports.wsAliasResponseSchema = zod_1.z.object({
     alias: zod_1.z.string(),
@@ -14,6 +14,13 @@ exports.connectionSchema = zod_1.z.object({
     user: zod_1.z.string(),
     pass: zod_1.z.string(),
 });
+exports.milestoneCameraListSchema = zod_1.z
+    .object({
+    index: zod_1.z.number(),
+    value: zod_1.z.string(),
+    label: zod_1.z.string(),
+})
+    .array();
 exports.widgetSchema = zod_1.z.object({
     enabled: zod_1.z.boolean().default(true),
     coord: zod_1.z.union([
@@ -202,6 +209,20 @@ exports.cameraSettingsSchema = zod_1.z.object({
         pass: '',
         sourceKey: '',
     }),
+    milestone: exports.connectionSchema
+        .extend({
+        enabled: zod_1.z.boolean(),
+        cameraList: zod_1.z.string().array().default([]),
+    })
+        .default({
+        enabled: false,
+        protocol: 'https_insecure',
+        ip: '',
+        port: 443,
+        user: '',
+        pass: '',
+        cameraList: [],
+    }),
     camstreamerIntegration: zod_1.z
         .object({
         adPlacementEnabled: zod_1.z.boolean(),

package/esm/PlaneTrackerAPI.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { blackListSchema, cameraSettingsSchema, domainListSchema, flightInfoSchema, getIcaoSchema, mapInfoSchema, priorityListSchema, serverSettingsSchema, trackingModeSchema, whiteListSchema, wsAliasResponseSchema, zonesSchema, } from './types/PlaneTrackerAPI';
+import { blackListSchema, cameraSettingsSchema, domainListSchema, flightInfoSchema, getIcaoSchema, mapInfoSchema, milestoneCameraListSchema, priorityListSchema, serverSettingsSchema, trackingModeSchema, whiteListSchema, wsAliasResponseSchema, zonesSchema, } from './types/PlaneTrackerAPI';
 import { CannotSetCoordsInAutoModeError, ImportSettingsError, InvalidAltitudeError, InvalidLatLngError, ResetCalibrationError, ServerError, BadRequestError, } from './errors/errors';
 import { BasicAPI } from './internal/BasicAPI';
 const BASE_PATH = '/local/planetracker';
@@ -193,6 +193,19 @@ export class PlaneTrackerAPI extends BasicAPI {
             }
         }
     }
+    async checkMilestoneConnection(params, options) {
+        try {
+            await this._postUrlEncoded(`${BASE_PATH}/package/checkMilestoneConnection.cgi`, { ...params }, options);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getMilestoneCameraList(params, options) {
+        const res = await this._postUrlEncoded(`${BASE_PATH}/package/getMilestoneCameraList.cgi`, { ...params }, options);
+        return milestoneCameraListSchema.parse(await res.json());
+    }
     downloadReport(options) {
         return this._getText(`${BASE_PATH}/report.cgi`, undefined, options);
     }

package/esm/node/events/MilestoneAgent.js

@@ -0,0 +1,120 @@
+import { ErrorWithResponse } from '../../errors/errors';
+import { HttpRequestSender } from '../HttpRequestSender';
+import { camerasResponseSchema, tokenResponseSchema, } from '../../types/MilestoneAgent';
+const CLIENT_ID = 'GrantValidatorClient';
+const PAGE_SIZE = 100;
+const TOKEN_EXPIRY_MARGIN_SEC = 60;
+export class MilestoneAgent {
+    settings;
+    protocol;
+    sender;
+    token;
+    constructor(options = {}) {
+        this.settings = {
+            protocol: options.protocol ?? 'https_insecure',
+            ip: options.ip ?? '127.0.0.1',
+            port: options.port ?? 443,
+            user: options.user ?? '',
+            pass: options.pass ?? '',
+            timeout: options.timeout ?? 10000,
+        };
+        this.protocol = this.settings.protocol === 'http' ? 'http:' : 'https:';
+        const tlsInsecure = this.settings.protocol === 'https_insecure';
+        this.sender = new HttpRequestSender({ rejectUnaurhorized: !tlsInsecure });
+    }
+    async checkConnection() {
+        await this.getToken(true);
+        await this.getCamerasPage(1, 1);
+    }
+    async getAllCameras() {
+        const cameras = [];
+        let page = 1;
+        for (;;) {
+            const pageCameras = await this.getCamerasPage(page, PAGE_SIZE);
+            cameras.push(...pageCameras);
+            if (pageCameras.length < PAGE_SIZE) {
+                break;
+            }
+            page += 1;
+        }
+        return cameras;
+    }
+    async sendBookmark(cameraId, bookmark) {
+        const token = await this.getToken();
+        const body = JSON.stringify({
+            ...bookmark,
+            devicePath: { type: 'cameras', id: cameraId },
+        });
+        const res = await this.sender.sendRequest(this.getRequestOptions('POST', '/api/rest/v1/bookmarks', token, {
+            'Content-Type': 'application/json',
+        }), body);
+        if (!res.ok) {
+            throw new ErrorWithResponse(res);
+        }
+    }
+    async getCamerasPage(page, itemsPerPage) {
+        const token = await this.getToken();
+        const res = await this.sender.sendRequest(this.getRequestOptions('GET', `/api/rest/v1/cameras?page=${page}&itemsPerPage=${itemsPerPage}`, token));
+        if (!res.ok) {
+            throw new ErrorWithResponse(res);
+        }
+        const responseBody = await res.text();
+        const result = await camerasResponseSchema.safeParseAsync(JSON.parse(responseBody));
+        if (!result.success) {
+            throw new Error('Milestone get cameras failed: ' + JSON.stringify(result.error.issues) + '\n' + responseBody);
+        }
+        return result.data.array;
+    }
+    async getToken(forceRefresh = false) {
+        const nowSec = Date.now() / 1000;
+        if (!forceRefresh && this.token !== undefined && this.token.expiresAt > nowSec) {
+            return this.token.value;
+        }
+        const body = new URLSearchParams({
+            grant_type: 'password',
+            username: this.settings.user,
+            password: this.settings.pass,
+            client_id: CLIENT_ID,
+        }).toString();
+        const res = await this.sender.sendRequest({
+            method: 'POST',
+            protocol: this.protocol,
+            host: this.settings.ip,
+            port: this.settings.port,
+            path: '/idp/connect/token',
+            timeout: this.settings.timeout,
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'Accept': 'application/json',
+            },
+        }, body);
+        if (!res.ok) {
+            throw new ErrorWithResponse(res);
+        }
+        const responseBody = await res.text();
+        const result = await tokenResponseSchema.safeParseAsync(JSON.parse(responseBody));
+        if (!result.success) {
+            throw new Error('Milestone authorization failed: ' + JSON.stringify(result.error.issues) + '\n' + responseBody);
+        }
+        this.token = {
+            value: result.data.access_token,
+            expiresAt: nowSec + result.data.expires_in - TOKEN_EXPIRY_MARGIN_SEC,
+        };
+        return this.token.value;
+    }
+    getRequestOptions(method, path, token, extraHeaders) {
+        return {
+            method,
+            protocol: this.protocol,
+            host: this.settings.ip,
+            port: this.settings.port,
+            path,
+            timeout: this.settings.timeout,
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/json',
+                ...extraHeaders,
+            },
+        };
+    }
+}

package/esm/node/index.js

@@ -6,6 +6,8 @@ export * from './events/AxisCameraStationEvents';
 export * from './TimeZoneDaemon';
 export * from './events/GenetecAgent';
 export * from '../types/GenetecAgent';
+export * from './events/MilestoneAgent';
+export * from '../types/MilestoneAgent';
 export { ResourceManager } from './CamOverlayPainter/ResourceManager';
 export { Painter } from './CamOverlayPainter/Painter';
 export { Frame } from './CamOverlayPainter/Frame';

package/esm/types/MilestoneAgent.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export const tokenResponseSchema = z.object({
+    access_token: z.string(),
+    expires_in: z.number(),
+    token_type: z.string(),
+});
+export const milestoneCameraSchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    displayName: z.string().optional(),
+    enabled: z.boolean().optional(),
+});
+export const camerasResponseSchema = z.object({
+    array: z.array(milestoneCameraSchema),
+});

package/esm/types/PlaneTrackerAPI.js

@@ -11,6 +11,13 @@ export const connectionSchema = z.object({
     user: z.string(),
     pass: z.string(),
 });
+export const milestoneCameraListSchema = z
+    .object({
+    index: z.number(),
+    value: z.string(),
+    label: z.string(),
+})
+    .array();
 export const widgetSchema = z.object({
     enabled: z.boolean().default(true),
     coord: z.union([
@@ -199,6 +206,20 @@ export const cameraSettingsSchema = z.object({
         pass: '',
         sourceKey: '',
     }),
+    milestone: connectionSchema
+        .extend({
+        enabled: z.boolean(),
+        cameraList: z.string().array().default([]),
+    })
+        .default({
+        enabled: false,
+        protocol: 'https_insecure',
+        ip: '',
+        port: 443,
+        user: '',
+        pass: '',
+        cameraList: [],
+    }),
     camstreamerIntegration: z
         .object({
         adPlacementEnabled: z.boolean(),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "camstreamerlib",
-    "version": "4.0.16",
+    "version": "4.0.17-dev-milestone.1",
     "description": "Helper library for CamStreamer ACAP applications.",
     "prettier": "@camstreamer/prettier-config",
     "engine": {

package/types/PlaneTrackerAPI.d.ts

@@ -1,5 +1,5 @@
 import { IClient, TResponse } from './internal/types';
-import { ICAO, TBlackList, TCameraSettings, TExportDataType, TGetIcaoByOption, TImportDataType, TPriorityList, TTrackingMode, TWhiteList, TZones } from './types/PlaneTrackerAPI';
+import { ICAO, TBlackList, TCameraSettings, TConnection, TExportDataType, TGetIcaoByOption, TImportDataType, TMilestoneCameraOption, TPriorityList, TTrackingMode, TWhiteList, TZones } from './types/PlaneTrackerAPI';
 import { THttpRequestOptions } from './types/common';
 import { BasicAPI } from './internal/BasicAPI';
 import { TApiUser } from './types/ws/PlaneTrackerEvents';
@@ -107,6 +107,15 @@ export declare class PlaneTrackerAPI<Client extends IClient<TResponse, any>> ext
             protocol: "https" | "http" | "https_insecure";
             sourceKey: string;
         };
+        milestone: {
+            ip: string;
+            enabled: boolean;
+            port: number;
+            cameraList: string[];
+            pass: string;
+            user: string;
+            protocol: "https" | "http" | "https_insecure";
+        };
         camstreamerIntegration: {
             adPlacementEnabled: boolean;
             adMinIntervalSec: number;
@@ -250,5 +259,7 @@ export declare class PlaneTrackerAPI<Client extends IClient<TResponse, any>> ext
     }>;
     setZones(zones: TZones, options?: THttpRequestOptions): Promise<void>;
     goToCoordinates(lat: number, lon: number, alt?: number, options?: THttpRequestOptions): Promise<void>;
+    checkMilestoneConnection(params: TConnection, options?: THttpRequestOptions): Promise<boolean>;
+    getMilestoneCameraList(params: TConnection, options?: THttpRequestOptions): Promise<TMilestoneCameraOption[]>;
     downloadReport(options?: THttpRequestOptions): Promise<string>;
 }

package/types/node/events/MilestoneAgent.d.ts

@@ -0,0 +1,14 @@
+import { MilestoneAgentOptions, TBookmark, TMilestoneCamera } from '../../types/MilestoneAgent';
+export declare class MilestoneAgent {
+    private settings;
+    private protocol;
+    private sender;
+    private token?;
+    constructor(options?: MilestoneAgentOptions);
+    checkConnection(): Promise<void>;
+    getAllCameras(): Promise<TMilestoneCamera[]>;
+    sendBookmark(cameraId: string, bookmark: TBookmark): Promise<void>;
+    private getCamerasPage;
+    private getToken;
+    private getRequestOptions;
+}

package/types/node/index.d.ts

@@ -6,6 +6,8 @@ export * from './events/AxisCameraStationEvents';
 export * from './TimeZoneDaemon';
 export * from './events/GenetecAgent';
 export * from '../types/GenetecAgent';
+export * from './events/MilestoneAgent';
+export * from '../types/MilestoneAgent';
 export { ResourceManager } from './CamOverlayPainter/ResourceManager';
 export { Painter } from './CamOverlayPainter/Painter';
 export { Frame } from './CamOverlayPainter/Frame';

package/types/types/MilestoneAgent.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+export type MilestoneAgentOptions = {
+    protocol?: 'http' | 'https' | 'https_insecure';
+    ip?: string;
+    port?: number;
+    user?: string;
+    pass?: string;
+    timeout?: number;
+};
+export declare const tokenResponseSchema: z.ZodObject<{
+    access_token: z.ZodString;
+    expires_in: z.ZodNumber;
+    token_type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    access_token: string;
+    expires_in: number;
+    token_type: string;
+}, {
+    access_token: string;
+    expires_in: number;
+    token_type: string;
+}>;
+export type TTokenResponse = z.infer<typeof tokenResponseSchema>;
+export declare const milestoneCameraSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | undefined;
+    enabled?: boolean | undefined;
+    displayName?: string | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    enabled?: boolean | undefined;
+    displayName?: string | undefined;
+}>;
+export type TMilestoneCamera = z.infer<typeof milestoneCameraSchema>;
+export declare const camerasResponseSchema: z.ZodObject<{
+    array: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }, {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    array: {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }[];
+}, {
+    array: {
+        id: string;
+        name?: string | undefined;
+        enabled?: boolean | undefined;
+        displayName?: string | undefined;
+    }[];
+}>;
+export type TCamerasResponse = z.infer<typeof camerasResponseSchema>;
+export type TBookmark = {
+    header: string;
+    description: string;
+    timeBegin: string;
+    timeEnd: string;
+    timeTriggered: string;
+    reference: string;
+};

package/types/types/PlaneTrackerAPI.d.ts

@@ -33,6 +33,21 @@ export declare const connectionSchema: z.ZodObject<{
     user: string;
     protocol: "https" | "http" | "https_insecure";
 }>;
+export type TConnection = z.infer<typeof connectionSchema>;
+export declare const milestoneCameraListSchema: z.ZodArray<z.ZodObject<{
+    index: z.ZodNumber;
+    value: z.ZodString;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    label: string;
+    index: number;
+}, {
+    value: string;
+    label: string;
+    index: number;
+}>, "many">;
+export type TMilestoneCameraOption = z.infer<typeof milestoneCameraListSchema>[number];
 export declare const widgetSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     coord: z.ZodUnion<[z.ZodLiteral<"top_left">, z.ZodLiteral<"top_right">, z.ZodLiteral<"bottom_left">, z.ZodLiteral<"bottom_right">]>;
@@ -358,6 +373,32 @@ export declare const cameraSettingsSchema: z.ZodObject<{
         protocol: "https" | "http" | "https_insecure";
         sourceKey: string;
     }>>;
+    milestone: z.ZodDefault<z.ZodObject<{
+        protocol: z.ZodUnion<[z.ZodLiteral<"http">, z.ZodLiteral<"https">, z.ZodLiteral<"https_insecure">]>;
+        ip: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+        port: z.ZodNumber;
+        user: z.ZodString;
+        pass: z.ZodString;
+    } & {
+        enabled: z.ZodBoolean;
+        cameraList: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        cameraList: string[];
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+    }, {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+        cameraList?: string[] | undefined;
+    }>>;
     camstreamerIntegration: z.ZodDefault<z.ZodObject<{
         adPlacementEnabled: z.ZodBoolean;
         adMinIntervalSec: z.ZodNumber;
@@ -463,6 +504,15 @@ export declare const cameraSettingsSchema: z.ZodObject<{
         protocol: "https" | "http" | "https_insecure";
         sourceKey: string;
     };
+    milestone: {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        cameraList: string[];
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+    };
     camstreamerIntegration: {
         adPlacementEnabled: boolean;
         adMinIntervalSec: number;
@@ -606,6 +656,15 @@ export declare const cameraSettingsSchema: z.ZodObject<{
         protocol: "https" | "http" | "https_insecure";
         sourceKey: string;
     } | undefined;
+    milestone?: {
+        ip: string;
+        enabled: boolean;
+        port: number;
+        pass: string;
+        user: string;
+        protocol: "https" | "http" | "https_insecure";
+        cameraList?: string[] | undefined;
+    } | undefined;
     camstreamerIntegration?: {
         adPlacementEnabled: boolean;
         adMinIntervalSec: number;