mysa-js-sdk 1.1.2 → 1.3.0

package/README.md

@@ -51,6 +51,12 @@ Then, run the example:
 npm run example
 ```
 
+If you prefer to see the raw data published by your Mysa smart thermostats, run:
+
+```bash
+npm run example:raw
+```
+
 ## Using
 
 The Mysa SDK provides a simple interface to interact with Mysa smart thermostats.

package/dist/index.cjs

@@ -211,6 +211,7 @@ var OutMessageType = /* @__PURE__ */ ((OutMessageType2) => {
 })(OutMessageType || {});
 
 // src/api/MysaApiClient.ts
+var import_client_iot = require("@aws-sdk/client-iot");
 var import_credential_providers = require("@aws-sdk/credential-providers");
 var import_amazon_cognito_identity_js = require("amazon-cognito-identity-js");
 var import_aws_iot_device_sdk_v2 = require("aws-iot-device-sdk-v2");
@@ -294,8 +295,23 @@ var MysaApiClient = class {
   /**
    * Logs in the user with the given email address and password.
    *
+   * This method authenticates the user with Mysa's Cognito user pool and establishes a session that can be used for
+   * subsequent API calls. Upon successful login, a 'sessionChanged' event is emitted.
+   *
+   * @example
+   *
+   * ```typescript
+   * try {
+   *   await client.login('user@example.com', 'password123');
+   *   console.log('Login successful!');
+   * } catch (error) {
+   *   console.error('Login failed:', error.message);
+   * }
+   * ```
+   *
    * @param emailAddress - The email address of the user.
    * @param password - The password of the user.
+   * @throws {@link Error} When authentication fails due to invalid credentials or network issues.
    */
   async login(emailAddress, password) {
     this._cognitoUser = void 0;
@@ -322,7 +338,21 @@ var MysaApiClient = class {
   /**
    * Retrieves the list of devices associated with the user.
    *
+   * This method fetches all Mysa devices linked to the authenticated user's account, including device information such
+   * as models, locations, and configuration details.
+   *
+   * @example
+   *
+   * ```typescript
+   * const devices = await client.getDevices();
+   * for (const [deviceId, device] of Object.entries(devices.DevicesObj)) {
+   *   console.log(`Device: ${device.DisplayName} (${device.Model})`);
+   * }
+   * ```
+   *
    * @returns A promise that resolves to the list of devices.
+   * @throws {@link MysaApiError} When the API request fails.
+   * @throws {@link UnauthenticatedError} When the user is not authenticated.
    */
   async getDevices() {
     this._logger.debug(`Fetching devices...`);
@@ -337,6 +367,65 @@ var MysaApiClient = class {
     }
     return response.json();
   }
+  /**
+   * Retrieves the serial number for a specific device.
+   *
+   * This method uses AWS IoT's DescribeThing API to fetch the serial number attribute for the specified device. This
+   * requires additional AWS IoT permissions and may not be available for all devices.
+   *
+   * @example
+   *
+   * ```typescript
+   * const serialNumber = await client.getDeviceSerialNumber('device123');
+   * if (serialNumber) {
+   *   console.log(`Device serial: ${serialNumber}`);
+   * } else {
+   *   console.log('Serial number not available');
+   * }
+   * ```
+   *
+   * @param deviceId - The ID of the device to get the serial number for.
+   * @returns A promise that resolves to the serial number, or undefined if not found.
+   * @throws {@link UnauthenticatedError} When the user is not authenticated.
+   */
+  async getDeviceSerialNumber(deviceId) {
+    var _a;
+    this._logger.debug(`Fetching serial number for device ${deviceId}...`);
+    const session = await this.getFreshSession();
+    const credentialsProvider = (0, import_credential_providers.fromCognitoIdentityPool)({
+      clientConfig: {
+        region: AwsRegion
+      },
+      identityPoolId: CognitoIdentityPoolId,
+      logins: {
+        [CognitoLoginKey]: session.getIdToken().getJwtToken()
+      }
+    });
+    const credentials = await credentialsProvider();
+    const iotClient = new import_client_iot.IoTClient({
+      region: AwsRegion,
+      credentials: {
+        accessKeyId: credentials.accessKeyId,
+        secretAccessKey: credentials.secretAccessKey,
+        sessionToken: credentials.sessionToken
+      }
+    });
+    try {
+      const command = new import_client_iot.DescribeThingCommand({ thingName: deviceId });
+      const response = await iotClient.send(command);
+      return (_a = response.attributes) == null ? void 0 : _a["Serial"];
+    } catch (error) {
+      this._logger.warn(`Could not get serial number for device ${deviceId}:`, error);
+      return void 0;
+    }
+  }
+  /**
+   * Retrieves firmware information for all devices.
+   *
+   * @returns A promise that resolves to the firmware information for all devices.
+   * @throws {@link MysaApiError} When the API request fails.
+   * @throws {@link UnauthenticatedError} When the user is not authenticated.
+   */
   async getDeviceFirmwares() {
     this._logger.debug(`Fetching device firmwares...`);
     const session = await this.getFreshSession();
@@ -350,6 +439,13 @@ var MysaApiClient = class {
     }
     return response.json();
   }
+  /**
+   * Retrieves the current state information for all devices.
+   *
+   * @returns A promise that resolves to the current state of all devices.
+   * @throws {@link MysaApiError} When the API request fails.
+   * @throws {@link UnauthenticatedError} When the user is not authenticated.
+   */
   async getDeviceStates() {
     this._logger.debug(`Fetching device states...`);
     const session = await this.getFreshSession();
@@ -363,6 +459,31 @@ var MysaApiClient = class {
     }
     return response.json();
   }
+  /**
+   * Sets the state of a specific device by sending commands via MQTT.
+   *
+   * This method allows you to change the temperature set point and/or operating mode of a Mysa device. The command is
+   * sent through the MQTT connection for real-time device control.
+   *
+   * @example
+   *
+   * ```typescript
+   * // Set temperature to 22°C
+   * await client.setDeviceState('device123', 22);
+   *
+   * // Turn device off
+   * await client.setDeviceState('device123', undefined, 'off');
+   *
+   * // Set temperature and mode
+   * await client.setDeviceState('device123', 20, 'heat');
+   * ```
+   *
+   * @param deviceId - The ID of the device to control.
+   * @param setPoint - The target temperature set point (optional).
+   * @param mode - The operating mode to set ('off', 'heat', or undefined to leave unchanged).
+   * @throws {@link UnauthenticatedError} When the user is not authenticated.
+   * @throws {@link Error} When MQTT connection or command sending fails.
+   */
   async setDeviceState(deviceId, setPoint, mode) {
     this._logger.debug(`Setting device state for '${deviceId}'`);
     if (!this._cachedDevices) {
@@ -404,7 +525,23 @@ var MysaApiClient = class {
   /**
    * Starts receiving real-time updates for the specified device.
    *
+   * This method establishes an MQTT subscription to receive live status updates from the device, including temperature,
+   * humidity, set point changes, and other state information. The client will automatically send keep-alive messages to
+   * maintain the connection.
+   *
+   * @example
+   *
+   * ```typescript
+   * // Start receiving updates and listen for events
+   * await client.startRealtimeUpdates('device123');
+   *
+   * client.emitter.on('statusChanged', (status) => {
+   *   console.log(`Temperature: ${status.temperature}°C`);
+   * });
+   * ```
+   *
    * @param deviceId - The ID of the device to start receiving updates for.
+   * @throws {@link Error} When MQTT connection or subscription fails.
    */
   async startRealtimeUpdates(deviceId) {
     this._logger.info(`Starting real-time updates for device '${deviceId}'`);
@@ -441,7 +578,11 @@ var MysaApiClient = class {
   /**
    * Stops receiving real-time updates for the specified device.
    *
+   * This method unsubscribes from the MQTT topic for the specified device and clears any associated timers to stop the
+   * keep-alive messages.
+   *
    * @param deviceId - The ID of the device to stop receiving real-time updates for.
+   * @throws {@link Error} When MQTT unsubscription fails.
    */
   async stopRealtimeUpdates(deviceId) {
     this._logger.info(`Stopping real-time updates for device '${deviceId}'`);
@@ -457,6 +598,15 @@ var MysaApiClient = class {
     clearInterval(timer);
     this._realtimeDeviceIds.delete(deviceId);
   }
+  /**
+   * Ensures a valid, non-expired session is available.
+   *
+   * This method checks if the current session is valid and not expired. If the session is expired, it automatically
+   * refreshes it using the refresh token.
+   *
+   * @returns A promise that resolves to a valid CognitoUserSession.
+   * @throws {@link UnauthenticatedError} When no session exists or refresh fails.
+   */
   async getFreshSession() {
     if (!this._cognitoUser || !this._cognitoUserSession) {
       throw new UnauthenticatedError("An attempt was made to access a resource without a valid session.");
@@ -480,6 +630,15 @@ var MysaApiClient = class {
       });
     });
   }
+  /**
+   * Establishes and returns an MQTT connection for real-time communication.
+   *
+   * This method creates a new MQTT connection if one doesn't exist, using AWS IoT WebSocket connections with Cognito
+   * credentials. The connection is cached and reused for subsequent calls.
+   *
+   * @returns A promise that resolves to an active MQTT connection.
+   * @throws {@link Error} When connection establishment fails.
+   */
   async getMqttConnection() {
     if (this._mqttConnection) {
       return this._mqttConnection;
@@ -507,6 +666,15 @@ var MysaApiClient = class {
     await this._mqttConnection.connect();
     return this._mqttConnection;
   }
+  /**
+   * Processes incoming MQTT messages and emits appropriate events.
+   *
+   * This method parses MQTT payloads and converts them into typed events that can be listened to via the client's event
+   * emitter. It handles both v1 and v2 device message formats and emits events like 'statusChanged', 'setPointChanged',
+   * and 'stateChanged'.
+   *
+   * @param payload - The raw MQTT message payload to process.
+   */
   processMqttMessage(payload) {
     try {
       const parsedPayload = parseMqttPayload(payload);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/api/Errors.ts","../src/api/Logger.ts","../src/lib/EventEmitter.ts","../src/lib/PayloadParser.ts","../src/lib/PayloadTypeGuards.ts","../src/types/mqtt/in/InMessageType.ts","../src/types/mqtt/out/OutMessageType.ts","../src/api/MysaApiClient.ts"],"sourcesContent":["export * from './api';\nexport * from './types';\n","/** Error thrown when attempting to access the Mysa API without proper authentication. */\nexport class UnauthenticatedError extends Error {\n  /**\n   * Creates a new UnauthenticatedError instance.\n   *\n   * @param message - The error message\n   */\n  constructor(message: string) {\n    super(message);\n    this.name = 'UnauthenticatedError';\n  }\n}\n\n/** Error thrown when a Mysa API request fails. */\nexport class MysaApiError extends Error {\n  /** The HTTP status code returned by the API */\n  readonly status: number;\n  /** The HTTP status text returned by the API */\n  readonly statusText: string;\n\n  /**\n   * Creates a new MysaApiError instance.\n   *\n   * @param apiResponse - The failed Response object from the API call\n   */\n  constructor(apiResponse: Response) {\n    super(\n      `Failed to call the '${apiResponse.url}' Mysa API endpoint. The server responded with a status of ${apiResponse.status} (${apiResponse.statusText}).`\n    );\n    this.name = 'MysaApiError';\n    this.status = apiResponse.status;\n    this.statusText = apiResponse.statusText;\n  }\n}\n","/** Interface for logging operations at different severity levels */\nexport interface Logger {\n  /** Logs a debug message with optional metadata */\n  debug(message: string, ...meta: unknown[]): void;\n\n  /** Logs an info message with optional metadata */\n  info(message: string, ...meta: unknown[]): void;\n\n  /** Logs a warning message with optional metadata */\n  warn(message: string, ...meta: unknown[]): void;\n\n  /** Logs an error message with optional metadata */\n  error(message: string, ...meta: unknown[]): void;\n}\n\n/** Logger implementation that silently discards all log messages. */\n/* eslint-disable @typescript-eslint/no-unused-vars */\nexport class VoidLogger implements Logger {\n  debug(message: string, ...meta: unknown[]): void {}\n  info(message: string, ...meta: unknown[]): void {}\n  warn(message: string, ...meta: unknown[]): void {}\n  error(message: string, ...meta: unknown[]): void {}\n}\n/* eslint-enable @typescript-eslint/no-unused-vars */\n","import { EventEmitter as NodeEventEmitter } from 'node:events';\n\n/**\n * Typed wrapper around Node's `EventEmitter` class.\n *\n * @remarks\n * Source: {@link https://blog.makerx.com.au/a-type-safe-event-emitter-in-node-js}\n */\n/* eslint-disable @typescript-eslint/no-explicit-any */\nexport class EventEmitter<TEvents extends Record<string, any>> implements NodeJS.EventEmitter {\n  private _emitter = new NodeEventEmitter();\n\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArg: TEvents[TEventName]) {\n    return this._emitter.emit(eventName, ...(eventArg as []));\n  }\n\n  on<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    handler: (...eventArg: TEvents[TEventName]) => void\n  ) {\n    this._emitter.on(eventName, handler as any);\n    return this;\n  }\n\n  once<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    handler: (...eventArg: TEvents[TEventName]) => void\n  ) {\n    this._emitter.once(eventName, handler as any);\n    return this;\n  }\n\n  off<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    handler: (...eventArg: TEvents[TEventName]) => void\n  ) {\n    this._emitter.off(eventName, handler as any);\n    return this;\n  }\n\n  addListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.addListener(eventName, listener);\n    return this;\n  }\n\n  removeListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.removeListener(eventName, listener);\n    return this;\n  }\n\n  removeAllListeners<TEventName extends keyof TEvents & string>(eventName?: TEventName | undefined) {\n    this._emitter.removeAllListeners(eventName);\n    return this;\n  }\n\n  setMaxListeners(n: number) {\n    this._emitter.setMaxListeners(n);\n    return this;\n  }\n\n  getMaxListeners(): number {\n    return this._emitter.getMaxListeners();\n  }\n\n  listeners<TEventName extends keyof TEvents & string>(eventName: TEventName) {\n    return this._emitter.listeners(eventName);\n  }\n\n  rawListeners<TEventName extends keyof TEvents & string>(eventName: TEventName) {\n    return this._emitter.rawListeners(eventName);\n  }\n\n  listenerCount<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener?: (...args: TEvents[TEventName]) => void\n  ) {\n    return this._emitter.listenerCount(eventName, listener);\n  }\n\n  prependListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.prependListener(eventName, listener);\n    return this;\n  }\n\n  prependOnceListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.prependOnceListener(eventName, listener);\n    return this;\n  }\n\n  eventNames() {\n    return this._emitter.eventNames();\n  }\n}\n/* eslint-enable @typescript-eslint/no-explicit-any */\n","import { InPayload } from '@/types/mqtt/InPayload';\nimport { OutPayload } from '@/types/mqtt/OutPayload';\n\n/**\n * Parses an MQTT payload from binary data into a typed OutPayload object.\n *\n * Converts the raw ArrayBuffer received from MQTT messages into a structured TypeScript object representing device\n * status, state changes, or other outgoing message types from Mysa devices.\n *\n * @param payload - The raw binary MQTT message payload as ArrayBuffer\n * @returns The parsed payload as a typed OutPayload object\n * @throws Error if the payload cannot be decoded or parsed as valid JSON\n */\nexport function parseMqttPayload(payload: ArrayBuffer): OutPayload {\n  try {\n    const decoder = new TextDecoder('utf-8');\n    const jsonString = decoder.decode(payload);\n    return JSON.parse(jsonString);\n  } catch (error) {\n    console.error('Error parsing MQTT payload:', error);\n    throw new Error('Failed to parse MQTT payload');\n  }\n}\n\n/**\n * Serializes an InPayload object into binary data for MQTT transmission.\n *\n * Converts a typed TypeScript payload object into the binary ArrayBuffer format required for sending commands and\n * requests to Mysa devices via MQTT.\n *\n * @typeParam T - The specific InPayload type being serialized\n * @param payload - The typed payload object to serialize\n * @returns The serialized payload as ArrayBuffer ready for MQTT transmission\n */\nexport function serializeMqttPayload<T extends InPayload>(payload: T): ArrayBuffer {\n  const jsonString = JSON.stringify(payload);\n  const encoder = new TextEncoder();\n  return encoder.encode(jsonString);\n}\n","import { MsgOutPayload } from '@/types/mqtt/MsgOutPayload';\nimport { MsgTypeOutPayload } from '@/types/mqtt/MsgTypeOutPayload';\nimport { OutPayload } from '@/types/mqtt/OutPayload';\n\n/**\n * Type guard function to determine if an OutPayload is a MsgType-based payload.\n *\n * Checks whether the payload uses the legacy MsgType field format for message type identification. This is used to\n * differentiate between different payload structures and ensure proper type narrowing in TypeScript.\n *\n * @param payload - The OutPayload to check\n * @returns True if the payload is a MsgTypeOutPayload, false otherwise\n */\nexport function isMsgTypeOutPayload(payload: OutPayload): payload is MsgTypeOutPayload {\n  return 'MsgType' in payload;\n}\n\n/**\n * Type guard function to determine if an OutPayload is a message-based payload.\n *\n * Checks whether the payload uses the newer msg field format for message type identification. This is used to\n * differentiate between different payload structures and ensure proper type narrowing in TypeScript.\n *\n * @param payload - The OutPayload to check\n * @returns True if the payload is a MsgOutPayload, false otherwise\n */\nexport function isMsgOutPayload(payload: OutPayload): payload is MsgOutPayload {\n  return 'msg' in payload;\n}\n","/**\n * Enumeration of message types for incoming MQTT messages from clients to devices.\n *\n * These message types determine how commands and requests are interpreted by Mysa devices. The enum values correspond\n * to specific numeric identifiers used in the MQTT protocol.\n */\nexport enum InMessageType {\n  //\n  // When the message type is reported in the `MsgType` field of the payload.\n  //\n\n  /** Request to check and retrieve current device settings */\n  CHECK_DEVICE_SETTINGS = 6,\n\n  /** Command to start publishing periodic device status updates */\n  START_PUBLISHING_DEVICE_STATUS = 11,\n\n  //\n  // When the message type is reported in the `msg` field of the payload.\n  //\n\n  /** Command to change the current state of a device (temperature, mode, etc.) */\n  CHANGE_DEVICE_STATE = 44\n}\n","/**\n * Enumeration of message types for outgoing MQTT messages from devices to clients.\n *\n * These message types identify different kinds of status updates, notifications, and data reports that Mysa devices can\n * send via MQTT. The enum values correspond to specific numeric identifiers used in the MQTT protocol.\n */\nexport enum OutMessageType {\n  //\n  // When the message type is reported in the `MsgType` field of the payload.\n  //\n\n  /** Version 1 device status report with basic device information */\n  DEVICE_V1_STATUS = 0,\n\n  /** Notification that a device's temperature setpoint has been changed */\n  DEVICE_SETPOINT_CHANGE = 1,\n\n  /** Device log entry or diagnostic information */\n  DEVICE_LOG = 4,\n\n  /** Notification sent when a device completes its boot sequence */\n  DEVICE_POST_BOOT = 10,\n\n  //\n  // When the message type is reported in the `msg` field of the payload.\n  //\n\n  /** Version 2 device status report with enhanced device information */\n  DEVICE_V2_STATUS = 40,\n\n  /** Notification that a device's operational state has changed */\n  DEVICE_STATE_CHANGE = 44\n}\n","import { MysaSession } from '@/api/MysaSession';\nimport { EventEmitter } from '@/lib/EventEmitter';\nimport { parseMqttPayload, serializeMqttPayload } from '@/lib/PayloadParser';\nimport { isMsgOutPayload, isMsgTypeOutPayload } from '@/lib/PayloadTypeGuards';\nimport { ChangeDeviceState } from '@/types/mqtt/in/ChangeDeviceState';\nimport { InMessageType } from '@/types/mqtt/in/InMessageType';\nimport { StartPublishingDeviceStatus } from '@/types/mqtt/in/StartPublishingDeviceStatus';\nimport { OutMessageType } from '@/types/mqtt/out/OutMessageType';\nimport { Devices, DeviceStates, Firmwares } from '@/types/rest';\nimport { fromCognitoIdentityPool } from '@aws-sdk/credential-providers';\nimport {\n  AuthenticationDetails,\n  CognitoAccessToken,\n  CognitoIdToken,\n  CognitoRefreshToken,\n  CognitoUser,\n  CognitoUserPool,\n  CognitoUserSession\n} from 'amazon-cognito-identity-js';\nimport { iot, mqtt } from 'aws-iot-device-sdk-v2';\nimport dayjs from 'dayjs';\nimport duration from 'dayjs/plugin/duration.js';\nimport { MysaApiError, UnauthenticatedError } from './Errors';\nimport { Logger, VoidLogger } from './Logger';\nimport { MysaApiClientEventTypes } from './MysaApiClientEventTypes';\nimport { MysaApiClientOptions } from './MysaApiClientOptions';\nimport { MysaDeviceMode } from './MysaDeviceMode';\n\ndayjs.extend(duration);\n\nconst AwsRegion = 'us-east-1';\nconst CognitoUserPoolId = 'us-east-1_GUFWfhI7g';\nconst CognitoClientId = '19efs8tgqe942atbqmot5m36t3';\nconst CognitoIdentityPoolId = 'us-east-1:ebd95d52-9995-45da-b059-56b865a18379';\nconst CognitoLoginKey = `cognito-idp.${AwsRegion}.amazonaws.com/${CognitoUserPoolId}`;\nconst MqttEndpoint = 'a3q27gia9qg3zy-ats.iot.us-east-1.amazonaws.com';\nconst MysaApiBaseUrl = 'https://app-prod.mysa.cloud';\nconst RealtimeKeepAliveInterval = dayjs.duration(5, 'minutes');\n\n/**\n * Main client for interacting with the Mysa API and real-time device communication.\n *\n * The MysaApiClient provides a comprehensive interface for authenticating with Mysa services, managing device data, and\n * receiving real-time updates from Mysa thermostats and heating devices. It handles both REST API calls for device\n * management and MQTT connections for live status updates and control commands.\n *\n * @example\n *\n * ```typescript\n * const client = new MysaApiClient();\n *\n * await client.login('user@example.com', 'password');\n * const devices = await client.getDevices();\n *\n * client.emitter.on('statusChanged', (status) => {\n *   console.log(`Device ${status.deviceId} temperature: ${status.temperature}°C`);\n * });\n *\n * for (const device of Object.entries(devices.DevicesObj)) {\n *   await client.startRealtimeUpdates(device[0]);\n * }\n * ```\n */\nexport class MysaApiClient {\n  /** The current session object, if any. */\n  private _cognitoUserSession?: CognitoUserSession;\n\n  /** The current user object, if any. */\n  private _cognitoUser?: CognitoUser;\n\n  /** The logger instance used by the client. */\n  private _logger: Logger;\n\n  /** The fetcher function used by the client. */\n  private _fetcher: typeof fetch;\n\n  /** The MQTT connection used for real-time updates. */\n  private _mqttConnection?: mqtt.MqttClientConnection;\n\n  /** The device IDs that are currently being updated in real-time, mapped to their respective timeouts. */\n  private _realtimeDeviceIds: Map<string, NodeJS.Timeout> = new Map();\n\n  /** The cached devices object, if any. */\n  private _cachedDevices?: Devices;\n\n  /**\n   * Event emitter for client events.\n   *\n   * @see {@link MysaApiClientEventTypes} for the possible events and their payloads.\n   */\n  readonly emitter = new EventEmitter<MysaApiClientEventTypes>();\n\n  /**\n   * Gets the persistable session object.\n   *\n   * @returns The current persistable session object, if any.\n   */\n  get session(): MysaSession | undefined {\n    if (!this._cognitoUserSession || !this._cognitoUser) {\n      return undefined;\n    }\n\n    return {\n      username: this._cognitoUser.getUsername(),\n      idToken: this._cognitoUserSession.getIdToken().getJwtToken(),\n      accessToken: this._cognitoUserSession.getAccessToken().getJwtToken(),\n      refreshToken: this._cognitoUserSession.getRefreshToken().getToken()\n    };\n  }\n\n  /**\n   * Returns whether the client currently has an active session.\n   *\n   * @returns True if the client has an active session, false otherwise.\n   */\n  get isAuthenticated(): boolean {\n    return !!this.session;\n  }\n\n  /**\n   * Constructs a new instance of the MysaApiClient.\n   *\n   * @param session - The persistable session object, if any.\n   * @param options - The options for the client.\n   */\n  constructor(session?: MysaSession, options?: MysaApiClientOptions) {\n    this._logger = options?.logger || new VoidLogger();\n    this._fetcher = options?.fetcher || fetch;\n\n    if (session) {\n      this._cognitoUser = new CognitoUser({\n        Username: session.username,\n        Pool: new CognitoUserPool({ UserPoolId: CognitoUserPoolId, ClientId: CognitoClientId })\n      });\n      this._cognitoUserSession = new CognitoUserSession({\n        IdToken: new CognitoIdToken({ IdToken: session.idToken }),\n        AccessToken: new CognitoAccessToken({ AccessToken: session.accessToken }),\n        RefreshToken: new CognitoRefreshToken({ RefreshToken: session.refreshToken })\n      });\n    }\n  }\n\n  /**\n   * Logs in the user with the given email address and password.\n   *\n   * @param emailAddress - The email address of the user.\n   * @param password - The password of the user.\n   */\n  async login(emailAddress: string, password: string): Promise<void> {\n    this._cognitoUser = undefined;\n    this._cognitoUserSession = undefined;\n    this.emitter.emit('sessionChanged', this.session);\n\n    return new Promise((resolve, reject) => {\n      const user = new CognitoUser({\n        Username: emailAddress,\n        Pool: new CognitoUserPool({ UserPoolId: CognitoUserPoolId, ClientId: CognitoClientId })\n      });\n\n      user.authenticateUser(new AuthenticationDetails({ Username: emailAddress, Password: password }), {\n        onSuccess: (session) => {\n          this._cognitoUser = user;\n          this._cognitoUserSession = session;\n          this.emitter.emit('sessionChanged', this.session);\n\n          resolve();\n        },\n        onFailure: (err) => {\n          reject(err);\n        }\n      });\n    });\n  }\n\n  /**\n   * Retrieves the list of devices associated with the user.\n   *\n   * @returns A promise that resolves to the list of devices.\n   */\n  async getDevices(): Promise<Devices> {\n    this._logger.debug(`Fetching devices...`);\n\n    const session = await this.getFreshSession();\n\n    const response = await this._fetcher(`${MysaApiBaseUrl}/devices`, {\n      headers: {\n        Authorization: `${session.getIdToken().getJwtToken()}`\n      }\n    });\n\n    if (!response.ok) {\n      throw new MysaApiError(response);\n    }\n\n    return response.json();\n  }\n\n  async getDeviceFirmwares(): Promise<Firmwares> {\n    this._logger.debug(`Fetching device firmwares...`);\n\n    const session = await this.getFreshSession();\n\n    const response = await this._fetcher(`${MysaApiBaseUrl}/devices/firmware`, {\n      headers: {\n        Authorization: `${session.getIdToken().getJwtToken()}`\n      }\n    });\n\n    if (!response.ok) {\n      throw new MysaApiError(response);\n    }\n\n    return response.json();\n  }\n\n  async getDeviceStates(): Promise<DeviceStates> {\n    this._logger.debug(`Fetching device states...`);\n\n    const session = await this.getFreshSession();\n\n    const response = await this._fetcher(`${MysaApiBaseUrl}/devices/state`, {\n      headers: {\n        Authorization: `${session.getIdToken().getJwtToken()}`\n      }\n    });\n\n    if (!response.ok) {\n      throw new MysaApiError(response);\n    }\n\n    return response.json();\n  }\n\n  async setDeviceState(deviceId: string, setPoint?: number, mode?: MysaDeviceMode) {\n    this._logger.debug(`Setting device state for '${deviceId}'`);\n\n    if (!this._cachedDevices) {\n      this._cachedDevices = await this.getDevices();\n    }\n\n    const device = this._cachedDevices.DevicesObj[deviceId];\n\n    this._logger.debug(`Initializing MQTT connection...`);\n    const mqttConnection = await this.getMqttConnection();\n\n    const now = dayjs();\n\n    this._logger.debug(`Sending request to set device state for '${deviceId}'...`);\n    const payload = serializeMqttPayload<ChangeDeviceState>({\n      msg: InMessageType.CHANGE_DEVICE_STATE,\n      id: now.unix(),\n      time: now.unix(),\n      ver: '1.0',\n      src: {\n        ref: this.session!.username,\n        type: 100\n      },\n      dest: {\n        ref: deviceId,\n        type: 1\n      },\n      resp: 2,\n      body: {\n        ver: 1,\n        type: device.Model.startsWith('BB-V1')\n          ? 1\n          : device.Model.startsWith('BB-V2')\n            ? device.Model.endsWith('-L')\n              ? 5\n              : 4\n            : 0,\n        cmd: [\n          {\n            tm: -1,\n            sp: setPoint,\n            md: mode === 'off' ? 1 : mode === 'heat' ? 3 : undefined\n          }\n        ]\n      }\n    });\n\n    await mqttConnection.publish(`/v1/dev/${deviceId}/in`, payload, mqtt.QoS.AtLeastOnce);\n  }\n\n  /**\n   * Starts receiving real-time updates for the specified device.\n   *\n   * @param deviceId - The ID of the device to start receiving updates for.\n   */\n  async startRealtimeUpdates(deviceId: string) {\n    this._logger.info(`Starting real-time updates for device '${deviceId}'`);\n\n    if (this._realtimeDeviceIds.has(deviceId)) {\n      this._logger.debug(`Real-time updates for device '${deviceId}' already started`);\n      return;\n    }\n\n    this._logger.debug(`Initializing MQTT connection...`);\n    const mqttConnection = await this.getMqttConnection();\n\n    this._logger.debug(`Subscribing to MQTT topic '/v1/dev/${deviceId}/out'...`);\n    await mqttConnection.subscribe(`/v1/dev/${deviceId}/out`, mqtt.QoS.AtLeastOnce, (_, payload) => {\n      this.processMqttMessage(payload);\n    });\n\n    this._logger.debug(`Sending request to start publishing device status for '${deviceId}'...`);\n    const payload = serializeMqttPayload<StartPublishingDeviceStatus>({\n      Device: deviceId,\n      MsgType: InMessageType.START_PUBLISHING_DEVICE_STATUS,\n      Timestamp: dayjs().unix(),\n      Timeout: RealtimeKeepAliveInterval.asSeconds()\n    });\n    await mqttConnection.publish(`/v1/dev/${deviceId}/in`, payload, mqtt.QoS.AtLeastOnce);\n\n    const timer = setInterval(async () => {\n      this._logger.debug(`Sending request to keep-alive publishing device status for '${deviceId}'...`);\n      const payload = serializeMqttPayload<StartPublishingDeviceStatus>({\n        Device: deviceId,\n        MsgType: InMessageType.START_PUBLISHING_DEVICE_STATUS,\n        Timestamp: dayjs().unix(),\n        Timeout: RealtimeKeepAliveInterval.asSeconds()\n      });\n      await mqttConnection.publish(`/v1/dev/${deviceId}/in`, payload, mqtt.QoS.AtLeastOnce);\n    }, RealtimeKeepAliveInterval.subtract(10, 'seconds').asMilliseconds());\n\n    this._realtimeDeviceIds.set(deviceId, timer);\n  }\n\n  /**\n   * Stops receiving real-time updates for the specified device.\n   *\n   * @param deviceId - The ID of the device to stop receiving real-time updates for.\n   */\n  async stopRealtimeUpdates(deviceId: string) {\n    this._logger.info(`Stopping real-time updates for device '${deviceId}'`);\n\n    const timer = this._realtimeDeviceIds.get(deviceId);\n    if (!timer) {\n      this._logger.warn(`No real-time updates are running for device '${deviceId}'`);\n      return;\n    }\n\n    this._logger.debug(`Initializing MQTT connection...`);\n    const mqttConnection = await this.getMqttConnection();\n\n    this._logger.debug(`Unsubscribing to MQTT topic '/v1/dev/${deviceId}/out'...`);\n    await mqttConnection.unsubscribe(`/v1/dev/${deviceId}/out`);\n\n    clearInterval(timer);\n    this._realtimeDeviceIds.delete(deviceId);\n  }\n\n  private async getFreshSession(): Promise<CognitoUserSession> {\n    if (!this._cognitoUser || !this._cognitoUserSession) {\n      throw new UnauthenticatedError('An attempt was made to access a resource without a valid session.');\n    }\n\n    if (\n      this._cognitoUserSession.isValid() &&\n      dayjs.unix(this._cognitoUserSession.getIdToken().getExpiration()).isAfter()\n    ) {\n      this._logger.debug('Session is valid, no need to refresh');\n      return Promise.resolve(this._cognitoUserSession);\n    }\n\n    this._logger.debug('Session is not valid or expired, refreshing...');\n    return new Promise<CognitoUserSession>((resolve, reject) => {\n      this._cognitoUser!.refreshSession(this._cognitoUserSession!.getRefreshToken(), (error, session) => {\n        if (error) {\n          this._logger.error('Failed to refresh session:', error);\n          reject(new UnauthenticatedError('Unable to refresh the authentication session.'));\n        } else {\n          this._logger.debug('Session refreshed successfully');\n          this._cognitoUserSession = session;\n          this.emitter.emit('sessionChanged', this.session);\n          resolve(session);\n        }\n      });\n    });\n  }\n\n  private async getMqttConnection(): Promise<mqtt.MqttClientConnection> {\n    if (this._mqttConnection) {\n      return this._mqttConnection;\n    }\n\n    const session = await this.getFreshSession();\n    const credentialsProvider = fromCognitoIdentityPool({\n      clientConfig: {\n        region: AwsRegion\n      },\n      identityPoolId: CognitoIdentityPoolId,\n      logins: {\n        [CognitoLoginKey]: session.getIdToken().getJwtToken()\n      },\n      logger: this._logger\n    });\n    const credentials = await credentialsProvider();\n\n    const builder = iot.AwsIotMqttConnectionConfigBuilder.new_with_websockets()\n      .with_credentials(AwsRegion, credentials.accessKeyId, credentials.secretAccessKey, credentials.sessionToken)\n      .with_endpoint(MqttEndpoint)\n      .with_client_id(`mysa-js-sdk-${dayjs().unix()}`) // Unique client ID\n      .with_clean_session(true)\n      .with_keep_alive_seconds(30)\n      .with_ping_timeout_ms(3000)\n      .with_protocol_operation_timeout_ms(60000);\n\n    const config = builder.build();\n    const client = new mqtt.MqttClient();\n    this._mqttConnection = client.new_connection(config);\n\n    this._mqttConnection.on('closed', () => {\n      this._logger.info('MQTT connection closed');\n      this._mqttConnection = undefined;\n    });\n\n    await this._mqttConnection.connect();\n\n    return this._mqttConnection;\n  }\n\n  private processMqttMessage(payload: ArrayBuffer) {\n    try {\n      const parsedPayload = parseMqttPayload(payload);\n\n      this.emitter.emit('rawRealtimeMessageReceived', parsedPayload);\n\n      if (isMsgTypeOutPayload(parsedPayload)) {\n        switch (parsedPayload.MsgType) {\n          case OutMessageType.DEVICE_V1_STATUS:\n            this.emitter.emit('statusChanged', {\n              deviceId: parsedPayload.Device,\n              temperature: parsedPayload.MainTemp,\n              humidity: parsedPayload.Humidity,\n              setPoint: parsedPayload.SetPoint,\n              current: parsedPayload.Current\n            });\n            break;\n\n          case OutMessageType.DEVICE_SETPOINT_CHANGE:\n            this.emitter.emit('setPointChanged', {\n              deviceId: parsedPayload.Device,\n              newSetPoint: parsedPayload.Next,\n              previousSetPoint: parsedPayload.Prev\n            });\n            break;\n        }\n      } else if (isMsgOutPayload(parsedPayload)) {\n        switch (parsedPayload.msg) {\n          case OutMessageType.DEVICE_V2_STATUS:\n            this.emitter.emit('statusChanged', {\n              deviceId: parsedPayload.src.ref,\n              temperature: parsedPayload.body.ambTemp,\n              humidity: parsedPayload.body.hum,\n              setPoint: parsedPayload.body.stpt,\n              dutyCycle: parsedPayload.body.dtyCycle\n            });\n            break;\n\n          case OutMessageType.DEVICE_STATE_CHANGE:\n            this.emitter.emit('stateChanged', {\n              deviceId: parsedPayload.src.ref,\n              mode: parsedPayload.body.state.md === 1 ? 'off' : parsedPayload.body.state.md === 3 ? 'heat' : undefined,\n              setPoint: parsedPayload.body.state.sp\n            });\n            break;\n        }\n      }\n    } catch (error) {\n      this._logger.error('Error handling MQTT message:', error);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCO,IAAM,uBAAN,cAAmC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM9C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,eAAN,cAA2B,MAAM;AAAA;AAAA,EAE7B;AAAA;AAAA,EAEA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,YAAY,aAAuB;AACjC;AAAA,MACE,uBAAuB,YAAY,GAAG,8DAA8D,YAAY,MAAM,KAAK,YAAY,UAAU;AAAA,IACnJ;AACA,SAAK,OAAO;AACZ,SAAK,SAAS,YAAY;AAC1B,SAAK,aAAa,YAAY;AAAA,EAChC;AACF;;;AChBO,IAAM,aAAN,MAAmC;AAAA,EACxC,MAAM,YAAoB,MAAuB;AAAA,EAAC;AAAA,EAClD,KAAK,YAAoB,MAAuB;AAAA,EAAC;AAAA,EACjD,KAAK,YAAoB,MAAuB;AAAA,EAAC;AAAA,EACjD,MAAM,YAAoB,MAAuB;AAAA,EAAC;AACpD;;;ACtBA,yBAAiD;AAS1C,IAAM,eAAN,MAAuF;AAAA,EACpF,WAAW,IAAI,mBAAAA,aAAiB;AAAA,EAExC,KAAgD,cAA0B,UAA+B;AACvG,WAAO,KAAK,SAAS,KAAK,WAAW,GAAI,QAAe;AAAA,EAC1D;AAAA,EAEA,GACE,WACA,SACA;AACA,SAAK,SAAS,GAAG,WAAW,OAAc;AAC1C,WAAO;AAAA,EACT;AAAA,EAEA,KACE,WACA,SACA;AACA,SAAK,SAAS,KAAK,WAAW,OAAc;AAC5C,WAAO;AAAA,EACT;AAAA,EAEA,IACE,WACA,SACA;AACA,SAAK,SAAS,IAAI,WAAW,OAAc;AAC3C,WAAO;AAAA,EACT;AAAA,EAEA,YACE,WACA,UACA;AACA,SAAK,SAAS,YAAY,WAAW,QAAQ;AAC7C,WAAO;AAAA,EACT;AAAA,EAEA,eACE,WACA,UACA;AACA,SAAK,SAAS,eAAe,WAAW,QAAQ;AAChD,WAAO;AAAA,EACT;AAAA,EAEA,mBAA8D,WAAoC;AAChG,SAAK,SAAS,mBAAmB,SAAS;AAC1C,WAAO;AAAA,EACT;AAAA,EAEA,gBAAgB,GAAW;AACzB,SAAK,SAAS,gBAAgB,CAAC;AAC/B,WAAO;AAAA,EACT;AAAA,EAEA,kBAA0B;AACxB,WAAO,KAAK,SAAS,gBAAgB;AAAA,EACvC;AAAA,EAEA,UAAqD,WAAuB;AAC1E,WAAO,KAAK,SAAS,UAAU,SAAS;AAAA,EAC1C;AAAA,EAEA,aAAwD,WAAuB;AAC7E,WAAO,KAAK,SAAS,aAAa,SAAS;AAAA,EAC7C;AAAA,EAEA,cACE,WACA,UACA;AACA,WAAO,KAAK,SAAS,cAAc,WAAW,QAAQ;AAAA,EACxD;AAAA,EAEA,gBACE,WACA,UACA;AACA,SAAK,SAAS,gBAAgB,WAAW,QAAQ;AACjD,WAAO;AAAA,EACT;AAAA,EAEA,oBACE,WACA,UACA;AACA,SAAK,SAAS,oBAAoB,WAAW,QAAQ;AACrD,WAAO;AAAA,EACT;AAAA,EAEA,aAAa;AACX,WAAO,KAAK,SAAS,WAAW;AAAA,EAClC;AACF;;;AC3FO,SAAS,iBAAiB,SAAkC;AACjE,MAAI;AACF,UAAM,UAAU,IAAI,YAAY,OAAO;AACvC,UAAM,aAAa,QAAQ,OAAO,OAAO;AACzC,WAAO,KAAK,MAAM,UAAU;AAAA,EAC9B,SAAS,OAAO;AACd,YAAQ,MAAM,+BAA+B,KAAK;AAClD,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD;AACF;AAYO,SAAS,qBAA0C,SAAyB;AACjF,QAAM,aAAa,KAAK,UAAU,OAAO;AACzC,QAAM,UAAU,IAAI,YAAY;AAChC,SAAO,QAAQ,OAAO,UAAU;AAClC;;;ACzBO,SAAS,oBAAoB,SAAmD;AACrF,SAAO,aAAa;AACtB;AAWO,SAAS,gBAAgB,SAA+C;AAC7E,SAAO,SAAS;AAClB;;;ACtBO,IAAK,gBAAL,kBAAKC,mBAAL;AAML,EAAAA,8BAAA,2BAAwB,KAAxB;AAGA,EAAAA,8BAAA,oCAAiC,MAAjC;AAOA,EAAAA,8BAAA,yBAAsB,MAAtB;AAhBU,SAAAA;AAAA,GAAA;;;ACAL,IAAK,iBAAL,kBAAKC,oBAAL;AAML,EAAAA,gCAAA,sBAAmB,KAAnB;AAGA,EAAAA,gCAAA,4BAAyB,KAAzB;AAGA,EAAAA,gCAAA,gBAAa,KAAb;AAGA,EAAAA,gCAAA,sBAAmB,MAAnB;AAOA,EAAAA,gCAAA,sBAAmB,MAAnB;AAGA,EAAAA,gCAAA,yBAAsB,MAAtB;AAzBU,SAAAA;AAAA,GAAA;;;ACGZ,kCAAwC;AACxC,wCAQO;AACP,mCAA0B;AAC1B,mBAAkB;AAClB,sBAAqB;AAOrB,aAAAC,QAAM,OAAO,gBAAAC,OAAQ;AAErB,IAAM,YAAY;AAClB,IAAM,oBAAoB;AAC1B,IAAM,kBAAkB;AACxB,IAAM,wBAAwB;AAC9B,IAAM,kBAAkB,eAAe,SAAS,kBAAkB,iBAAiB;AACnF,IAAM,eAAe;AACrB,IAAM,iBAAiB;AACvB,IAAM,4BAA4B,aAAAD,QAAM,SAAS,GAAG,SAAS;AA0BtD,IAAM,gBAAN,MAAoB;AAAA;AAAA,EAEjB;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA,qBAAkD,oBAAI,IAAI;AAAA;AAAA,EAG1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOC,UAAU,IAAI,aAAsC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7D,IAAI,UAAmC;AACrC,QAAI,CAAC,KAAK,uBAAuB,CAAC,KAAK,cAAc;AACnD,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,UAAU,KAAK,aAAa,YAAY;AAAA,MACxC,SAAS,KAAK,oBAAoB,WAAW,EAAE,YAAY;AAAA,MAC3D,aAAa,KAAK,oBAAoB,eAAe,EAAE,YAAY;AAAA,MACnE,cAAc,KAAK,oBAAoB,gBAAgB,EAAE,SAAS;AAAA,IACpE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,kBAA2B;AAC7B,WAAO,CAAC,CAAC,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,SAAuB,SAAgC;AACjE,SAAK,WAAU,mCAAS,WAAU,IAAI,WAAW;AACjD,SAAK,YAAW,mCAAS,YAAW;AAEpC,QAAI,SAAS;AACX,WAAK,eAAe,IAAI,8CAAY;AAAA,QAClC,UAAU,QAAQ;AAAA,QAClB,MAAM,IAAI,kDAAgB,EAAE,YAAY,mBAAmB,UAAU,gBAAgB,CAAC;AAAA,MACxF,CAAC;AACD,WAAK,sBAAsB,IAAI,qDAAmB;AAAA,QAChD,SAAS,IAAI,iDAAe,EAAE,SAAS,QAAQ,QAAQ,CAAC;AAAA,QACxD,aAAa,IAAI,qDAAmB,EAAE,aAAa,QAAQ,YAAY,CAAC;AAAA,QACxE,cAAc,IAAI,sDAAoB,EAAE,cAAc,QAAQ,aAAa,CAAC;AAAA,MAC9E,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,MAAM,cAAsB,UAAiC;AACjE,SAAK,eAAe;AACpB,SAAK,sBAAsB;AAC3B,SAAK,QAAQ,KAAK,kBAAkB,KAAK,OAAO;AAEhD,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,OAAO,IAAI,8CAAY;AAAA,QAC3B,UAAU;AAAA,QACV,MAAM,IAAI,kDAAgB,EAAE,YAAY,mBAAmB,UAAU,gBAAgB,CAAC;AAAA,MACxF,CAAC;AAED,WAAK,iBAAiB,IAAI,wDAAsB,EAAE,UAAU,cAAc,UAAU,SAAS,CAAC,GAAG;AAAA,QAC/F,WAAW,CAAC,YAAY;AACtB,eAAK,eAAe;AACpB,eAAK,sBAAsB;AAC3B,eAAK,QAAQ,KAAK,kBAAkB,KAAK,OAAO;AAEhD,kBAAQ;AAAA,QACV;AAAA,QACA,WAAW,CAAC,QAAQ;AAClB,iBAAO,GAAG;AAAA,QACZ;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAA+B;AACnC,SAAK,QAAQ,MAAM,qBAAqB;AAExC,UAAM,UAAU,MAAM,KAAK,gBAAgB;AAE3C,UAAM,WAAW,MAAM,KAAK,SAAS,GAAG,cAAc,YAAY;AAAA,MAChE,SAAS;AAAA,QACP,eAAe,GAAG,QAAQ,WAAW,EAAE,YAAY,CAAC;AAAA,MACtD;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,aAAa,QAAQ;AAAA,IACjC;AAEA,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,qBAAyC;AAC7C,SAAK,QAAQ,MAAM,8BAA8B;AAEjD,UAAM,UAAU,MAAM,KAAK,gBAAgB;AAE3C,UAAM,WAAW,MAAM,KAAK,SAAS,GAAG,cAAc,qBAAqB;AAAA,MACzE,SAAS;AAAA,QACP,eAAe,GAAG,QAAQ,WAAW,EAAE,YAAY,CAAC;AAAA,MACtD;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,aAAa,QAAQ;AAAA,IACjC;AAEA,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,kBAAyC;AAC7C,SAAK,QAAQ,MAAM,2BAA2B;AAE9C,UAAM,UAAU,MAAM,KAAK,gBAAgB;AAE3C,UAAM,WAAW,MAAM,KAAK,SAAS,GAAG,cAAc,kBAAkB;AAAA,MACtE,SAAS;AAAA,QACP,eAAe,GAAG,QAAQ,WAAW,EAAE,YAAY,CAAC;AAAA,MACtD;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,aAAa,QAAQ;AAAA,IACjC;AAEA,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,eAAe,UAAkB,UAAmB,MAAuB;AAC/E,SAAK,QAAQ,MAAM,6BAA6B,QAAQ,GAAG;AAE3D,QAAI,CAAC,KAAK,gBAAgB;AACxB,WAAK,iBAAiB,MAAM,KAAK,WAAW;AAAA,IAC9C;AAEA,UAAM,SAAS,KAAK,eAAe,WAAW,QAAQ;AAEtD,SAAK,QAAQ,MAAM,iCAAiC;AACpD,UAAM,iBAAiB,MAAM,KAAK,kBAAkB;AAEpD,UAAM,UAAM,aAAAA,SAAM;AAElB,SAAK,QAAQ,MAAM,4CAA4C,QAAQ,MAAM;AAC7E,UAAM,UAAU,qBAAwC;AAAA,MACtD;AAAA,MACA,IAAI,IAAI,KAAK;AAAA,MACb,MAAM,IAAI,KAAK;AAAA,MACf,KAAK;AAAA,MACL,KAAK;AAAA,QACH,KAAK,KAAK,QAAS;AAAA,QACnB,MAAM;AAAA,MACR;AAAA,MACA,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,MAAM;AAAA,MACR;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,QACJ,KAAK;AAAA,QACL,MAAM,OAAO,MAAM,WAAW,OAAO,IACjC,IACA,OAAO,MAAM,WAAW,OAAO,IAC7B,OAAO,MAAM,SAAS,IAAI,IACxB,IACA,IACF;AAAA,QACN,KAAK;AAAA,UACH;AAAA,YACE,IAAI;AAAA,YACJ,IAAI;AAAA,YACJ,IAAI,SAAS,QAAQ,IAAI,SAAS,SAAS,IAAI;AAAA,UACjD;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAED,UAAM,eAAe,QAAQ,WAAW,QAAQ,OAAO,SAAS,kCAAK,IAAI,WAAW;AAAA,EACtF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,qBAAqB,UAAkB;AAC3C,SAAK,QAAQ,KAAK,0CAA0C,QAAQ,GAAG;AAEvE,QAAI,KAAK,mBAAmB,IAAI,QAAQ,GAAG;AACzC,WAAK,QAAQ,MAAM,iCAAiC,QAAQ,mBAAmB;AAC/E;AAAA,IACF;AAEA,SAAK,QAAQ,MAAM,iCAAiC;AACpD,UAAM,iBAAiB,MAAM,KAAK,kBAAkB;AAEpD,SAAK,QAAQ,MAAM,sCAAsC,QAAQ,UAAU;AAC3E,UAAM,eAAe,UAAU,WAAW,QAAQ,QAAQ,kCAAK,IAAI,aAAa,CAAC,GAAGE,aAAY;AAC9F,WAAK,mBAAmBA,QAAO;AAAA,IACjC,CAAC;AAED,SAAK,QAAQ,MAAM,0DAA0D,QAAQ,MAAM;AAC3F,UAAM,UAAU,qBAAkD;AAAA,MAChE,QAAQ;AAAA,MACR;AAAA,MACA,eAAW,aAAAF,SAAM,EAAE,KAAK;AAAA,MACxB,SAAS,0BAA0B,UAAU;AAAA,IAC/C,CAAC;AACD,UAAM,eAAe,QAAQ,WAAW,QAAQ,OAAO,SAAS,kCAAK,IAAI,WAAW;AAEpF,UAAM,QAAQ,YAAY,YAAY;AACpC,WAAK,QAAQ,MAAM,+DAA+D,QAAQ,MAAM;AAChG,YAAME,WAAU,qBAAkD;AAAA,QAChE,QAAQ;AAAA,QACR;AAAA,QACA,eAAW,aAAAF,SAAM,EAAE,KAAK;AAAA,QACxB,SAAS,0BAA0B,UAAU;AAAA,MAC/C,CAAC;AACD,YAAM,eAAe,QAAQ,WAAW,QAAQ,OAAOE,UAAS,kCAAK,IAAI,WAAW;AAAA,IACtF,GAAG,0BAA0B,SAAS,IAAI,SAAS,EAAE,eAAe,CAAC;AAErE,SAAK,mBAAmB,IAAI,UAAU,KAAK;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAoB,UAAkB;AAC1C,SAAK,QAAQ,KAAK,0CAA0C,QAAQ,GAAG;AAEvE,UAAM,QAAQ,KAAK,mBAAmB,IAAI,QAAQ;AAClD,QAAI,CAAC,OAAO;AACV,WAAK,QAAQ,KAAK,gDAAgD,QAAQ,GAAG;AAC7E;AAAA,IACF;AAEA,SAAK,QAAQ,MAAM,iCAAiC;AACpD,UAAM,iBAAiB,MAAM,KAAK,kBAAkB;AAEpD,SAAK,QAAQ,MAAM,wCAAwC,QAAQ,UAAU;AAC7E,UAAM,eAAe,YAAY,WAAW,QAAQ,MAAM;AAE1D,kBAAc,KAAK;AACnB,SAAK,mBAAmB,OAAO,QAAQ;AAAA,EACzC;AAAA,EAEA,MAAc,kBAA+C;AAC3D,QAAI,CAAC,KAAK,gBAAgB,CAAC,KAAK,qBAAqB;AACnD,YAAM,IAAI,qBAAqB,mEAAmE;AAAA,IACpG;AAEA,QACE,KAAK,oBAAoB,QAAQ,KACjC,aAAAF,QAAM,KAAK,KAAK,oBAAoB,WAAW,EAAE,cAAc,CAAC,EAAE,QAAQ,GAC1E;AACA,WAAK,QAAQ,MAAM,sCAAsC;AACzD,aAAO,QAAQ,QAAQ,KAAK,mBAAmB;AAAA,IACjD;AAEA,SAAK,QAAQ,MAAM,gDAAgD;AACnE,WAAO,IAAI,QAA4B,CAAC,SAAS,WAAW;AAC1D,WAAK,aAAc,eAAe,KAAK,oBAAqB,gBAAgB,GAAG,CAAC,OAAO,YAAY;AACjG,YAAI,OAAO;AACT,eAAK,QAAQ,MAAM,8BAA8B,KAAK;AACtD,iBAAO,IAAI,qBAAqB,+CAA+C,CAAC;AAAA,QAClF,OAAO;AACL,eAAK,QAAQ,MAAM,gCAAgC;AACnD,eAAK,sBAAsB;AAC3B,eAAK,QAAQ,KAAK,kBAAkB,KAAK,OAAO;AAChD,kBAAQ,OAAO;AAAA,QACjB;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,oBAAwD;AACpE,QAAI,KAAK,iBAAiB;AACxB,aAAO,KAAK;AAAA,IACd;AAEA,UAAM,UAAU,MAAM,KAAK,gBAAgB;AAC3C,UAAM,0BAAsB,qDAAwB;AAAA,MAClD,cAAc;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,MACA,gBAAgB;AAAA,MAChB,QAAQ;AAAA,QACN,CAAC,eAAe,GAAG,QAAQ,WAAW,EAAE,YAAY;AAAA,MACtD;AAAA,MACA,QAAQ,KAAK;AAAA,IACf,CAAC;AACD,UAAM,cAAc,MAAM,oBAAoB;AAE9C,UAAM,UAAU,iCAAI,kCAAkC,oBAAoB,EACvE,iBAAiB,WAAW,YAAY,aAAa,YAAY,iBAAiB,YAAY,YAAY,EAC1G,cAAc,YAAY,EAC1B,eAAe,mBAAe,aAAAA,SAAM,EAAE,KAAK,CAAC,EAAE,EAC9C,mBAAmB,IAAI,EACvB,wBAAwB,EAAE,EAC1B,qBAAqB,GAAI,EACzB,mCAAmC,GAAK;AAE3C,UAAM,SAAS,QAAQ,MAAM;AAC7B,UAAM,SAAS,IAAI,kCAAK,WAAW;AACnC,SAAK,kBAAkB,OAAO,eAAe,MAAM;AAEnD,SAAK,gBAAgB,GAAG,UAAU,MAAM;AACtC,WAAK,QAAQ,KAAK,wBAAwB;AAC1C,WAAK,kBAAkB;AAAA,IACzB,CAAC;AAED,UAAM,KAAK,gBAAgB,QAAQ;AAEnC,WAAO,KAAK;AAAA,EACd;AAAA,EAEQ,mBAAmB,SAAsB;AAC/C,QAAI;AACF,YAAM,gBAAgB,iBAAiB,OAAO;AAE9C,WAAK,QAAQ,KAAK,8BAA8B,aAAa;AAE7D,UAAI,oBAAoB,aAAa,GAAG;AACtC,gBAAQ,cAAc,SAAS;AAAA,UAC7B;AACE,iBAAK,QAAQ,KAAK,iBAAiB;AAAA,cACjC,UAAU,cAAc;AAAA,cACxB,aAAa,cAAc;AAAA,cAC3B,UAAU,cAAc;AAAA,cACxB,UAAU,cAAc;AAAA,cACxB,SAAS,cAAc;AAAA,YACzB,CAAC;AACD;AAAA,UAEF;AACE,iBAAK,QAAQ,KAAK,mBAAmB;AAAA,cACnC,UAAU,cAAc;AAAA,cACxB,aAAa,cAAc;AAAA,cAC3B,kBAAkB,cAAc;AAAA,YAClC,CAAC;AACD;AAAA,QACJ;AAAA,MACF,WAAW,gBAAgB,aAAa,GAAG;AACzC,gBAAQ,cAAc,KAAK;AAAA,UACzB;AACE,iBAAK,QAAQ,KAAK,iBAAiB;AAAA,cACjC,UAAU,cAAc,IAAI;AAAA,cAC5B,aAAa,cAAc,KAAK;AAAA,cAChC,UAAU,cAAc,KAAK;AAAA,cAC7B,UAAU,cAAc,KAAK;AAAA,cAC7B,WAAW,cAAc,KAAK;AAAA,YAChC,CAAC;AACD;AAAA,UAEF;AACE,iBAAK,QAAQ,KAAK,gBAAgB;AAAA,cAChC,UAAU,cAAc,IAAI;AAAA,cAC5B,MAAM,cAAc,KAAK,MAAM,OAAO,IAAI,QAAQ,cAAc,KAAK,MAAM,OAAO,IAAI,SAAS;AAAA,cAC/F,UAAU,cAAc,KAAK,MAAM;AAAA,YACrC,CAAC;AACD;AAAA,QACJ;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,WAAK,QAAQ,MAAM,gCAAgC,KAAK;AAAA,IAC1D;AAAA,EACF;AACF;","names":["NodeEventEmitter","InMessageType","OutMessageType","dayjs","duration","payload"]}
+{"version":3,"sources":["../src/index.ts","../src/api/Errors.ts","../src/api/Logger.ts","../src/lib/EventEmitter.ts","../src/lib/PayloadParser.ts","../src/lib/PayloadTypeGuards.ts","../src/types/mqtt/in/InMessageType.ts","../src/types/mqtt/out/OutMessageType.ts","../src/api/MysaApiClient.ts"],"sourcesContent":["export * from './api';\nexport * from './types';\n","/** Error thrown when attempting to access the Mysa API without proper authentication. */\nexport class UnauthenticatedError extends Error {\n  /**\n   * Creates a new UnauthenticatedError instance.\n   *\n   * @param message - The error message\n   */\n  constructor(message: string) {\n    super(message);\n    this.name = 'UnauthenticatedError';\n  }\n}\n\n/** Error thrown when a Mysa API request fails. */\nexport class MysaApiError extends Error {\n  /** The HTTP status code returned by the API */\n  readonly status: number;\n  /** The HTTP status text returned by the API */\n  readonly statusText: string;\n\n  /**\n   * Creates a new MysaApiError instance.\n   *\n   * @param apiResponse - The failed Response object from the API call\n   */\n  constructor(apiResponse: Response) {\n    super(\n      `Failed to call the '${apiResponse.url}' Mysa API endpoint. The server responded with a status of ${apiResponse.status} (${apiResponse.statusText}).`\n    );\n    this.name = 'MysaApiError';\n    this.status = apiResponse.status;\n    this.statusText = apiResponse.statusText;\n  }\n}\n","/** Interface for logging operations at different severity levels */\nexport interface Logger {\n  /** Logs a debug message with optional metadata */\n  debug(message: string, ...meta: unknown[]): void;\n\n  /** Logs an info message with optional metadata */\n  info(message: string, ...meta: unknown[]): void;\n\n  /** Logs a warning message with optional metadata */\n  warn(message: string, ...meta: unknown[]): void;\n\n  /** Logs an error message with optional metadata */\n  error(message: string, ...meta: unknown[]): void;\n}\n\n/** Logger implementation that silently discards all log messages. */\n/* eslint-disable @typescript-eslint/no-unused-vars */\nexport class VoidLogger implements Logger {\n  debug(message: string, ...meta: unknown[]): void {}\n  info(message: string, ...meta: unknown[]): void {}\n  warn(message: string, ...meta: unknown[]): void {}\n  error(message: string, ...meta: unknown[]): void {}\n}\n/* eslint-enable @typescript-eslint/no-unused-vars */\n","import { EventEmitter as NodeEventEmitter } from 'node:events';\n\n/**\n * Typed wrapper around Node's `EventEmitter` class.\n *\n * @remarks\n * Source: {@link https://blog.makerx.com.au/a-type-safe-event-emitter-in-node-js}\n */\n/* eslint-disable @typescript-eslint/no-explicit-any */\nexport class EventEmitter<TEvents extends Record<string, any>> implements NodeJS.EventEmitter {\n  private _emitter = new NodeEventEmitter();\n\n  emit<TEventName extends keyof TEvents & string>(eventName: TEventName, ...eventArg: TEvents[TEventName]) {\n    return this._emitter.emit(eventName, ...(eventArg as []));\n  }\n\n  on<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    handler: (...eventArg: TEvents[TEventName]) => void\n  ) {\n    this._emitter.on(eventName, handler as any);\n    return this;\n  }\n\n  once<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    handler: (...eventArg: TEvents[TEventName]) => void\n  ) {\n    this._emitter.once(eventName, handler as any);\n    return this;\n  }\n\n  off<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    handler: (...eventArg: TEvents[TEventName]) => void\n  ) {\n    this._emitter.off(eventName, handler as any);\n    return this;\n  }\n\n  addListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.addListener(eventName, listener);\n    return this;\n  }\n\n  removeListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.removeListener(eventName, listener);\n    return this;\n  }\n\n  removeAllListeners<TEventName extends keyof TEvents & string>(eventName?: TEventName | undefined) {\n    this._emitter.removeAllListeners(eventName);\n    return this;\n  }\n\n  setMaxListeners(n: number) {\n    this._emitter.setMaxListeners(n);\n    return this;\n  }\n\n  getMaxListeners(): number {\n    return this._emitter.getMaxListeners();\n  }\n\n  listeners<TEventName extends keyof TEvents & string>(eventName: TEventName) {\n    return this._emitter.listeners(eventName);\n  }\n\n  rawListeners<TEventName extends keyof TEvents & string>(eventName: TEventName) {\n    return this._emitter.rawListeners(eventName);\n  }\n\n  listenerCount<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener?: (...args: TEvents[TEventName]) => void\n  ) {\n    return this._emitter.listenerCount(eventName, listener);\n  }\n\n  prependListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.prependListener(eventName, listener);\n    return this;\n  }\n\n  prependOnceListener<TEventName extends keyof TEvents & string>(\n    eventName: TEventName,\n    listener: (...args: TEvents[TEventName]) => void\n  ) {\n    this._emitter.prependOnceListener(eventName, listener);\n    return this;\n  }\n\n  eventNames() {\n    return this._emitter.eventNames();\n  }\n}\n/* eslint-enable @typescript-eslint/no-explicit-any */\n","import { InPayload } from '@/types/mqtt/InPayload';\nimport { OutPayload } from '@/types/mqtt/OutPayload';\n\n/**\n * Parses an MQTT payload from binary data into a typed OutPayload object.\n *\n * Converts the raw ArrayBuffer received from MQTT messages into a structured TypeScript object representing device\n * status, state changes, or other outgoing message types from Mysa devices.\n *\n * @param payload - The raw binary MQTT message payload as ArrayBuffer\n * @returns The parsed payload as a typed OutPayload object\n * @throws Error if the payload cannot be decoded or parsed as valid JSON\n */\nexport function parseMqttPayload(payload: ArrayBuffer): OutPayload {\n  try {\n    const decoder = new TextDecoder('utf-8');\n    const jsonString = decoder.decode(payload);\n    return JSON.parse(jsonString);\n  } catch (error) {\n    console.error('Error parsing MQTT payload:', error);\n    throw new Error('Failed to parse MQTT payload');\n  }\n}\n\n/**\n * Serializes an InPayload object into binary data for MQTT transmission.\n *\n * Converts a typed TypeScript payload object into the binary ArrayBuffer format required for sending commands and\n * requests to Mysa devices via MQTT.\n *\n * @typeParam T - The specific InPayload type being serialized\n * @param payload - The typed payload object to serialize\n * @returns The serialized payload as ArrayBuffer ready for MQTT transmission\n */\nexport function serializeMqttPayload<T extends InPayload>(payload: T): ArrayBuffer {\n  const jsonString = JSON.stringify(payload);\n  const encoder = new TextEncoder();\n  return encoder.encode(jsonString);\n}\n","import { MsgOutPayload } from '@/types/mqtt/MsgOutPayload';\nimport { MsgTypeOutPayload } from '@/types/mqtt/MsgTypeOutPayload';\nimport { OutPayload } from '@/types/mqtt/OutPayload';\n\n/**\n * Type guard function to determine if an OutPayload is a MsgType-based payload.\n *\n * Checks whether the payload uses the legacy MsgType field format for message type identification. This is used to\n * differentiate between different payload structures and ensure proper type narrowing in TypeScript.\n *\n * @param payload - The OutPayload to check\n * @returns True if the payload is a MsgTypeOutPayload, false otherwise\n */\nexport function isMsgTypeOutPayload(payload: OutPayload): payload is MsgTypeOutPayload {\n  return 'MsgType' in payload;\n}\n\n/**\n * Type guard function to determine if an OutPayload is a message-based payload.\n *\n * Checks whether the payload uses the newer msg field format for message type identification. This is used to\n * differentiate between different payload structures and ensure proper type narrowing in TypeScript.\n *\n * @param payload - The OutPayload to check\n * @returns True if the payload is a MsgOutPayload, false otherwise\n */\nexport function isMsgOutPayload(payload: OutPayload): payload is MsgOutPayload {\n  return 'msg' in payload;\n}\n","/**\n * Enumeration of message types for incoming MQTT messages from clients to devices.\n *\n * These message types determine how commands and requests are interpreted by Mysa devices. The enum values correspond\n * to specific numeric identifiers used in the MQTT protocol.\n */\nexport enum InMessageType {\n  //\n  // When the message type is reported in the `MsgType` field of the payload.\n  //\n\n  /** Request to check and retrieve current device settings */\n  CHECK_DEVICE_SETTINGS = 6,\n\n  /** Command to start publishing periodic device status updates */\n  START_PUBLISHING_DEVICE_STATUS = 11,\n\n  //\n  // When the message type is reported in the `msg` field of the payload.\n  //\n\n  /** Command to change the current state of a device (temperature, mode, etc.) */\n  CHANGE_DEVICE_STATE = 44\n}\n","/**\n * Enumeration of message types for outgoing MQTT messages from devices to clients.\n *\n * These message types identify different kinds of status updates, notifications, and data reports that Mysa devices can\n * send via MQTT. The enum values correspond to specific numeric identifiers used in the MQTT protocol.\n */\nexport enum OutMessageType {\n  //\n  // When the message type is reported in the `MsgType` field of the payload.\n  //\n\n  /** Version 1 device status report with basic device information */\n  DEVICE_V1_STATUS = 0,\n\n  /** Notification that a device's temperature setpoint has been changed */\n  DEVICE_SETPOINT_CHANGE = 1,\n\n  /** Device log entry or diagnostic information */\n  DEVICE_LOG = 4,\n\n  /** Notification sent when a device completes its boot sequence */\n  DEVICE_POST_BOOT = 10,\n\n  //\n  // When the message type is reported in the `msg` field of the payload.\n  //\n\n  /** Version 2 device status report with enhanced device information */\n  DEVICE_V2_STATUS = 40,\n\n  /** Notification that a device's operational state has changed */\n  DEVICE_STATE_CHANGE = 44\n}\n","import { MysaSession } from '@/api/MysaSession';\nimport { EventEmitter } from '@/lib/EventEmitter';\nimport { parseMqttPayload, serializeMqttPayload } from '@/lib/PayloadParser';\nimport { isMsgOutPayload, isMsgTypeOutPayload } from '@/lib/PayloadTypeGuards';\nimport { ChangeDeviceState } from '@/types/mqtt/in/ChangeDeviceState';\nimport { InMessageType } from '@/types/mqtt/in/InMessageType';\nimport { StartPublishingDeviceStatus } from '@/types/mqtt/in/StartPublishingDeviceStatus';\nimport { OutMessageType } from '@/types/mqtt/out/OutMessageType';\nimport { Devices, DeviceStates, Firmwares } from '@/types/rest';\nimport { DescribeThingCommand, IoTClient } from '@aws-sdk/client-iot';\nimport { fromCognitoIdentityPool } from '@aws-sdk/credential-providers';\nimport {\n  AuthenticationDetails,\n  CognitoAccessToken,\n  CognitoIdToken,\n  CognitoRefreshToken,\n  CognitoUser,\n  CognitoUserPool,\n  CognitoUserSession\n} from 'amazon-cognito-identity-js';\nimport { iot, mqtt } from 'aws-iot-device-sdk-v2';\nimport dayjs from 'dayjs';\nimport duration from 'dayjs/plugin/duration.js';\nimport { MysaApiError, UnauthenticatedError } from './Errors';\nimport { Logger, VoidLogger } from './Logger';\nimport { MysaApiClientEventTypes } from './MysaApiClientEventTypes';\nimport { MysaApiClientOptions } from './MysaApiClientOptions';\nimport { MysaDeviceMode } from './MysaDeviceMode';\n\ndayjs.extend(duration);\n\nconst AwsRegion = 'us-east-1';\nconst CognitoUserPoolId = 'us-east-1_GUFWfhI7g';\nconst CognitoClientId = '19efs8tgqe942atbqmot5m36t3';\nconst CognitoIdentityPoolId = 'us-east-1:ebd95d52-9995-45da-b059-56b865a18379';\nconst CognitoLoginKey = `cognito-idp.${AwsRegion}.amazonaws.com/${CognitoUserPoolId}`;\nconst MqttEndpoint = 'a3q27gia9qg3zy-ats.iot.us-east-1.amazonaws.com';\nconst MysaApiBaseUrl = 'https://app-prod.mysa.cloud';\nconst RealtimeKeepAliveInterval = dayjs.duration(5, 'minutes');\n\n/**\n * Main client for interacting with the Mysa API and real-time device communication.\n *\n * The MysaApiClient provides a comprehensive interface for authenticating with Mysa services, managing device data, and\n * receiving real-time updates from Mysa thermostats and heating devices. It handles both REST API calls for device\n * management and MQTT connections for live status updates and control commands.\n *\n * @example\n *\n * ```typescript\n * const client = new MysaApiClient();\n *\n * await client.login('user@example.com', 'password');\n * const devices = await client.getDevices();\n *\n * client.emitter.on('statusChanged', (status) => {\n *   console.log(`Device ${status.deviceId} temperature: ${status.temperature}°C`);\n * });\n *\n * for (const device of Object.entries(devices.DevicesObj)) {\n *   await client.startRealtimeUpdates(device[0]);\n * }\n * ```\n */\nexport class MysaApiClient {\n  /** The current session object, if any. */\n  private _cognitoUserSession?: CognitoUserSession;\n\n  /** The current user object, if any. */\n  private _cognitoUser?: CognitoUser;\n\n  /** The logger instance used by the client. */\n  private _logger: Logger;\n\n  /** The fetcher function used by the client. */\n  private _fetcher: typeof fetch;\n\n  /** The MQTT connection used for real-time updates. */\n  private _mqttConnection?: mqtt.MqttClientConnection;\n\n  /** The device IDs that are currently being updated in real-time, mapped to their respective timeouts. */\n  private _realtimeDeviceIds: Map<string, NodeJS.Timeout> = new Map();\n\n  /** The cached devices object, if any. */\n  private _cachedDevices?: Devices;\n\n  /**\n   * Event emitter for client events.\n   *\n   * @see {@link MysaApiClientEventTypes} for the possible events and their payloads.\n   */\n  readonly emitter = new EventEmitter<MysaApiClientEventTypes>();\n\n  /**\n   * Gets the persistable session object.\n   *\n   * @returns The current persistable session object, if any.\n   */\n  get session(): MysaSession | undefined {\n    if (!this._cognitoUserSession || !this._cognitoUser) {\n      return undefined;\n    }\n\n    return {\n      username: this._cognitoUser.getUsername(),\n      idToken: this._cognitoUserSession.getIdToken().getJwtToken(),\n      accessToken: this._cognitoUserSession.getAccessToken().getJwtToken(),\n      refreshToken: this._cognitoUserSession.getRefreshToken().getToken()\n    };\n  }\n\n  /**\n   * Returns whether the client currently has an active session.\n   *\n   * @returns True if the client has an active session, false otherwise.\n   */\n  get isAuthenticated(): boolean {\n    return !!this.session;\n  }\n\n  /**\n   * Constructs a new instance of the MysaApiClient.\n   *\n   * @param session - The persistable session object, if any.\n   * @param options - The options for the client.\n   */\n  constructor(session?: MysaSession, options?: MysaApiClientOptions) {\n    this._logger = options?.logger || new VoidLogger();\n    this._fetcher = options?.fetcher || fetch;\n\n    if (session) {\n      this._cognitoUser = new CognitoUser({\n        Username: session.username,\n        Pool: new CognitoUserPool({ UserPoolId: CognitoUserPoolId, ClientId: CognitoClientId })\n      });\n      this._cognitoUserSession = new CognitoUserSession({\n        IdToken: new CognitoIdToken({ IdToken: session.idToken }),\n        AccessToken: new CognitoAccessToken({ AccessToken: session.accessToken }),\n        RefreshToken: new CognitoRefreshToken({ RefreshToken: session.refreshToken })\n      });\n    }\n  }\n\n  /**\n   * Logs in the user with the given email address and password.\n   *\n   * This method authenticates the user with Mysa's Cognito user pool and establishes a session that can be used for\n   * subsequent API calls. Upon successful login, a 'sessionChanged' event is emitted.\n   *\n   * @example\n   *\n   * ```typescript\n   * try {\n   *   await client.login('user@example.com', 'password123');\n   *   console.log('Login successful!');\n   * } catch (error) {\n   *   console.error('Login failed:', error.message);\n   * }\n   * ```\n   *\n   * @param emailAddress - The email address of the user.\n   * @param password - The password of the user.\n   * @throws {@link Error} When authentication fails due to invalid credentials or network issues.\n   */\n  async login(emailAddress: string, password: string): Promise<void> {\n    this._cognitoUser = undefined;\n    this._cognitoUserSession = undefined;\n    this.emitter.emit('sessionChanged', this.session);\n\n    return new Promise((resolve, reject) => {\n      const user = new CognitoUser({\n        Username: emailAddress,\n        Pool: new CognitoUserPool({ UserPoolId: CognitoUserPoolId, ClientId: CognitoClientId })\n      });\n\n      user.authenticateUser(new AuthenticationDetails({ Username: emailAddress, Password: password }), {\n        onSuccess: (session) => {\n          this._cognitoUser = user;\n          this._cognitoUserSession = session;\n          this.emitter.emit('sessionChanged', this.session);\n\n          resolve();\n        },\n        onFailure: (err) => {\n          reject(err);\n        }\n      });\n    });\n  }\n\n  /**\n   * Retrieves the list of devices associated with the user.\n   *\n   * This method fetches all Mysa devices linked to the authenticated user's account, including device information such\n   * as models, locations, and configuration details.\n   *\n   * @example\n   *\n   * ```typescript\n   * const devices = await client.getDevices();\n   * for (const [deviceId, device] of Object.entries(devices.DevicesObj)) {\n   *   console.log(`Device: ${device.DisplayName} (${device.Model})`);\n   * }\n   * ```\n   *\n   * @returns A promise that resolves to the list of devices.\n   * @throws {@link MysaApiError} When the API request fails.\n   * @throws {@link UnauthenticatedError} When the user is not authenticated.\n   */\n  async getDevices(): Promise<Devices> {\n    this._logger.debug(`Fetching devices...`);\n\n    const session = await this.getFreshSession();\n\n    const response = await this._fetcher(`${MysaApiBaseUrl}/devices`, {\n      headers: {\n        Authorization: `${session.getIdToken().getJwtToken()}`\n      }\n    });\n\n    if (!response.ok) {\n      throw new MysaApiError(response);\n    }\n\n    return response.json();\n  }\n\n  /**\n   * Retrieves the serial number for a specific device.\n   *\n   * This method uses AWS IoT's DescribeThing API to fetch the serial number attribute for the specified device. This\n   * requires additional AWS IoT permissions and may not be available for all devices.\n   *\n   * @example\n   *\n   * ```typescript\n   * const serialNumber = await client.getDeviceSerialNumber('device123');\n   * if (serialNumber) {\n   *   console.log(`Device serial: ${serialNumber}`);\n   * } else {\n   *   console.log('Serial number not available');\n   * }\n   * ```\n   *\n   * @param deviceId - The ID of the device to get the serial number for.\n   * @returns A promise that resolves to the serial number, or undefined if not found.\n   * @throws {@link UnauthenticatedError} When the user is not authenticated.\n   */\n  async getDeviceSerialNumber(deviceId: string): Promise<string | undefined> {\n    this._logger.debug(`Fetching serial number for device ${deviceId}...`);\n\n    const session = await this.getFreshSession();\n\n    // Get AWS credentials for IoT client\n    const credentialsProvider = fromCognitoIdentityPool({\n      clientConfig: {\n        region: AwsRegion\n      },\n      identityPoolId: CognitoIdentityPoolId,\n      logins: {\n        [CognitoLoginKey]: session.getIdToken().getJwtToken()\n      }\n    });\n\n    const credentials = await credentialsProvider();\n    const iotClient = new IoTClient({\n      region: AwsRegion,\n      credentials: {\n        accessKeyId: credentials.accessKeyId,\n        secretAccessKey: credentials.secretAccessKey,\n        sessionToken: credentials.sessionToken\n      }\n    });\n\n    try {\n      const command = new DescribeThingCommand({ thingName: deviceId });\n      const response = await iotClient.send(command);\n      return response.attributes?.['Serial'];\n    } catch (error) {\n      this._logger.warn(`Could not get serial number for device ${deviceId}:`, error);\n      return undefined;\n    }\n  }\n\n  /**\n   * Retrieves firmware information for all devices.\n   *\n   * @returns A promise that resolves to the firmware information for all devices.\n   * @throws {@link MysaApiError} When the API request fails.\n   * @throws {@link UnauthenticatedError} When the user is not authenticated.\n   */\n  async getDeviceFirmwares(): Promise<Firmwares> {\n    this._logger.debug(`Fetching device firmwares...`);\n\n    const session = await this.getFreshSession();\n\n    const response = await this._fetcher(`${MysaApiBaseUrl}/devices/firmware`, {\n      headers: {\n        Authorization: `${session.getIdToken().getJwtToken()}`\n      }\n    });\n\n    if (!response.ok) {\n      throw new MysaApiError(response);\n    }\n\n    return response.json();\n  }\n\n  /**\n   * Retrieves the current state information for all devices.\n   *\n   * @returns A promise that resolves to the current state of all devices.\n   * @throws {@link MysaApiError} When the API request fails.\n   * @throws {@link UnauthenticatedError} When the user is not authenticated.\n   */\n  async getDeviceStates(): Promise<DeviceStates> {\n    this._logger.debug(`Fetching device states...`);\n\n    const session = await this.getFreshSession();\n\n    const response = await this._fetcher(`${MysaApiBaseUrl}/devices/state`, {\n      headers: {\n        Authorization: `${session.getIdToken().getJwtToken()}`\n      }\n    });\n\n    if (!response.ok) {\n      throw new MysaApiError(response);\n    }\n\n    return response.json();\n  }\n\n  /**\n   * Sets the state of a specific device by sending commands via MQTT.\n   *\n   * This method allows you to change the temperature set point and/or operating mode of a Mysa device. The command is\n   * sent through the MQTT connection for real-time device control.\n   *\n   * @example\n   *\n   * ```typescript\n   * // Set temperature to 22°C\n   * await client.setDeviceState('device123', 22);\n   *\n   * // Turn device off\n   * await client.setDeviceState('device123', undefined, 'off');\n   *\n   * // Set temperature and mode\n   * await client.setDeviceState('device123', 20, 'heat');\n   * ```\n   *\n   * @param deviceId - The ID of the device to control.\n   * @param setPoint - The target temperature set point (optional).\n   * @param mode - The operating mode to set ('off', 'heat', or undefined to leave unchanged).\n   * @throws {@link UnauthenticatedError} When the user is not authenticated.\n   * @throws {@link Error} When MQTT connection or command sending fails.\n   */\n  async setDeviceState(deviceId: string, setPoint?: number, mode?: MysaDeviceMode) {\n    this._logger.debug(`Setting device state for '${deviceId}'`);\n\n    if (!this._cachedDevices) {\n      this._cachedDevices = await this.getDevices();\n    }\n\n    const device = this._cachedDevices.DevicesObj[deviceId];\n\n    this._logger.debug(`Initializing MQTT connection...`);\n    const mqttConnection = await this.getMqttConnection();\n\n    const now = dayjs();\n\n    this._logger.debug(`Sending request to set device state for '${deviceId}'...`);\n    const payload = serializeMqttPayload<ChangeDeviceState>({\n      msg: InMessageType.CHANGE_DEVICE_STATE,\n      id: now.unix(),\n      time: now.unix(),\n      ver: '1.0',\n      src: {\n        ref: this.session!.username,\n        type: 100\n      },\n      dest: {\n        ref: deviceId,\n        type: 1\n      },\n      resp: 2,\n      body: {\n        ver: 1,\n        type: device.Model.startsWith('BB-V1')\n          ? 1\n          : device.Model.startsWith('BB-V2')\n            ? device.Model.endsWith('-L')\n              ? 5\n              : 4\n            : 0,\n        cmd: [\n          {\n            tm: -1,\n            sp: setPoint,\n            md: mode === 'off' ? 1 : mode === 'heat' ? 3 : undefined\n          }\n        ]\n      }\n    });\n\n    await mqttConnection.publish(`/v1/dev/${deviceId}/in`, payload, mqtt.QoS.AtLeastOnce);\n  }\n\n  /**\n   * Starts receiving real-time updates for the specified device.\n   *\n   * This method establishes an MQTT subscription to receive live status updates from the device, including temperature,\n   * humidity, set point changes, and other state information. The client will automatically send keep-alive messages to\n   * maintain the connection.\n   *\n   * @example\n   *\n   * ```typescript\n   * // Start receiving updates and listen for events\n   * await client.startRealtimeUpdates('device123');\n   *\n   * client.emitter.on('statusChanged', (status) => {\n   *   console.log(`Temperature: ${status.temperature}°C`);\n   * });\n   * ```\n   *\n   * @param deviceId - The ID of the device to start receiving updates for.\n   * @throws {@link Error} When MQTT connection or subscription fails.\n   */\n  async startRealtimeUpdates(deviceId: string) {\n    this._logger.info(`Starting real-time updates for device '${deviceId}'`);\n\n    if (this._realtimeDeviceIds.has(deviceId)) {\n      this._logger.debug(`Real-time updates for device '${deviceId}' already started`);\n      return;\n    }\n\n    this._logger.debug(`Initializing MQTT connection...`);\n    const mqttConnection = await this.getMqttConnection();\n\n    this._logger.debug(`Subscribing to MQTT topic '/v1/dev/${deviceId}/out'...`);\n    await mqttConnection.subscribe(`/v1/dev/${deviceId}/out`, mqtt.QoS.AtLeastOnce, (_, payload) => {\n      this.processMqttMessage(payload);\n    });\n\n    this._logger.debug(`Sending request to start publishing device status for '${deviceId}'...`);\n    const payload = serializeMqttPayload<StartPublishingDeviceStatus>({\n      Device: deviceId,\n      MsgType: InMessageType.START_PUBLISHING_DEVICE_STATUS,\n      Timestamp: dayjs().unix(),\n      Timeout: RealtimeKeepAliveInterval.asSeconds()\n    });\n    await mqttConnection.publish(`/v1/dev/${deviceId}/in`, payload, mqtt.QoS.AtLeastOnce);\n\n    const timer = setInterval(async () => {\n      this._logger.debug(`Sending request to keep-alive publishing device status for '${deviceId}'...`);\n      const payload = serializeMqttPayload<StartPublishingDeviceStatus>({\n        Device: deviceId,\n        MsgType: InMessageType.START_PUBLISHING_DEVICE_STATUS,\n        Timestamp: dayjs().unix(),\n        Timeout: RealtimeKeepAliveInterval.asSeconds()\n      });\n      await mqttConnection.publish(`/v1/dev/${deviceId}/in`, payload, mqtt.QoS.AtLeastOnce);\n    }, RealtimeKeepAliveInterval.subtract(10, 'seconds').asMilliseconds());\n\n    this._realtimeDeviceIds.set(deviceId, timer);\n  }\n\n  /**\n   * Stops receiving real-time updates for the specified device.\n   *\n   * This method unsubscribes from the MQTT topic for the specified device and clears any associated timers to stop the\n   * keep-alive messages.\n   *\n   * @param deviceId - The ID of the device to stop receiving real-time updates for.\n   * @throws {@link Error} When MQTT unsubscription fails.\n   */\n  async stopRealtimeUpdates(deviceId: string) {\n    this._logger.info(`Stopping real-time updates for device '${deviceId}'`);\n\n    const timer = this._realtimeDeviceIds.get(deviceId);\n    if (!timer) {\n      this._logger.warn(`No real-time updates are running for device '${deviceId}'`);\n      return;\n    }\n\n    this._logger.debug(`Initializing MQTT connection...`);\n    const mqttConnection = await this.getMqttConnection();\n\n    this._logger.debug(`Unsubscribing to MQTT topic '/v1/dev/${deviceId}/out'...`);\n    await mqttConnection.unsubscribe(`/v1/dev/${deviceId}/out`);\n\n    clearInterval(timer);\n    this._realtimeDeviceIds.delete(deviceId);\n  }\n\n  /**\n   * Ensures a valid, non-expired session is available.\n   *\n   * This method checks if the current session is valid and not expired. If the session is expired, it automatically\n   * refreshes it using the refresh token.\n   *\n   * @returns A promise that resolves to a valid CognitoUserSession.\n   * @throws {@link UnauthenticatedError} When no session exists or refresh fails.\n   */\n  private async getFreshSession(): Promise<CognitoUserSession> {\n    if (!this._cognitoUser || !this._cognitoUserSession) {\n      throw new UnauthenticatedError('An attempt was made to access a resource without a valid session.');\n    }\n\n    if (\n      this._cognitoUserSession.isValid() &&\n      dayjs.unix(this._cognitoUserSession.getIdToken().getExpiration()).isAfter()\n    ) {\n      this._logger.debug('Session is valid, no need to refresh');\n      return Promise.resolve(this._cognitoUserSession);\n    }\n\n    this._logger.debug('Session is not valid or expired, refreshing...');\n    return new Promise<CognitoUserSession>((resolve, reject) => {\n      this._cognitoUser!.refreshSession(this._cognitoUserSession!.getRefreshToken(), (error, session) => {\n        if (error) {\n          this._logger.error('Failed to refresh session:', error);\n          reject(new UnauthenticatedError('Unable to refresh the authentication session.'));\n        } else {\n          this._logger.debug('Session refreshed successfully');\n          this._cognitoUserSession = session;\n          this.emitter.emit('sessionChanged', this.session);\n          resolve(session);\n        }\n      });\n    });\n  }\n\n  /**\n   * Establishes and returns an MQTT connection for real-time communication.\n   *\n   * This method creates a new MQTT connection if one doesn't exist, using AWS IoT WebSocket connections with Cognito\n   * credentials. The connection is cached and reused for subsequent calls.\n   *\n   * @returns A promise that resolves to an active MQTT connection.\n   * @throws {@link Error} When connection establishment fails.\n   */\n  private async getMqttConnection(): Promise<mqtt.MqttClientConnection> {\n    if (this._mqttConnection) {\n      return this._mqttConnection;\n    }\n\n    const session = await this.getFreshSession();\n    const credentialsProvider = fromCognitoIdentityPool({\n      clientConfig: {\n        region: AwsRegion\n      },\n      identityPoolId: CognitoIdentityPoolId,\n      logins: {\n        [CognitoLoginKey]: session.getIdToken().getJwtToken()\n      },\n      logger: this._logger\n    });\n    const credentials = await credentialsProvider();\n\n    const builder = iot.AwsIotMqttConnectionConfigBuilder.new_with_websockets()\n      .with_credentials(AwsRegion, credentials.accessKeyId, credentials.secretAccessKey, credentials.sessionToken)\n      .with_endpoint(MqttEndpoint)\n      .with_client_id(`mysa-js-sdk-${dayjs().unix()}`) // Unique client ID\n      .with_clean_session(true)\n      .with_keep_alive_seconds(30)\n      .with_ping_timeout_ms(3000)\n      .with_protocol_operation_timeout_ms(60000);\n\n    const config = builder.build();\n    const client = new mqtt.MqttClient();\n    this._mqttConnection = client.new_connection(config);\n\n    this._mqttConnection.on('closed', () => {\n      this._logger.info('MQTT connection closed');\n      this._mqttConnection = undefined;\n    });\n\n    await this._mqttConnection.connect();\n\n    return this._mqttConnection;\n  }\n\n  /**\n   * Processes incoming MQTT messages and emits appropriate events.\n   *\n   * This method parses MQTT payloads and converts them into typed events that can be listened to via the client's event\n   * emitter. It handles both v1 and v2 device message formats and emits events like 'statusChanged', 'setPointChanged',\n   * and 'stateChanged'.\n   *\n   * @param payload - The raw MQTT message payload to process.\n   */\n  private processMqttMessage(payload: ArrayBuffer) {\n    try {\n      const parsedPayload = parseMqttPayload(payload);\n\n      this.emitter.emit('rawRealtimeMessageReceived', parsedPayload);\n\n      if (isMsgTypeOutPayload(parsedPayload)) {\n        switch (parsedPayload.MsgType) {\n          case OutMessageType.DEVICE_V1_STATUS:\n            this.emitter.emit('statusChanged', {\n              deviceId: parsedPayload.Device,\n              temperature: parsedPayload.MainTemp,\n              humidity: parsedPayload.Humidity,\n              setPoint: parsedPayload.SetPoint,\n              current: parsedPayload.Current\n            });\n            break;\n\n          case OutMessageType.DEVICE_SETPOINT_CHANGE:\n            this.emitter.emit('setPointChanged', {\n              deviceId: parsedPayload.Device,\n              newSetPoint: parsedPayload.Next,\n              previousSetPoint: parsedPayload.Prev\n            });\n            break;\n        }\n      } else if (isMsgOutPayload(parsedPayload)) {\n        switch (parsedPayload.msg) {\n          case OutMessageType.DEVICE_V2_STATUS:\n            this.emitter.emit('statusChanged', {\n              deviceId: parsedPayload.src.ref,\n              temperature: parsedPayload.body.ambTemp,\n              humidity: parsedPayload.body.hum,\n              setPoint: parsedPayload.body.stpt,\n              dutyCycle: parsedPayload.body.dtyCycle\n            });\n            break;\n\n          case OutMessageType.DEVICE_STATE_CHANGE:\n            this.emitter.emit('stateChanged', {\n              deviceId: parsedPayload.src.ref,\n              mode: parsedPayload.body.state.md === 1 ? 'off' : parsedPayload.body.state.md === 3 ? 'heat' : undefined,\n              setPoint: parsedPayload.body.state.sp\n            });\n            break;\n        }\n      }\n    } catch (error) {\n      this._logger.error('Error handling MQTT message:', error);\n    }\n  }\n}\n"],"mappings":"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","names":["NodeEventEmitter","InMessageType","OutMessageType","dayjs","duration","payload"]}

