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

package/cjs/services/EvaluatorService.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluatorService = void 0;
+const models_1 = require("../models");
+const BaseServiceAbstract_1 = require("./BaseServiceAbstract");
+const RocosLogger_1 = require("../logger/RocosLogger");
+const helpers_1 = require("../helpers");
+class EvaluatorService extends BaseServiceAbstract_1.BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger_1.RocosLogger.getInstance(`EvaluatorService(${this.config.url})`);
+        this.sandbox = helpers_1.WebSandbox.new().catch((e) => {
+            this.logger.error('Failed to create WebSandbox', e);
+            throw e;
+        });
+    }
+    getError(e) {
+        return new models_1.RocosError(e, models_1.errorCodes.EVALUATOR_SERVICE_ERROR);
+    }
+    getStatus() {
+        return true;
+    }
+    async teardown() {
+        const sandbox = await this.sandbox;
+        sandbox.destroy();
+    }
+    async execute(code, context, options) {
+        const sandbox = await this.sandbox;
+        return sandbox.run(code, context, options);
+    }
+}
+exports.EvaluatorService = EvaluatorService;

package/cjs/services/EventService.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventService = void 0;
+const api_1 = require("../constants/api");
+const RocosError_1 = require("../models/RocosError");
+const BaseServiceAbstract_1 = require("./BaseServiceAbstract");
+const RocosLogger_1 = require("../logger/RocosLogger");
+const formatServiceUrl_1 = require("../helpers/formatServiceUrl");
+class EventService extends BaseServiceAbstract_1.BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger_1.RocosLogger.getInstance(`EventService(${this.config.url})`);
+    }
+    getError(e) {
+        return new RocosError_1.RocosError(e, RocosError_1.errorCodes.EVENT_SERVICE_ERROR);
+    }
+    getStatus() {
+        return true;
+    }
+    /**
+     * Get event definitions for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param includeCounts - Counter
+     * @description - Renamed from getEventDefinitions
+     */
+    // TODO: map the response object
+    async getDefinitions(projectId, callsign, includeCounts = 0) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_ROBOT_EVENT_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), `Failed to get event definitions list for ${projectId}, callsign  ${callsign}.`, { includeCounts });
+    }
+    /**
+     * Add event definitions for a robot
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param model - Payload
+     * @description - Renamed from AddEventDefinitions
+     */
+    // TODO: map the request model
+    // TODO: map the response object
+    // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+    async addDefinitions(projectId, callsign, model) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_ROBOT_EVENT_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), model, `Failed to add event definitions for ${projectId}, callsign ${callsign}.`);
+    }
+    /**
+     * Get history for an event
+     *
+     * @param projectId - Project Id
+     * @param callsign - Robot callsign
+     * @param eventDefinitionId - Event Definition Id
+     * @description - Renamed from getEventHistory
+     */
+    // TODO: map the response object
+    async getHistory(projectId, callsign, eventDefinitionId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_ROBOT_EVENT_HISTORY_URL, {
+            url: this.config.url,
+            projectId,
+            callsign,
+            eventDefinitionId,
+        }, this.config.insecure), `Failed to get event history for ${projectId}, callsign ${callsign}, eventDefinitionId ${eventDefinitionId}.`);
+    }
+    /**
+     * Get events for a robot definition
+     *
+     * @param projectId - Project Id
+     * @param definitionId - Robot definition Id
+     * @description - Renamed from robotDefGetEventDefinitions
+     */
+    // TODO: map the response object
+    async getDefinitionsForRobotDef(projectId, definitionId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_DEFINITION_EVENT_URL, { url: this.config.url, projectId, definitionId }, this.config.insecure), `Failed to get event definitions list for ${projectId}, definitionId ${definitionId}.`);
+    }
+    /**
+     * Update events for a robot definition
+     *
+     * @param projectId - Project Id
+     * @param definitionId - Robot definition Id
+     * @param model - Payload
+     * @description - Renamed from robotDefAddEventDefinitions
+     */
+    // TODO: map the request model
+    // TODO: map the response object
+    // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+    async addDefinitionsForRobotDef(projectId, definitionId, model) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_DEFINITION_EVENT_URL, { url: this.config.url, projectId, definitionId }, this.config.insecure), model, `Failed to update event definitions for ${projectId}, definitionId ${definitionId}.`);
+    }
+}
+exports.EventService = EventService;

