@dronedeploy/rocos-js-sdk 4.4.4 → 4.4.6

package/LICENSE

@@ -0,0 +1,3 @@
+Copyright (c) 2026 DroneDeploy, Inc. All rights reserved.
+
+This software is the confidential, proprietary property of DroneDeploy, Inc. and is licensed, not sold. No use, copying, modification, or distribution is permitted without DroneDeploy's prior written consent. Provided "AS IS" without warranty of any kind.

package/cjs/api/StreamRegister.d.ts

@@ -1,13 +1,28 @@
 import { IBaseStream } from '../models';
+export interface IAcquiredStream<T extends IBaseStream> {
+    stream: T;
+    isNew: boolean;
+    /** Settles when the stream's one-time init completes; rejects (and evicts) if init fails. */
+    ready: Promise<void>;
+    /** Releases this holder's refcount. One-shot: extra calls are ignored. */
+    release: () => void;
+}
+/**
+ * Sole owner of stream lifecycle. Streams are shared per identifier and refcounted: acquireStream
+ * gets-or-creates and increments in one synchronous step, and the returned handle's release()
+ * tears the stream down when the last holder leaves. Teardown never happens outside
+ * release/removeAllStreams, so a held stream can not be stopped or replaced underneath its holders.
+ */
 export declare class StreamRegister {
-    private teleStreams;
+    private entries;
     private logger;
     private static instance;
     private constructor();
     static getInstance(): StreamRegister;
     static getIdentifier($identifier: string, scope?: string): string;
-    addStream(stream: IBaseStream): void;
+    acquireStream<T extends IBaseStream>(identifier: string, create: () => T, init: (stream: T) => Promise<void>): IAcquiredStream<T>;
     getStream(identifier: string): IBaseStream | undefined;
-    removeStream(stream: IBaseStream): void;
     removeAllStreams(): boolean;
+    private release;
+    private evict;
 }

package/cjs/api/StreamRegister.js

@@ -3,9 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StreamRegister = void 0;
 const models_1 = require("../models");
 const RocosLogger_1 = require("../logger/RocosLogger");
