@dronedeploy/rocos-js-sdk 3.0.1-alpha.2 → 3.0.1-alpha.5

package/esm/services/RTPWebRTCService.js

@@ -0,0 +1,227 @@
+import { RocosError, errorCodes } from '../models';
+import { Subject, scan, shareReplay } from 'rxjs';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { splitRobotTopic } from '../helpers/splitRobotTopic';
+export var WebRTCEventType;
+(function (WebRTCEventType) {
+    WebRTCEventType["LoadingTURNConfigs"] = "loading-turn-configs";
+    WebRTCEventType["Disconnected"] = "disconnected";
+    WebRTCEventType["DataChannelOpen"] = "data-channel-open";
+    WebRTCEventType["CreatingOffer"] = "creating-offer";
+    WebRTCEventType["AddingRemoteTrack"] = "adding-remote-track";
+    WebRTCEventType["ICEConnectionStateChange"] = "ice-connection-state-change";
+    WebRTCEventType["SendingOffer"] = "sending-offer";
+    WebRTCEventType["FailedGettingTURNConfig"] = "failed-getting-turn-config";
+    WebRTCEventType["GotTURNConfig"] = "got-turn-config";
+    WebRTCEventType["FailedGettingAnswer"] = "failed-getting-answer";
+    WebRTCEventType["GotAnswer"] = "got-answer";
+    WebRTCEventType["DataChannelMessage"] = "data-channel-message";
+})(WebRTCEventType || (WebRTCEventType = {}));
+export class RTPWebRTCService extends BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+    }
+    getStatus() {
+        return true;
+    }
+    getError(e) {
+        return new RocosError(e, errorCodes.WEBRTC_SERVICE_ERROR);
+    }
+    /** Create a new peer connection with a robot
+     *
+     * To connect, call `connect` on the returned connection
+     *
+     * If `logLevel` is set to trace, the connection will emit all messages as events
+     */
+    createPeerConnection(params) {
+        const isInsecure = this.config.insecure ?? false;
+        const port = this.config.port ?? (isInsecure ? 80 : 443);
+        return new WebRTCConnection({
+            endpoint: {
+                host: this.config.url,
+                port,
+                insecure: isInsecure,
+            },
+            token: this.config.token,
+            projectId: params.projectId,
+            callsign: params.callsign,
+            logLevel: params.logLevel,
+        });
+    }
+}
+export class WebRTCConnection {
+    constructor(params) {
+        this.errorsSubject$ = new Subject();
+        this.streamsSubject$ = new Subject();
+        this.eventsSubject$ = new Subject();
+        this.errors$ = this.errorsSubject$.asObservable();
+        this.events$ = this.eventsSubject$.asObservable();
+        this.streams$ = this.streamsSubject$.pipe(scan((streams, stream) => [...streams, stream].filter((i) => i.active), []), shareReplay(1));
+        this.endpoint = params.endpoint;
+        this.token = params.token;
+        this.projectId = params.projectId;
+        this.callsign = params.callsign;
+        this.logLevel = params.logLevel;
+    }
+    get peerConnectionAvailable() {
+        return !!this.pc;
+    }
+    /** Connect to the robot
+     *
+     * This will create a new peer connection, and send an offer to the robot.
+     * If a connection already exists, it will be disconnected first
+     *
+     * @throws {Error} if the offer fails
+     * @returns {Promise<void>} resolves when the connection is established
+     */
+    async connect() {
+        if (this.peerConnectionAvailable)
+            this.disconnect(); // disconnect any lingering connections
+        const config = await this.loadConfig();
+        const pc = this.createPeerConnection(config);
+        this.pc = pc;
+        // Creating data channel, must be done before creating the offer
+        const sendChannel = pc.createDataChannel('submanager');
+        sendChannel.onclose = () => this.log(WebRTCEventType.Disconnected);
+        sendChannel.onopen = () => {
+            this.log(WebRTCEventType.DataChannelOpen);
+        };
+        sendChannel.onmessage = (e) => {
+            this.log(WebRTCEventType.DataChannelMessage, {
+                label: sendChannel.label,
+                data: e.data,
+            });
+        };
+        // Offer to receive 1 audio, and 1 video track
+        pc.addTransceiver('video', { direction: 'recvonly' });
+        pc.addTransceiver('audio', { direction: 'recvonly' });
+        this.log(WebRTCEventType.CreatingOffer);
+        this.sendChannel = sendChannel;
+        await pc.createOffer().then((d) => pc.setLocalDescription(d));
+    }
+    /**
+     * Disconnect from the robot
+     */
+    disconnect() {
+        this.sendChannel?.close();
+        this.pc?.close();
+        this.pc = undefined;
+        this.sendChannel = undefined;
+    }
+    /**
+     * Subscribe to a video or audio topic
+     *
+     * This will send a message to the robot to start streaming the requested topic.
+     *
+     * Any data received will be sent to the streams emitted by `streams$`
+     */
+    subscribeToTopic(topic, type) {
+        if (!this.sendChannel) {
+            throw new Error(`Failed to start ${type}, no data channel available`);
+        }
+        if (!topic || topic.split('/').length < 1) {
+            throw new Error('Invalid Topic Provided');
+        }
+        const { component, topic: path } = splitRobotTopic(topic);
+        this.sendChannel.send(JSON.stringify({
+            projectId: this.projectId,
+            callsign: this.callsign,
+            component,
+            topic: path,
+            token: this.token,
+            logLevel: this.logLevel,
+            type,
+            mode: 'subscribe',
+        }));
+    }
+    async sendOffer(sdp) {
+        return fetch(this.getEndpoint('sdp'), {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+            },
+            body: JSON.stringify({
+                sdp,
+            }),
+        })
+            .then((res) => res.json())
+            .catch((err) => {
+            this.log(WebRTCEventType.FailedGettingAnswer);
+            throw new Error(err);
+        })
+            .then((res) => {
+            this.log(WebRTCEventType.GotAnswer);
+            return res;
+        });
+    }
+    async loadConfig() {
+        this.log(WebRTCEventType.LoadingTURNConfigs);
+        return fetch(this.getEndpoint('/sdp/configs'), {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+            },
+        })
+            .then((res) => res.json())
+            .catch((err) => {
+            this.log(WebRTCEventType.FailedGettingTURNConfig);
+            throw new Error(err);
+        })
+            .then((res) => {
+            this.log(WebRTCEventType.GotTURNConfig);
+            return res;
+        });
+    }
+    createPeerConnection(config) {
+        const pc = new RTCPeerConnection(config);
+        this.pc = pc;
+        pc.ontrack = (event) => {
+            if (!document) {
+                this.errorsSubject$.next(new Error('No browser - operation not supported'));
+            }
+            for (const stream of event.streams) {
+                this.streamsSubject$.next(stream);
+            }
+            this.log(WebRTCEventType.AddingRemoteTrack);
+        };
+        pc.oniceconnectionstatechange = () => {
+            this.log(WebRTCEventType.ICEConnectionStateChange, {
+                state: pc.iceConnectionState,
+            });
+            if (pc.iceConnectionState === 'failed') {
+                this.errorsSubject$.next(new Error('ICE Connection Failed'));
+            }
+        };
+        pc.onicecandidate = async (event) => {
+            if (event.candidate === null) {
+                const sdp = btoa(JSON.stringify(pc.localDescription));
+                this.log(WebRTCEventType.SendingOffer);
+                const { answer } = await this.sendOffer(sdp);
+                this.log(WebRTCEventType.GotAnswer);
+                try {
+                    await pc.setRemoteDescription(new RTCSessionDescription(JSON.parse(atob(answer))));
+                }
+                catch (e) {
+                    this.log(WebRTCEventType.FailedGettingAnswer);
+                    console.error('Failed to get answer', e);
+                    this.errorsSubject$.next(new Error('Failed to get answer'));
+                }
+            }
+        };
+        return pc;
+    }
+    getEndpoint(path) {
+        const { host, port, insecure } = this.endpoint;
+        const protocol = insecure ? 'http' : 'https';
+        const base = new URL(`${protocol}://${host}:${port}`);
+        if (path)
+            base.pathname = path;
+        return base.toString();
+    }
+    log(type, metadata) {
+        this.eventsSubject$.next({
+            type,
+            metadata,
+        });
+    }
+}

