@dronedeploy/rocos-js-sdk 3.0.1-alpha.8 → 3.0.1

package/esm/services/MapService.js

@@ -1,14 +1,22 @@
-import { API_MAPS_COPY_URL, API_MAPS_DEPLOYED_URL, API_MAPS_DEPLOY_URL, API_MAPS_GEOJSON_URL, API_MAPS_MERGE_URL, API_MAPS_PANORAMA_OBSERVATIONS_URL, API_MAPS_URL, API_MAP_ID_URL, API_OBSERVATIONS_URL, API_OBSERVATION_KEYS_URL, } from '../constants/api';
+import { API_GRAPHS_MAPS_COPY_URL, API_GRAPHS_MAPS_DEPLOYED_URL, API_GRAPHS_MAPS_DEPLOY_URL, API_GRAPHS_MAPS_GEOJSON_URL, API_GRAPHS_MAPS_MERGE_URL, API_GRAPHS_MAPS_URL, API_GRAPHS_MAP_ID_URL, API_GRAPHS_OBSERVATIONS_URL, API_GRAPHS_OBSERVATION_KEYS_URL, API_GRAPHS_PANORAMA, API_GRAPHS_PANORAMA_OBSERVATIONS_URL, } from '../constants/api';
 import { RocosError, errorCodes } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
 import { formatServiceUrl } from '../helpers/formatServiceUrl';
 /**
- * Integrations to retrieve data from the linked project in DroneDeploy
+ * Maps service for managing robot maps in the cloud and on robots
  */
 export class MapService extends BaseServiceAbstract {
     constructor(config) {
         super(config);
+        /*
+         * @deprecated use getAssets instead
+         */
+        this.getObservations = this.getAssets;
+        /*
+         * @deprecated use getAssetKeys instead
+         */
+        this.getObservationsKeys = this.getAssetsKeys;
         this.logger = RocosLogger.getInstance(`MapService(${this.config.url})`);
     }
     getStatus() {
@@ -18,7 +26,7 @@ export class MapService extends BaseServiceAbstract {
         return new RocosError(e, errorCodes.MAPS_SERVICE_ERROR);
     }
     async list(projectId, callsign) {
-        const resp = await this.callGet(formatServiceUrl(API_MAPS_URL, {
+        const resp = await this.callGet(formatServiceUrl(API_GRAPHS_MAPS_URL, {
             url: this.config.url,
             projectId,
         }, this.config.insecure), 'Failed to get maps.', callsign ? { callsign } : undefined);
@@ -31,7 +39,7 @@ export class MapService extends BaseServiceAbstract {
      */
     async listDeployedMaps(projectId, callsign) {
         const safeCallsign = encodeURIComponent(callsign);
-        const resp = await this.callGet(formatServiceUrl(API_MAPS_DEPLOYED_URL, {
+        const resp = await this.callGet(formatServiceUrl(API_GRAPHS_MAPS_DEPLOYED_URL, {
             url: this.config.url,
             projectId,
             callsign: safeCallsign,
@@ -55,7 +63,7 @@ export class MapService extends BaseServiceAbstract {
             description: options.description,
             callsign: options.callsign,
         };
-        return this.callPost(formatServiceUrl(API_MAPS_MERGE_URL, {
+        return this.callPost(formatServiceUrl(API_GRAPHS_MAPS_MERGE_URL, {
             url: this.config.url,
             projectId,
         }, this.config.insecure), payload, 'Failed to merge maps.');
@@ -66,7 +74,7 @@ export class MapService extends BaseServiceAbstract {
      * @param mapId Map ID
      */
     async get(projectId, mapId) {
-        return this.callGet(formatServiceUrl(API_MAP_ID_URL, {
+        return this.callGet(formatServiceUrl(API_GRAPHS_MAP_ID_URL, {
             url: this.config.url,
             projectId,
             mapId,
@@ -79,7 +87,7 @@ export class MapService extends BaseServiceAbstract {
      * @param options New metadata
      */
     async update(projectId, mapId, options) {
-        return this.callPut(formatServiceUrl(API_MAP_ID_URL, {
+        return this.callPut(formatServiceUrl(API_GRAPHS_MAP_ID_URL, {
             url: this.config.url,
             projectId,
             mapId,
@@ -94,14 +102,14 @@ export class MapService extends BaseServiceAbstract {
      * @param hash Map hash
      */
     async sendToCloud(projectId, mapId, callsign, hash) {
-        return this.callPost(formatServiceUrl(API_MAP_ID_URL, {
+        return this.callPost(formatServiceUrl(API_GRAPHS_MAP_ID_URL, {
             url: this.config.url,
             projectId,
             mapId,
         }, this.config.insecure), { callsign, hash }, 'Failed to start map upload.');
     }
     async delete(projectId, mapId, callsign, hash) {
-        return this.callDelete(formatServiceUrl(API_MAP_ID_URL, {
+        return this.callDelete(formatServiceUrl(API_GRAPHS_MAP_ID_URL, {
             url: this.config.url,
             projectId,
             mapId,
@@ -115,7 +123,7 @@ export class MapService extends BaseServiceAbstract {
      * @param options Options to create the new map
      */
     async copy(projectId, mapId, options) {
-        return this.callPost(formatServiceUrl(API_MAPS_COPY_URL, {
+        return this.callPost(formatServiceUrl(API_GRAPHS_MAPS_COPY_URL, {
             url: this.config.url,
             projectId,
             mapId,
@@ -128,7 +136,7 @@ export class MapService extends BaseServiceAbstract {
      * @param callsign Robot callsign
      */
     async deploy(projectId, mapId, callsign) {
-        return this.callPost(formatServiceUrl(API_MAPS_DEPLOY_URL, {
+        return this.callPost(formatServiceUrl(API_GRAPHS_MAPS_DEPLOY_URL, {
             url: this.config.url,
             projectId,
             mapId,
@@ -146,7 +154,7 @@ export class MapService extends BaseServiceAbstract {
             projectId,
             mapId,
         };
-        return this.callGet(formatServiceUrl(API_MAPS_GEOJSON_URL, params, this.config.insecure), 'Failed to get map GeoJSON.', frameId ? { frameID: frameId } : undefined);
+        return this.callGet(formatServiceUrl(API_GRAPHS_MAPS_GEOJSON_URL, params, this.config.insecure), 'Failed to get map GeoJSON.', frameId ? { frameID: frameId } : undefined);
     }
     /**
      * Returns a Promise that resolves to an array of Observation objects for the given panorama ID.
@@ -156,7 +164,7 @@ export class MapService extends BaseServiceAbstract {
      * @returns A Promise that resolves to an array of Observation objects.
      */
     listObservations(projectId, panoramaId) {
-        return this.callGet(formatServiceUrl(API_MAPS_PANORAMA_OBSERVATIONS_URL, { url: this.config.url, projectId, panoramaId }, this.config.insecure), 'Failed to list observations.');
+        return this.callGet(formatServiceUrl(API_GRAPHS_PANORAMA_OBSERVATIONS_URL, { url: this.config.url, projectId, panoramaId }, this.config.insecure), 'Failed to list observations.');
     }
     /**
      * Creates new observations on a panorama.
@@ -167,7 +175,7 @@ export class MapService extends BaseServiceAbstract {
      * @returns A Promise that resolves when the observations have been created.
      */
     createObservations(projectId, panoramaId, observations) {
-        return this.callPut(formatServiceUrl(API_MAPS_PANORAMA_OBSERVATIONS_URL, { url: this.config.url, projectId, panoramaId }, this.config.insecure), observations, 'Failed to update observations.');
+        return this.callPut(formatServiceUrl(API_GRAPHS_PANORAMA_OBSERVATIONS_URL, { url: this.config.url, projectId, panoramaId }, this.config.insecure), observations, 'Failed to update observations.');
     }
     /**
      * Gets observations for a project.
@@ -177,16 +185,26 @@ export class MapService extends BaseServiceAbstract {
      * @param frameID (optional) Transforms on a seed frame
      * @returns A list of observations
      */
-    getObservations(projectId, key = '', frameID = '') {
-        return this.callGet(formatServiceUrl(API_OBSERVATIONS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get observations.', { key, frameID });
+    getAssets(projectId, key = '', frameID = '') {
+        return this.callGet(formatServiceUrl(API_GRAPHS_OBSERVATIONS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get assets.', { key, frameID });
     }
     /**
-     * Lists available keys for all observations in a project.
+     * Lists available keys for all assets in a project.
      *
      * @param projectId The ID of the project the observations belongs to.
-     * @returns A list of observations
+     * @returns A list of assets
+     */
+    getAssetsKeys(projectId) {
+        return this.callGet(formatServiceUrl(API_GRAPHS_OBSERVATION_KEYS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get asset keys.');
+    }
+    /**
+     * Deletes a panorama by panoramaID.
+     *
+     * @param projectId The ID of the project the panorama belongs to.
+     * @param panoramaId The ID of the panorama to delete.
+     * @returns A Promise.
      */
-    getObservationsKeys(projectId) {
-        return this.callGet(formatServiceUrl(API_OBSERVATION_KEYS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get observation keys.');
+    deletePanorama(projectId, panoramaId) {
+        return this.callDelete(formatServiceUrl(API_GRAPHS_PANORAMA, { url: this.config.url, projectId, panoramaId }, this.config.insecure), 'Failed to delete panorama.');
     }
 }

package/esm/services/ProfileService.d.ts

@@ -232,6 +232,30 @@ export declare class ProfileService extends BaseServiceAbstract implements IBase
      * @description - Renamed from robotDefGetGamepads
      */
     getGamepads(projectId: string, definitionId: string): Promise<any>;
+    /** Export robot definition into JSON format
+     *
+     * Can be used to import robot definition into another project
+     *
+     * @param projectId - Project Id
+     * @param definitionId - Robot definition Id
+     *
+     * @see import
+     */
+    export(projectId: string, definitionId: string): Promise<Record<string, unknown>>;
+    /** Import robot definition from JSON format
+     *
+     * Accepts a previously exported robot definition
+     *
+     * @param projectId - Project Id
+     * @param profileData - Robot definition data
+     * @param newName - Optional new name for the robot definition. If not provided, the name from the imported definition will be used.
+     * @param newDescription - Optional new description for the robot definition. If not provided, the description from the imported definition will be used.
+     *
+     * @see export
+     */
+    import(projectId: string, profileData: Blob | File, newName?: string, newDescription?: string): Promise<{
+        profileId: string;
+    }>;
     /**
      * Update gamepads for a robot definition
      *

package/esm/services/ProfileService.js

@@ -1,4 +1,4 @@
-import { API_PROJECT_DEFINITION_ACTION_URL, API_PROJECT_DEFINITION_AGENT_URL, API_PROJECT_DEFINITION_BLOB_URL, API_PROJECT_DEFINITION_BUTTON_URL, API_PROJECT_DEFINITION_COMMAND2_URL, API_PROJECT_DEFINITION_COMMAND_URL, API_PROJECT_DEFINITION_COPY_URL, API_PROJECT_DEFINITION_DASHBOARD_URL, API_PROJECT_DEFINITION_GAMEPAD_URL, API_PROJECT_DEFINITION_ID_URL, API_PROJECT_DEFINITION_SETTING_URL, API_PROJECT_DEFINITION_STREAM_URL, API_PROJECT_DEFINITION_TRIGGER_URL, API_PROJECT_DEFINITION_URL, API_PROJECT_PROFILE_DASHBOARD_URL, API_PROJECT_ROBOT_DEFINITION_URL, API_PROJECT_ROBOT_URL, } from '../constants/api';
+import { API_PROJECT_DEFINITION_ACTION_URL, API_PROJECT_DEFINITION_AGENT_URL, API_PROJECT_DEFINITION_BLOB_URL, API_PROJECT_DEFINITION_BUTTON_URL, API_PROJECT_DEFINITION_COMMAND2_URL, API_PROJECT_DEFINITION_COMMAND_URL, API_PROJECT_DEFINITION_COPY_URL, API_PROJECT_DEFINITION_DASHBOARD_URL, API_PROJECT_DEFINITION_EXPORT, API_PROJECT_DEFINITION_GAMEPAD_URL, API_PROJECT_DEFINITION_ID_URL, API_PROJECT_DEFINITION_IMPORT, API_PROJECT_DEFINITION_SETTING_URL, API_PROJECT_DEFINITION_STREAM_URL, API_PROJECT_DEFINITION_TRIGGER_URL, API_PROJECT_DEFINITION_URL, API_PROJECT_PROFILE_DASHBOARD_URL, API_PROJECT_ROBOT_DEFINITION_URL, API_PROJECT_ROBOT_URL, } from '../constants/api';
 import { RocosError, errorCodes } from '../models/RocosError';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
@@ -345,6 +345,40 @@ export class ProfileService extends BaseServiceAbstract {
     async getGamepads(projectId, definitionId) {
         return this.callGet(formatServiceUrl(API_PROJECT_DEFINITION_GAMEPAD_URL, { url: this.config.url, projectId, definitionId }, this.config.insecure), `Failed to get gamepads for ${projectId}, definitionId  ${definitionId}.`);
     }
+    /** Export robot definition into JSON format
+     *
+     * Can be used to import robot definition into another project
+     *
+     * @param projectId - Project Id
+     * @param definitionId - Robot definition Id
+     *
+     * @see import
+     */
+    async export(projectId, definitionId) {
+        return this.callPost(formatServiceUrl(API_PROJECT_DEFINITION_EXPORT, { url: this.config.url, projectId, definitionId }, this.config.insecure), undefined, `Failed to export robot definition for ${projectId}, definitionId  ${definitionId}.`);
+    }
+    /** Import robot definition from JSON format
+     *
+     * Accepts a previously exported robot definition
+     *
+     * @param projectId - Project Id
+     * @param profileData - Robot definition data
+     * @param newName - Optional new name for the robot definition. If not provided, the name from the imported definition will be used.
+     * @param newDescription - Optional new description for the robot definition. If not provided, the description from the imported definition will be used.
+     *
+     * @see export
+     */
+    async import(projectId, profileData, newName, newDescription) {
+        const formData = new FormData();
+        if (newName) {
+            formData.append('name', newName);
+        }
+        if (newDescription) {
+            formData.append('description', newDescription);
+        }
+        formData.append('file', profileData);
+        return this.callPost(formatServiceUrl(API_PROJECT_DEFINITION_IMPORT, { url: this.config.url, projectId }, this.config.insecure), formData, `Failed to import robot definition for ${projectId}.`);
+    }
     /**
      * Update gamepads for a robot definition
      *

package/esm/services/ProjectService.d.ts

@@ -1,4 +1,4 @@
-import { IBaseService, IOperation, IProject, IProjectInfo, IRocosSDKConfig, ProjectUser, RocosError } from '../models';
+import { ExternalProject, IBaseService, IOperation, IProject, IProjectInfo, IRocosSDKConfig, NewProjectRequest, ProjectUser, RocosError } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 export declare class ProjectService extends BaseServiceAbstract implements IBaseService {
     constructor(config: IRocosSDKConfig);
@@ -57,7 +57,7 @@ export declare class ProjectService extends BaseServiceAbstract implements IBase
      * @param templateId - Template Id, From back-end responses
      * @param body - Optional parameters
      */
-    createProjectByTemplate(templateId: string, body?: any): Promise<any>;
+    createProjectByTemplate(templateId: string, body?: NewProjectRequest): Promise<void>;
     /**
      * Operations related functions
      */
@@ -103,4 +103,9 @@ export declare class ProjectService extends BaseServiceAbstract implements IBase
      */
     listUsers(projectId: string): Promise<ProjectUser[]>;
     getProjectByLinkedProjectId(linkedProjectId: string): Promise<IProject>;
+    /**
+     * List external projects
+     * @returns Returns list of DroneDeploy projects with their location and linked state
+     */
+    listExternalProjects(accountId: string): Promise<ExternalProject[]>;
 }

package/esm/services/ProjectService.js

@@ -1,5 +1,5 @@
-import { API_ACCOUNT_PROJECT_ID_URL, API_ACCOUNT_PROJECT_URL, API_LINKED_PROJECT_URL, API_PROJECT_ID_URL, API_PROJECT_OPERATION_ID_URL, API_PROJECT_OPERATION_URL, API_PROJECT_URL, API_PROJECT_USERS_URL, API_TEMPLATE_PROVISION_ID_URL, API_TEMPLATE_PROVISION_URL, } from '../constants/api';
-import { errorCodes, RocosError, } from '../models';
+import { API_ACCOUNT_EXTERNAL_PROJECTS_URL, API_ACCOUNT_PROJECT_ID_URL, API_ACCOUNT_PROJECT_URL, API_LINKED_PROJECT_URL, API_PROJECT_ID_URL, API_PROJECT_OPERATION_ID_URL, API_PROJECT_OPERATION_URL, API_PROJECT_URL, API_PROJECT_USERS_URL, API_TEMPLATE_PROVISION_ID_URL, API_TEMPLATE_PROVISION_URL, } from '../constants/api';
+import { RocosError, errorCodes, } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
 import { formatServiceUrl } from '../helpers/formatServiceUrl';
@@ -90,9 +90,6 @@ export class ProjectService extends BaseServiceAbstract {
      * @param templateId - Template Id, From back-end responses
      * @param body - Optional parameters
      */
-    // TODO: map the request model
-    // TODO: map the response object
-    // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
     async createProjectByTemplate(templateId, body) {
         return this.callPost(formatServiceUrl(API_TEMPLATE_PROVISION_ID_URL, { url: this.config.url, templateId }, this.config.insecure), body, `Failed to create project template for ${templateId}.`);
     }
@@ -160,4 +157,11 @@ export class ProjectService extends BaseServiceAbstract {
     async getProjectByLinkedProjectId(linkedProjectId) {
         return this.callGet(formatServiceUrl(API_LINKED_PROJECT_URL, { url: this.config.url, linkedProjectId }, this.config.insecure), `Failed to get project info for linked project ID: ${linkedProjectId}.`);
     }
+    /**
+     * List external projects
+     * @returns Returns list of DroneDeploy projects with their location and linked state
+     */
+    async listExternalProjects(accountId) {
+        return this.callGet(formatServiceUrl(API_ACCOUNT_EXTERNAL_PROJECTS_URL, { url: this.config.url, accountId }, this.config.insecure), 'Failed to get external project list.');
+    }
 }

package/esm/services/RTPWebRTCService.d.ts

@@ -35,6 +35,10 @@ export interface PeerConnectionParams {
     projectId: string;
     callsign: string;
     logLevel?: 'trace';
+    mimeType?: {
+        video?: string;
+        audio?: string;
+    };
 }
 interface InternalPeerConnectionParams extends PeerConnectionParams {
     endpoint: {
@@ -54,7 +58,7 @@ export declare class RTPWebRTCService extends BaseServiceAbstract implements IBa
      *
      * If `logLevel` is set to trace, the connection will emit all messages as events
      */
-    createPeerConnection(params: PeerConnectionParams): WebRTCConnection;
+    createPeerConnection(params: PeerConnectionParams): Promise<WebRTCConnection>;
 }
 export declare class WebRTCConnection {
     private pc?;
@@ -64,6 +68,7 @@ export declare class WebRTCConnection {
     private readonly projectId;
     private readonly callsign;
     private readonly logLevel?;
+    private sendOfferOptions?;
     private errorsSubject$;
     private streamsSubject$;
     private eventsSubject$;

package/esm/services/RTPWebRTCService.js

@@ -1,6 +1,7 @@
 import { RocosError, errorCodes } from '../models';
 import { Subject, scan, shareReplay } from 'rxjs';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { RocosStore } from '../store/RocosStore';
 import { splitRobotTopic } from '../helpers/splitRobotTopic';
 export var WebRTCEventType;
 (function (WebRTCEventType) {
@@ -33,19 +34,21 @@ export class RTPWebRTCService extends BaseServiceAbstract {
      *
      * If `logLevel` is set to trace, the connection will emit all messages as events
      */
-    createPeerConnection(params) {
+    async createPeerConnection(params) {
         const isInsecure = this.config.insecure ?? false;
         const port = this.config.port ?? (isInsecure ? 80 : 443);
+        const token = (await RocosStore.getSDKInstance(this.config).getAuthService().getToken()).value;
         return new WebRTCConnection({
             endpoint: {
                 host: this.config.url,
                 port,
                 insecure: isInsecure,
             },
-            token: this.config.token,
+            token,
             projectId: params.projectId,
             callsign: params.callsign,
             logLevel: params.logLevel,
+            mimeType: params.mimeType,
         });
     }
 }
@@ -62,6 +65,10 @@ export class WebRTCConnection {
         this.projectId = params.projectId;
         this.callsign = params.callsign;
         this.logLevel = params.logLevel;
+        this.sendOfferOptions = {
+            audioMimeType: params.mimeType?.audio,
+            videoMimeType: params.mimeType?.video,
+        };
     }
     get peerConnectionAvailable() {
         return !!this.pc;
@@ -142,6 +149,7 @@ export class WebRTCConnection {
             },
             body: JSON.stringify({
                 sdp,
+                options: this.sendOfferOptions,
             }),
         })
             .then((res) => res.json())

package/esm/services/RobotService.d.ts

@@ -1,4 +1,4 @@
-import { IBaseService, IRobot, IRobotSettings, IRobotTemplate, IRocosSDKConfig, RocosError } from '../models';
+import { IBaseService, IConnectedCallsign, IRobot, IRobotSettings, IRobotTemplate, IRocosSDKConfig, RocosError } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 export declare class RobotService extends BaseServiceAbstract implements IBaseService {
     constructor(config: IRocosSDKConfig);
@@ -275,4 +275,6 @@ export declare class RobotService extends BaseServiceAbstract implements IBaseSe
      * @param model - \payload
      */
     updateGamepads(projectId: string, callsign: string, model: any): Promise<any>;
+    getConnectedCallsigns(projectId: string): Promise<Map<string, IConnectedCallsign>>;
+    getConnectedCallsign(projectId: string, callsign: string): Promise<IConnectedCallsign>;
 }

package/esm/services/RobotService.js

@@ -1,5 +1,5 @@
-import { API_PROJECT_PROFILE_DASHBOARD_CUSTOM_WIDGET_URL, API_PROJECT_PROFILE_DASHBOARD_ID_URL, API_PROJECT_PROFILE_DASHBOARD_URL, API_PROJECT_ROBOT_AGENT_URL, API_PROJECT_ROBOT_ATTRIBUTES_URL, API_PROJECT_ROBOT_BUTTON_URL, API_PROJECT_ROBOT_COMMAND2_URL, API_PROJECT_ROBOT_COMMAND_URL, API_PROJECT_ROBOT_DASHBOARD_CUSTOM_WIDGET_URL, API_PROJECT_ROBOT_DASHBOARD_ID_URL, API_PROJECT_ROBOT_DASHBOARD_URL, API_PROJECT_ROBOT_GAMEPAD_URL, API_PROJECT_ROBOT_ID_URL, API_PROJECT_ROBOT_REGISTER_URL, API_PROJECT_ROBOT_SETTING_URL, API_PROJECT_ROBOT_TRIGGER_URL, API_PROJECT_ROBOT_URL, API_PROJECT_VROBOT_DEPLOY_URL, API_PROJECT_VROBOT_DETAILS_URL, API_SOURCE_SCHEMA_URL, API_TEMPLATE_DEPLOY_URL, } from '../constants/api';
-import { errorCodes, Robot, RobotTemplate, RocosError, } from '../models';
+import { API_PROJECT_PROFILE_DASHBOARD_CUSTOM_WIDGET_URL, API_PROJECT_PROFILE_DASHBOARD_ID_URL, API_PROJECT_PROFILE_DASHBOARD_URL, API_PROJECT_ROBOT_AGENT_URL, API_PROJECT_ROBOT_ATTRIBUTES_URL, API_PROJECT_ROBOT_BUTTON_URL, API_PROJECT_ROBOT_COMMAND2_URL, API_PROJECT_ROBOT_COMMAND_URL, API_PROJECT_ROBOT_CONFIGS_CONNECTIONS_URL, API_PROJECT_ROBOT_CONFIGS_CONNECTION_URL, API_PROJECT_ROBOT_DASHBOARD_CUSTOM_WIDGET_URL, API_PROJECT_ROBOT_DASHBOARD_ID_URL, API_PROJECT_ROBOT_DASHBOARD_URL, API_PROJECT_ROBOT_GAMEPAD_URL, API_PROJECT_ROBOT_ID_URL, API_PROJECT_ROBOT_REGISTER_URL, API_PROJECT_ROBOT_SETTING_URL, API_PROJECT_ROBOT_TRIGGER_URL, API_PROJECT_ROBOT_URL, API_PROJECT_VROBOT_DEPLOY_URL, API_PROJECT_VROBOT_DETAILS_URL, API_SOURCE_SCHEMA_URL, API_TEMPLATE_DEPLOY_URL, } from '../constants/api';
+import { Robot, RobotTemplate, RocosError, errorCodes, } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
 import { cleanObject } from '../helpers/cleanObject';
@@ -457,4 +457,10 @@ export class RobotService extends BaseServiceAbstract {
     async updateGamepads(projectId, callsign, model) {
         return this.callPost(formatServiceUrl(API_PROJECT_ROBOT_GAMEPAD_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), model, `Failed to update gamepads for ${projectId}, callsign  ${callsign}.`);
     }
+    async getConnectedCallsigns(projectId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ROBOT_CONFIGS_CONNECTIONS_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to get connected callsigns for ${projectId}.`);
+    }
+    async getConnectedCallsign(projectId, callsign) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ROBOT_CONFIGS_CONNECTION_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), `Failed to get connected callsign for ${projectId}, callsign  ${callsign}.`);
+    }
 }

package/esm/services/SpotProvisioningService.d.ts

@@ -1,7 +1,7 @@
 import { IBaseService, IRocosSDKConfig, RocosError } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { Timezone } from '../constants/timezones';
-type SpotImageTag = 'stable' | 'dev' | 'unstable';
+type SpotImageTag = 'stable' | 'dev' | 'unstable' | 'rc' | (string & {});
 export declare class SpotProvisioningService extends BaseServiceAbstract implements IBaseService {
     constructor(config: IRocosSDKConfig);
     getStatus(): boolean;

package/esm/services/SpotProvisioningServiceNode.d.ts

@@ -2,7 +2,7 @@
 import { IBaseService, IRocosSDKConfig, RocosError } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { Timezone } from '../constants/timezones';
-type SpotImageTag = 'stable' | 'dev' | 'unstable';
+type SpotImageTag = 'stable' | 'dev' | 'unstable' | 'rc' | (string & {});
 export declare class SpotProvisioningServiceNode extends BaseServiceAbstract implements IBaseService {
     constructor(config: IRocosSDKConfig);
     getStatus(): boolean;

package/esm/services/TargetService.d.ts

@@ -0,0 +1,16 @@
+import { Asset, IBaseService, IRocosSDKConfig, RocosError, Target, TargetMedia } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+/**
+ * Service for managing targets (such as assets, PoI's, or FLOCS) on DroneDeploy
+ */
+export declare class TargetService extends BaseServiceAbstract implements IBaseService {
+    list: (projectId: string, frameID?: string) => Promise<Target[]>;
+    constructor(config: IRocosSDKConfig);
+    getStatus(): boolean;
+    protected getError(e: Error): RocosError;
+    createTargets(projectId: string, targets: Target[]): Promise<void>;
+    listTargets(projectId: string, frameID?: string): Promise<Target[]>;
+    createAssets(projectId: string, assets: Asset[]): Promise<void>;
+    listAssets(projectId: string, frameID?: string): Promise<Asset[]>;
+    addMedia(projectId: string, targetId: string, media: TargetMedia): Promise<void>;
+}

package/esm/services/TargetService.js

@@ -0,0 +1,54 @@
+import { API_GRAPHS_ASSETS_UPLOAD_URL, API_GRAPHS_ASSETS_URL, API_GRAPHS_TARGETS_URL, API_GRAPHS_TARGET_UPLOAD_URL, } from '../constants/api';
+import { RocosError, errorCodes } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { RocosLogger } from '../logger/RocosLogger';
+import { formatServiceUrl } from '../helpers/formatServiceUrl';
+/**
+ * Service for managing targets (such as assets, PoI's, or FLOCS) on DroneDeploy
+ */
+export class TargetService extends BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger.getInstance(`TargetService(${this.config.url})`);
+        this.list = this.listTargets;
+    }
+    getStatus() {
+        return true;
+    }
+    getError(e) {
+        return new RocosError(e, errorCodes.TARGET_SERVICE_ERROR);
+    }
+    async createTargets(projectId, targets) {
+        return this.callPut(formatServiceUrl(API_GRAPHS_TARGET_UPLOAD_URL, {
+            url: this.config.url,
+            projectId,
+        }, this.config.insecure), targets, `Failed to upload targets for ${projectId}`);
+    }
+    async listTargets(projectId, frameID = 'seed') {
+        const resp = await this.callGet(formatServiceUrl(API_GRAPHS_TARGETS_URL, {
+            url: this.config.url,
+            projectId,
+        }, this.config.insecure), 'Failed to list targets', { frameID });
+        return resp;
+    }
+    async createAssets(projectId, assets) {
+        return this.callPut(formatServiceUrl(API_GRAPHS_ASSETS_UPLOAD_URL, {
+            url: this.config.url,
+            projectId,
+        }, this.config.insecure), assets, `Failed to upload assets for ${projectId}`);
+    }
+    async listAssets(projectId, frameID = 'seed') {
+        const resp = await this.callGet(formatServiceUrl(API_GRAPHS_ASSETS_URL, {
+            url: this.config.url,
+            projectId,
+        }, this.config.insecure), 'Failed to list assets', { frameID });
+        return resp;
+    }
+    async addMedia(projectId, targetId, media) {
+        await this.callPost(formatServiceUrl(API_GRAPHS_TARGETS_URL, {
+            url: this.config.url,
+            projectId,
+            targetId,
+        }, this.config.insecure), media, 'Failed to add media to a target');
+    }
+}

package/esm/services/TelemetryService.d.ts

@@ -1,5 +1,5 @@
 import { Observable } from 'rxjs';
-import { CallsignStatus, IRocosSDKConfig, IRocosTelemetryMessage, IStreamStatusMessage, ITelemetryStream, ITelemetryStreamConfig, ITelemetrySubscriptionParams, ITelemetrySubscriptions } from '../models';
+import { CallsignStatus, IRocosSDKConfig, IRocosTelemetryMessage, IStreamStatusMessage, ITelemetryStream, ITelemetryStreamConfig, ITelemetrySubscriptionParams, ITelemetrySubscriptions, TelemetryMonitorStatus } from '../models';
 import { BaseStreamService } from './BaseStreamService';
 export declare class TelemetryService extends BaseStreamService<ITelemetryStream, ITelemetryStreamConfig> {
     private statusSubscription;
@@ -34,6 +34,15 @@ export declare class TelemetryService extends BaseStreamService<ITelemetryStream
      * @param intervalMs optionally override the interval to check for heartbeats (in ms). Default 2000ms
      */
     getRobotStatusChanges(projectId: string, callsign: string, heartbeatTimeoutMs?: number, intervalMs?: number): Observable<CallsignStatus>;
+    /**
+     * Subscribes to the given telemetry and checks we receive one at least emission every `heartbeatTimeoutMs` (default 5s)
+     * @param projectId
+     * @param callsign
+     * @param source the telemetry source to monitor
+     * @param heartbeatTimeoutMs optionally override the deadline for telemetry emissions (in ms). Default 5000ms
+     * @param intervalMs optionally override the interval to check for telemetry emissions (in ms). Default 2000ms
+     */
+    monitorTelemetryWithTimeout(projectId: string, callsign: string, source: string, heartbeatTimeoutMs?: number, intervalMs?: number): Observable<TelemetryMonitorStatus>;
     protected initStream(stream: ITelemetryStream): Promise<void>;
     private buildScope;
     private createStream;

package/esm/services/TelemetryService.js

@@ -1,5 +1,5 @@
 import { BehaviorSubject, catchError, combineLatest, distinctUntilChanged, from, interval, map, mergeAll, of, startWith, } from 'rxjs';
-import { CallsignStatus, CallsignsLookup, CallsignsLookupType, RocosError, SubscriberStatusEnum, errorCodes, } from '../models';
+import { CallsignStatus, CallsignsLookup, CallsignsLookupType, RocosError, TelemetryMonitorStatus, SubscriberStatusEnum, errorCodes, } from '../models';
 import { filter, finalize } from 'rxjs/operators';
 import { BaseStreamService } from './BaseStreamService';
 import { IDENTIFIER_NAME_TELEMETRY } from '../constants/identifier';
@@ -95,23 +95,45 @@ export class TelemetryService extends BaseStreamService {
      * @param intervalMs optionally override the interval to check for heartbeats (in ms). Default 2000ms
      */
     getRobotStatusChanges(projectId, callsign, heartbeatTimeoutMs = HEARTBEAT_TIMEOUT, intervalMs = 2000) {
+        return this.monitorTelemetryWithTimeout(projectId, callsign, HEARTBEAT_SOURCE, heartbeatTimeoutMs, intervalMs).pipe(map((status) => {
+            switch (status) {
+                case TelemetryMonitorStatus.CONNECTED:
+                    return CallsignStatus.ONLINE;
+                case TelemetryMonitorStatus.DISCONNECTED:
+                    return CallsignStatus.OFFLINE;
+                case TelemetryMonitorStatus.ERROR:
+                    return CallsignStatus.ERROR;
+                default:
+                    return CallsignStatus.UNKNOWN;
+            }
+        }));
+    }
+    /**
+     * Subscribes to the given telemetry and checks we receive one at least emission every `heartbeatTimeoutMs` (default 5s)
+     * @param projectId
+     * @param callsign
+     * @param source the telemetry source to monitor
+     * @param heartbeatTimeoutMs optionally override the deadline for telemetry emissions (in ms). Default 5000ms
+     * @param intervalMs optionally override the interval to check for telemetry emissions (in ms). Default 2000ms
+     */
+    monitorTelemetryWithTimeout(projectId, callsign, source, heartbeatTimeoutMs = HEARTBEAT_TIMEOUT, intervalMs = 2000) {
         const startedAt = Date.now();
         const heartbeatTime$ = this.subscribe({
             projectId,
-            sources: [HEARTBEAT_SOURCE],
+            sources: [source],
             callsigns: [callsign],
         }).pipe(map(() => Date.now()));
         return combineLatest([heartbeatTime$.pipe(startWith(startedAt)), interval(intervalMs)]).pipe(map(([lastHeartbeat, _]) => {
             const now = Date.now();
             // If we haven't received a heartbeat, but we've only just started
             if (lastHeartbeat === startedAt && now - startedAt <= heartbeatTimeoutMs) {
-                return CallsignStatus.UNKNOWN;
+                return TelemetryMonitorStatus.UNKNOWN;
             }
             if (now - lastHeartbeat > heartbeatTimeoutMs) {
-                return CallsignStatus.OFFLINE;
+                return TelemetryMonitorStatus.DISCONNECTED;
             }
-            return CallsignStatus.ONLINE;
-        }), startWith(CallsignStatus.UNKNOWN), distinctUntilChanged(), catchError(() => of(CallsignStatus.ERROR)));
+            return TelemetryMonitorStatus.CONNECTED;
+        }), startWith(TelemetryMonitorStatus.UNKNOWN), distinctUntilChanged(), catchError(() => of(TelemetryMonitorStatus.ERROR)));
     }
     async initStream(stream) {
         await super.initStream(stream);

package/esm/services/WorkflowService.d.ts

@@ -36,27 +36,37 @@ export declare class WorkflowService extends BaseServiceAbstract implements IBas
      */
     update(projectId: string, workflowId: string, model: Workflow): Promise<Workflow>;
     /**
-     * Upload workflow asset
+     * Delete a workflow
      *
      * @param projectId - Project Id
      * @param workflowId - Workflow Id
-     * @param fileName - Name of file including extension
-     * @param arrayBuffer - data to upload
      */
-    uploadAsset(projectId: string, workflowId: string, fileName: string, arrayBuffer: ArrayBuffer): Promise<void>;
-    protected uploadAssetWithHash(projectId: string, workflowId: string, fileName: string, arrayBuffer: ArrayBuffer, hash: string): Promise<void>;
+    delete(projectId: string, workflowId: string): Promise<void>;
     /**
-     * Delete a workflow
+     * Upload workflow asset
      *
      * @param projectId - Project Id
      * @param workflowId - Workflow Id
+     * @param fileName - Name of file including extension
+     * @param arrayBuffer - data to upload
      */
-    delete(projectId: string, workflowId: string): Promise<void>;
+    uploadAsset(projectId: string, workflowId: string, fileName: string, arrayBuffer: ArrayBuffer): Promise<void>;
+    protected uploadAssetWithHash(projectId: string, workflowId: string, fileName: string, arrayBuffer: ArrayBuffer, hash: string): Promise<void>;
     /**
      * Get deployed workflows on robot
      *
      * @param projectId - Project Id
      * @param callsign - Robot callsign
      */
-    getDeployedWorkflows(projectId: string, callsign: string): Promise<Workflow[]>;
+    getDeployedWorkflows(projectId: string, profileId: string, callsign?: string): Promise<Workflow[]>;
+    addRobotDeployment(projectId: string, callsign: string, workflowId: string): Promise<void>;
+    addProfileDeployment(projectId: string, profileId: string, workflowId: string): Promise<void>;
+    removeRobotDeployment(projectId: string, callsign: string, workflowId: string): Promise<void>;
+    removeProfileDeployment(projectId: string, profileId: string, workflowId: string): Promise<void>;
+    updateRobotDeployments(projectId: string, callsign: string, workflows: string[]): Promise<void>;
+    updateProfileDeployments(projectId: string, profileId: string, workflows: string[]): Promise<void>;
+    getAffectedRobots(projectId: string, workflowId: string): Promise<{
+        callsigns: string[];
+        profileIds: string[];
+    }>;
 }