package/cjs/services/FileAccessorService.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileAccessorService = void 0;
+const BaseStreamService_1 = require("./BaseStreamService");
+const FileAccessorStream_1 = require("../api/streams/fileAccessor/FileAccessorStream");
+const identifier_1 = require("../constants/identifier");
+class FileAccessorService extends BaseStreamService_1.BaseStreamService {
+    constructor(config) {
+        super('FileAccessorService', config);
+    }
+    async serverReqOp(params) {
+        const stream = await this.createStream();
+        return stream.serverReqOp(params);
+    }
+    async listFolder(params) {
+        const stream = await this.createStream();
+        return stream.listFolder(params);
+    }
+    async downloadFile(params) {
+        const stream = await this.createStream();
+        return stream.downloadFile(params);
+    }
+    async getDownloadFileLinkByUsingBlob(params) {
+        const stream = await this.createStream();
+        return stream.getDownloadFileLinkByUsingBlob(params);
+    }
+    async createStream() {
+        return (await this.createStreamFromConfig(identifier_1.IDENTIFIER_NAME_FILE_ACCESSOR, {
+            url: this.config.url,
+            token: this.config.token,
+            scope: 'default',
+            options: this.config.options,
+            port: this.config.port,
+            insecure: this.config.insecure,
+        })).stream;
+    }
+    getStream(config) {
+        return new FileAccessorStream_1.FileAccessorStream(config);
+    }
+}
+exports.FileAccessorService = FileAccessorService;

package/cjs/services/FileAccessorServiceNode.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileAccessorServiceNode = void 0;
+const FileAccessorService_1 = require("./FileAccessorService");
+const FileAccessorStreamNode_1 = require("../api/streams/fileAccessor/FileAccessorStreamNode");
+class FileAccessorServiceNode extends FileAccessorService_1.FileAccessorService {
+    getStream(config) {
+        return new FileAccessorStreamNode_1.FileAccessorStreamNode(config);
+    }
+}
+exports.FileAccessorServiceNode = FileAccessorServiceNode;

