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

package/esm/models/target/Target.d.ts

@@ -0,0 +1,30 @@
+import { Quaternion } from '../graph/Quaternion';
+import { Vector3 } from '../graph/Vector3';
+export interface TargetBase {
+    id: string;
+    name: string;
+    data?: Record<string, string>;
+    translation?: Vector3;
+    rotation?: Quaternion;
+    media?: TargetMedia[];
+    position?: TargetWgs84 | Vector3;
+    frame?: string;
+}
+export interface TargetMedia {
+    id: string;
+    data: Record<string, string>;
+}
+export interface TargetWgs84 {
+    lat: number;
+    lon: number;
+    alt?: number;
+}
+export declare const isTargetWgs84: (position: TargetWgs84 | Vector3) => position is TargetWgs84;
+export interface Target extends TargetBase {
+    type: 'TARGET';
+}
+export declare const isTarget: (target: Target | Asset) => target is Target;
+export interface Asset extends TargetBase {
+    type: 'ASSET';
+}
+export declare const isAsset: (target: Target | Asset) => target is Asset;

package/esm/models/target/Target.js

@@ -0,0 +1,9 @@
+export const isTargetWgs84 = (position) => {
+    return Boolean(position) && 'lat' in position && 'lon' in position;
+};
+export const isTarget = (target) => {
+    return target.type === 'TARGET';
+};
+export const isAsset = (target) => {
+    return target.type === 'ASSET';
+};

package/esm/node/RocosSDKNode.d.ts

@@ -1,4 +1,4 @@
-import { EvaluatorService, ScheduleService } from '../services';
+import { EvaluatorService } from '../services';
 import { IBaseService, ServiceEnum } from '../models';
 import { CallerServiceNode } from '../services/CallerServiceNode';
 import { CommandServiceNode } from '../services/CommandServiceNode';
