@dronedeploy/rocos-js-sdk 3.0.1-alpha.9 → 3.0.2

package/esm/services/DeviceCredentialsService.js

@@ -0,0 +1,52 @@
+import { API_DEVICE_CREDENTIALS_AUTH_URL, API_DEVICE_CREDENTIALS_URL } from '../constants/api';
+import { RocosError, errorCodes } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { RocosLogger } from '../logger/RocosLogger';
+import { formatServiceUrl } from '../helpers/formatServiceUrl';
+/**
+ * Manage external devices authenticating with the platform
+ */
+export class DeviceCredentialsService extends BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger.getInstance(`DeviceCredentials(${this.config.url})`);
+    }
+    getStatus() {
+        return true;
+    }
+    getError(e) {
+        return new RocosError(e, errorCodes.DEVICE_CREDENTIALS_SERVICE_ERROR);
+    }
+    list(projectId, callsign) {
+        return this.callGet(formatServiceUrl(API_DEVICE_CREDENTIALS_URL, {
+            url: this.config.url,
+            projectId,
+            callsign,
+        }, this.config.insecure), 'Failed to get device credentials.');
+    }
+    create(projectId, callsign, credentials, disableValidation = false) {
+        let queryParams;
+        if (disableValidation) {
+            queryParams = {
+                validate: false,
+            };
+        }
+        return this.callPost(formatServiceUrl(API_DEVICE_CREDENTIALS_URL, {
+            url: this.config.url,
+            projectId,
+            callsign,
+        }, this.config.insecure), credentials, 'Failed to create device credentials.', undefined, queryParams);
+    }
+    delete(projectId, callsign, component, system) {
+        return this.callDelete(formatServiceUrl(API_DEVICE_CREDENTIALS_URL, {
+            url: this.config.url,
+            projectId,
+            callsign,
+        }, this.config.insecure), 'Failed to delete device credentials.', { component, system });
+    }
+    auth(credentials) {
+        return this.callPost(formatServiceUrl(API_DEVICE_CREDENTIALS_AUTH_URL, {
+            url: this.config.url,
+        }, this.config.insecure), credentials, 'Failed to delete device credentials.');
+    }
+}

package/esm/services/EnvironmentService.d.ts

@@ -0,0 +1,34 @@
+import { IBaseService, IRocosSDKConfig, RocosError } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+/**
+ * Service responsible for saving and retrieving the project environment from Giraffe.
+ */
+export declare class EnvironmentService extends BaseServiceAbstract implements IBaseService {
+    constructor(config: IRocosSDKConfig);
+    protected getError(e: Error): RocosError;
+    getStatus(): boolean;
+    /**
+     * Get Environment
+     *
+     * @param projectId - Project Id
+     */
+    get(projectId: string): Promise<unknown>;
+    /**
+     * Set Environment
+     *
+     * @param projectId - Project Id
+     */
+    set(projectId: string, scene: unknown): Promise<void>;
+    /**
+     * Update Environment
+     *
+     * @param projectId - Project Id
+     */
+    update(projectId: string, scene: unknown): Promise<void>;
+    /**
+     * Delete Environment
+     *
+     * @param projectId - Project Id
+     */
+    delete(projectId: string): Promise<void>;
+}

package/esm/services/EnvironmentService.js

@@ -0,0 +1,52 @@
+import { RocosError, errorCodes } from '../models';
+import { API_PROJECT_ENVIRONMENT_URL } from '../constants/api';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { RocosLogger } from '../logger/RocosLogger';
+import { formatServiceUrl } from '../helpers/formatServiceUrl';
+/**
+ * Service responsible for saving and retrieving the project environment from Giraffe.
+ */
+export class EnvironmentService extends BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger.getInstance(`EnvironmentService(${this.config.url})`);
+    }
+    getError(e) {
+        return new RocosError(e, errorCodes.ENVIRONMENT_SERVICE_ERROR);
+    }
+    getStatus() {
+        return true;
+    }
+    /**
+     * Get Environment
+     *
+     * @param projectId - Project Id
+     */
+    async get(projectId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ENVIRONMENT_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to get environment for ${projectId}.`);
+    }
+    /**
+     * Set Environment
+     *
+     * @param projectId - Project Id
+     */
+    async set(projectId, scene) {
+        return this.callPost(formatServiceUrl(API_PROJECT_ENVIRONMENT_URL, { url: this.config.url, projectId }, this.config.insecure), scene, `Failed to set environment for ${projectId}.`);
+    }
+    /**
+     * Update Environment
+     *
+     * @param projectId - Project Id
+     */
+    async update(projectId, scene) {
+        return this.callPut(formatServiceUrl(API_PROJECT_ENVIRONMENT_URL, { url: this.config.url, projectId }, this.config.insecure), scene, `Failed to update environment for ${projectId}.`);
+    }
+    /**
+     * Delete Environment
+     *
+     * @param projectId - Project Id
+     */
+    async delete(projectId) {
+        return this.callDelete(formatServiceUrl(API_PROJECT_ENVIRONMENT_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to update environment for ${projectId}.`);
+    }
+}