package/cjs/services/FunctionService.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FunctionService = void 0;
+const api_1 = require("../constants/api");
+const RocosError_1 = require("../models/RocosError");
+const BaseServiceAbstract_1 = require("./BaseServiceAbstract");
+const ExportDataQuery_1 = require("../models/ExportDataQuery");
+const RocosLogger_1 = require("../logger/RocosLogger");
+const formatServiceUrl_1 = require("../helpers/formatServiceUrl");
+class FunctionService extends BaseServiceAbstract_1.BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger_1.RocosLogger.getInstance(`FunctionService(${this.config.url})`);
+    }
+    getError(e) {
+        return new RocosError_1.RocosError(e, RocosError_1.errorCodes.FUNCTION_SERVICE_ERROR);
+    }
+    getStatus() {
+        return true;
+    }
+    /**
+     * Export data
+     *
+     * @param projectId - Project Id
+     * @param query - Payload {@link IExportDataQuery}
+     */
+    // TODO: map the response object
+    async exportJobs(projectId, query) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_EXPORT_URL, { url: this.config.url, projectId }, this.config.insecure), new ExportDataQuery_1.ExportDataQuery(query).toJSON(), `Failed to export data for ${projectId}.`);
+    }
+    /**
+     * Create a function
+     *
+     * @param projectId - Project Id
+     * @param model - Payload {@link IFunctionConfig}
+     */
+    // TODO: map the response object
+    async create(projectId, model) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_URL, { url: this.config.url, projectId }, this.config.insecure), model, `Failed to create function for ${projectId}.`);
+    }
+    /**
+     * Get a functions
+     *
+     * @param projectId - Project Id
+     */
+    // TODO: map the response object
+    async list(projectId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to get functions for ${projectId}.`);
+    }
+    /**
+     * Update a function
+     *
+     * @param projectId - Project Id
+     * @param functionId - Function Id
+     * @param model - Payload {@link IFunctionConfig}
+     */
+    // TODO: map the response object
+    async update(projectId, functionId, model) {
+        return this.callPut((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_ID_URL, { url: this.config.url, projectId, functionId }, this.config.insecure), model, `Failed to update function for ${projectId}, functionId ${functionId}.`);
+    }
+    /**
+     * Get function
+     *
+     * @param projectId - Project Id
+     * @param functionId - Function Id
+     */
+    // TODO: map the response object
+    async info(projectId, functionId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_ID_URL, { url: this.config.url, projectId, functionId }, this.config.insecure), `Failed to get function for ${projectId}, functionId ${functionId}.`);
+    }
+    /**
+     * Delete function
+     *
+     * @param projectId - Project Id
+     * @param functionId - Function Id
+     */
+    // TODO: map the response object
+    async delete(projectId, functionId) {
+        return this.callDelete((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_ID_URL, { url: this.config.url, projectId, functionId }, this.config.insecure), `Failed to delete function for ${projectId}, functionId ${functionId}.`);
+    }
+    /**
+     * Run a function
+     *
+     * @param projectId - Project Id
+     * @param functionId - Function Id
+     * @param body - Payload
+     */
+    // TODO: map the response object
+    async run(projectId, functionId, body = null) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_RUN_URL, { url: this.config.url, projectId, functionId }, this.config.insecure), body, `Failed to run function for ${projectId}, functionId ${functionId}.`);
+    }
+    /**
+     * Get function pods
+     *
+     * @param projectId - Project Id
+     * @param functionId - Function Id
+     */
+    // TODO: map the response object
+    async pods(projectId, functionId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_PROJECT_FUNCTION_POD_URL, { url: this.config.url, projectId, functionId }, this.config.insecure), `Failed to ged function pods for ${projectId}, functionId ${functionId}.`);
+    }
+}
+exports.FunctionService = FunctionService;

package/cjs/services/IntegrationService.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationService = void 0;
+const api_1 = require("../constants/api");
+const models_1 = require("../models");
+const BaseServiceAbstract_1 = require("./BaseServiceAbstract");
+const RocosLogger_1 = require("../logger/RocosLogger");
+const formatServiceUrl_1 = require("../helpers/formatServiceUrl");
+/**
+ * Integrations to retrieve data from the linked project in DroneDeploy
+ */
+class IntegrationService extends BaseServiceAbstract_1.BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger_1.RocosLogger.getInstance(`IntegrationService(${this.config.url})`);
+    }
+    getStatus() {
+        return true;
+    }
+    getError(e) {
+        return new models_1.RocosError(e, models_1.errorCodes.INTEGRATIONS_SERVICE_ERROR);
+    }
+    /**
+     * Gets latest plans from the project linked to the provided project ID
+     * @param projectId Project ID
+     * @returns Plans list (limited to 50)
+     */
+    async getPlans(projectId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_DD_INTEGRATION_PLANS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get plans.');
+    }
+    /**
+     * Gets the plans from the project linked to the provided project ID
+     * @param projectId Project ID
+     * @param pageStart Page start
+     * @returns Plans list (limited to 50) with cursor to next page when available
+     */
+    async getPlansPaged(projectId, pageStart) {
+        const params = pageStart ? { page_start: pageStart } : undefined;
+        const response = await this.callGet((0, formatServiceUrl_1.formatServiceUrl)(`${api_1.API_DD_INTEGRATION_PLANS_URL}`, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get plans.', params, { responseType: 'raw' });
+        const pageNext = response.headers.get('x-dd-page-next') ?? undefined;
+        const plans = await response.json();
+        return {
+            plans,
+            pageNext,
+        };
+    }
+    /**
+     * Gets a plan for a given project (using its linked project)
+     * @param projectId Project ID
+     * @param planId Requested plan
+     * @returns A single plan
+     */
+    async getPlanById(projectId, planId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_DD_INTEGRATION_PLAN_BY_ID_URL, { url: this.config.url, projectId, planId }, this.config.insecure), 'Failed to get plan.');
+    }
+    /**
+     * Returns raster overlays such as drawings to be used for mission planning
+     * @param projectId Project ID
+     * @returns A list of overlays in the project
+     */
+    async getOverlays(projectId) {
+        return this.callGet((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_DD_INTEGRATION_OVERLAYS_URL, { url: this.config.url, projectId }, this.config.insecure), 'Failed to get overlays.');
+    }
+    /**
+     * Creates a blank issue in the latest ortho plan available
+     * @param projectId Project ID
+     * @param location Location of the issue
+     */
+    async createIssue(projectId, location) {
+        return this.callPost((0, formatServiceUrl_1.formatServiceUrl)(api_1.API_DD_INTEGRATION_ISSUES_URL, { url: this.config.url, projectId }, this.config.insecure), {
+            lat: location.lat,
+            lng: location.lng,
+        }, 'Failed to create issue.');
+    }
+}
+exports.IntegrationService = IntegrationService;

package/cjs/services/MapService.d.ts

@@ -0,0 +1,142 @@
+import { IBaseService, IRocosSDKConfig, Map, RocosError } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { Observation } from '../models/maps/Panorama';
+/**
+ * Integrations to retrieve data from the linked project in DroneDeploy
+ */
+export declare class MapService extends BaseServiceAbstract implements IBaseService {
+    constructor(config: IRocosSDKConfig);
+    getStatus(): boolean;
+    protected getError(e: Error): RocosError;
+    /**
+     * List maps from the cloud
+     *
+     * @param projectId Project ID
+     * @returns All maps in the cloud
+     */
+    list(projectId: string): Promise<Map[]>;
+    /**
+     * List maps from the robot and the cloud
+     *
+     * @param projectId Project ID
+     * @param callsign Robot callsign
+     * @returns All maps in the cloud
+     */
+    list(projectId: string, callsign: string): Promise<Map[]>;
+    /** List maps to be deployed to a callsign
+     *
+     * @param projectId
+     * @param callsign
+     */
+    listDeployedMaps(projectId: string, callsign: string): Promise<Map[]>;
+    /**
+     * Creates a new map by merging two existing maps
+     * @param projectId Project ID
+     * @param maps Array of two map IDs to merge
+     * @param options Options to create the new map
+     */
+    merge(projectId: string, maps: [string, string], options: {
+        name: string;
+        description?: string;
+        callsign: string;
+    }): Promise<void>;
+    /** Returns a map in its canonical form
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     */
+    get(projectId: string, mapId: string): Promise<Map>;
+    /**
+     * Updates a maps metadata
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param options New metadata
+     */
+    update(projectId: string, mapId: string, options: {
+        description?: string;
+        callsign?: string;
+    }): Promise<void>;
+    /**
+     * Begins uploading a map from the agent
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param callsign Robot callsign
+     * @param hash Map hash
+     */
+    sendToCloud(projectId: string, mapId: string, callsign: string, hash: string): Promise<void>;
+    /**
+     * Deletes a map from the cloud and all agents
+     * @param projectId
+     * @param mapId
+     */
+    delete(projectId: string, mapId: string): Promise<void>;
+    /**
+     * Deletes a map from a single agent.
+     *
+     * If the callsign does not have the map deployed, any local copy of the map will be deleted.
+     *
+     * @param projectId
+     * @param mapId
+     * @param callsign
+     * @param hash
+     */
+    delete(projectId: string, mapId: string, callsign: string, hash: string): Promise<void>;
+    /**
+     * Makes a copy of an uploaded map
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param options Options to create the new map
+     */
+    copy(projectId: string, mapId: string, options: {
+        description?: string;
+    }): Promise<void>;
+    /** Deploy a map from the cloud to a robot
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param callsign Robot callsign
+     */
+    deploy(projectId: string, mapId: string, callsign: string): Promise<void>;
+    /** Get a GeoJSON representation of a map
+     *
+     * @param projectId Project ID
+     * @param mapId Map ID
+     * @param frameId Frame ID (optional)
+     */
+    getGeoJSON(projectId: string, mapId: string, frameId?: string): Promise<unknown>;
+    /**
+     * Returns a Promise that resolves to an array of Observation objects for the given panorama ID.
+     *
+     * @param projectId The ID of the project the panorama belongs to.
+     * @param panoramaId The ID of the panorama to retrieve observations for.
+     * @returns A Promise that resolves to an array of Observation objects.
+     */
+    listObservations(projectId: string, panoramaId: string): Promise<Observation[]>;
+    /**
+     * Creates new observations on a panorama.
+     *
+     * @param projectId The ID of the project the panorama belongs to.
+     * @param panoramaId The ID of the panorama to create observations for.
+     * @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>;
+    /**
+     * Gets observations for a project.
+     *
+     * @param projectId The ID of the project the observations belongs to.
+     * @param key (optional) Filters on a key defined on the observation
+     * @param frameID (optional) Transforms on a seed frame
+     * @returns A list of observations
+     */
+    getObservations(projectId: string, key?: string, frameID?: string): Promise<Observation[]>;
+    /**
+     * Lists available keys for all observations in a project.
+     *
+     * @param projectId The ID of the project the observations belongs to.
+     * @returns A list of observations
+     */
+    getObservationsKeys(projectId: string): Promise<string[]>;
+}