@dronedeploy/rocos-js-sdk 3.0.1-alpha.1 → 3.0.1-alpha.14

package/esm/node/RocosSDKNode.d.ts

@@ -0,0 +1,51 @@
+import { EvaluatorService, ScheduleService } from '../services';
+import { IBaseService, ServiceEnum } from '../models';
+import { CallerServiceNode } from '../services/CallerServiceNode';
+import { CommandServiceNode } from '../services/CommandServiceNode';
+import { ControlServiceNode } from '../services/ControlServiceNode';
+import { FileAccessorServiceNode } from '../services/FileAccessorServiceNode';
+import { RocosSDK } from '../RocosSDK';
+import { SearchServiceNode } from '../services/SearchServiceNode';
+import { TelemetryServiceNode } from '../services/TelemetryServiceNode';
+export declare class RocosSDKNode extends RocosSDK {
+    getService<T extends IBaseService>(name: ServiceEnum): T;
+    /**
+     * Gets the telemetry service.
+     */
+    getTelemetryService(): TelemetryServiceNode;
+    /**
+     * Gets the scheduler service.
+     */
+    getSchedulerService(): ScheduleService;
+    /**
+     * Gets the service call service.
+     */
+    getCallerService(): CallerServiceNode;
+    /**
+     * Gets the command service.
+     */
+    getCommandService(): CommandServiceNode;
+    /**
+     * Gets the robot control service.
+     */
+    getControlService(): ControlServiceNode;
+    /**
+     * Gets the search service.
+     */
+    getSearchService(): SearchServiceNode;
+    /**
+     * Gets the file accessor service
+     * @returns FileAccessorServiceNode
+     */
+    getFileAccessorService(): FileAccessorServiceNode;
+    /**
+     * Gets the evaluator service
+     * @deprecated Not supported in Node.js
+     */
+    getEvaluatorService(): EvaluatorService;
+    /**
+     * Gets the WebRTC service
+     * @deprecated Not supported in Node.js
+     */
+    getRTPWebRTCService(): never;
+}

package/esm/node/RocosSDKNode.js