package/esm/services/EvaluatorService.js

@@ -19,7 +19,7 @@ export class EvaluatorService extends BaseServiceAbstract {
     }
     async teardown() {
         const sandbox = await this.sandbox;
-        sandbox.destroy();
+        sandbox.destroy('evaluator service torn down');
     }
     async execute(code, context, options) {
         const sandbox = await this.sandbox;

package/esm/services/IntegrationService.d.ts

@@ -1,4 +1,4 @@
-import { IBaseService, IRocosSDKConfig, Overlay, Plan, RocosError } from '../models';
+import { IBaseService, IRocosSDKConfig, Location, Overlay, PaginatedResults, Plan, RocosError } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 /**
  * Integrations to retrieve data from the linked project in DroneDeploy
@@ -45,4 +45,10 @@ export declare class IntegrationService extends BaseServiceAbstract implements I
         lat: number;
         lng: number;
     }): Promise<void>;
+    /**
+     * Gets locations for the provided project ID
+     * @param projectId Project ID
+     * @returns Plans list (limited to 50)
+     */
+    getLocations(projectId: string, pageStart?: string): Promise<PaginatedResults<Location>>;
 }

package/esm/services/IntegrationService.js

@@ -1,5 +1,5 @@
-import { API_DD_INTEGRATION_ISSUES_URL, API_DD_INTEGRATION_OVERLAYS_URL, API_DD_INTEGRATION_PLANS_URL, API_DD_INTEGRATION_PLAN_BY_ID_URL, } from '../constants/api';
-import { RocosError, errorCodes } from '../models';
+import { API_DD_INTEGRATION_ISSUES_URL, API_DD_INTEGRATION_LOCATIONS_URL, API_DD_INTEGRATION_OVERLAYS_URL, API_DD_INTEGRATION_PLANS_URL, API_DD_INTEGRATION_PLAN_BY_ID_URL, } from '../constants/api';
+import { RocosError, errorCodes, } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
 import { formatServiceUrl } from '../helpers/formatServiceUrl';
@@ -69,4 +69,12 @@ export class IntegrationService extends BaseServiceAbstract {
             lng: location.lng,
         }, 'Failed to create issue.');
     }
+    /**
+     * Gets locations for the provided project ID
+     * @param projectId Project ID
+     * @returns Plans list (limited to 50)
+     */
+    async getLocations(projectId, pageStart) {
+        return this.callGet(formatServiceUrl(API_DD_INTEGRATION_LOCATIONS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get locations.', pageStart ? { page_start: pageStart } : undefined);
+    }
 }

package/esm/services/MapService.d.ts

@@ -1,10 +1,12 @@
-import { IBaseService, IRocosSDKConfig, Map, RocosError } from '../models';
+import { Asset, IBaseService, IRocosSDKConfig, Map, RocosError } from '../models';
+import { CreateObservation, Observation } from '../models/maps/Panorama';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
-import { Observation } from '../models/maps/Panorama';
 /**
- * Integrations to retrieve data from the linked project in DroneDeploy
+ * Maps service for managing robot maps in the cloud and on robots
  */
 export declare class MapService extends BaseServiceAbstract implements IBaseService {
+    getObservations: (projectId: string, key?: string, frameID?: string) => Promise<Asset[]>;
+    getObservationsKeys: (projectId: string) => Promise<string[]>;
     constructor(config: IRocosSDKConfig);
     getStatus(): boolean;
     protected getError(e: Error): RocosError;
@@ -122,7 +124,7 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
      * @param observations An array of Observation objects to create.
      * @returns A Promise that resolves when the observations have been created.
      */
-    createObservations(projectId: string, panoramaId: string, observations: Observation[]): Promise<void>;
+    createObservations(projectId: string, panoramaId: string, observations: CreateObservation[]): Promise<void>;
     /**
      * Gets observations for a project.
      *
@@ -131,12 +133,20 @@ export declare class MapService extends BaseServiceAbstract implements IBaseServ
      * @param frameID (optional) Transforms on a seed frame
      * @returns A list of observations
      */
-    getObservations(projectId: string, key?: string, frameID?: string): Promise<Observation[]>;
+    getAssets(projectId: string, key?: string, frameID?: string): Promise<Asset[]>;
     /**
-     * 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: string): Promise<string[]>;
+    /**
+     * 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: string): Promise<string[]>;
+    deletePanorama(projectId: string, panoramaId: string): Promise<void>;
 }

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}.`);
+    }
 }