@espressif/rainmaker-neo-base-sdk 1.0.0

package/dist/types/utils/error/ESPAPICallValidationError.d.ts

@@ -0,0 +1,19 @@
+import { apiCallValidationErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents an API call validation error.
+ *
+ * This class extends `ESPBaseError` and provides detailed error information
+ * related to validation issues encountered during API calls.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPAPICallValidationError extends ESPBaseError {
+    /**
+     * Constructs a new instance of `ESPAPICallValidationError`.
+     *
+     * @param code - The error code corresponding to a specific validation error message
+     *               from `apiCallValidationErrorMessages`.
+     */
+    constructor(code: keyof typeof apiCallValidationErrorMessages);
+}

package/dist/types/utils/error/ESPAuthError.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SDK-specific authentication error wrapper.
+ *
+ * Provides stable error codes so callers can branch on `err.code` while
+ * preserving the original cause via `originalError` for debugging.
+ */
+export declare class ESPAuthError extends Error {
+    code: string;
+    originalError?: unknown;
+    constructor(code: string, message: string, originalError?: unknown);
+}

package/dist/types/utils/error/ESPBaseError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Base class for creating custom errors.
+ */
+export declare class ESPBaseError extends Error {
+    code: string;
+    label: string;
+    constructor(label: string, code: string, errorMessages: Record<string, string>, defaultMessage: string);
+}

package/dist/types/utils/error/ESPClaimError.d.ts

@@ -0,0 +1,25 @@
+import { claimErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents an error related to assisted claiming.
+ *
+ * This class extends `ESPBaseError` and is used to handle errors that occur
+ * during assisted claiming, such as device-side CSR retrieval or claiming
+ * API failures.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPClaimError extends ESPBaseError {
+    /**
+     * Creates an instance of `ESPClaimError`.
+     *
+     * @param code - The error code corresponding to a specific claiming error message
+     *               from `claimErrorMessages`.
+     * @param detail - Optional reason from the claiming service, appended to the
+     *                 message. The claiming API returns `{ message }` on every
+     *                 failure, and those reasons are actionable — a node quota
+     *                 cap, an unclaimed device, a rejected CSR — so they are
+     *                 surfaced instead of a generic API failure.
+     */
+    constructor(code: keyof typeof claimErrorMessages, detail?: string);
+}

package/dist/types/utils/error/ESPConfigError.d.ts

@@ -0,0 +1,19 @@
+import { configErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents a configuration error in the SDK.
+ *
+ * This class extends `ESPBaseError` and is used to handle errors related to
+ * configuration issues during SDK setup or runtime operations.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPConfigError extends ESPBaseError {
+    /**
+     * Constructs a new instance of `ESPConfigError`.
+     *
+     * @param code - The error code corresponding to a specific configuration error message
+     *               from `configErrorMessages`.
+     */
+    constructor(code: keyof typeof configErrorMessages);
+}

package/dist/types/utils/error/ESPProvError.d.ts

@@ -0,0 +1,19 @@
+import { provErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents an error related to provisioning issues.
+ *
+ * This class extends `ESPBaseError` and is used to handle errors that occur
+ * during the provisioning process, such as device setup or user-device association.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPProvError extends ESPBaseError {
+    /**
+     * Creates an instance of `ESPProvError`.
+     *
+     * @param code - The error code corresponding to a specific provisioning error message
+     *               from `provErrorMessages`.
+     */
+    constructor(code: keyof typeof provErrorMessages);
+}

package/dist/types/utils/error/ESPStorageAdapterError.d.ts

@@ -0,0 +1,19 @@
+import { storageAdapterErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents an error related to the storage adapter.
+ *
+ * This class extends `ESPBaseError` and is used to handle errors that arise
+ * due to issues with the storage adapter configuration or functionality.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPStorageAdapterError extends ESPBaseError {
+    /**
+     * Creates an instance of `ESPStorageAdapterError`.
+     *
+     * @param code - The error code corresponding to a specific storage adapter error
+     *               message from `storageAdapterErrorMessages`.
+     */
+    constructor(code: keyof typeof storageAdapterErrorMessages);
+}

package/dist/types/utils/error/ESPTokenError.d.ts

@@ -0,0 +1,20 @@
+import { tokenErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents an error related to authentication tokens.
+ *
+ * This class is used to handle errors that occur during token-related operations,
+ * such as missing or invalid tokens. It extends `ESPBaseError` to provide a structured
+ * and consistent error-handling mechanism.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPTokenError extends ESPBaseError {
+    /**
+     * Creates an instance of `ESPTokenError`.
+     *
+     * @param code - The error code corresponding to a specific token-related error message
+     *               from `tokenErrorMessages`.
+     */
+    constructor(code: keyof typeof tokenErrorMessages);
+}

package/dist/types/utils/error/ESPValidationError.d.ts

@@ -0,0 +1,19 @@
+import { validationErrorMessages } from "./errorMessages";
+import { ESPBaseError } from "./ESPBaseError";
+/**
+ * Represents a validation error encountered during input validation or processing.
+ *
+ * This class is used to handle errors related to invalid or missing parameters.
+ * It extends `ESPBaseError` to provide a structured error-handling mechanism.
+ *
+ * @extends ESPBaseError
+ */
+export declare class ESPValidationError extends ESPBaseError {
+    /**
+     * Creates an instance of `ESPValidationError`.
+     *
+     * @param code - The error code corresponding to a specific validation error message
+     *               from `validationErrorMessages`.
+     */
+    constructor(code: keyof typeof validationErrorMessages);
+}

package/dist/types/utils/error/Error.d.ts

@@ -0,0 +1,8 @@
+export { ESPConfigError } from "./ESPConfigError";
+export { ESPValidationError } from "./ESPValidationError";
+export { ESPStorageAdapterError } from "./ESPStorageAdapterError";
+export { ESPAPICallValidationError } from "./ESPAPICallValidationError";
+export { ESPTokenError } from "./ESPTokenError";
+export { ESPProvError } from "./ESPProvError";
+export { ESPClaimError } from "./ESPClaimError";
+export { ESPAuthError } from "../../ESPRMNeoAuth";

package/dist/types/utils/error/errorMessages.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Contains error messages related to configuration issues.
+ *
+ * These messages are used to provide descriptive errors when
+ * configuration validations fail in the ESPRMAuth instance.
+ */
+declare const configErrorMessages: {
+    /** Error message indicating that the SDK is not initialized. */
+    SDK_NOT_CONFIGURED: string;
+    /** Error message indicating that the config must be a non-null object. */
+    INVALID_CONFIG_OBJECT: string;
+    /** Error message indicating that the base URL is invalid or empty. */
+    INVALID_BASE_URL: string;
+    /** Error message indicating that the transport mode is invalid. */
+    INVALID_TRANSPORT_MODE: string;
+    /** Error message indicating that the transport order is empty or not an array. */
+    INVALID_TRANSPORT_ORDER: string;
+    /** Error message indicating that the AWS region is required. */
+    INVALID_REGION: string;
+    /** Error message indicating that an invalid storage adapter was provided. */
+    INVALID_STORAGE_ADAPTER: string;
+    /** Error message indicating that an invalid MQTT adapter was provided. */
+    INVALID_MQTT_ADAPTER: string;
+    /** Error message indicating that the IoT endpoint is missing or empty. */
+    INVALID_IOT_ENDPOINT: string;
+    /** Error message indicating that an invalid provisioning adapter was provided. */
+    INVALID_PROVISION_ADAPTER: string;
+    /** Error message indicating that an invalid local control adapter was provided. */
+    INVALID_LOCAL_CONTROL_ADAPTER: string;
+    /** Error message indicating that an invalid local discovery adapter was provided. */
+    INVALID_LOCAL_DISCOVERY_ADAPTER: string;
+    /** Error message indicating that the User/auth API base URL is missing or empty. */
+    INVALID_USER_API_BASE: string;
+};
+/**
+ * Contains validation error messages for user authentication.
+ *
+ * These messages are used to inform users about missing or invalid
+ * parameters during the authentication process.
+ */
+declare const validationErrorMessages: {
+    /** Error message indicating that the password is required. */
+    MISSING_LOGIN_PASSWORD: string;
+};
+/**
+ * Contains error messages related to storage adapter issues.
+ *
+ * These messages inform users about potential issues with storage
+ * adapter configurations, especially in unsupported environments.
+ */
+declare const storageAdapterErrorMessages: {
+    /** Error message indicating that the default storage adapter API is unsupported. */
+    UNSUPPORTED_DEFAULT_STORAGE_ADAPTER_API: string;
+};
+/**
+ * Contains validation error messages for API calls.
+ *
+ * These messages are used to inform users when required API parameters
+ * are missing or invalid.
+ */
+declare const apiCallValidationErrorMessages: {
+    /** Error message indicating that the group ID is missing. */
+    MISSING_GROUP_ID: string;
+    /** Error message indicating that the group name is missing. */
+    MISSING_GROUP_NAME: string;
+    /** Error message indicating that the node list is missing. */
+    MISSING_NODE_LIST: string;
+    /** Error message indicating that the node ID is missing. */
+    MISSING_NODE_ID: string;
+    /** Error message indicating that the parent node reference has been garbage collected. */
+    MISSING_NODE_REF: string;
+    /** Error message indicating that the secret key is missing. */
+    MISSING_SECRET_KEY: string;
+    /** Error message indicating that update information for the group is missing. */
+    MISSING_GROUP_UPDATE_INFO: string;
+    /** Error message indicating that device token or endpoint is missing for delete endpoint operation. */
+    MISSING_DELETE_ENDPOINT_PARAMS: string;
+    /** Error message indicating that a device list refresh is required. */
+    DEVICE_LIST_REFRESH_REQUIRED: string;
+    /** Error message indicating that a node is unreachable. */
+    NODE_UNREACHABLE: string;
+    /** Error message indicating that a event type is invalid. */
+    INVALID_EVENT_TYPE: string;
+    /** Error message indicating that the base URL is missing. */
+    MISSING_BASE_URL: string;
+    /** Error message indicating that the automation action index is invalid. */
+    INVALID_ACTION_INDEX: string;
+    /** Error message indicating that the automation ID is missing. */
+    MISSING_AUTOMATION_ID: string;
+    /** Error message indicating that the automation name is missing. */
+    MISSING_AUTOMATION_NAME: string;
+    /** Error message indicating that the automation conditions are missing. */
+    MISSING_AUTOMATION_CONDITIONS: string;
+    /** Error message indicating that the automation actions are missing. */
+    MISSING_AUTOMATION_ACTIONS: string;
+    /** Error message indicating setParams was called with an empty or missing params object. */
+    MISSING_PARAMS: string;
+    /** Error message indicating that the trigger item is missing or invalid. */
+    MISSING_TRIGGER: string;
+    /** Error message indicating that the trigger ID is missing or empty. */
+    MISSING_TRIGGER_ID: string;
+    /** Error message indicating that a trigger with the same id already exists. */
+    TRIGGER_ALREADY_EXISTS: string;
+    /** Error message indicating that the action target is invalid or missing required fields. */
+    INVALID_ACTION_TARGET: string;
+    /** Error message indicating that options.dataType is missing for a custom time-series key. */
+    MISSING_TS_CUSTOM_KEY_DATA_TYPE: string;
+    /** Error message indicating that the time-series param carries no data type. */
+    MISSING_TS_DATA_TYPE: string;
+    /** Error message indicating that the time-series param was not found on the node's config. */
+    TS_PARAM_NOT_FOUND: string;
+    /** Error message indicating that startTs is missing for a raw time-series query. */
+    MISSING_TS_START_TIME: string;
+    /** Error message indicating that the time-series aggregation window is missing or invalid. */
+    INVALID_TS_WINDOW: string;
+    /** Error message indicating that the schedule item is missing or invalid. */
+    MISSING_SCHEDULE: string;
+    /** Error message indicating that the schedule id is missing or empty. */
+    MISSING_SCHEDULE_ID: string;
+    /** Error message indicating that the schedules argument is not an array. */
+    INVALID_SCHEDULES: string;
+    /** Error message indicating that the nodeSchedules argument is not an array. */
+    INVALID_NODE_SCHEDULES: string;
+    /** Error message indicating that schedule.enabled is missing or not a boolean. */
+    INVALID_SCHEDULE_ENABLED: string;
+    /** Error message indicating that schedule.triggers is missing or not an array. */
+    INVALID_SCHEDULE_TRIGGERS: string;
+    /** Error message indicating that schedule.action is missing or not an object. */
+    INVALID_SCHEDULE_ACTION: string;
+    /** Error message indicating that a schedule with the same id already exists. */
+    SCHEDULE_ALREADY_EXISTS: string;
+    /** Error message indicating that the schedule was not found on the node. */
+    SCHEDULE_NOT_FOUND: string;
+    /** Error message indicating that the trigger was not found on the node. */
+    TRIGGER_NOT_FOUND: string;
+    /** Error message indicating that the schedule's node could not be resolved. */
+    SCHEDULE_NODE_NOT_FOUND: string;
+    /** Error message indicating addNode was called on a root group. */
+    ADD_NODE_REQUIRES_NESTED_GROUP: string;
+    /** Error message indicating the node is already in the group. */
+    NODE_ALREADY_IN_GROUP: string;
+    /** Error message indicating the node config could not be resolved. */
+    NODE_CONFIG_UNRESOLVED: string;
+    /** Error message indicating the user ID is missing. */
+    MISSING_USER_ID: string;
+    /** Error message indicating the username is missing for group sharing. */
+    MISSING_USERNAME: string;
+    /** Error message indicating removeMember was called with the current-user alias. */
+    USE_LEAVE_FOR_CURRENT_USER: string;
+};
+/**
+ * Contains error messages related to token access issues.
+ *
+ * These messages are used to inform users when there is a problem with
+ * the authentication tokens.
+ */
+declare const tokenErrorMessages: {
+    /** Error message indicating that the access token is missing. */
+    MISSING_ACCESS_TOKEN: string;
+    /** Error message indicating that the ID token is missing. */
+    MISSING_ID_TOKEN: string;
+    /** Error message indicating that the refresh token is missing. */
+    MISSING_REFRESH_TOKEN: string;
+    /** Error message indicating that extending the session failed. */
+    EXTEND_SESSION_FAILED: string;
+};
+/**
+ * Contains error messages related to authentication operations.
+ */
+declare const authErrorMessages: {
+    /** Error message indicating that the user is not logged in. */
+    NOT_LOGGED_IN: string;
+    /** Fallback message when password recovery initiation fails without an Error. */
+    FORGOT_PASSWORD_FAILED: string;
+    /** Fallback message when loading the logged-in user fails without an Error. */
+    GET_LOGGED_IN_USER_FAILED: string;
+    /** Error message when login response is missing required tokens. */
+    LOGIN_FAILED_MISSING_TOKENS: string;
+    /** Fallback message when login fails without an Error. */
+    LOGIN_FAILED: string;
+    /** Invalid username/password message. */
+    INVALID_CREDENTIALS: string;
+    /** User not found message. */
+    USER_NOT_FOUND: string;
+    /** Error message when token refresh response is missing required tokens. */
+    TOKEN_REFRESH_FAILED_MISSING_TOKENS: string;
+    /** Error message when OTP verification returns no authentication result. */
+    OTP_NO_AUTH_RESULT: string;
+    /** Error message when OTP request returns no session token. */
+    OTP_SESSION_TOKEN_FAILED: string;
+    /** Fallback message when sign-up code request fails without an Error. */
+    SIGNUP_FAILED: string;
+    /** Fallback message when sign-up confirmation fails without an Error. */
+    CONFIRM_SIGNUP_FAILED: string;
+    /** Fallback message when password change fails without an Error. */
+    CHANGE_PASSWORD_FAILED: string;
+    /** Fallback message when password reset confirmation fails without an Error. */
+    PASSWORD_RESET_FAILED: string;
+};
+/**
+ * Contains provisioning-related error messages.
+ *
+ * These messages are used to inform users about issues during the
+ * device provisioning process.
+ */
+declare const provErrorMessages: {
+    /** Error message indicating that the provisioning adapter is missing. */
+    MISSING_PROV_ADAPTER: string;
+    /** Error message indicating that the node ID is missing. */
+    MISSING_NODE_ID: string;
+    /** Error message indicating that the ID token is missing. */
+    MISSING_ID_TOKEN: string;
+    /** Error message indicating that device provisioning failed. */
+    FAILED_PROV: string;
+    /** Error message indicating that user device association failed. */
+    FAILED_USER_DEVICE_ASSOCIATION: string;
+    /** Error message indicating that creating a user node mapping request failed due to network issues. */
+    FAILED_USER_NODE_MAPPING_REQUEST_CREATION: string;
+    /** Error message indicating that the user device mapping cloud operation timed out. */
+    FAILED_USER_NODE_MAPPING_CLOUD_TIMEOUT: string;
+    /** Error message indicating that the device did not come online within the timeout. */
+    NODE_ONLINE_TIMEOUT: string;
+    /** Error message indicating that an unsupported provisioning type was requested. */
+    INVALID_PROVISION_TYPE: string;
+    /** Error message indicating that the node mapping response was malformed. */
+    INVALID_MAPPING_RESPONSE: string;
+    /** Error message indicating that the challenge response from the device was malformed. */
+    INVALID_CHALLENGE_RESPONSE_FORMAT: string;
+};
+/**
+ * An object containing error messages related to claiming issues.
+ */
+declare const claimErrorMessages: {
+    /** Error message indicating that the claiming process failed to start. */
+    CLAIM_START_FAILED: string;
+    /** Error message indicating that the claiming process was aborted. */
+    CLAIM_ABORTED: string;
+    /** Error message indicating that the claiming API call failed. */
+    CLAIM_API_FAILED: string;
+    /** Error message indicating that the claiming API is unavailable. */
+    CLAIM_API_NOT_CONFIGURED: string;
+    /** Error message indicating that the device did not report a usable MAC address. */
+    DEVICE_MAC_UNAVAILABLE: string;
+    /** Error message indicating that CSR retrieval from the device failed. */
+    CSR_RETRIEVAL_FAILED: string;
+    /** Error message indicating that sending the certificate to the device failed. */
+    CERTIFICATE_SEND_FAILED: string;
+    /** Error message indicating that the device stopped advancing the CSR stream. */
+    CSR_STALLED: string;
+};
+declare const defaultErrorMessages: {
+    /** Error message indicating that an unknown error occurred. */
+    UNKNOWN_ERROR: string;
+    /** Error message indicating that an unknown error occurred during configuration. */
+    CONFIGURATION_ERROR: string;
+    /** Error message indicating that an unknown error occurred during provision. */
+    PROVISION_ERROR: string;
+    /** Error message indicating that an unknown error occurred during claiming. */
+    CLAIM_ERROR: string;
+    API_ERROR: string;
+    CONFIG_ERROR: string;
+    VALIDATION_ERROR: string;
+    STORAGE_ERROR: string;
+    TOKEN_ERROR: string;
+    STORAGE_ADAPTER_ERROR: string;
+};
+export { configErrorMessages, validationErrorMessages, storageAdapterErrorMessages, apiCallValidationErrorMessages, tokenErrorMessages, authErrorMessages, provErrorMessages, claimErrorMessages, defaultErrorMessages, };

package/dist/types/utils/eventEmitter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Lightweight EventEmitter for browser/RN without relying on Node's `events` module.
+ * Listener errors are isolated so one failing callback does not break others.
+ */
+export declare class EventEmitter {
+    private readonly listeners;
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    off(event: string, listener: (...args: unknown[]) => void): this;
+    removeAllListeners(event?: string): this;
+    emit(event: string, ...args: unknown[]): boolean;
+}

package/dist/types/utils/eventSubscriptionUtils.d.ts

@@ -0,0 +1,17 @@
+import { DiscoveryParamsInterface, ESPDiscoveredNodeData } from "../types/discovery";
+import { ESPNodeUpdateData } from "../types/subscription";
+/** Handle that stops whatever backing source a subscribe() started. */
+export type EventTeardown = {
+    stop(): void;
+};
+/** Maps a default local-discovery hit into the client-facing payload shape. */
+export declare function toDiscoveredNodeData(info: Record<string, any>): ESPDiscoveredNodeData;
+/** Starts LAN discovery; each hit is mapped then passed to `onDiscovered`. */
+export declare function startLocalDiscovery(onDiscovered: (data: ESPDiscoveredNodeData) => void): EventTeardown;
+/** Forwards process-wide node param updates to `onUpdate`. */
+export declare function startNodeUpdates(onUpdate: (update: ESPNodeUpdateData) => void): EventTeardown;
+/**
+ * Starts discovery with a custom config; raw adapter results are forwarded
+ * unchanged (caller interprets them).
+ */
+export declare function startCustomDiscovery(config: DiscoveryParamsInterface, onInfo: (info: Record<string, any>) => void): EventTeardown;

package/dist/types/utils/export.d.ts

@@ -0,0 +1,22 @@
+export * from "./awsShadowTopics";
+export * from "./coerce";
+export * from "./awsSigv4Utils";
+export * from "./awsUtils";
+export * from "./constants";
+export * from "./logger";
+export * from "./mapLimit";
+export * from "./eventEmitter";
+export * from "./mqtt";
+export * from "./shadowUtils";
+export * from "./waitForNodeOnline";
+export * from "./nodeNcfgVersionHandler";
+export * from "./nodeUtils";
+export * from "./groupUtils";
+export * from "./scheduleUtils";
+export * from "./triggerUtils";
+export * from "./tsDataUtils";
+export * from "./userUtils";
+export { ESPBaseError } from "./error/ESPBaseError";
+export * from "./error/Error";
+export * from "./validator/validators";
+export { decodeToken } from "../services/ESPRMNeoHelpers/DecodeToken";

package/dist/types/utils/groupUtils.d.ts

@@ -0,0 +1,20 @@
+import { ESPRMNeoGroup } from "../ESPRMNeoGroup";
+type RootPathFn<A extends unknown[]> = (groupId: string, ...args: A) => string;
+type SubgroupPathFn<A extends unknown[]> = (parentId: string, groupId: string, ...args: A) => string;
+/**
+ * Resolves a group API path for a root group vs nested subgroup.
+ *
+ * - Root: `root(group.groupId, ...args)`
+ * - Child: `subgroup(group.parentId, group.groupId, ...args)`
+ */
+export declare function resolveGroupPath<A extends unknown[]>(group: ESPRMNeoGroup, root: RootPathFn<A>, subgroup: SubgroupPathFn<A>, ...args: A): string;
+/**
+ * PATCH body for renaming a root group (`group_name`) or nested subgroup
+ * (`subgroup_name`).
+ */
+export declare function buildGroupNameBody(group: ESPRMNeoGroup, name: string): {
+    group_name: string;
+} | {
+    subgroup_name: string;
+};
+export {};

package/dist/types/utils/logger.d.ts

@@ -0,0 +1,16 @@
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+export declare class Logger {
+    private context;
+    private static level;
+    constructor(context: string);
+    static setLogLevel(level: LogLevel): void;
+    error(message: string, error?: any): void;
+    warn(message: string, data?: any): void;
+    info(message: string, data?: any): void;
+    debug(message: string, data?: any): void;
+}

package/dist/types/utils/mapLimit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runs one promise per item immediately, keeping at most `poolLimit` in flight
+ * (classic async pool: schedule parallel work, throttle with {@link Promise.race}).
+ * Results match the order of `items`.
+ *
+ * @param poolLimit - Max concurrent `iteratorFn` executions (must be ≥ 1)
+ * @param items - Input values
+ * @param iteratorFn - Async work per item
+ */
+export declare function concurrentFetchPool<T, R>(poolLimit: number, items: readonly T[], iteratorFn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/types/utils/mqtt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolves an MQTT endpoint to a WebSocket MQTT URL (wss://host/mqtt).
+ * Strips any existing protocol or /mqtt path from the input and returns a normalized URL.
+ *
+ * @param mqttEndpoint - Raw MQTT endpoint (e.g. "xxxxx-ats.iot.region.amazonaws.com" or "wss://.../mqtt").
+ * @returns Normalized URL "wss://{host}/mqtt" for use with MQTT over WebSocket.
+ * @throws Error if endpoint is empty.
+ */
+export declare function resolveMqttWebSocketEndpoint(mqttEndpoint: string): string;

package/dist/types/utils/nodeNcfgVersionHandler.d.ts

@@ -0,0 +1,36 @@
+import type { ESPRMNeoShadowDocument } from "../types/node";
+/**
+ * Reads `ncfg_ver` from an IoT shadow document's `state.reported`.
+ *
+ * Legacy integer timestamps from older firmware are normalized to strings.
+ */
+export declare function getNcfgVersion(shadow: ESPRMNeoShadowDocument): string | null;
+/**
+ * Returns true when the shadow's `ncfg_ver` differs from the last cached
+ * version for this node. On first sighting, persists a baseline and returns
+ * false (no refresh needed).
+ */
+export declare function hasNcfgVersionChanged(nodeId: string, shadow: ESPRMNeoShadowDocument): Promise<boolean>;
+/**
+ * Persists the shadow's `ncfg_ver` as the last-seen cached version for this node.
+ * Call after a successful config refresh when {@link hasNcfgVersionChanged}
+ * returned true.
+ */
+export declare function persistNcfgVersionMarker(nodeId: string, shadow: ESPRMNeoShadowDocument): Promise<void>;
+/**
+ * Removes the cached ncfg_ver for a single node. Call after
+ * `group.removeNode()` so the entry doesn't outlive the node in storage.
+ */
+export declare function clearNcfgVersionMarker(nodeId: string): Promise<void>;
+/**
+ * Removes every cached ncfg_ver. Call on logout / session reset.
+ * Returns the list of node ids whose entries were cleared, so callers can
+ * follow up (e.g. delete the corresponding node-config cache entries).
+ */
+export declare function clearAllNcfgVersionMarkers(): Promise<string[]>;
+/**
+ * Returns the list of node ids the SDK is currently tracking cached versions for.
+ * Callers can use it to enumerate related caches at logout time without
+ * needing the storage adapter to support key listing.
+ */
+export declare function listTrackedNodeIds(): Promise<string[]>;