@@ -0,0 +1,146 @@
+import { AssetStorageService, AuthService, ConfigGroupService, DashboardService, EventService, FunctionService, IntegrationService, MapService, ProfileService, ProjectService, RobotService, ScheduleService, SpotProvisioningServiceNode, StreamService, UserService, } from '../services';
+import { ServiceEnum } from '../models';
+import { CallerServiceNode } from '../services/CallerServiceNode';
+import { CommandServiceNode } from '../services/CommandServiceNode';
+import { ControlServiceNode } from '../services/ControlServiceNode';
+import { FileAccessorServiceNode } from '../services/FileAccessorServiceNode';
+import { RocosSDK } from '../RocosSDK';
+import { SearchServiceNode } from '../services/SearchServiceNode';
+import { TelemetryServiceNode } from '../services/TelemetryServiceNode';
+import { WorkflowServiceNode } from '../services/WorkflowServiceNode';
+export class RocosSDKNode extends RocosSDK {
+    // eslint-disable-next-line max-lines-per-function
+    getService(name) {
+        if (!this.services?.[name]) {
+            this.logger.info(`Service ${name} does not exist, creating it now.`);
+            const config = this.overrideConfig(name);
+            switch (name) {
+                case ServiceEnum.AUTH:
+                    this.services[name] = new AuthService(config);
+                    break;
+                case ServiceEnum.TELEMETRY:
+                    this.services[name] = new TelemetryServiceNode(config);
+                    break;
+                case ServiceEnum.ROBOT:
+                    this.services[name] = new RobotService(config);
+                    break;
+                case ServiceEnum.EVENT:
+                    this.services[name] = new EventService(config);
+                    break;
+                case ServiceEnum.PROJECT:
+                    this.services[name] = new ProjectService(config);
+                    break;
+                case ServiceEnum.CALLER:
+                    this.services[name] = new CallerServiceNode(config);
+                    break;
+                case ServiceEnum.COMMAND:
+                    this.services[name] = new CommandServiceNode(config);
+                    break;
+                case ServiceEnum.CONTROL:
+                    this.services[name] = new ControlServiceNode(config);
+                    break;
+                case ServiceEnum.SEARCH:
+                    this.services[name] = new SearchServiceNode(config);
+                    break;
+                case ServiceEnum.CONFIG_GROUP:
+                    this.services[name] = new ConfigGroupService(config);
+                    break;
+                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;
+                case ServiceEnum.USER:
+                    this.services[name] = new UserService(config);
+                    break;
+                case ServiceEnum.WORKFLOW:
+                    this.services[name] = new WorkflowServiceNode(config);
+                    break;
+                case ServiceEnum.ASSET_STORAGE:
+                    this.services[name] = new AssetStorageService(config);
+                    break;
+                case ServiceEnum.PROFILE:
+                    this.services[name] = new ProfileService(config);
+                    break;
+                case ServiceEnum.FILE_ACCESSOR:
+                    this.services[name] = new FileAccessorServiceNode(config);
+                    break;
+                case ServiceEnum.SPOT_PROVISIONER:
+                    this.services[name] = new SpotProvisioningServiceNode(config);
+                    break;
+                case ServiceEnum.SCHEDULE:
+                    this.services[name] = new ScheduleService(config);
+                    break;
+                case ServiceEnum.INTEGRATION:
+                    this.services[name] = new IntegrationService(config);
+                    break;
+                case ServiceEnum.MAP:
+                    this.services[name] = new MapService(config);
+                    break;
+            }
+        }
+        this.logger.debug(`Found service ${name}.`);
+        return this.services[name];
+    }
+    /**
+     * Gets the telemetry service.
+     */
+    getTelemetryService() {
+        return this.getService(ServiceEnum.TELEMETRY);
+    }
+    /**
+     * Gets the scheduler service.
+     */
+    getSchedulerService() {
+        return this.getService(ServiceEnum.SCHEDULE);
+    }
+    /**
+     * Gets the service call service.
+     */
+    getCallerService() {
+        return this.getService(ServiceEnum.CALLER);
+    }
+    /**
+     * Gets the command service.
+     */
+    getCommandService() {
+        return this.getService(ServiceEnum.COMMAND);
+    }
+    /**
+     * Gets the robot control service.
+     */
+    getControlService() {
+        return this.getService(ServiceEnum.CONTROL);
+    }
+    /**
+     * Gets the search service.
+     */
+    getSearchService() {
+        return this.getService(ServiceEnum.SEARCH);
+    }
+    /**
+     * Gets the file accessor service
+     * @returns FileAccessorServiceNode
+     */
+    getFileAccessorService() {
+        return this.getService(ServiceEnum.FILE_ACCESSOR);
+    }
+    /**
+     * Gets the evaluator service
+     * @deprecated Not supported in Node.js
+     */
+    getEvaluatorService() {
+        throw new Error('Evaluator service is not supported in NodeJS');
+    }
+    /**
+     * Gets the WebRTC service
+     * @deprecated Not supported in Node.js
+     */
+    getRTPWebRTCService() {
+        throw new Error('WebRTC service is not supported in NodeJS');
+    }
+}

package/esm/node/index.js

@@ -0,0 +1,7 @@
+export * from './RocosSDKNode';
+export * from '../services/CallerServiceNode';
+export * from '../services/CommandServiceNode';
+export * from '../services/ControlServiceNode';
+export * from '../services/FileAccessorServiceNode';
+export * from '../services/SearchServiceNode';
+export * from '../services/TelemetryServiceNode';

package/esm/services/AssetStorageService.d.ts

