@formant/data-sdk 1.81.8 → 1.82.1

package/dist/types/data-sdk/src/Fleet.d.ts

@@ -39,9 +39,11 @@ import { createFleet } from "./api/createFleet";
 import { getAllEventTriggerGroup } from "./api/getAllEventTriggerGroup";
 import { getEventTriggerGroup } from "./api/getEventTriggerGroup";
 import { patchEventTriggerGroup } from "./api/patchEventTriggerGroup";
+import { IDevice } from "./message-bus/listeners/EmbeddedAppMessage";
 export declare class Fleet {
     static defaultDeviceId: string | undefined;
     static knownContext: WeakRef<Device>[];
+    static groupDevices: IDevice[] | undefined;
     static createFleet: typeof createFleet;
     static listFleets: typeof listFleets;
     static getFleet: typeof getFleet;
@@ -53,6 +55,24 @@ export declare class Fleet {
     static getCurrentDevice(): Promise<Device>;
     static getPeerDevice(url: string): Promise<PeerDevice>;
     static getDevice(deviceId: string): Promise<Device>;
+    /**
+     * Sets the group devices for multi-device (coherence group) contexts.
+     * This is typically called automatically when overview_devices message is received.
+     * @param devices Array of device information from the host container
+     */
+    static setGroupDevices(devices: IDevice[]): void;
+    /**
+     * Gets the group devices for multi-device contexts.
+     * Returns undefined if not in a group context (single device view).
+     * @returns Array of device information or undefined
+     */
+    static getGroupDevices(): IDevice[] | undefined;
+    /**
+     * Gets all group devices as Device instances.
+     * Useful for modules that need full Device objects rather than just IDevice info.
+     * @returns Promise resolving to array of Device instances
+     */
+    static getGroupDevicesAsDeviceInstances(): Promise<Device[]>;
     static aggregateTelemetry: typeof aggregateTelemetry;
     static createShareLink: typeof createShareLink;
     static eventsCounter: typeof eventsCounter;

package/dist/types/data-sdk/src/devices/Device.d.ts

@@ -45,9 +45,11 @@ export declare class Device extends BaseDevice {
     /**
      * Asynchronously retrieves the configuration document for a device.
      *
-     * @param {boolean} getDesiredConfigurationVersion - Whether to retrieve the desired configuration version
+     * @param {boolean} getDesiredConfigurationVersion - Whether to retrieve the desired configuration version.
+     *   If false, uses reportedConfiguration.version, falling back to desiredConfigurationVersion
+     *   if the device has no reportedConfiguration (e.g., agent never connected).
      * @returns {Promise<ConfigurationDocument>} A promise that resolves to the configuration document
-     * @throws {Error} Throws an error if the device has no configuration or has never been turned on
+     * @throws {Error} Throws an error if the device has no configuration version
      */
     getConfiguration(getDesiredConfigurationVersion?: boolean): Promise<ConfigurationDocument>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formant/data-sdk",
-  "version": "1.81.8",
+  "version": "1.82.1",
   "description": "A library for getting data from Formant",
   "repository": {
     "type": "git",