+/**
+ * Sole owner of stream lifecycle. Streams are shared per identifier and refcounted: acquireStream
+ * gets-or-creates and increments in one synchronous step, and the returned handle's release()
+ * tears the stream down when the last holder leaves. Teardown never happens outside
+ * release/removeAllStreams, so a held stream can not be stopped or replaced underneath its holders.
+ */
 class StreamRegister {
     constructor() {
-        this.teleStreams = new Map();
+        this.entries = new Map();
         this.logger = RocosLogger_1.RocosLogger.getInstance('StreamRegister');
     }
     static getInstance() {
@@ -17,55 +23,83 @@ class StreamRegister {
     static getIdentifier($identifier, scope) {
         return `${$identifier}-${scope ?? ''}`;
     }
-    addStream(stream) {
-        try {
-            // Stop any existing occupant of this key before overwriting it.
-            const existing = this.teleStreams.get(stream.identifier);
-            if (existing && existing !== stream) {
-                existing.stopStream();
-            }
-            this.teleStreams.set(stream.identifier, stream);
+    acquireStream(identifier, create, init) {
+        let entry = this.entries.get(identifier);
+        let isNew = false;
+        if (entry) {
+            entry.refCount++;
         }
-        catch (e) {
-            this.logger.error(`Failed to add stream to list. identifier: ${stream.identifier}`, e);
-            if (e instanceof Error || typeof e === 'string') {
-                throw new models_1.RocosError(e, models_1.errorCodes.STREAM_LISTENER_ERROR);
-            }
-            else {
-                throw e;
-            }
+        else {
+            isNew = true;
+            const stream = create();
+            const ready = init(stream).catch((error) => {
+                this.logger.error(`Stream init failed, evicting. identifier: ${identifier}`, error);
+                try {
+                    this.evict(identifier, stream);
+                }
+                catch (evictionError) {
+                    this.logger.error(`Failed to evict after init failure. identifier: ${identifier}`, evictionError);
+                }
+                throw error;
+            });
+            // `ready` is stored and shared; this discarded catch pins a rejection observer so an init
+            // failure can never surface as an unhandled rejection, while holders still see the rejection.
+            void ready.catch(() => undefined);
+            entry = { stream, refCount: 1, ready };
+            this.entries.set(identifier, entry);
         }
+        const held = entry;
+        let released = false;
+        const release = () => {
+            // One-shot so a double release can never consume another holder's refcount.
+            if (released)
+                return;
+            released = true;
+            this.release(identifier, held);
+        };
+        return { stream: entry.stream, isNew, ready: entry.ready, release };
     }
     getStream(identifier) {
-        return this.teleStreams.get(identifier);
+        return this.entries.get(identifier)?.stream;
     }
-    removeStream(stream) {
-        try {
-            stream.stopStream();
-            // Only clear the entry if this instance still owns the key: a replacement may already hold it,
-            // and evicting that would leave subscribers forking duplicate streams for the scope.
-            if (this.teleStreams.get(stream.identifier) === stream) {
-                this.teleStreams.delete(stream.identifier);
-            }
-        }
-        catch (e) {
-            this.logger.error(`Failed to remove stream from list. identifier: ${stream.identifier}`, e);
-            if (e instanceof Error || typeof e === 'string') {
-                throw new models_1.RocosError(e, models_1.errorCodes.STREAM_LISTENER_ERROR);
+    removeAllStreams() {
+        for (const [, entry] of this.entries.entries()) {
+            try {
+                entry.stream.stopStream();
             }
-            else {
-                throw e;
+            catch (e) {
+                this.logger.error(`error removing stream, ${e}`);
             }
         }
+        this.entries.clear();
+        return true;
     }
-    removeAllStreams() {
+    release(identifier, entry) {
+        if (this.entries.get(identifier) !== entry)
+            return; // already evicted, or force-removed
+        entry.refCount--;
+        if (entry.refCount > 0)
+            return;
+        // Wait for init to settle before tearing down, so init can never open resources on an already
+        // stopped stream. A re-acquire in the meantime revives the entry and cancels the teardown.
+        void entry.ready
+            .catch(() => undefined)
+            .then(() => {
+            if (this.entries.get(identifier) === entry && entry.refCount <= 0) {
+                this.evict(identifier, entry.stream);
+            }
+        })
+            .catch((e) => this.logger.error(`Failed to evict stream. identifier: ${identifier}`, e));
+    }
+    evict(identifier, stream) {
         try {
-            for (const [, stream] of this.teleStreams.entries()) {
-                this.removeStream(stream);
+            if (this.entries.get(identifier)?.stream === stream) {
+                this.entries.delete(identifier);
             }
+            stream.stopStream();
         }
         catch (e) {
-            this.logger.error(`error removing stream, ${e}`);
+            this.logger.error(`Failed to remove stream from list. identifier: ${identifier}`, e);
             if (e instanceof Error || typeof e === 'string') {
                 throw new models_1.RocosError(e, models_1.errorCodes.STREAM_LISTENER_ERROR);
             }
@@ -73,7 +107,6 @@ class StreamRegister {
                 throw e;
             }
         }
-        return true;
     }
 }
 exports.StreamRegister = StreamRegister;

package/cjs/api/atoms/StreamHeartbeat.js

@@ -38,7 +38,7 @@ class StreamHeartbeat {
             this.callback = callback;
             this.timeout = timeout;
             this.logger.info('Creating stream heartbeat');
-            this.interval = setInterval(this.callback, this.timeout);
+            this.interval = setInterval(() => this.callback?.(), this.timeout);
         }
         else {
             this.logger.warn('Stream heartbeat already exists');
@@ -58,7 +58,7 @@ class StreamHeartbeat {
         // if the health check has not started yet, we initialise it
         if (!this.healthInterval) {
             this.logger.debug('Starting health check timer');
-            this.healthInterval = setInterval(this.checkHealth, this.healthTimeout);
+            this.healthInterval = setInterval(() => void this.checkHealth(), this.healthTimeout);
             this.healthLastSeenDate = new Date();
             this.healthMisses = 0;
         }

package/cjs/api/streams/telemetry/TelemetryStreamAbstract.d.ts

@@ -14,6 +14,7 @@ export declare abstract class TelemetryStreamAbstract implements ITelemetryStrea
     protected token?: string;
     private scope;
     protected url: string;
+    private telemetryActionQueue;
     private timerIntervalInSec;
     protected subscriberStatus: SubscriberStatusEnum;
     private checkerStartedAt?;
@@ -40,10 +41,17 @@ export declare abstract class TelemetryStreamAbstract implements ITelemetryStrea
     stopStream(): void;
     addSubscription(params: ITelemetryParams): void;
     removeSubscription(params: ITelemetryParams, terminateReceiverGroup?: boolean): Promise<void>;
+    private isQueryLookup;
+    private getSubscribedSources;
     sendAcknowledgment(uid: string, status: TelemetryAckStatus, noRetry: boolean): boolean;
     private getSubscriptions;
     protected onData(message: TelemetryStreamMessage, isStream: true): void;
     protected onData(message: TelemetryMessage, isStream: false): void;
+    /**
+     * Gateway subscription state is a set mutated by deltas, so ordering is correctness: a concurrent
+     * unsubscribe landing last strands a subscribe and nothing re-adds it.
+     */
+    private enqueueTelemetryAction;
     private takeTelemetryAction;
     protected listenMessagesAndRenew(): void;
     private addTerminateToAction;
@@ -52,7 +60,6 @@ export declare abstract class TelemetryStreamAbstract implements ITelemetryStrea
      * Auto resubscribe to reduce CPU usage.
      */
     private autoResubscribe;
-    private isFoundCallsign;
     private isFoundSource;
     private isRegisteredMessage;
     private updateReceivedDataStatsWithMessage;

package/cjs/api/streams/telemetry/TelemetryStreamAbstract.js

@@ -9,11 +9,13 @@ const identifier_1 = require("../../../constants/identifier");
 const RocosStore_1 = require("../../../store/RocosStore");
 const StreamHeartbeat_1 = require("../../atoms/StreamHeartbeat");
 const StreamRegister_1 = require("../../StreamRegister");
+const arrayRemove_1 = require("../../../helpers/arrayRemove");
 const arrayUnique_1 = require("../../../helpers/arrayUnique");
 const operators_1 = require("rxjs/operators");
 const getSubscriptionsDifference_1 = require("../../../helpers/getSubscriptionsDifference");
 class TelemetryStreamAbstract {
     constructor(config) {
+        this.telemetryActionQueue = Promise.resolve();
         // /////////////////
         // Subscriber Check
         this.timerIntervalInSec = 1;
@@ -60,27 +62,44 @@ class TelemetryStreamAbstract {
         }
         this.subscriberStatus = models_1.SubscriberStatusEnum.STOPPED;
         this.statusStream$.next(this.subscriberStatus);
+        // The stream is being torn down (the registry only stops a stream when it is evicted), so
+        // complete the status stream: this releases every service-level forwarder subscribed to it
+        // rather than leaving them attached to a dead instance.
+        this.statusStream$.complete();
     }
     addSubscription(params) {
         this.logger.info('Adding subscriptions from stream', params.uniqueId);
         if (!this.subscriptions.has(params.uniqueId)) {
+            const isQuery = this.isQueryLookup();
             // get subscriptions before change
-            const before = this.getSubscriptions();
+            const before = isQuery ? {} : this.getSubscriptions();
             this.subscriptions.set(params.uniqueId, {
                 ...params,
                 count: 1, // set the count to one just in case it's set in param
             });
             // get subscriptions after change
-            const after = this.getSubscriptions();
-            // assign the current values from state after change
-            this.callsignsLookup = new models_1.CallsignsLookup(Object.keys(after));
-            this.sources = (0, arrayUnique_1.arrayUnique)(Object.values(after).reduce((a, v) => a.concat(v), []));
-            // compare before and after subscriptions and only add the difference
-            const { toAdd } = (0, getSubscriptionsDifference_1.getSubscriptionsDifference)(before, after);
-            // only subscribe if the subscriberId exists, otherwise the messages will be subscribed on lazy load
-            if (toAdd.callsigns.length && toAdd.sources.length) {
-                this.logger.debug('New subscriptions added, we need to refresh sources', { toAdd });
-                void this.takeTelemetryAction('subscribe', new models_1.CallsignsLookup(toAdd.callsigns), toAdd.sources);
+            const after = isQuery ? {} : this.getSubscriptions();
+            if (isQuery) {
+                // A query stream selects its callsigns server-side, so the callsign-keyed view above holds
+                // nothing for it: keep the query and diff on sources alone.
+                const sourcesBefore = this.sources;
+                this.sources = this.getSubscribedSources();
+                const toAdd = (0, arrayRemove_1.arrayRemove)(this.sources, sourcesBefore);
+                if (toAdd.length) {
+                    this.logger.debug('New query subscriptions added, we need to refresh sources', { toAdd });
+                    void this.enqueueTelemetryAction('subscribe', this.callsignsLookup, toAdd);
+                }
+            }
+            else {
+                // assign the current values from state after change
+                this.callsignsLookup = new models_1.CallsignsLookup(Object.keys(after));
+                this.sources = (0, arrayUnique_1.arrayUnique)(Object.values(after).reduce((a, v) => a.concat(v), []));
+                // compare before and after subscriptions and only add the difference
+                const { toAdd } = (0, getSubscriptionsDifference_1.getSubscriptionsDifference)(before, after);
+                if (toAdd.callsigns.length && toAdd.sources.length) {
+                    this.logger.debug('New subscriptions added, we need to refresh sources', { toAdd });
+                    void this.enqueueTelemetryAction('subscribe', new models_1.CallsignsLookup(toAdd.callsigns), toAdd.sources);
+                }
             }
         }
         else {
@@ -100,16 +119,24 @@ class TelemetryStreamAbstract {
         if (subs.count)
             return;
         this.logger.info('Removing subscriptions from stream registry', params.uniqueId);
-        const before = this.getSubscriptions();
+        const isQuery = this.isQueryLookup();
+        const before = isQuery ? {} : this.getSubscriptions();
         this.subscriptions.delete(params.uniqueId);
-        const after = this.getSubscriptions();
-        // Do this before we send the telemetry request so that new subscriptions don't get this stream from the register while it is closing
-        if (!this.subscriptions.size) {
-            this.logger.info('No subscriptions remaining closing stream', params.uniqueId);
-            this.stopStream();
-            // self remove when no subscriptions are left
-            StreamRegister_1.StreamRegister.getInstance().removeStream(this);
-            this.logger.info('Stream closed');
+        const after = isQuery ? {} : this.getSubscriptions();
+        if (isQuery) {
+            const sourcesBefore = this.sources;
+            this.sources = this.getSubscribedSources();
+            const toRemove = (0, arrayRemove_1.arrayRemove)(sourcesBefore, this.sources);
+            if (toRemove.length) {
+                this.logger.debug('Query subscriptions removed, we need to refresh sources', { toRemove });
+                try {
+                    await this.enqueueTelemetryAction('unsubscribe', this.callsignsLookup, toRemove, terminateReceiverGroup);
+                }
+                catch (err) {
+                    this.logger.error(`Failed to unsubscribe: ${err}`);
+                }
+            }
+            return;
         }
         // assign the current values from state after change
         this.callsignsLookup = new models_1.CallsignsLookup(Object.keys(after));
@@ -118,13 +145,23 @@ class TelemetryStreamAbstract {
         if (toRemove.callsigns.length && toRemove.sources.length) {
             this.logger.debug('Subscriptions removed, we need to refresh sources', { toRemove });
             try {
-                await this.takeTelemetryAction('unsubscribe', new models_1.CallsignsLookup(toRemove.callsigns), toRemove.sources, terminateReceiverGroup);
+                await this.enqueueTelemetryAction('unsubscribe', new models_1.CallsignsLookup(toRemove.callsigns), toRemove.sources, terminateReceiverGroup);
             }
             catch (err) {
                 this.logger.error(`Failed to unsubscribe: ${err}`);
             }
         }
     }
+    isQueryLookup() {
+        return this.callsignsLookup?.isQuery() ?? false;
+    }
+    getSubscribedSources() {
+        const sources = [];
+        this.subscriptions.forEach((data) => {
+            sources.push(...data.sources);
+        });
+        return (0, arrayUnique_1.arrayUnique)(sources);
+    }
     sendAcknowledgment(uid, status, noRetry) {
         return this.sendAcknowledgmentInternal(uid, status, noRetry);
     }
@@ -174,8 +211,8 @@ class TelemetryStreamAbstract {
                 this.subscriberId = subscriberId;
                 rocosMessage.subscriberId = this.subscriberId;
                 this.logger.info('onData', `subscriberId has been updated - ${subscriberId}`, { subscriberId });
-                void this.takeTelemetryAction('subscribe');
-                this.heartbeat.start(this.sendHeartbeat, this.sendHeartbeatTime);
+                void this.enqueueTelemetryAction('subscribe');
+                this.heartbeat.start(() => this.sendHeartbeat(), this.sendHeartbeatTime);
                 isRobotMessage = false;
                 break;
             }
@@ -211,25 +248,40 @@ class TelemetryStreamAbstract {
             });
         }
     }
+    /**
+     * Gateway subscription state is a set mutated by deltas, so ordering is correctness: a concurrent
+     * unsubscribe landing last strands a subscribe and nothing re-adds it.
+     */
+    enqueueTelemetryAction(actionType, callsignsLookup, sources, terminate) {
+        const takeAction = () => this.takeTelemetryAction(actionType, callsignsLookup, sources, terminate);
+        const run = this.telemetryActionQueue.then(takeAction);
+        // The tail only signals whose turn it is, so it must never reject, otherwise one failed op
+        // would wedge every op queued behind it. Callers still see the failure through `run`.
+        this.telemetryActionQueue = run.then(() => undefined, () => undefined);
+        return run;
+    }
     async takeTelemetryAction(actionType, callsignsLookup, sources, terminate) {
         this.logger.debug('takeTelemetryAction', actionType);
-        if (!this.subscriberId || !this.projectId) {
-            this.logger.debug('takeTelemetryAction', actionType, `${actionType} without subscriberId or projectId - message will not send out`, {
-                subscriberId: this.subscriberId,
-                projectId: this.projectId,
-            });
+        // A config fault, not a race: this stream can never address a request.
+        if (!this.projectId) {
+            this.logger.warn('takeTelemetryAction', actionType, `${actionType} without a projectId - dropped`);
+            return Promise.resolve();
+        }
+        if (!this.subscriberId) {
+            // Deferred, not lost: `onData` re-asserts `this.sources` when the subscriberId arrives.
+            this.logger.debug('takeTelemetryAction', actionType, `${actionType} before the receiver was registered - deferred to the post-registration re-assert`);
             return Promise.resolve();
         }
         const actionSources = sources ?? this.sources;
         const actionCallsigns = callsignsLookup ?? this.callsignsLookup;
-        if (this.callsignsLookup.lookupType === models_1.CallsignsLookupType.List) {
+        if (!actionCallsigns.isQuery()) {
             // Compose the request message
             const req = teletubby_pb_1.TelemetryRequest.create({
                 subscriberId: this.subscriberId,
                 requestedActions: [
                     {
                         operation: actionType,
-                        callsigns: actionCallsigns.lookupValue,
+                        callsigns: actionCallsigns.getCallsigns(),
                         sources: actionSources,
                     },
                 ],
@@ -241,12 +293,12 @@ class TelemetryStreamAbstract {
             // Send the message to back-end.
             return this.requestTelemetry(req);
         }
-        else if (actionCallsigns.lookupType === models_1.CallsignsLookupType.Query) {
-            const lookupValue = actionCallsigns.lookupValue;
+        const query = actionCallsigns.getQuery();
+        if (query) {
             // We don't support nested query at the moment
             const queryOrPredicatesList = [];
             // Loop through user provided predicates to construct a telemetry query request
-            lookupValue.predicates.forEach((callsignsPredicate) => {
+            query.predicates.forEach((callsignsPredicate) => {
                 const queryOrPredicate = teletubby_pb_1.QueryOrPredicate.create({
                     content: {
                         oneofKind: 'predicate',
@@ -265,7 +317,7 @@ class TelemetryStreamAbstract {
                 sources: actionSources,
                 operation: actionType,
                 callsignQuery: {
-                    operation: lookupValue.operation.valueOf(),
+                    operation: query.operation.valueOf(),
                     queryOrPredicates: queryOrPredicatesList,
                 },
             });
@@ -382,16 +434,11 @@ class TelemetryStreamAbstract {
         this.lastRobotMessageReceived = undefined;
         this.registerReceiver();
     }
-    isFoundCallsign(callsign) {
-        return this.callsignsLookup.lookupType === models_1.CallsignsLookupType.List
-            ? this.callsignsLookup.lookupValue.indexOf(callsign) !== -1
-            : true; // If callsigns lookup option is query, we always return true
-    }
     isFoundSource(source) {
         return this.sources.indexOf(source) !== -1;
     }
     isRegisteredMessage(callsign, source) {
-        return this.isFoundCallsign(callsign) && this.isFoundSource(source);
+        return this.callsignsLookup.includesCallsign(callsign) && this.isFoundSource(source);
     }
     updateReceivedDataStatsWithMessage(msg) {
         const { source } = msg;

package/cjs/api/streams/webRTCSignalling/WebRTCSignallingStreamAbstract.js

@@ -12,7 +12,7 @@ class WebRTCSignallingStreamAbstract {
     constructor(config) {
         this.subscriberStatus = models_1.SubscriberStatusEnum.STOPPED;
         this.scope = config.scope;
-        this.identifier = StreamRegister_1.StreamRegister.getIdentifier(identifier_1.IDENTIFIER_NAME_COMMAND, this.scope);
+        this.identifier = StreamRegister_1.StreamRegister.getIdentifier(identifier_1.IDENTIFIER_NAME_WEBRTC_SIGNALLING, this.scope);
         this.token = config.token;
         this.url = config.url;
         this.statusStream$ = new rxjs_1.BehaviorSubject(models_1.SubscriberStatusEnum.STOPPED);

package/cjs/constants/api.d.ts

@@ -36,7 +36,7 @@ export declare const API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL = "https:/
 export declare const API_PROJECT_ASSET_INTEGRATIONS_PATH_URL = "https://{url}/projects/{projectId}/integrations";
 export declare const API_PROJECT_ASSET_INTEGRATION_PATH_URL = "https://{url}/projects/{projectId}/integrations/{integrationId}";
 export declare const API_PROJECT_ROBOT_ASSET_PATH_URL = "https://{url}/projects/{projectId}/robots/{callsign}/assets";
-export declare const API_PROJECT_FLOW_ASSET_PATH_URL = "https://{url}/projects/{projectId}/flows/{callsign}/assets";
+export declare const API_PROJECT_FLOW_ASSET_PATH_URL = "https://{url}/projects/{projectId}/flows/{flowId}/instances/{flowInstance}/assets";
 export declare const API_PROJECT_MISSION_ASSETS_PATH_URL = "https://{url}/projects/{projectId}/missionassets";
 export declare const API_PROJECT_MISSION_ASSET_PATH_URL = "https://{url}/projects/{projectId}/missionassets/{assetId}";
 export declare const API_PROJECT_MAPPED_ASSETS_PATH_URL = "https://{url}/projects/{projectId}/mappedassets";
@@ -126,7 +126,7 @@ export declare const API_DD_INTEGRATION_LEVELS_URL = "https://{url}/projects/{pr
 export declare const API_GRAPHS_MAPS_URL = "https://{url}/graphs/projects/{projectId}/maps";
 export declare const API_GRAPHS_MAPS_NEW_URL = "https://{url}/graphs/projects/{projectId}/maps/new";
 export declare const API_GRAPHS_MAPS_DEPLOYED_URL = "https://{url}/graphs/projects/{projectId}/maps/deployed?callsign={callsign}";
-export declare const API_GRAPHS_MAPS_MERGE_URL = "https://{url}/graphs/projects/{projectId}/maps/merge";
+export declare const API_GRAPHS_MAPS_UNION_URL = "https://{url}/graphs/projects/{projectId}/maps/union";
 export declare const API_GRAPHS_MAP_ID_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}";
 export declare const API_GRAPHS_MAP_CONTENT_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/content";
 export declare const API_GRAPHS_MAP_METADATA_URL = "https://{url}/graphs/projects/{projectId}/maps/{mapId}/metadata";
@@ -152,6 +152,7 @@ export declare const API_GRAPHS_TARGET_UPLOAD_URL = "https://{url}/graphs/projec
 export declare const API_GRAPHS_TARGETS_URL = "https://{url}/graphs/projects/{projectId}/targets";
 export declare const API_GRAPHS_ASSETS_UPLOAD_URL = "https://{url}/graphs/projects/{projectId}/assets/upload";
 export declare const API_GRAPHS_ASSETS_URL = "https://{url}/graphs/projects/{projectId}/assets";
+export declare const API_GRAPHS_TARGET_MEDIA_URL = "https://{url}/graphs/projects/{projectId}/targets/{targetId}/media";
 export declare const API_PROJECT_WORKFLOW_URL = "https://{url}/projects/{projectId}/automate/flows";
 export declare const API_PROJECT_WORKFLOW_ID_URL = "https://{url}/projects/{projectId}/automate/flows/{workflowId}";
 export declare const API_PROJECT_WORKFLOW_ASSET_URL = "https://{url}/projects/{projectId}/automate/flows/{workflowId}/assets";

package/cjs/constants/api.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.API_PROJECT_ROBOT_EVENT_URL = exports.API_PROJECT_ROBOT_REGISTER_URL = exports.API_PROJECT_ROBOT_DEFINITION_URL = exports.API_PROJECT_ROBOT_ATTRIBUTES_URL = exports.API_PROJECT_ROBOT_ID_URL = exports.API_ACCOUNT_ROBOT_URL = exports.API_PROJECT_ROBOT_URL = exports.API_PROJECT_MAPPED_ASSET_PATH_URL = exports.API_PROJECT_MAPPED_ASSETS_PATH_URL = exports.API_PROJECT_MISSION_ASSET_PATH_URL = exports.API_PROJECT_MISSION_ASSETS_PATH_URL = exports.API_PROJECT_FLOW_ASSET_PATH_URL = exports.API_PROJECT_ROBOT_ASSET_PATH_URL = exports.API_PROJECT_ASSET_INTEGRATION_PATH_URL = exports.API_PROJECT_ASSET_INTEGRATIONS_PATH_URL = exports.API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL = exports.API_PROJECT_ASSET_PROFILES_SYNC_DEFINITION_PATH_URL = exports.API_PROJECT_ASSET_ROBOTS_SYNC_DEFINITION_PATH_URL = exports.API_PROJECT_ASSET_PATH_URL = exports.API_PROJECT_ASSET_URL = exports.API_PROJECT_USERS_URL = exports.API_PROJECT_ID_URL = exports.API_PROJECT_URL = exports.API_ACCOUNT_EXTERNAL_PROJECTS_URL = exports.API_ACCOUNT_PROJECT_APPLICATION_ID_URL = exports.API_ACCOUNT_PROJECT_APPLICATION_URL = exports.API_ACCOUNT_PROJECT_USER_ID_URL = exports.API_ACCOUNT_PROJECT_USER_URL = exports.API_ACCOUNT_PROJECT_ID_URL = exports.API_ACCOUNT_PROJECT_URL = exports.API_SERVER_TIME_URL = exports.API_ACCOUNT_SETTINGS_URL = exports.API_AUTH_USER_ACCOUNT_USER_ID_URL = exports.API_AUTH_USER_ACCOUNT_USER_URL = exports.API_ACCOUNT_ACTIVATE_URL = exports.API_ACCOUNT_ID_URL = exports.API_ACCOUNT_URL = exports.API_USER_PAT_TOKEN_URL = exports.API_USER_PAT_URL = exports.API_USER_VERIFY_EMAIL_URL = exports.API_USER_INVITATION_CHECK_URL = exports.API_USER_INVITATION_ACCEPT_URL = exports.API_USER_INVITATION_URL = exports.API_USER_PASSWORD_FORGOT_URL = exports.API_OTP_AUTH_URL = exports.API_OTP_URL = exports.API_USER_TOKEN_URL = exports.API_USER_URL = exports.API_ADMIN_USER_INVITATION_URL = exports.API_APPLICATION_AUTH_URL = void 0;
 exports.API_PROJECT_STREAM_URL = exports.API_PROJECT_GROUP_TYPE_OWNER_OVERRIDE_URL = exports.API_PROJECT_GROUP_TYPE_OWNER_ID_URL = exports.API_PROJECT_GROUP_TYPE_VERSION_URL = exports.API_PROJECT_GROUP_TYPE_CONFIG_URL = exports.API_PROJECT_GROUP_TYPE_PUBLISH_URL = exports.API_PROJECT_GROUP_TYPE_ID_URL = exports.API_PROJECT_GROUP_TYPE_URL = exports.API_PROJECT_ENVIRONMENT_URL = exports.API_PROJECT_DEFINITION_LIBRARY = exports.API_PROJECT_DEFINITION_IMPORT_LIBRARY = exports.API_PROJECT_DEFINITION_IMPORT = exports.API_PROJECT_DEFINITION_EXPORT = exports.API_PROJECT_DEFINITION_GAMEPAD_URL = exports.API_PROJECT_DEFINITION_TRIGGER_URL = exports.API_PROJECT_DEFINITION_BUTTON_URL = exports.API_PROJECT_DEFINITION_ACTION_URL = exports.API_PROJECT_DEFINITION_EVENT_URL = exports.API_PROJECT_DEFINITION_COMMAND2_URL = exports.API_PROJECT_DEFINITION_COMMAND_URL = exports.API_PROJECT_DEFINITION_AGENT_URL = exports.API_PROJECT_DEFINITION_SETTING_URL = exports.API_PROJECT_DEFINITION_BLOB_URL = exports.API_PROJECT_DEFINITION_DASHBOARD_URL = exports.API_PROJECT_DEFINITION_COPY_URL = exports.API_PROJECT_DEFINITION_STREAM_URL = exports.API_PROJECT_DEFINITION_ID_URL = exports.API_PROJECT_DEFINITION_URL = exports.API_PROJECT_VROBOT_DEPLOY_URL = exports.API_PROJECT_VROBOT_DETAILS_URL = exports.API_PROJECT_COLLECTION_DOCS_URL = exports.API_PROJECT_COLLECTION_ID_URL = exports.API_PROJECT_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_DASHBOARD_WIDGET_URL = exports.API_PROJECT_DASHBOARD_ID_URL = exports.API_PROJECT_DASHBOARD_URL = exports.API_PROJECT_OPERATION_ID_URL = exports.API_PROJECT_OPERATION_URL = exports.API_PROJECT_ROBOT_CONFIGS_CONNECTION_URL = exports.API_PROJECT_ROBOT_CONFIGS_CONNECTIONS_URL = exports.API_SERVICE_CONNECTION_URL = exports.API_SERVICE_CONNECTIONS_URL = exports.API_PROJECT_ROBOT_GAMEPAD_URL = exports.API_PROJECT_ROBOT_TRIGGER_URL = exports.API_PROJECT_ROBOT_BUTTON_URL = exports.API_PROJECT_ROBOT_COMMAND2_URL = exports.API_PROJECT_ROBOT_COMMAND_URL = exports.API_PROJECT_ROBOT_AGENT_URL = exports.API_PROJECT_ROBOT_SETTING_URL = exports.API_PROJECT_ROBOT_EVENT_HISTORY_URL = void 0;
-exports.API_GRAPHS_OBSERVATION_KEYS_URL = exports.API_GRAPHS_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA = exports.API_GRAPHS_PANORAMAS_URL = exports.API_GRAPHS_MAPS_GEOJSON_URL = exports.API_GRAPHS_MAPS_DEPLOY_URL = exports.API_GRAPHS_MAPS_COPY_URL = exports.API_GRAPHS_MAP_PATH_APPEND_TRANSFORMABLE_URL = exports.API_GRAPHS_MAP_PATH_APPEND_URL = exports.API_GRAPHS_MAP_PATH_URL = exports.API_GRAPHS_MAP_PATHS_URL = exports.API_GRAPHS_MAP_EDGE_URL = exports.API_GRAPHS_MAP_EDGES_ADD_TRANSFORM_URL = exports.API_GRAPHS_MAP_EDGES_ADD_URL = exports.API_GRAPHS_MAP_NODE_URL = exports.API_GRAPHS_MAP_NODES_ADD_TRANSFORMABLE_URL = exports.API_GRAPHS_MAP_NODES_ADD_URL = exports.API_GRAPHS_MAP_METADATA_URL = exports.API_GRAPHS_MAP_CONTENT_URL = exports.API_GRAPHS_MAP_ID_URL = exports.API_GRAPHS_MAPS_MERGE_URL = exports.API_GRAPHS_MAPS_DEPLOYED_URL = exports.API_GRAPHS_MAPS_NEW_URL = exports.API_GRAPHS_MAPS_URL = exports.API_DD_INTEGRATION_LEVELS_URL = exports.API_DD_INTEGRATION_LOCATIONS_URL = exports.API_DD_INTEGRATION_ISSUES_URL = exports.API_DD_INTEGRATION_OVERLAYS_URL = exports.API_DD_INTEGRATION_PLAN_BY_ID_URL = exports.API_DD_INTEGRATION_PLANS_URL = exports.API_SPOTTY_URL = exports.API_PROJECT_SCHEDULES_URL = exports.API_SOURCE_ID_URL = exports.API_SOURCE_URL = exports.API_SOURCE_SCHEMA_URL = exports.API_TEMPLATE_EXPORTER_URL = exports.API_TEMPLATE_PROVISION_ID_URL = exports.API_TEMPLATE_PROVISION_URL = exports.API_TEMPLATE_DEPLOY_URL = exports.API_PROJECT_PROFILE_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_PROFILE_DASHBOARD_ID_URL = exports.API_PROJECT_PROFILE_DASHBOARD_URL = exports.API_PROJECT_CALLSIGN_STREAM_URL = exports.API_PROJECT_ROBOT_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_ROBOT_DASHBOARD_ID_URL = exports.API_PROJECT_ROBOT_DASHBOARD_URL = exports.API_PROJECT_STREAM_CALLSIGN_URL = exports.API_PROJECT_STREAM_DATA_URL = exports.API_PROJECT_STREAM_ID_URL = void 0;
-exports.API_PROJECT_ROBOT_TAG_URL = exports.API_PROJECT_PROFILE_TAG_URL = exports.API_PROJECT_PROFILE_TAGS_URL = exports.API_PROJECT_TAG_ROBOTS_URL = exports.API_PROJECT_ROBOT_TAGS_URL = exports.API_DEVICE_CREDENTIALS_AUTH_URL = exports.API_DEVICE_CREDENTIALS_URL = exports.API_LINKED_PROJECT_URL = exports.API_PROJECT_WORKFLOW_IMPORT_URL = exports.API_PROJECT_WORKFLOW_EXPORT_URL = exports.API_PROJECT_WORKFLOW_AFFECTED_URL = exports.API_PROJECT_ROBOT_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_PROFILE_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_ROBOT_NO_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_ROBOT_DEPLOYMENTS_URL = exports.API_PROJECT_WORKFLOW_ASSET_ID_URL = exports.API_PROJECT_WORKFLOW_ASSET_URL = exports.API_PROJECT_WORKFLOW_ID_URL = exports.API_PROJECT_WORKFLOW_URL = exports.API_GRAPHS_ASSETS_URL = exports.API_GRAPHS_ASSETS_UPLOAD_URL = exports.API_GRAPHS_TARGETS_URL = exports.API_GRAPHS_TARGET_UPLOAD_URL = void 0;
+exports.API_GRAPHS_OBSERVATION_KEYS_URL = exports.API_GRAPHS_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA_OBSERVATIONS_URL = exports.API_GRAPHS_PANORAMA = exports.API_GRAPHS_PANORAMAS_URL = exports.API_GRAPHS_MAPS_GEOJSON_URL = exports.API_GRAPHS_MAPS_DEPLOY_URL = exports.API_GRAPHS_MAPS_COPY_URL = exports.API_GRAPHS_MAP_PATH_APPEND_TRANSFORMABLE_URL = exports.API_GRAPHS_MAP_PATH_APPEND_URL = exports.API_GRAPHS_MAP_PATH_URL = exports.API_GRAPHS_MAP_PATHS_URL = exports.API_GRAPHS_MAP_EDGE_URL = exports.API_GRAPHS_MAP_EDGES_ADD_TRANSFORM_URL = exports.API_GRAPHS_MAP_EDGES_ADD_URL = exports.API_GRAPHS_MAP_NODE_URL = exports.API_GRAPHS_MAP_NODES_ADD_TRANSFORMABLE_URL = exports.API_GRAPHS_MAP_NODES_ADD_URL = exports.API_GRAPHS_MAP_METADATA_URL = exports.API_GRAPHS_MAP_CONTENT_URL = exports.API_GRAPHS_MAP_ID_URL = exports.API_GRAPHS_MAPS_UNION_URL = exports.API_GRAPHS_MAPS_DEPLOYED_URL = exports.API_GRAPHS_MAPS_NEW_URL = exports.API_GRAPHS_MAPS_URL = exports.API_DD_INTEGRATION_LEVELS_URL = exports.API_DD_INTEGRATION_LOCATIONS_URL = exports.API_DD_INTEGRATION_ISSUES_URL = exports.API_DD_INTEGRATION_OVERLAYS_URL = exports.API_DD_INTEGRATION_PLAN_BY_ID_URL = exports.API_DD_INTEGRATION_PLANS_URL = exports.API_SPOTTY_URL = exports.API_PROJECT_SCHEDULES_URL = exports.API_SOURCE_ID_URL = exports.API_SOURCE_URL = exports.API_SOURCE_SCHEMA_URL = exports.API_TEMPLATE_EXPORTER_URL = exports.API_TEMPLATE_PROVISION_ID_URL = exports.API_TEMPLATE_PROVISION_URL = exports.API_TEMPLATE_DEPLOY_URL = exports.API_PROJECT_PROFILE_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_PROFILE_DASHBOARD_ID_URL = exports.API_PROJECT_PROFILE_DASHBOARD_URL = exports.API_PROJECT_CALLSIGN_STREAM_URL = exports.API_PROJECT_ROBOT_DASHBOARD_CUSTOM_WIDGET_URL = exports.API_PROJECT_ROBOT_DASHBOARD_ID_URL = exports.API_PROJECT_ROBOT_DASHBOARD_URL = exports.API_PROJECT_STREAM_CALLSIGN_URL = exports.API_PROJECT_STREAM_DATA_URL = exports.API_PROJECT_STREAM_ID_URL = void 0;
+exports.API_PROJECT_ROBOT_TAG_URL = exports.API_PROJECT_PROFILE_TAG_URL = exports.API_PROJECT_PROFILE_TAGS_URL = exports.API_PROJECT_TAG_ROBOTS_URL = exports.API_PROJECT_ROBOT_TAGS_URL = exports.API_DEVICE_CREDENTIALS_AUTH_URL = exports.API_DEVICE_CREDENTIALS_URL = exports.API_LINKED_PROJECT_URL = exports.API_PROJECT_WORKFLOW_IMPORT_URL = exports.API_PROJECT_WORKFLOW_EXPORT_URL = exports.API_PROJECT_WORKFLOW_AFFECTED_URL = exports.API_PROJECT_ROBOT_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_PROFILE_DEPLOYED_WORKFLOW_URL = exports.API_PROJECT_ROBOT_NO_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_PROFILE_DEPLOYMENTS_URL = exports.API_PROJECT_ROBOT_DEPLOYMENTS_URL = exports.API_PROJECT_WORKFLOW_ASSET_ID_URL = exports.API_PROJECT_WORKFLOW_ASSET_URL = exports.API_PROJECT_WORKFLOW_ID_URL = exports.API_PROJECT_WORKFLOW_URL = exports.API_GRAPHS_TARGET_MEDIA_URL = exports.API_GRAPHS_ASSETS_URL = exports.API_GRAPHS_ASSETS_UPLOAD_URL = exports.API_GRAPHS_TARGETS_URL = exports.API_GRAPHS_TARGET_UPLOAD_URL = void 0;
 exports.API_APPLICATION_AUTH_URL = 'https://{url}/applications/auth';
 exports.API_ADMIN_USER_INVITATION_URL = 'https://{url}/admin/users/invitations';
 exports.API_USER_URL = 'https://{url}/users';
@@ -42,7 +42,7 @@ exports.API_PROJECT_ASSET_INTEGRATION_PROVIDERS_PATH_URL = 'https://{url}/projec
 exports.API_PROJECT_ASSET_INTEGRATIONS_PATH_URL = 'https://{url}/projects/{projectId}/integrations';
 exports.API_PROJECT_ASSET_INTEGRATION_PATH_URL = 'https://{url}/projects/{projectId}/integrations/{integrationId}';
 exports.API_PROJECT_ROBOT_ASSET_PATH_URL = 'https://{url}/projects/{projectId}/robots/{callsign}/assets';
-exports.API_PROJECT_FLOW_ASSET_PATH_URL = 'https://{url}/projects/{projectId}/flows/{callsign}/assets';
+exports.API_PROJECT_FLOW_ASSET_PATH_URL = 'https://{url}/projects/{projectId}/flows/{flowId}/instances/{flowInstance}/assets';
 exports.API_PROJECT_MISSION_ASSETS_PATH_URL = 'https://{url}/projects/{projectId}/missionassets';
 exports.API_PROJECT_MISSION_ASSET_PATH_URL = 'https://{url}/projects/{projectId}/missionassets/{assetId}';
 exports.API_PROJECT_MAPPED_ASSETS_PATH_URL = 'https://{url}/projects/{projectId}/mappedassets';
@@ -134,7 +134,7 @@ exports.API_DD_INTEGRATION_LEVELS_URL = 'https://{url}/projects/{projectId}/dd/l
 exports.API_GRAPHS_MAPS_URL = 'https://{url}/graphs/projects/{projectId}/maps';
 exports.API_GRAPHS_MAPS_NEW_URL = 'https://{url}/graphs/projects/{projectId}/maps/new';
 exports.API_GRAPHS_MAPS_DEPLOYED_URL = 'https://{url}/graphs/projects/{projectId}/maps/deployed?callsign={callsign}';
-exports.API_GRAPHS_MAPS_MERGE_URL = 'https://{url}/graphs/projects/{projectId}/maps/merge';
+exports.API_GRAPHS_MAPS_UNION_URL = 'https://{url}/graphs/projects/{projectId}/maps/union';
 exports.API_GRAPHS_MAP_ID_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}';
 exports.API_GRAPHS_MAP_CONTENT_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/content';
 exports.API_GRAPHS_MAP_METADATA_URL = 'https://{url}/graphs/projects/{projectId}/maps/{mapId}/metadata';
@@ -160,6 +160,7 @@ exports.API_GRAPHS_TARGET_UPLOAD_URL = 'https://{url}/graphs/projects/{projectId
 exports.API_GRAPHS_TARGETS_URL = 'https://{url}/graphs/projects/{projectId}/targets';
 exports.API_GRAPHS_ASSETS_UPLOAD_URL = 'https://{url}/graphs/projects/{projectId}/assets/upload';
 exports.API_GRAPHS_ASSETS_URL = 'https://{url}/graphs/projects/{projectId}/assets';
+exports.API_GRAPHS_TARGET_MEDIA_URL = 'https://{url}/graphs/projects/{projectId}/targets/{targetId}/media';
 exports.API_PROJECT_WORKFLOW_URL = 'https://{url}/projects/{projectId}/automate/flows';
 exports.API_PROJECT_WORKFLOW_ID_URL = 'https://{url}/projects/{projectId}/automate/flows/{workflowId}';
 exports.API_PROJECT_WORKFLOW_ASSET_URL = 'https://{url}/projects/{projectId}/automate/flows/{workflowId}/assets';

package/cjs/constants/identifier.d.ts

@@ -1,6 +1,7 @@
 export declare const IDENTIFIER_NAME_TELEMETRY = "telemetry";
 export declare const IDENTIFIER_NAME_CALLER = "caller";
 export declare const IDENTIFIER_NAME_COMMAND = "command";
+export declare const IDENTIFIER_NAME_WEBRTC_SIGNALLING = "webRTCSignalling";
 export declare const IDENTIFIER_NAME_CONTROL = "control";
 export declare const IDENTIFIER_NAME_SEARCH = "search";
 export declare const IDENTIFIER_NAME_FILE_ACCESSOR = "fileAccessor";

package/cjs/constants/identifier.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IDENTIFIER_NAME_FILE_ACCESSOR = exports.IDENTIFIER_NAME_SEARCH = exports.IDENTIFIER_NAME_CONTROL = exports.IDENTIFIER_NAME_COMMAND = exports.IDENTIFIER_NAME_CALLER = exports.IDENTIFIER_NAME_TELEMETRY = void 0;
+exports.IDENTIFIER_NAME_FILE_ACCESSOR = exports.IDENTIFIER_NAME_SEARCH = exports.IDENTIFIER_NAME_CONTROL = exports.IDENTIFIER_NAME_WEBRTC_SIGNALLING = exports.IDENTIFIER_NAME_COMMAND = exports.IDENTIFIER_NAME_CALLER = exports.IDENTIFIER_NAME_TELEMETRY = void 0;
 exports.IDENTIFIER_NAME_TELEMETRY = 'telemetry';
 exports.IDENTIFIER_NAME_CALLER = 'caller';
 exports.IDENTIFIER_NAME_COMMAND = 'command';
+exports.IDENTIFIER_NAME_WEBRTC_SIGNALLING = 'webRTCSignalling';
 exports.IDENTIFIER_NAME_CONTROL = 'control';
 exports.IDENTIFIER_NAME_SEARCH = 'search';
 exports.IDENTIFIER_NAME_FILE_ACCESSOR = 'fileAccessor';

package/cjs/helpers/getUniqueId.js

@@ -10,6 +10,7 @@ const flattenCallsignsLookup_1 = require("./flattenCallsignsLookup");
  * @param scope
  */
 const getUniqueId = (projectId, callsignsLookup, sources, scope) => {
-    return [projectId, ...(0, flattenCallsignsLookup_1.flattenCallsignsLookup)(callsignsLookup), ...sources.sort(), scope].join();
+    // Copy before sorting: the caller keeps this array, and filters incoming messages with it.
+    return [projectId, ...(0, flattenCallsignsLookup_1.flattenCallsignsLookup)(callsignsLookup), ...[...sources].sort(), scope].join();
 };
 exports.getUniqueId = getUniqueId;

package/cjs/models/callsigns/CallsignsLookup.d.ts

@@ -4,5 +4,9 @@ export declare class CallsignsLookup {
     lookupValue: CallsignsQuery | string[];
     lookupType: CallsignsLookupType;
     constructor(lookupValue: string[] | CallsignsQuery);
+    isQuery(): boolean;
+    getCallsigns(): string[];
+    getQuery(): CallsignsQuery | undefined;
+    includesCallsign(callsign: string): boolean;
     toID(): string[];
 }

package/cjs/models/callsigns/CallsignsLookup.js

@@ -22,6 +22,25 @@ class CallsignsLookup {
             }
         }
     }
+    isQuery() {
+        return this.lookupType === CallsignsEnums_1.CallsignsLookupType.Query;
+    }
+    getCallsigns() {
+        if (this.isQuery())
+            return [];
+        return this.lookupValue;
+    }
+    getQuery() {
+        if (!this.isQuery())
+            return undefined;
+        return this.lookupValue;
+    }
+    // A query resolves its callsigns server side, so there is no local list to match against.
+    includesCallsign(callsign) {
+        if (this.isQuery())
+            return true;
+        return this.getCallsigns().includes(callsign);
+    }
     toID() {
         if (this.lookupType === CallsignsEnums_1.CallsignsLookupType.List) {
             return this.lookupValue.sort();