@@ -0,0 +1,137 @@
+import { AssetItemModel, AssetItemWithObservationsModel, AssetSyncDefinitionsModel, AssetSyncIntegrationModel, AssetSyncIntegrationProviderModel, CreateAssetSyncIntegrationModel, IBaseService, IRocosSDKConfig, RocosError } from '../models';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+export declare class AssetStorageService extends BaseServiceAbstract implements IBaseService {
+    constructor(config: IRocosSDKConfig);
+    protected getError(e: Error): RocosError;
+    getStatus(): boolean;
+    /**
+     * Create a new project asset
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     * @param file - File payload
+     */
+    create(projectId: string, filePath: string, file: File): Promise<AssetItemModel>;
+    /**
+     * Update a project asset
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     * @param file - File payload
+     */
+    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<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<Blob>;
+    /**
+     * List assets for a robot
+     *
+     * @param projectId
+     * @param callsign
+     * @param parent
+     * @param signedURL
+     */
+    listRobotAssets(projectId: string, callsign: string, parent?: string, signedURL?: boolean): Promise<AssetItemModel[]>;
+    /**
+     * List assets for a flow
+     *
+     * @param projectId
+     * @param flowId
+     * @param flowInstance
+     * @param parent
+     * @param signedURL
+     */
+    listFlowAssets(projectId: string, flowId: string, flowInstance: string, parent?: string, signedURL?: boolean): Promise<AssetItemModel[]>;
+    /**
+     * List assets for a mission
+     *
+     * @param projectId
+     * @param assetIdList
+     */
+    listMissionAssets(projectId: string, assetIdList: string[]): Promise<AssetItemModel[]>;
+    /**
+     * Get a single asset for a mission
+     *
+     * @param projectId
+     * @param assetId
+     */
+    getMissionAsset(projectId: string, assetId: string): Promise<AssetItemModel>;
+    /**
+     * Lists mapped assets
+     *
+     * @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[]>;
+    /**
+     * Set Robot Sync Definitions
+     * @param projectId
+     * @param callsign
+     * @param definition
+     * @param syncNow - Sync configured paths immediately
+     */
+    setRobotSyncDefinitions(projectId: string, callsign: string, definition: AssetSyncDefinitionsModel, syncNow?: boolean): Promise<AssetSyncDefinitionsModel>;
+    /**
+     * Get Robot Sync Definitions
+     * @param projectId
+     * @param callsign
+     */
+    getRobotSyncDefinitions(projectId: string, callsign: string): Promise<AssetSyncDefinitionsModel>;
+    /**
+     * Set Profile Sync Definitions
+     * @param projectId
+     * @param profileId
+     * @param definition
+     */
+    setProfileSyncDefinitions(projectId: string, profileId: string, definition: AssetSyncDefinitionsModel): Promise<AssetSyncDefinitionsModel>;
+    /**
+     * Get Profile Sync Definitions
+     * @param projectId
+     * @param profileId
+     */
+    getProfileSyncDefinition(projectId: string, profileId: string): Promise<AssetSyncDefinitionsModel>;
+    /**
+     * Get Sync Integration Providers
+     * @param projectId
+     */
+    getSyncIntegrationProviders(projectId: string): Promise<AssetSyncIntegrationProviderModel[]>;
+    /**
+     * Get Sync Integrations by Project
+     * @param projectId
+     */
+    getSyncIntegrations(projectId: string): Promise<AssetSyncIntegrationModel[]>;
+    /**
+     * Create a new Sync Integration
+     * @param projectId
+     * @param integration
+     */
+    createSyncIntegration(projectId: string, integration: CreateAssetSyncIntegrationModel): Promise<AssetSyncIntegrationModel>;
+    /**
+     * Update a Sync Integration
+     * @param projectId
+     * @param integrationId
+     * @param integration
+     */
+    updateSyncIntegration(projectId: string, integrationId: string, integration: CreateAssetSyncIntegrationModel): Promise<AssetSyncIntegrationModel>;
+    /**
+     * Delete a Sync Integration
+     * @param projectId
+     * @param integrationId
+     */
+    deleteSyncIntegration(projectId: string, integrationId: string): Promise<void>;
+}

package/esm/services/AssetStorageService.js