package/esm/services/RTPWebRTCService.spec.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @jest-environment jsdom
+ */
+export {};

package/esm/services/RTPWebRTCService.spec.js

@@ -0,0 +1,169 @@
+/**
+ * @jest-environment jsdom
+ */
+import { lastValueFrom, takeUntil, toArray } from 'rxjs';
+import { RTPWebRTCService } from './RTPWebRTCService';
+class WebRTCMockHelper {
+    constructor() {
+        this.dataChannel = {
+            label: 'submanager',
+            onopen: () => void 0,
+            onclose: () => void 0,
+            onmessage: (e) => void 0,
+            send: this.sendMessage.bind(this),
+            close: this.close.bind(this),
+        };
+        this.connection = {
+            ontrack: (event) => void 0,
+            oniceconnectionstatechange: () => void 0,
+            onicecandidate: async (event) => void 0,
+            setRemoteDescription: jest.fn(),
+            iceConnectionState: 'new',
+            localDescription: null,
+            createDataChannel: jest.fn().mockReturnValue(this.dataChannel),
+            addTransceiver: jest.fn(),
+            createOffer: this.createOffer.bind(this),
+            setLocalDescription: jest.fn(),
+            close: this.close.bind(this),
+        };
+        this.streams = [];
+    }
+    installMocks() {
+        ;
+        global.RTCPeerConnection = jest.fn().mockReturnValue(this.connection);
+        global.RTCSessionDescription = jest.fn();
+        this.mockFetch();
+    }
+    async createOffer() {
+        await this.connection.onicecandidate({
+            candidate: null,
+        });
+        this.connection.iceConnectionState = 'checking';
+        this.connection.oniceconnectionstatechange();
+        this.addTrack('my-stream-1');
+        this.addTrack('my-stream-2');
+        this.connection.iceConnectionState = 'connected';
+        this.connection.oniceconnectionstatechange();
+        this.dataChannel.onopen();
+        return {
+            sdp: 'my-sdp',
+            type: 'offer',
+        };
+    }
+    addTrack(name) {
+        const stream = { name, active: true };
+        this.streams.push(stream);
+        this.connection.ontrack({
+            streams: [stream],
+        });
+    }
+    close() {
+        this.streams.forEach((stream) => {
+            stream.active = false;
+        });
+        this.dataChannel.onclose();
+        this.connection.iceConnectionState = 'closed';
+        this.connection.oniceconnectionstatechange();
+    }
+    sendMessage(message) {
+        const { logLevel } = JSON.parse(message);
+        if (logLevel === 'trace') {
+            this.dataChannel.onmessage({
+                data: message,
+            });
+        }
+    }
+    mockFetch() {
+        global.fetch = jest.fn().mockImplementation((url) => {
+            switch (url) {
+                case 'https://localhost:0/sdp/configs':
+                    return Promise.resolve({
+                        json: () => ({
+                            iceServers: [
+                                {
+                                    urls: ['stun:turn.localhost:443'],
+                                },
+                            ],
+                        }),
+                    });
+                case 'https://localhost:0/sdp':
+                    return Promise.resolve({
+                        json: () => ({
+                            answer: btoa('null'),
+                        }),
+                    });
+                default:
+                    throw new Error(`Unexpected URL: ${url}`);
+            }
+        });
+    }
+}
+describe('RTPWebRTCService', () => {
+    let service;
+    beforeEach(() => {
+        service = new RTPWebRTCService({
+            url: 'localhost',
+            port: 0,
+            token: 'test',
+        });
+    });
+    describe('streams$', () => {
+        it('should emit a stream when a new stream is added', async () => {
+            // Arrange
+            new WebRTCMockHelper().installMocks();
+            const connection = service.createPeerConnection({
+                projectId: 'my-project',
+                callsign: 'my-callsign',
+                logLevel: 'trace',
+            });
+            // Act
+            const streams = await lastValueFrom(connection.streams$.pipe(takeUntil(connection.connect()), toArray()));
+            // Assert
+            expect(streams).toEqual([
+                [
+                    {
+                        name: 'my-stream-1',
+                        active: true,
+                    },
+                ],
+                [
+                    {
+                        name: 'my-stream-1',
+                        active: true,
+                    },
+                    {
+                        name: 'my-stream-2',
+                        active: true,
+                    },
+                ],
+            ]);
+        });
+        it('should reset the streams when the connection is disconnected and the streams become inactive', async () => {
+            // Arrange
+            new WebRTCMockHelper().installMocks();
+            const connection = service.createPeerConnection({
+                projectId: 'my-project',
+                callsign: 'my-callsign',
+                logLevel: 'trace',
+            });
+            // Act
+            const streams = await lastValueFrom(connection.streams$.pipe(takeUntil((async () => {
+                await connection.connect();
+                connection.disconnect();
+                await connection.connect();
+            })()), toArray()));
+            expect(streams).toEqual([
+                [{ name: 'my-stream-1', active: false }],
+                [
+                    { name: 'my-stream-1', active: false },
+                    { name: 'my-stream-2', active: false },
+                ],
+                [{ name: 'my-stream-1', active: true }],
+                [
+                    { name: 'my-stream-1', active: true },
+                    { name: 'my-stream-2', active: true },
+                ],
+            ]);
+        });
+    });
+});