@@ -13,10 +13,6 @@ export declare class RocosSDKNode extends RocosSDK {
      * Gets the telemetry service.
      */
     getTelemetryService(): TelemetryServiceNode;
-    /**
-     * Gets the scheduler service.
-     */
-    getSchedulerService(): ScheduleService;
     /**
      * Gets the service call service.
      */

package/esm/node/RocosSDKNode.js

@@ -1,4 +1,4 @@
-import { AssetStorageService, AuthService, ConfigGroupService, DashboardService, EventService, FunctionService, IntegrationService, MapService, ProfileService, ProjectService, RobotService, ScheduleService, SpotProvisioningServiceNode, StreamService, UserService, } from '../services';
+import { AssetStorageService, AuthService, ConfigGroupService, DashboardService, DeviceCredentialsService, EnvironmentService, EventService, IntegrationService, MapService, ProfileService, ProjectService, RobotService, ScheduleService, SpotProvisioningServiceNode, StreamService, TargetService, UserService, } from '../services';
 import { ServiceEnum } from '../models';
 import { CallerServiceNode } from '../services/CallerServiceNode';
 import { CommandServiceNode } from '../services/CommandServiceNode';
@@ -24,6 +24,9 @@ export class RocosSDKNode extends RocosSDK {
                 case ServiceEnum.ROBOT:
                     this.services[name] = new RobotService(config);
                     break;
+                case ServiceEnum.ENVIRONMENT:
+                    this.services[name] = new EnvironmentService(config);
+                    break;
                 case ServiceEnum.EVENT:
                     this.services[name] = new EventService(config);
                     break;
@@ -48,9 +51,6 @@ export class RocosSDKNode extends RocosSDK {
                 case ServiceEnum.DASHBOARD:
                     this.services[name] = new DashboardService(config);
                     break;
-                case ServiceEnum.FUNCTION:
-                    this.services[name] = new FunctionService(config);
-                    break;
                 case ServiceEnum.STREAM:
                     this.services[name] = new StreamService(config);
                     break;
@@ -81,6 +81,12 @@ export class RocosSDKNode extends RocosSDK {
                 case ServiceEnum.MAP:
                     this.services[name] = new MapService(config);
                     break;
+                case ServiceEnum.DEVICE_CREDENTIALS:
+                    this.services[name] = new DeviceCredentialsService(config);
+                    break;
+                case ServiceEnum.TARGET:
+                    this.services[name] = new TargetService(config);
+                    break;
             }
         }
         this.logger.debug(`Found service ${name}.`);
@@ -92,12 +98,6 @@ export class RocosSDKNode extends RocosSDK {
     getTelemetryService() {
         return this.getService(ServiceEnum.TELEMETRY);
     }
-    /**
-     * Gets the scheduler service.
-     */
-    getSchedulerService() {
-        return this.getService(ServiceEnum.SCHEDULE);
-    }
     /**
      * Gets the service call service.
      */

package/esm/services/AssetStorageService.d.ts

@@ -1,9 +1,5 @@
-import { AssetItemModel, AssetItemWithObservationsModel, AssetSyncDefinitionModel, AssetSyncDefinitionsModel, AssetSyncIntegrationModel, AssetSyncIntegrationProviderModel } from '../models';
-import { RocosError } from '../models/RocosError';
+import { AssetItemModel, AssetItemWithObservationsModel, AssetSyncDefinitionsModel, AssetSyncIntegrationModel, AssetSyncIntegrationProviderModel, CreateAssetSyncIntegrationModel, IBaseService, IRocosSDKConfig, RocosError } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
-import { IBaseService } from '../models/IBaseService';
-import { IRocosSDKConfig } from '../models/IRocosSDKConfig';
-import { CreateAssetSyncIntegrationModel } from '../models/asset-storage/SyncIntegrations';
 export declare class AssetStorageService extends BaseServiceAbstract implements IBaseService {
     constructor(config: IRocosSDKConfig);
     protected getError(e: Error): RocosError;
@@ -15,7 +11,7 @@ export declare class AssetStorageService extends BaseServiceAbstract implements
      * @param filePath - Path to asset file
      * @param file - File payload
      */
-    create(projectId: string, filePath: string, file: File): Promise<any>;
+    create(projectId: string, filePath: string, file: File): Promise<AssetItemModel>;
     /**
      * Update a project asset
      *
@@ -23,28 +19,23 @@ export declare class AssetStorageService extends BaseServiceAbstract implements
      * @param filePath - Path to asset file
      * @param file - File payload
      */
-    update(projectId: string, filePath: string, file: File): Promise<any>;
+    update(projectId: string, filePath: string, file: File): Promise<AssetItemModel>;
     /**
      * Delete a project asset
      *
      * @param projectId - Project Id
      * @param filePath - Path to asset file
      */
-    delete(projectId: string, filePath: string): Promise<any>;
-    /**
-     * Lost assets for a project or project file path
-     *
-     * @param projectId - Project Id
-     * @param filePath - Path to asset file
-     */
-    list(projectId: string, filePath?: string): Promise<any>;
+    delete(projectId: string, filePath: string): Promise<unknown>;
+    list(projectId: string): Promise<AssetItemModel[]>;
+    list(projectId: string, filePath: string): Promise<unknown>;
     /**
      * Get a project asset
      *
      * @param projectId - Project Id
      * @param filePath - Path to asset file
      */
-    getAsset(projectId: string, filePath: string): Promise<any>;
+    getAsset(projectId: string, filePath: string): Promise<Blob>;
     /**
      * List assets for a robot
      *
@@ -84,15 +75,24 @@ export declare class AssetStorageService extends BaseServiceAbstract implements
      * @param projectId
      * @param start Start date for the query (optional)
      * @param end End date for the query (optional)
+     * @param includeObservations If observations should be included in the response (optional)
+     */
+    listMappedAssets(projectId: string, start?: Date, end?: Date, includeObservations?: boolean): Promise<AssetItemWithObservationsModel[]>;
+    /**
+     * Get mapped asset
+     *
+     * @param projectId
+     * @param assetId
      */
-    listMappedAssets(projectId: string, start?: Date, end?: Date): Promise<AssetItemWithObservationsModel[]>;
+    getMappedAsset(projectId: string, assetId: string): Promise<AssetItemWithObservationsModel>;
     /**
      * Set Robot Sync Definitions
      * @param projectId
      * @param callsign
      * @param definition
+     * @param syncNow - Sync configured paths immediately
      */
-    setRobotSyncDefinitions(projectId: string, callsign: string, definition: AssetSyncDefinitionModel): Promise<AssetSyncDefinitionsModel>;
+    setRobotSyncDefinitions(projectId: string, callsign: string, definition: AssetSyncDefinitionsModel, syncNow?: boolean): Promise<AssetSyncDefinitionsModel>;
     /**
      * Get Robot Sync Definitions
      * @param projectId
@@ -105,7 +105,7 @@ export declare class AssetStorageService extends BaseServiceAbstract implements
      * @param profileId
      * @param definition
      */
-    setProfileSyncDefinitions(projectId: string, profileId: string, definition: AssetSyncDefinitionModel): Promise<any>;
+    setProfileSyncDefinitions(projectId: string, profileId: string, definition: AssetSyncDefinitionsModel): Promise<AssetSyncDefinitionsModel>;
     /**
      * Get Profile Sync Definitions
      * @param projectId

package/esm/services/AssetStorageService.js

@@ -1,5 +1,5 @@
-import { API_PROJECT_ASSET_INTEGRATIONS_PATH_URL, API_PROJECT_ASSET_INTEGRATION_PATH_URL, API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL, API_PROJECT_ASSET_PATH_URL, API_PROJECT_ASSET_PROFILES_SYNC_DEFINITION_PATH_URL, API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL, API_PROJECT_ASSET_URL, API_PROJECT_FLOW_ASSET_PATH_URL, API_PROJECT_MAPPED_ASSETS_PATH_URL, API_PROJECT_MISSION_ASSETS_PATH_URL, API_PROJECT_MISSION_ASSET_PATH_URL, API_PROJECT_ROBOT_ASSET_PATH_URL, } from '../constants/api';
-import { RocosError, errorCodes } from '../models/RocosError';
+import { API_PROJECT_ASSET_INTEGRATIONS_PATH_URL, API_PROJECT_ASSET_INTEGRATION_PATH_URL, API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL, API_PROJECT_ASSET_PATH_URL, API_PROJECT_ASSET_PROFILES_SYNC_DEFINITION_PATH_URL, API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL, API_PROJECT_ASSET_URL, API_PROJECT_FLOW_ASSET_PATH_URL, API_PROJECT_MAPPED_ASSETS_PATH_URL, API_PROJECT_MAPPED_ASSET_PATH_URL, API_PROJECT_MISSION_ASSETS_PATH_URL, API_PROJECT_MISSION_ASSET_PATH_URL, API_PROJECT_ROBOT_ASSET_PATH_URL, } from '../constants/api';
+import { RocosError, errorCodes, } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
 import { formatServiceUrl } from '../helpers/formatServiceUrl';
@@ -21,7 +21,6 @@ export class AssetStorageService extends BaseServiceAbstract {
      * @param filePath - Path to asset file
      * @param file - File payload
      */
-    // TODO: map the response object
     async create(projectId, filePath, file) {
         const formData = new FormData();
         formData.append('file', file);
@@ -34,7 +33,6 @@ export class AssetStorageService extends BaseServiceAbstract {
      * @param filePath - Path to asset file
      * @param file - File payload
      */
-    // TODO: map the response object
     async update(projectId, filePath, file) {
         const formData = new FormData();
         formData.append('file', file);
@@ -56,7 +54,6 @@ export class AssetStorageService extends BaseServiceAbstract {
      * @param projectId - Project Id
      * @param filePath - Path to asset file
      */
-    // TODO: map the response object
     async list(projectId, filePath) {
         let url = '';
         if (filePath) {
@@ -73,7 +70,6 @@ export class AssetStorageService extends BaseServiceAbstract {
      * @param projectId - Project Id
      * @param filePath - Path to asset file
      */
-    // TODO: map the response object
     async getAsset(projectId, filePath) {
         return this.callGet(formatServiceUrl(API_PROJECT_ASSET_PATH_URL, { url: this.config.url, projectId, filePath }, this.config.insecure), `Failed to get asset for ${projectId}, filePath ${filePath}.`, undefined, {
             responseType: 'blob',
@@ -128,26 +124,41 @@ export class AssetStorageService extends BaseServiceAbstract {
      * @param projectId
      * @param start Start date for the query (optional)
      * @param end End date for the query (optional)
+     * @param includeObservations If observations should be included in the response (optional)
      */
-    async listMappedAssets(projectId, start, end) {
+    async listMappedAssets(projectId, start, end, includeObservations) {
         return this.callGet(formatServiceUrl(API_PROJECT_MAPPED_ASSETS_PATH_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to list mapped assets for ${projectId}.`, {
             start: start?.toISOString() ?? '',
             end: end?.toISOString() ?? '',
+            includeObservations: includeObservations ? 'true' : 'false',
         });
     }
+    /**
+     * Get mapped asset
+     *
+     * @param projectId
+     * @param assetId
+     */
+    async getMappedAsset(projectId, assetId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_MAPPED_ASSET_PATH_URL, { url: this.config.url, projectId, assetId }, this.config.insecure), `Failed to get mapped asset for ${projectId} and id: ${assetId}.`);
+    }
     /**
      * Set Robot Sync Definitions
      * @param projectId
      * @param callsign
      * @param definition
+     * @param syncNow - Sync configured paths immediately
      */
-    setRobotSyncDefinitions(projectId, callsign, definition) {
+    setRobotSyncDefinitions(projectId, callsign, definition, syncNow = false) {
+        const url = formatServiceUrl(API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL, { url: this.config.url, projectId, callsign }, this.config.insecure);
         const httpOptions = {
             headers: {
                 'content-type': 'application/json',
             },
         };
-        return this.callPost(formatServiceUrl(API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), definition, `Failed to update asset for ${projectId}, callsign ${callsign}.`, httpOptions);
+        return this.callPost(url, definition, `Failed to update asset for ${projectId}, callsign ${callsign}.`, httpOptions, {
+            syncNow,
+        });
     }
     /**
      * Get Robot Sync Definitions

package/esm/services/AuthService.d.ts

@@ -1,10 +1,20 @@
+import { Observable } from 'rxjs';
 import { IBaseService, IRocosSDKConfig, RocosError, Token } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 export declare class AuthService extends BaseServiceAbstract implements IBaseService {
     protected config: IRocosSDKConfig;
     private token?;
     private tokenRefreshTimeoutId?;
+    private tokenSubject$;
     constructor(config: IRocosSDKConfig);
+    /** Observable for token updates
+     *
+     * This is useful for getting notified when the token changes.
+     * i.e. when the token is refreshed from the token refresh checker.
+     *
+     * It will emit the current token when you subscribe and then emit new tokens when they are set.
+     */
+    get token$(): Observable<Token>;
     getStatus(): boolean;
     teardown(): void;
     protected getError(e: RocosError): RocosError;
@@ -62,9 +72,10 @@ export declare class AuthService extends BaseServiceAbstract implements IBaseSer
      * If you want to refresh the token regardless of the expiry time, use `refreshToken`.
      *
      * @param minutes the number of minutes before the token expires to refresh the token
+     * @returns true if the token was refreshed
      * @see refreshToken
      */
-    refreshTokenIfExpired(minutes: number): Promise<void>;
+    refreshTokenIfExpired(minutes: number): Promise<boolean>;
     /** Start a 5-minute loop to check if the token needs to be refreshed
      *
      * This is useful when you are using GRPC services (i.e. telemetry) which does not automatically refresh the token.

package/esm/services/AuthService.js

@@ -1,19 +1,35 @@
 import { API_APPLICATION_AUTH_URL, API_OTP_AUTH_URL, API_OTP_URL, API_USER_TOKEN_URL } from '../constants/api';
+import { BehaviorSubject } from 'rxjs';
 import { RocosError, Token, errorCodes } from '../models';
 import { BaseServiceAbstract } from './BaseServiceAbstract';
 import { RocosLogger } from '../logger/RocosLogger';
 import { RocosStore } from '../store/RocosStore';
+import { filter } from 'rxjs/operators';
 import { formatServiceUrl } from '../helpers/formatServiceUrl';
 import { issuer } from '../constants/auth';
 export class AuthService extends BaseServiceAbstract {
     constructor(config) {
         super(config);
         this.config = config;
+        this.tokenSubject$ = new BehaviorSubject(null);
         this.config = config;
         this.logger = RocosLogger.getInstance(`AuthService(${this.config.url})`);
         if (this.config.token) {
             this.setToken(this.config.token);
         }
+        this.token$.subscribe((token) => {
+            RocosStore.getChangeSubject().next({ type: 'token', url: this.config.url, data: token.value });
+        });
+    }
+    /** Observable for token updates
+     *
+     * This is useful for getting notified when the token changes.
+     * i.e. when the token is refreshed from the token refresh checker.
+     *
+     * It will emit the current token when you subscribe and then emit new tokens when they are set.
+     */
+    get token$() {
+        return this.tokenSubject$.asObservable().pipe(filter(Boolean));
     }
     getStatus() {
         return true;
@@ -39,7 +55,12 @@ export class AuthService extends BaseServiceAbstract {
         }
         this.config.token = this.token.value;
         // output a message for token change
-        RocosStore.getChangeSubject().next({ type: 'token', url: this.config.url, data: this.token.value });
+        if (this.isTokenValid(this.token)) {
+            this.tokenSubject$.next(this.token);
+        }
+        else {
+            void this.getToken();
+        }
     }
     /**
      * Clear token
@@ -163,6 +184,7 @@ export class AuthService extends BaseServiceAbstract {
      * If you want to refresh the token regardless of the expiry time, use `refreshToken`.
      *
      * @param minutes the number of minutes before the token expires to refresh the token
+     * @returns true if the token was refreshed
      * @see refreshToken
      */
     async refreshTokenIfExpired(minutes) {
@@ -170,7 +192,9 @@ export class AuthService extends BaseServiceAbstract {
             this.logger.info('Token expires in 15 minutes. Refreshing.');
             const newToken = await this.refreshToken();
             this.setToken(newToken);
+            return true;
         }
+        return false;
     }
     /** Start a 5-minute loop to check if the token needs to be refreshed
      *

package/esm/services/BaseServiceAbstract.d.ts

@@ -21,7 +21,7 @@ export declare abstract class BaseServiceAbstract {
     protected logger: Logger;
     protected constructor(config: IRocosSDKConfig);
     protected abstract getError(e: Error): RocosError;
-    protected callPost<Response = unknown, Payload = unknown>(url: string, payload: Payload, errorMessage: string, config?: RequestConfig): Promise<Response>;
+    protected callPost<Response = unknown, Payload = unknown>(url: string, payload: Payload, errorMessage: string, config?: RequestConfig, params?: QueryParams): Promise<Response>;
     protected callPut<Response = unknown, Payload = unknown>(url: string, payload: Payload, errorMessage: string, config?: RequestConfig): Promise<Response>;
     protected callDelete<Response = unknown, Payload = unknown>(url: string, errorMessage: string, payload?: Payload): Promise<Response>;
     protected callGet<Response = unknown>(url: string, errorMessage: string, params?: QueryParams, config?: RequestConfig): Promise<Response>;

package/esm/services/BaseServiceAbstract.js

@@ -1,12 +1,12 @@
-import { RocosError, HttpError } from '../models';
+import { HttpError, RocosError } from '../models';
 import { getURLSearchParams } from '../helpers';
 import { RocosStore } from '../store/RocosStore';
 export class BaseServiceAbstract {
     constructor(config) {
         this.config = config;
     }
-    async callPost(url, payload, errorMessage, config) {
-        return this.call(url, 'POST', { errorMessage, payload, config });
+    async callPost(url, payload, errorMessage, config, params) {
+        return this.call(url, 'POST', { errorMessage, payload, config, params });
     }
     async callPut(url, payload, errorMessage, config) {
         return this.call(url, 'PUT', { errorMessage, payload, config });

package/esm/services/DeviceCredentialsService.d.ts

@@ -0,0 +1,15 @@
+import { DeviceCredentialAuth, DeviceCredentialAuthResult, DeviceCredentialCreate, DeviceCredentials } from '../models/device-credentials/DeviceCredentials';
+import { IBaseService, IRocosSDKConfig, RocosError } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+/**
+ * Manage external devices authenticating with the platform
+ */
+export declare class DeviceCredentialsService extends BaseServiceAbstract implements IBaseService {
+    constructor(config: IRocosSDKConfig);
+    getStatus(): boolean;
+    protected getError(e: Error): RocosError;
+    list(projectId: string, callsign: string): Promise<DeviceCredentials>;
+    create(projectId: string, callsign: string, credentials: DeviceCredentialCreate, disableValidation?: boolean): Promise<DeviceCredentialCreate>;
+    delete(projectId: string, callsign: string, component: string, system: string): Promise<void>;
+    auth(credentials: DeviceCredentialAuth): Promise<DeviceCredentialAuthResult>;
+}

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,28 @@
+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>;
+    /**
+     * 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,44 @@
+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}.`);
+    }
+    /**
+     * 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>;
 }