@@ -0,0 +1,223 @@
+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';
+import { BaseServiceAbstract } from './BaseServiceAbstract';
+import { RocosLogger } from '../logger/RocosLogger';
+import { formatServiceUrl } from '../helpers/formatServiceUrl';
+export class AssetStorageService extends BaseServiceAbstract {
+    constructor(config) {
+        super(config);
+        this.logger = RocosLogger.getInstance(`AssetStorageService(${this.config.url})`);
+    }
+    getError(e) {
+        return new RocosError(e, errorCodes.ASSET_STORAGE_SERVICE_ERROR);
+    }
+    getStatus() {
+        return true;
+    }
+    /**
+     * Create a new project asset
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     * @param file - File payload
+     */
+    async create(projectId, filePath, file) {
+        const formData = new FormData();
+        formData.append('file', file);
+        return this.callPut(formatServiceUrl(API_PROJECT_ASSET_PATH_URL, { url: this.config.url, projectId, filePath }, this.config.insecure), formData, `Failed to create asset for ${projectId}, filePath ${filePath}.`);
+    }
+    /**
+     * Update a project asset
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     * @param file - File payload
+     */
+    async update(projectId, filePath, file) {
+        const formData = new FormData();
+        formData.append('file', file);
+        return this.callPost(formatServiceUrl(API_PROJECT_ASSET_PATH_URL, { url: this.config.url, projectId, filePath }, this.config.insecure), formData, `Failed to update asset for ${projectId}, filePath ${filePath}.`);
+    }
+    /**
+     * Delete a project asset
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     */
+    // TODO: map the response object
+    async delete(projectId, filePath) {
+        return this.callDelete(formatServiceUrl(API_PROJECT_ASSET_PATH_URL, { url: this.config.url, projectId, filePath }, this.config.insecure), `Failed to delete asset for ${projectId}, filePath ${filePath}.`);
+    }
+    /**
+     * Lost assets for a project or project file path
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     */
+    async list(projectId, filePath) {
+        let url = '';
+        if (filePath) {
+            url = formatServiceUrl(API_PROJECT_ASSET_PATH_URL, { url: this.config.url, projectId, filePath }, this.config.insecure);
+        }
+        else {
+            url = formatServiceUrl(API_PROJECT_ASSET_URL, { url: this.config.url, projectId }, this.config.insecure);
+        }
+        return this.callGet(url, `Failed to get asset list for ${projectId}, filePath ${filePath}.`);
+    }
+    /**
+     * Get a project asset
+     *
+     * @param projectId - Project Id
+     * @param filePath - Path to asset file
+     */
+    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',
+        });
+    }
+    /**
+     * List assets for a robot
+     *
+     * @param projectId
+     * @param callsign
+     * @param parent
+     * @param signedURL
+     */
+    async listRobotAssets(projectId, callsign, parent = '/', signedURL = false) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ROBOT_ASSET_PATH_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), `Failed to get asset for ${projectId}, callsign ${callsign}.`, { parent, signedURL });
+    }
+    /**
+     * List assets for a flow
+     *
+     * @param projectId
+     * @param flowId
+     * @param flowInstance
+     * @param parent
+     * @param signedURL
+     */
+    async listFlowAssets(projectId, flowId, flowInstance, parent = '/', signedURL = false) {
+        return this.callGet(formatServiceUrl(API_PROJECT_FLOW_ASSET_PATH_URL, { url: this.config.url, projectId, flowId, flowInstance }, this.config.insecure), `Failed to get asset for ${projectId}, flow ${flowId}, flow instance ${flowInstance}.`, { parent, signedURL });
+    }
+    /**
+     * List assets for a mission
+     *
+     * @param projectId
+     * @param assetIdList
+     */
+    async listMissionAssets(projectId, assetIdList) {
+        const searchParams = new URLSearchParams();
+        assetIdList.forEach((assetId) => searchParams.append('assetID', assetId));
+        return this.callGet(formatServiceUrl(API_PROJECT_MISSION_ASSETS_PATH_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to get asset for ${projectId}, assetIdList ${assetIdList}.`, searchParams);
+    }
+    /**
+     * Get a single asset for a mission
+     *
+     * @param projectId
+     * @param assetId
+     */
+    async getMissionAsset(projectId, assetId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_MISSION_ASSET_PATH_URL, { url: this.config.url, projectId, assetId }, this.config.insecure), `Failed to get asset for ${projectId}, dataUUID ${assetId}.`, undefined);
+    }
+    /**
+     * Lists mapped assets
+     *
+     * @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, 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',
+        });
+    }
+    /**
+     * Set Robot Sync Definitions
+     * @param projectId
+     * @param callsign
+     * @param definition
+     * @param syncNow - Sync configured paths immediately
+     */
+    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(url, definition, `Failed to update asset for ${projectId}, callsign ${callsign}.`, httpOptions, {
+            syncNow,
+        });
+    }
+    /**
+     * Get Robot Sync Definitions
+     * @param projectId
+     * @param callsign
+     */
+    getRobotSyncDefinitions(projectId, callsign) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL, { url: this.config.url, projectId, callsign }, this.config.insecure), `Failed to get asset for ${projectId}, callsign ${callsign}.`, undefined);
+    }
+    /**
+     * Set Profile Sync Definitions
+     * @param projectId
+     * @param profileId
+     * @param definition
+     */
+    setProfileSyncDefinitions(projectId, profileId, definition) {
+        const httpOptions = {
+            headers: {
+                'content-type': 'application/json',
+            },
+        };
+        return this.callPost(formatServiceUrl(API_PROJECT_ASSET_PROFILES_SYNC_DEFINITION_PATH_URL, { url: this.config.url, projectId, profileId }, this.config.insecure), definition, `Failed to update sync-definition for ${projectId}, callsign ${profileId}.`, httpOptions);
+    }
+    /**
+     * Get Profile Sync Definitions
+     * @param projectId
+     * @param profileId
+     */
+    getProfileSyncDefinition(projectId, profileId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ASSET_PROFILES_SYNC_DEFINITION_PATH_URL, { url: this.config.url, projectId, profileId }, this.config.insecure), `Failed to get sync-definition for ${projectId}, callsign ${profileId}.`, undefined);
+    }
+    /**
+     * Get Sync Integration Providers
+     * @param projectId
+     */
+    getSyncIntegrationProviders(projectId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to get asset sync integration providers for ${projectId}.`);
+    }
+    /**
+     * Get Sync Integrations by Project
+     * @param projectId
+     */
+    getSyncIntegrations(projectId) {
+        return this.callGet(formatServiceUrl(API_PROJECT_ASSET_INTEGRATIONS_PATH_URL, { url: this.config.url, projectId }, this.config.insecure), `Failed to get asset sync integrations for ${projectId}.`);
+    }
+    /**
+     * Create a new Sync Integration
+     * @param projectId
+     * @param integration
+     */
+    createSyncIntegration(projectId, integration) {
+        return this.callPost(formatServiceUrl(API_PROJECT_ASSET_INTEGRATIONS_PATH_URL, { url: this.config.url, projectId }, this.config.insecure), integration, `Failed to create asset sync integration for ${projectId}.`);
+    }
+    /**
+     * Update a Sync Integration
+     * @param projectId
+     * @param integrationId
+     * @param integration
+     */
+    updateSyncIntegration(projectId, integrationId, integration) {
+        return this.callPut(formatServiceUrl(API_PROJECT_ASSET_INTEGRATION_PATH_URL, { url: this.config.url, projectId, integrationId }, this.config.insecure), integration, `Failed to update asset sync integrations for ${projectId}.`);
+    }
+    /**
+     * Delete a Sync Integration
+     * @param projectId
+     * @param integrationId
+     */
+    deleteSyncIntegration(projectId, integrationId) {
+        return this.callDelete(formatServiceUrl(API_PROJECT_ASSET_INTEGRATION_PATH_URL, { url: this.config.url, projectId, integrationId }, this.config.insecure), `Failed to delete asset sync integrations for ${projectId}.`);
+    }
+}