package/dist/index.d.cts

@@ -737,33 +737,170 @@ declare class MysaApiClient {
     /**
      * Logs in the user with the given email address and password.
      *
+     * This method authenticates the user with Mysa's Cognito user pool and establishes a session that can be used for
+     * subsequent API calls. Upon successful login, a 'sessionChanged' event is emitted.
+     *
+     * @example
+     *
+     * ```typescript
+     * try {
+     *   await client.login('user@example.com', 'password123');
+     *   console.log('Login successful!');
+     * } catch (error) {
+     *   console.error('Login failed:', error.message);
+     * }
+     * ```
+     *
      * @param emailAddress - The email address of the user.
      * @param password - The password of the user.
+     * @throws {@link Error} When authentication fails due to invalid credentials or network issues.
      */
     login(emailAddress: string, password: string): Promise<void>;
     /**
      * Retrieves the list of devices associated with the user.
      *
+     * This method fetches all Mysa devices linked to the authenticated user's account, including device information such
+     * as models, locations, and configuration details.
+     *
+     * @example
+     *
+     * ```typescript
+     * const devices = await client.getDevices();
+     * for (const [deviceId, device] of Object.entries(devices.DevicesObj)) {
+     *   console.log(`Device: ${device.DisplayName} (${device.Model})`);
+     * }
+     * ```
+     *
      * @returns A promise that resolves to the list of devices.
+     * @throws {@link MysaApiError} When the API request fails.
+     * @throws {@link UnauthenticatedError} When the user is not authenticated.
      */
     getDevices(): Promise<Devices>;
+    /**
+     * Retrieves the serial number for a specific device.
+     *
+     * This method uses AWS IoT's DescribeThing API to fetch the serial number attribute for the specified device. This
+     * requires additional AWS IoT permissions and may not be available for all devices.
+     *
+     * @example
+     *
+     * ```typescript
+     * const serialNumber = await client.getDeviceSerialNumber('device123');
+     * if (serialNumber) {
+     *   console.log(`Device serial: ${serialNumber}`);
+     * } else {
+     *   console.log('Serial number not available');
+     * }
+     * ```
+     *
+     * @param deviceId - The ID of the device to get the serial number for.
+     * @returns A promise that resolves to the serial number, or undefined if not found.
+     * @throws {@link UnauthenticatedError} When the user is not authenticated.
+     */
+    getDeviceSerialNumber(deviceId: string): Promise<string | undefined>;
+    /**
+     * Retrieves firmware information for all devices.
+     *
+     * @returns A promise that resolves to the firmware information for all devices.
+     * @throws {@link MysaApiError} When the API request fails.
+     * @throws {@link UnauthenticatedError} When the user is not authenticated.
+     */
     getDeviceFirmwares(): Promise<Firmwares>;
+    /**
+     * Retrieves the current state information for all devices.
+     *
+     * @returns A promise that resolves to the current state of all devices.
+     * @throws {@link MysaApiError} When the API request fails.
+     * @throws {@link UnauthenticatedError} When the user is not authenticated.
+     */
     getDeviceStates(): Promise<DeviceStates>;
+    /**
+     * Sets the state of a specific device by sending commands via MQTT.
+     *
+     * This method allows you to change the temperature set point and/or operating mode of a Mysa device. The command is
+     * sent through the MQTT connection for real-time device control.
+     *
+     * @example
+     *
+     * ```typescript
+     * // Set temperature to 22°C
+     * await client.setDeviceState('device123', 22);
+     *
+     * // Turn device off
+     * await client.setDeviceState('device123', undefined, 'off');
+     *
+     * // Set temperature and mode
+     * await client.setDeviceState('device123', 20, 'heat');
+     * ```
+     *
+     * @param deviceId - The ID of the device to control.
+     * @param setPoint - The target temperature set point (optional).
+     * @param mode - The operating mode to set ('off', 'heat', or undefined to leave unchanged).
+     * @throws {@link UnauthenticatedError} When the user is not authenticated.
+     * @throws {@link Error} When MQTT connection or command sending fails.
+     */
     setDeviceState(deviceId: string, setPoint?: number, mode?: MysaDeviceMode): Promise<void>;
     /**
      * Starts receiving real-time updates for the specified device.
      *
+     * This method establishes an MQTT subscription to receive live status updates from the device, including temperature,
+     * humidity, set point changes, and other state information. The client will automatically send keep-alive messages to
+     * maintain the connection.
+     *
+     * @example
+     *
+     * ```typescript
+     * // Start receiving updates and listen for events
+     * await client.startRealtimeUpdates('device123');
+     *
+     * client.emitter.on('statusChanged', (status) => {
+     *   console.log(`Temperature: ${status.temperature}°C`);
+     * });
+     * ```
+     *
      * @param deviceId - The ID of the device to start receiving updates for.
+     * @throws {@link Error} When MQTT connection or subscription fails.
      */
     startRealtimeUpdates(deviceId: string): Promise<void>;
     /**
      * Stops receiving real-time updates for the specified device.
      *
+     * This method unsubscribes from the MQTT topic for the specified device and clears any associated timers to stop the
+     * keep-alive messages.
+     *
      * @param deviceId - The ID of the device to stop receiving real-time updates for.
+     * @throws {@link Error} When MQTT unsubscription fails.
      */
     stopRealtimeUpdates(deviceId: string): Promise<void>;
+    /**
+     * Ensures a valid, non-expired session is available.
+     *
+     * This method checks if the current session is valid and not expired. If the session is expired, it automatically
+     * refreshes it using the refresh token.
+     *
+     * @returns A promise that resolves to a valid CognitoUserSession.
+     * @throws {@link UnauthenticatedError} When no session exists or refresh fails.
+     */
     private getFreshSession;
+    /**
+     * Establishes and returns an MQTT connection for real-time communication.
+     *
+     * This method creates a new MQTT connection if one doesn't exist, using AWS IoT WebSocket connections with Cognito
+     * credentials. The connection is cached and reused for subsequent calls.
+     *
+     * @returns A promise that resolves to an active MQTT connection.
+     * @throws {@link Error} When connection establishment fails.
+     */
     private getMqttConnection;
+    /**
+     * Processes incoming MQTT messages and emits appropriate events.
+     *
+     * This method parses MQTT payloads and converts them into typed events that can be listened to via the client's event
+     * emitter. It handles both v1 and v2 device message formats and emits events like 'statusChanged', 'setPointChanged',
+     * and 'stateChanged'.
+     *
+     * @param payload - The raw MQTT message payload to process.
+     */
     private processMqttMessage;
 }