package/esm/services/RobotService.d.ts

@@ -0,0 +1,278 @@
+import { IBaseService, IRobot, IRobotSettings, IRobotTemplate, IRocosSDKConfig, RocosError } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+export declare class RobotService extends BaseServiceAbstract implements IBaseService {
+    constructor(config: IRocosSDKConfig);
+    protected getError(e: Error): RocosError;
+    getStatus(): boolean;
+    /**
+     * Get a list of robots.
+     *
+     * @param projectId - Project Id
+     */
+    getRobots(projectId: string): Promise<IRobot[]>;
+    /**
+     * Create a new robot.
+     *
+     * @param projectId
+     * @param robot - Robot payload {@link IRobot}
+     */
+    create(projectId: string, robot: IRobot): Promise<any>;
+    /**
+     * Update robot information.
+     *
+     * @param projectId Project Id
+     * @param robot - Robot payload {@link IRobot}
+     */
+    update(projectId: string, robot: IRobot): Promise<any>;
+    /**
+     * Delete the robots by callsign list
+     *
+     * @param projectId - Project Id
+     * @param callsignIds - Callsign list
+     */
+    delete(projectId: string, callsignIds: string[]): Promise<any>;
+    /**
+     * Get robot information by project id and callsign of the robot.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Callsign of the robot
+     */
+    info(projectId: string, callsign: string): Promise<IRobot>;
+    /**
+     * Get robot information by project id and callsign of the robot.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Callsign of the robot
+     */
+    attributes(projectId: string, callsign: string): Promise<Record<string, string>>;
+    /**
+     * Register the specified callsign
+     *
+     * @param projectId - Project Id
+     * @param callsign - Callsign of the robot
+     */
+    register(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Robot Templates
+     */
+    templates(): Promise<IRobotTemplate[]>;
+    /**
+     * Get the deployment details of virtual robot.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Virtual Robot Callsign
+     */
+    virtualRobotDeploymentDetails(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Deploy a virtual robot by project id and callsign
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot's Callsign
+     */
+    deployVirtualRobot(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Get data sources tree components JSON schema
+     */
+    dataSourcesSchema(): Promise<any>;
+    /**
+     * Delete a robot dashboard.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     * @param dashboardId - Dashboard Id
+     */
+    deleteRobotDashboardsV2(projectId: string, callsign: string, dashboardId: string): Promise<any>;
+    /**
+     * Delete a profile dashboard.
+     *
+     * @param projectId - Project Id
+     * @param profileId - Profile Id
+     * @param dashboardId - Dashboard Id
+     */
+    deleteDashboardsV2(projectId: string, profileId: string, dashboardId: string): Promise<any>;
+    /**
+     * Get a list of robot dashboards.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     */
+    listRobotDashboardsV2(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Get a list of profile dashboards.
+     *
+     * @param projectId - Project Id
+     * @param profileId - Profile Id
+     */
+    listDashboardsV2(projectId: string, profileId: string): Promise<any>;
+    /**
+     * Get a profile dashboard.
+     *
+     * @param projectId - Project Id
+     * @param profileId - Profile Id
+     * @param dashboardId - Dashboard Id
+     */
+    robotDefDashboardsV2(projectId: string, profileId: string, dashboardId: string): Promise<any>;
+    /**
+     * Get Dashboard data which stored in Azure Blob.
+     *
+     * @param projectId - Project Id
+     * @param profileId - Profile Id
+     * @param dashboardId - Dashboard Id
+     */
+    robotDefDashboardBlobV2(projectId: string, profileId: string, dashboardId: string): Promise<any>;
+    /**
+     * Create dashboard for a robot.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     * @param model - Payload
+     */
+    createRobotDashboardsV2(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Create dashboard for a profile.
+     *
+     * @param projectId - Project Id
+     * @param profileId - Profile Id
+     * @param model - Payload
+     */
+    createDashboardsV2(projectId: string, profileId: string, model: any): Promise<any>;
+    /**
+     * Update dashboard for a profile.
+     *
+     * @param projectId - Project Id
+     * @param profileId - Profile Id
+     * @param dashboardId - Dashboard Id
+     * @param model - Payload
+     */
+    robotDefUpdateDashboardsV2(projectId: string, profileId: string, dashboardId: string, model: any): Promise<any>;
+    /**
+     * Get a list of dashboard for a robot.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     * @param dashboardId - Dashboard Id
+     */
+    getDashboardsV2(projectId: string, callsign: string, dashboardId: string): Promise<any>;
+    /**
+     * Get robot dashboard which stored in Azure Blob.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     * @param dashboardId - Dashboard Id
+     */
+    getDashboardBlobV2(projectId: string, callsign: string, dashboardId: string): Promise<any>;
+    /**
+     * Update dashboard for a robot.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     * @param dashboardId - Dashboard Id
+     * @param model - Payload
+     */
+    updateDashboardsV2(projectId: string, callsign: string, dashboardId: string, model: any): Promise<any>;
+    /**
+     * Get robot settings
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getSettings(projectId: string, callsign: string): Promise<IRobotSettings>;
+    /**
+     * Update robot settings.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     */
+    updateSettings(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Get agent settings for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getAgentSettings(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Update agent settings for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     */
+    updateAgentSettings(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Get commands for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getCommands(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Update commands for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     */
+    updateCommands(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Get command V2 for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getCommandsV2(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Update command V2 for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     */
+    updateCommandsV2(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Get buttons for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getButtons(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Update buttons for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     */
+    updateButtons(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Get triggers for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getTriggers(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Update triggers for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     */
+    updateTriggers(projectId: string, callsign: string, model: any): Promise<any>;
+    /**
+     * Get gamepads for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     */
+    getGamepads(projectId: string, callsign: string): Promise<any>;
+    /**
+     * Update gamepads for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - \payload
+     */
+    updateGamepads(projectId: string, callsign: string, model: any): Promise<any>;
+}

package/esm/services/ScheduleService.d.ts

@@ -0,0 +1,22 @@
+import { IBaseService, IRocosSDKConfig, IScheduleInfo, IScheduleInfoUpdate, RocosError } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+export declare class ScheduleService extends BaseServiceAbstract implements IBaseService {
+    constructor(config: IRocosSDKConfig);
+    protected getError(e: Error): RocosError;
+    getStatus(): boolean;
+    /**
+     * Get a list of schedules.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     */
+    getSchedules(projectId: string, callsign: string): Promise<IScheduleInfo>;
+    /**
+     * Update schedules.
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot Callsign
+     * @param schedules - Schedule information
+     */
+    updateSchedules(projectId: string, callsign: string, schedules: IScheduleInfoUpdate): Promise<IScheduleInfo>;
+}