package/esm/services/AuthService.d.ts

@@ -0,0 +1,93 @@
+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?;
+    constructor(config: IRocosSDKConfig);
+    getStatus(): boolean;
+    teardown(): void;
+    protected getError(e: RocosError): RocosError;
+    /**
+     * Set the Auth token
+     * @param value - Token value
+     */
+    setToken(value: string | Token): void;
+    /**
+     * @deprecated `expiresIn` is now derived from the token. Use `setToken(value: string | Token)` instead
+     */
+    setToken(value: string | Token, expiresIn: number): void;
+    /**
+     * Clear token
+     */
+    clearToken(): void;
+    /**
+     * Get the authentication token for application Id and application Key.
+     */
+    getAppToken(): Promise<Token>;
+    /**
+     * Get new auth token for a user
+     * @desc This only works for user auth tokens, not appId auth tokens
+     */
+    getNewUserToken(): Promise<Token>;
+    /**
+     * Get new auth token for a user.
+     *
+     * Uses the OTP flow to exchange an external token for a user token.
+     *
+     * @desc This only works for user auth tokens, not appId auth tokens
+     */
+    private getNewUserTokenFromExternalToken;
+    /**
+     * Get the authentication token
+     *
+     * This will return the current token if it is not expired, otherwise it will get a new token based on your config.
+     */
+    getToken(): Promise<Token>;
+    /**
+     * Refresh the authentication token
+     *
+     * This only works for user auth tokens, not appId auth tokens.
+     *
+     * The new token is not automatically set as the current token. Use `setToken` to set the new token.
+     *
+     * @see setToken
+     * @param token the token to refresh. If not provided, the current token will be used.
+     */
+    refreshToken(token?: Token): Promise<Token>;
+    /** Refresh the token if it is expired or will expire in the next `minutes` minutes
+     *
+     * This only works for user auth tokens, not appId auth tokens.
+     *
+     * 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
+     * @see refreshToken
+     */
+    refreshTokenIfExpired(minutes: number): Promise<void>;
+    /** 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.
+     * It is not required when using REST services as the token is refreshed automatically.
+     *
+     * The loop will stop when `stopTokenRefreshChecker` is called.
+     *
+     * @see stopTokenRefreshChecker
+     */
+    startTokenRefreshChecker(): void;
+    /**
+     * Stop the token refresh checker
+     * @see startTokenRefreshChecker
+     */
+    stopTokenRefreshChecker(): void;
+    /** Check if the token refresh checker is running
+     *
+     * @see startTokenRefreshChecker
+     * @see stopTokenRefreshChecker
+     * @returns true if the token refresh checker is running
+     */
+    isTokenRefreshCheckerRunning(): boolean;
+    /** Checks if the token is valid for use with the API */
+    isTokenValid(token: Token): boolean;
+    private isTokenIssuedByApp;
+}