@espressif/rainmaker-admin-sdk 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -3,7 +3,131 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and follows the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format.
 
-## [Unreleased]
+## [1.2.0] - 2026-09-25
+
+Minor release that adds typed access to node certificate registration, so
+admin apps can register nodes from a CSV, list registration jobs and inspect
+a single job without hand-rolled HTTP calls. It also completes the node
+endpoint response type.
+
+The registration request and status types are corrected to match what the
+backend accepts and returns. The old request shape (`node_ids` / `certs`)
+was never accepted by `admin/node_certificates/register`, so no working
+caller can break at runtime, but code that built that shape will no longer
+type-check.
+
+### Added
+
+- **CSV node certificate registration** (`ESPRMAdminNodeRegistration`)
+  - `getNodeCertificateUploadUrl({ file_name })` wraps
+    `GET admin/node_certificates/register?file_name=`. It returns a
+    pre-signed S3 PUT URL (valid for 1 hour) and the `request_id` to pass to
+    `registerNodeCertificates`. It throws `MISSING_FILE_NAME` when
+    `file_name` is empty.
+  - New types: `GetNodeCertificateUploadUrlParams`,
+    `NodeCertificateUploadUrlResponse` and
+    `RegisterNodeCertificatesResponse`.
+- **Node registration requests** (`ESPRMAdminNodeRegistration`)
+  - `listNodeRegistrationRequests(params?)` wraps
+    `GET admin/node_registrations/requests`. It accepts an optional `status`
+    filter plus `num_records` / `start_id` pagination and returns the
+    requests newest first, with `next_id` while more pages exist. The
+    backend caps `num_records` at 25.
+  - `getNodeRegistrationRequest(requestId)` wraps
+    `GET admin/node_registrations/requests/{request_id}` and returns the full
+    request detail: registration parameters, failure context and a
+    pre-signed CSV download URL that is valid for 1 hour. It throws
+    `MISSING_REQUEST_ID` when `requestId` is empty.
+  - New types: `NodeRegistrationRequestStatus`,
+    `ListNodeRegistrationRequestsParams`, `NodeRegistrationRequest`,
+    `ListNodeRegistrationRequestsResponse` and
+    `NodeRegistrationRequestDetail`.
+- **Command request cancellation** (`ESPRMAdminNode`)
+  - `cancelCommandRequests(params)` wraps `DELETE admin/nodes/cmd`. Pass
+    `request_id` to cancel one request, or `node_id` (optionally with
+    `cmd_id`) to cancel every pending request for a node. Only `requested`
+    and `in_progress` requests can be cancelled. It throws
+    `MISSING_CANCEL_COMMAND_SCOPE` when neither `request_id` nor `node_id`
+    is given, and `CMD_ID_REQUIRES_NODE_ID` when `cmd_id` is sent without
+    `node_id`.
+  - New types: `CancelCommandRequestsParams`,
+    `CancelCommandRequestsResponse`, `CommandRequestStatus` and
+    `CommandRequestDataError`.
+- **Errors**
+  - Added the `MISSING_CANCEL_COMMAND_SCOPE` and `CMD_ID_REQUIRES_NODE_ID`
+    API-call validation codes.
+
+### Changed
+
+- **Command requests** (`ESPRMAdminNode`)
+  - `CommandRequestInfo.status` and `GetCommandRequestsParams.status` are
+    now typed as `CommandRequestStatus` (`requested`, `in_progress`,
+    `success`, `failure`, `timed_out`, `overridden`, `cancelled`). Code that
+    passed an arbitrary string will no longer type-check; the backend never
+    returned any other value.
+  - `CommandRequestInfo` now declares the fields the backend already
+    returned: `user_name`, `is_base64`, `request_data_error`,
+    `response_data_error`, `indefinite_timeout` and `for_user`. Timestamp
+    fields are documented as epoch seconds.
+  - `GetCommandRequestsParams.start_time` / `end_time` are documented as
+    epoch seconds that must be sent together; the backend only honours a
+    time range when the `cmd_resp_history` deployment setting is enabled.
+- **CSV node certificate registration** (`ESPRMAdminNodeRegistration`)
+  - `RegisterNodeCertificatesRequest` now describes the real request body:
+    `file_name`, `file_md5`, `request_id` and `refresh_token` are required
+    (the backend rejects the call without them), and `type`, `model`,
+    `subtype`, `group_name`, `parent_group_id`, `parent_group_name`, `tags`,
+    `force`, `update_nodes`, `node_policies` and `tenant_id` are optional.
+    The previous `node_ids` / `certs` shape and its index signature are
+    removed.
+  - `registerNodeCertificates` now resolves to
+    `RegisterNodeCertificatesResponse`, which includes the `request_id`.
+  - `NodeCertificateRegistrationStatusResponse` now declares the fields the
+    backend returns (`completed_count`, `total_count`, `description`,
+    `failed_registration`, `group_name`, `group_id`) and types `status` as
+    `NodeRegistrationRequestStatus`. The undocumented `request_id` field and
+    the index signature are removed; the backend never returned them.
+- **Node endpoints**
+  - `GetMQTTHostResponse` now declares `mqtt_cred_host` (the AWS IoT
+    credential provider endpoint) and `https_host`, which
+    `admin/mqtt_host` already returned. Callers that read them through the
+    index signature keep working.
+
+### Notes
+
+- CSV registration is a three-step flow: call
+  `getNodeCertificateUploadUrl()`, `PUT` the CSV to the returned URL
+  **without** an `Authorization` header, then call
+  `registerNodeCertificates()` with the same `request_id` and the file's hex
+  MD5. Track progress with `getNodeCertificateRegistrationStatus()` or
+  `getNodeRegistrationRequest()`.
+- `getNodeCertificateRegistrationStatus()` checks the batch job and reports
+  `failure` when the job died while the request was still `requested`;
+  `getNodeRegistrationRequest()` returns the stored status as-is.
+
+## [1.1.1] - 2026-09-23
+
+Patch release for the simple time series data endpoint. The time range
+becomes optional, as the backend always allowed, and optional query
+parameters that are left undefined are no longer sent as the literal text
+`undefined`. No breaking changes; every existing call keeps working as before.
+
+### Changed
+
+- **Simple time series data**
+  - `start_time` and `end_time` on `GetSimpleTimeSeriesDataParams` are now
+    optional, matching the backend: omitting them queries from the oldest
+    record up to now. Existing callers that pass both are unaffected.
+
+### Fixed
+
+- **Query parameter serialisation**
+  - `ESPRMAPIManager.request()` no longer sends optional query parameters
+    that are `undefined` or `null`. Previously `URLSearchParams` turned them
+    into the literal text `undefined` / `null`, which the backend rejected
+    (for example `start_time=undefined` on `/admin/nodes/simple_tsdata`).
+    Numbers and booleans are stringified explicitly, and a params object
+    with no remaining entries produces no `?` at all.
 
 ## [1.1.0] - 2026-09-18
 

package/dist/cjs/entries/ESPRMAdminNode.cjs

@@ -12,6 +12,7 @@ require('../methods/ESPRMAdminNode/RemoveNodeTags.cjs');
 require('../methods/ESPRMAdminNode/GetNodeTags.cjs');
 require('../methods/ESPRMAdminNode/GetCommandRequests.cjs');
 require('../methods/ESPRMAdminNode/AddCommandRequest.cjs');
+require('../methods/ESPRMAdminNode/CancelCommandRequests.cjs');
 require('../methods/ESPRMAdminNode/GetTimeSeriesData.cjs');
 require('../methods/ESPRMAdminNode/GetSimpleTimeSeriesData.cjs');
 var ESPRMAdminNode = require('../ESPRMAdminNode.cjs');

package/dist/cjs/entries/ESPRMAdminNodeRegistration.cjs

@@ -10,8 +10,11 @@ require('../methods/ESPRMAdminNodeRegistration/GetNodeIds.cjs');
 require('../methods/ESPRMAdminNodeRegistration/GetNodeCertificates.cjs');
 require('../methods/ESPRMAdminNodeRegistration/GetNodeCertificateRegistrationStatus.cjs');
 require('../methods/ESPRMAdminNodeRegistration/RegisterNodeCertificates.cjs');
+require('../methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.cjs');
 require('../methods/ESPRMAdminNodeRegistration/GetMQTTHost.cjs');
 require('../methods/ESPRMAdminNodeRegistration/GetCustomMQTTHost.cjs');
+require('../methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.cjs');
+require('../methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.cjs');
 var ESPRMAdminNodeRegistration = require('../ESPRMAdminNodeRegistration.cjs');
 
 

package/dist/cjs/index.cjs

@@ -80,6 +80,7 @@ require('./methods/ESPRMAdminNode/RemoveNodeTags.cjs');
 require('./methods/ESPRMAdminNode/GetNodeTags.cjs');
 require('./methods/ESPRMAdminNode/GetCommandRequests.cjs');
 require('./methods/ESPRMAdminNode/AddCommandRequest.cjs');
+require('./methods/ESPRMAdminNode/CancelCommandRequests.cjs');
 require('./methods/ESPRMAdminNode/GetTimeSeriesData.cjs');
 require('./methods/ESPRMAdminNode/GetSimpleTimeSeriesData.cjs');
 require('./methods/ESPRMAdminOTAImage/UploadImage.cjs');
@@ -160,8 +161,11 @@ require('./methods/ESPRMAdminNodeRegistration/GetNodeIds.cjs');
 require('./methods/ESPRMAdminNodeRegistration/GetNodeCertificates.cjs');
 require('./methods/ESPRMAdminNodeRegistration/GetNodeCertificateRegistrationStatus.cjs');
 require('./methods/ESPRMAdminNodeRegistration/RegisterNodeCertificates.cjs');
+require('./methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.cjs');
 require('./methods/ESPRMAdminNodeRegistration/GetMQTTHost.cjs');
 require('./methods/ESPRMAdminNodeRegistration/GetCustomMQTTHost.cjs');
+require('./methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.cjs');
+require('./methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.cjs');
 require('./methods/ESPRMAdminSuperAdmin/ChangeSuperAdmin.cjs');
 require('./methods/ESPRMAdminSenderEmail/ChangeSenderEmail.cjs');
 require('./methods/ESPRMAdminCommonCustomData/SetCommonCustomData.cjs');

package/dist/cjs/methods/ESPRMAdminNode/CancelCommandRequests.cjs

@@ -0,0 +1,27 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMAdminNode = require('../../ESPRMAdminNode.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+
+ESPRMAdminNode.ESPRMAdminNode.prototype.cancelCommandRequests = async function (params) {
+    if (!params?.request_id && !params?.node_id) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_CANCEL_COMMAND_SCOPE);
+    }
+    if (params.cmd_id !== undefined && !params.node_id) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.CMD_ID_REQUIRES_NODE_ID);
+    }
+    const requestConfig = {
+        url: constants.APIEndpoints.ADMIN_CMD,
+        method: constants.HTTPMethods.DELETE,
+        params,
+    };
+    const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+    return response;
+};

package/dist/cjs/methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.cjs

@@ -0,0 +1,25 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMAdminNodeRegistration = require('../../ESPRMAdminNodeRegistration.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+
+ESPRMAdminNodeRegistration.ESPRMAdminNodeRegistration.prototype.getNodeCertificateUploadUrl =
+    async function (params) {
+        if (!params.file_name) {
+            throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_FILE_NAME);
+        }
+        const requestConfig = {
+            url: constants.APIEndpoints.ADMIN_NODE_CERTIFICATES_REGISTER,
+            method: constants.HTTPMethods.GET,
+            params: { file_name: params.file_name },
+        };
+        const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+        return response;
+    };

package/dist/cjs/methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.cjs

@@ -0,0 +1,24 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMAdminNodeRegistration = require('../../ESPRMAdminNodeRegistration.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+
+ESPRMAdminNodeRegistration.ESPRMAdminNodeRegistration.prototype.getNodeRegistrationRequest =
+    async function (requestId) {
+        if (!requestId) {
+            throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_REQUEST_ID);
+        }
+        const requestConfig = {
+            url: `${constants.APIEndpoints.ADMIN_NODE_REGISTRATION_REQUESTS}/${encodeURIComponent(requestId)}`,
+            method: constants.HTTPMethods.GET,
+        };
+        const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+        return response;
+    };

package/dist/cjs/methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.cjs

@@ -0,0 +1,21 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMAdminNodeRegistration = require('../../ESPRMAdminNodeRegistration.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+
+ESPRMAdminNodeRegistration.ESPRMAdminNodeRegistration.prototype.listNodeRegistrationRequests =
+    async function (params) {
+        const requestConfig = {
+            url: constants.APIEndpoints.ADMIN_NODE_REGISTRATION_REQUESTS,
+            method: constants.HTTPMethods.GET,
+            ...(params && { params }),
+        };
+        const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+        return response;
+    };

package/dist/cjs/services/ESPRMAPIManager.cjs

@@ -77,8 +77,16 @@ class ESPRMAPIManager {
         const base = requestConfig.baseURL ?? instance.#baseUrl;
         let requestUrl = `${base}/${requestConfig.url}`;
         if (requestConfig.params) {
-            const queryParams = new URLSearchParams(requestConfig.params).toString();
-            requestUrl += `?${queryParams}`;
+            // `URLSearchParams` stringifies every own key, so an optional param
+            // left as `undefined` would reach the backend as the literal text
+            // "undefined" and fail validation. Drop absent values and let
+            // numbers / booleans stringify explicitly.
+            const queryEntries = Object.entries(requestConfig.params)
+                .filter(([, value]) => value !== undefined && value !== null)
+                .map(([key, value]) => [key, String(value)]);
+            if (queryEntries.length > 0) {
+                requestUrl += `?${new URLSearchParams(queryEntries).toString()}`;
+            }
         }
         const fetchOptions = {
             method: requestConfig.method,

package/dist/cjs/utils/constants.cjs

@@ -70,6 +70,7 @@ const APIEndpoints = {
     ADMIN_NODE_IDS: "admin/node_ids",
     ADMIN_NODE_CERTIFICATES: "admin/node_certificates",
     ADMIN_NODE_CERTIFICATES_REGISTER: "admin/node_certificates/register",
+    ADMIN_NODE_REGISTRATION_REQUESTS: "admin/node_registrations/requests",
     ADMIN_API_STATS: "admin/api_stats",
     ADMIN_MQTT_STATS: "admin/mqtt_stats",
     ADMIN_CHANGE_SUPER_ADMIN: "admin/change_super_admin",
@@ -150,6 +151,8 @@ const APICallValidationErrorCodes = {
     MISSING_PLATFORM_NAME: "MISSING_PLATFORM_NAME",
     MISSING_PLATFORM_APPLICATION_ARN: "MISSING_PLATFORM_APPLICATION_ARN",
     MISSING_BATCH_ID: "MISSING_BATCH_ID",
+    MISSING_CANCEL_COMMAND_SCOPE: "MISSING_CANCEL_COMMAND_SCOPE",
+    CMD_ID_REQUIRES_NODE_ID: "CMD_ID_REQUIRES_NODE_ID",
 };
 const TokenErrorCodes = {
     MISSING_ACCESS_TOKEN: "MISSING_ACCESS_TOKEN",

package/dist/cjs/utils/error/errorMessages.cjs

@@ -54,6 +54,8 @@ const apiCallValidationErrorMessages = {
     MISSING_PLATFORM_NAME: "ESPAPICallValidationError: Platform name is required.",
     MISSING_PLATFORM_APPLICATION_ARN: "ESPAPICallValidationError: Platform application ARN is required.",
     MISSING_BATCH_ID: "ESPAPICallValidationError: Batch ID is required.",
+    MISSING_CANCEL_COMMAND_SCOPE: "ESPAPICallValidationError: Request ID or node ID is required.",
+    CMD_ID_REQUIRES_NODE_ID: "ESPAPICallValidationError: Command ID can only be used together with a node ID.",
 };
 const tokenErrorMessages = {
     MISSING_ACCESS_TOKEN: "ESPTokenError: Access token is missing. User needs to authenticate.",

package/dist/esm/entries/ESPRMAdminNode.js

@@ -10,6 +10,7 @@ import '../methods/ESPRMAdminNode/RemoveNodeTags.js';
 import '../methods/ESPRMAdminNode/GetNodeTags.js';
 import '../methods/ESPRMAdminNode/GetCommandRequests.js';
 import '../methods/ESPRMAdminNode/AddCommandRequest.js';
+import '../methods/ESPRMAdminNode/CancelCommandRequests.js';
 import '../methods/ESPRMAdminNode/GetTimeSeriesData.js';
 import '../methods/ESPRMAdminNode/GetSimpleTimeSeriesData.js';
 export { ESPRMAdminNode } from '../ESPRMAdminNode.js';

package/dist/esm/entries/ESPRMAdminNodeRegistration.js

@@ -8,6 +8,9 @@ import '../methods/ESPRMAdminNodeRegistration/GetNodeIds.js';
 import '../methods/ESPRMAdminNodeRegistration/GetNodeCertificates.js';
 import '../methods/ESPRMAdminNodeRegistration/GetNodeCertificateRegistrationStatus.js';
 import '../methods/ESPRMAdminNodeRegistration/RegisterNodeCertificates.js';
+import '../methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.js';
 import '../methods/ESPRMAdminNodeRegistration/GetMQTTHost.js';
 import '../methods/ESPRMAdminNodeRegistration/GetCustomMQTTHost.js';
+import '../methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.js';
+import '../methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.js';
 export { ESPRMAdminNodeRegistration } from '../ESPRMAdminNodeRegistration.js';

package/dist/esm/index.js

@@ -78,6 +78,7 @@ import './methods/ESPRMAdminNode/RemoveNodeTags.js';
 import './methods/ESPRMAdminNode/GetNodeTags.js';
 import './methods/ESPRMAdminNode/GetCommandRequests.js';
 import './methods/ESPRMAdminNode/AddCommandRequest.js';
+import './methods/ESPRMAdminNode/CancelCommandRequests.js';
 import './methods/ESPRMAdminNode/GetTimeSeriesData.js';
 import './methods/ESPRMAdminNode/GetSimpleTimeSeriesData.js';
 import './methods/ESPRMAdminOTAImage/UploadImage.js';
@@ -158,8 +159,11 @@ import './methods/ESPRMAdminNodeRegistration/GetNodeIds.js';
 import './methods/ESPRMAdminNodeRegistration/GetNodeCertificates.js';
 import './methods/ESPRMAdminNodeRegistration/GetNodeCertificateRegistrationStatus.js';
 import './methods/ESPRMAdminNodeRegistration/RegisterNodeCertificates.js';
+import './methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.js';
 import './methods/ESPRMAdminNodeRegistration/GetMQTTHost.js';
 import './methods/ESPRMAdminNodeRegistration/GetCustomMQTTHost.js';
+import './methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.js';
+import './methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.js';
 import './methods/ESPRMAdminSuperAdmin/ChangeSuperAdmin.js';
 import './methods/ESPRMAdminSenderEmail/ChangeSenderEmail.js';
 import './methods/ESPRMAdminCommonCustomData/SetCommonCustomData.js';

package/dist/esm/methods/ESPRMAdminNode/CancelCommandRequests.js

@@ -0,0 +1,25 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ESPRMAdminNode } from '../../ESPRMAdminNode.js';
+import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
+import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
+
+ESPRMAdminNode.prototype.cancelCommandRequests = async function (params) {
+    if (!params?.request_id && !params?.node_id) {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_CANCEL_COMMAND_SCOPE);
+    }
+    if (params.cmd_id !== undefined && !params.node_id) {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.CMD_ID_REQUIRES_NODE_ID);
+    }
+    const requestConfig = {
+        url: APIEndpoints.ADMIN_CMD,
+        method: HTTPMethods.DELETE,
+        params,
+    };
+    const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
+    return response;
+};

package/dist/esm/methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.js

@@ -0,0 +1,23 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ESPRMAdminNodeRegistration } from '../../ESPRMAdminNodeRegistration.js';
+import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
+import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
+
+ESPRMAdminNodeRegistration.prototype.getNodeCertificateUploadUrl =
+    async function (params) {
+        if (!params.file_name) {
+            throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_FILE_NAME);
+        }
+        const requestConfig = {
+            url: APIEndpoints.ADMIN_NODE_CERTIFICATES_REGISTER,
+            method: HTTPMethods.GET,
+            params: { file_name: params.file_name },
+        };
+        const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
+        return response;
+    };

package/dist/esm/methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.js

@@ -0,0 +1,22 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ESPRMAdminNodeRegistration } from '../../ESPRMAdminNodeRegistration.js';
+import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
+import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
+
+ESPRMAdminNodeRegistration.prototype.getNodeRegistrationRequest =
+    async function (requestId) {
+        if (!requestId) {
+            throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_REQUEST_ID);
+        }
+        const requestConfig = {
+            url: `${APIEndpoints.ADMIN_NODE_REGISTRATION_REQUESTS}/${encodeURIComponent(requestId)}`,
+            method: HTTPMethods.GET,
+        };
+        const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
+        return response;
+    };

package/dist/esm/methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.js

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ESPRMAdminNodeRegistration } from '../../ESPRMAdminNodeRegistration.js';
+import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
+import { HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+
+ESPRMAdminNodeRegistration.prototype.listNodeRegistrationRequests =
+    async function (params) {
+        const requestConfig = {
+            url: APIEndpoints.ADMIN_NODE_REGISTRATION_REQUESTS,
+            method: HTTPMethods.GET,
+            ...(params && { params }),
+        };
+        const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
+        return response;
+    };

package/dist/esm/services/ESPRMAPIManager.js

@@ -75,8 +75,16 @@ class ESPRMAPIManager {
         const base = requestConfig.baseURL ?? instance.#baseUrl;
         let requestUrl = `${base}/${requestConfig.url}`;
         if (requestConfig.params) {
-            const queryParams = new URLSearchParams(requestConfig.params).toString();
-            requestUrl += `?${queryParams}`;
+            // `URLSearchParams` stringifies every own key, so an optional param
+            // left as `undefined` would reach the backend as the literal text
+            // "undefined" and fail validation. Drop absent values and let
+            // numbers / booleans stringify explicitly.
+            const queryEntries = Object.entries(requestConfig.params)
+                .filter(([, value]) => value !== undefined && value !== null)
+                .map(([key, value]) => [key, String(value)]);
+            if (queryEntries.length > 0) {
+                requestUrl += `?${new URLSearchParams(queryEntries).toString()}`;
+            }
         }
         const fetchOptions = {
             method: requestConfig.method,

package/dist/esm/utils/constants.js

@@ -68,6 +68,7 @@ const APIEndpoints = {
     ADMIN_NODE_IDS: "admin/node_ids",
     ADMIN_NODE_CERTIFICATES: "admin/node_certificates",
     ADMIN_NODE_CERTIFICATES_REGISTER: "admin/node_certificates/register",
+    ADMIN_NODE_REGISTRATION_REQUESTS: "admin/node_registrations/requests",
     ADMIN_API_STATS: "admin/api_stats",
     ADMIN_MQTT_STATS: "admin/mqtt_stats",
     ADMIN_CHANGE_SUPER_ADMIN: "admin/change_super_admin",
@@ -148,6 +149,8 @@ const APICallValidationErrorCodes = {
     MISSING_PLATFORM_NAME: "MISSING_PLATFORM_NAME",
     MISSING_PLATFORM_APPLICATION_ARN: "MISSING_PLATFORM_APPLICATION_ARN",
     MISSING_BATCH_ID: "MISSING_BATCH_ID",
+    MISSING_CANCEL_COMMAND_SCOPE: "MISSING_CANCEL_COMMAND_SCOPE",
+    CMD_ID_REQUIRES_NODE_ID: "CMD_ID_REQUIRES_NODE_ID",
 };
 const TokenErrorCodes = {
     MISSING_ACCESS_TOKEN: "MISSING_ACCESS_TOKEN",

package/dist/esm/utils/error/errorMessages.js

@@ -52,6 +52,8 @@ const apiCallValidationErrorMessages = {
     MISSING_PLATFORM_NAME: "ESPAPICallValidationError: Platform name is required.",
     MISSING_PLATFORM_APPLICATION_ARN: "ESPAPICallValidationError: Platform application ARN is required.",
     MISSING_BATCH_ID: "ESPAPICallValidationError: Batch ID is required.",
+    MISSING_CANCEL_COMMAND_SCOPE: "ESPAPICallValidationError: Request ID or node ID is required.",
+    CMD_ID_REQUIRES_NODE_ID: "ESPAPICallValidationError: Command ID can only be used together with a node ID.",
 };
 const tokenErrorMessages = {
     MISSING_ACCESS_TOKEN: "ESPTokenError: Access token is missing. User needs to authenticate.",

package/dist/types/methods/ESPRMAdminNode/CancelCommandRequests.d.ts

@@ -0,0 +1,22 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CancelCommandRequestsParams, CancelCommandRequestsResponse } from "../../types/command_response.js";
+declare module "../../ESPRMAdminNode.js" {
+    interface ESPRMAdminNode {
+        /**
+         * Cancels pending (`requested` or `in_progress`) command requests created by any user.
+         *
+         * - `request_id`: cancels that request. The backend rejects the call (131020)
+         *   when the request is no longer pending.
+         * - `node_id`: cancels every pending request for the node, optionally narrowed
+         *   by `cmd_id`. Returns `total_cancelled: 0` when nothing matches.
+         *
+         * @param params - The cancel scope.
+         * @returns The number of requests that were cancelled.
+         */
+        cancelCommandRequests(params: CancelCommandRequestsParams): Promise<CancelCommandRequestsResponse>;
+    }
+}

package/dist/types/methods/ESPRMAdminNode/index.d.ts

@@ -10,5 +10,6 @@ import "./RemoveNodeTags.js";
 import "./GetNodeTags.js";
 import "./GetCommandRequests.js";
 import "./AddCommandRequest.js";
+import "./CancelCommandRequests.js";
 import "./GetTimeSeriesData.js";
 import "./GetSimpleTimeSeriesData.js";

package/dist/types/methods/ESPRMAdminNodeRegistration/GetMQTTHost.d.ts

@@ -7,9 +7,10 @@ import { GetMQTTHostResponse } from "../../types/node_registration.js";
 declare module "../../ESPRMAdminNodeRegistration.js" {
     interface ESPRMAdminNodeRegistration {
         /**
-         * Retrieves the default MQTT host endpoint for the deployment.
+         * Retrieves the deployment's default node endpoints: the MQTT host, the
+         * IoT credential provider host and, when configured, the HTTPS host.
          *
-         * @returns The MQTT host information.
+         * @returns The node endpoint information.
          */
         getMQTTHost(): Promise<GetMQTTHostResponse>;
     }

package/dist/types/methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.d.ts

@@ -0,0 +1,18 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GetNodeCertificateUploadUrlParams, NodeCertificateUploadUrlResponse } from "../../types/node_registration.js";
+declare module "../../ESPRMAdminNodeRegistration.js" {
+    interface ESPRMAdminNodeRegistration {
+        /**
+         * Fetches a pre-signed URL to upload a node certificates CSV, along with
+         * the request ID to pass to `registerNodeCertificates`.
+         *
+         * @param params - Must include the name of the CSV file.
+         * @returns The pre-signed upload URL and the registration request ID.
+         */
+        getNodeCertificateUploadUrl(params: GetNodeCertificateUploadUrlParams): Promise<NodeCertificateUploadUrlResponse>;
+    }
+}

package/dist/types/methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.d.ts

@@ -0,0 +1,17 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NodeRegistrationRequestDetail } from "../../types/node_registration.js";
+declare module "../../ESPRMAdminNodeRegistration.js" {
+    interface ESPRMAdminNodeRegistration {
+        /**
+         * Retrieves the full detail of a node certificate registration request.
+         *
+         * @param requestId - The ID of the registration request.
+         * @returns The registration request detail.
+         */
+        getNodeRegistrationRequest(requestId: string): Promise<NodeRegistrationRequestDetail>;
+    }
+}

package/dist/types/methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.d.ts

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ListNodeRegistrationRequestsParams } from "../../types/node_registration.js";
+import { ListNodeRegistrationRequestsResponse } from "../../types/node_registration.js";
+declare module "../../ESPRMAdminNodeRegistration.js" {
+    interface ESPRMAdminNodeRegistration {
+        /**
+         * Lists the node certificate registration requests of the signed-in
+         * admin, newest first.
+         *
+         * @param params - Optional status filter and pagination.
+         * @returns A page of registration requests.
+         */
+        listNodeRegistrationRequests(params?: ListNodeRegistrationRequestsParams): Promise<ListNodeRegistrationRequestsResponse>;
+    }
+}

package/dist/types/methods/ESPRMAdminNodeRegistration/RegisterNodeCertificates.d.ts

@@ -3,16 +3,16 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
-import { RegisterNodeCertificatesRequest } from "../../types/node_registration.js";
-import { ESPAPISuccessResponse } from "../../types/api.js";
+import { RegisterNodeCertificatesRequest, RegisterNodeCertificatesResponse } from "../../types/node_registration.js";
 declare module "../../ESPRMAdminNodeRegistration.js" {
     interface ESPRMAdminNodeRegistration {
         /**
-         * Registers node certificates for device authentication.
+         * Triggers registration of the node certificates in a CSV that was
+         * uploaded to the URL from `getNodeCertificateUploadUrl`.
          *
-         * @param params - The certificate data to register.
-         * @returns A success response upon registration.
+         * @param params - The uploaded file details and registration options.
+         * @returns The ID of the registration request.
          */
-        registerNodeCertificates(params: RegisterNodeCertificatesRequest): Promise<ESPAPISuccessResponse>;
+        registerNodeCertificates(params: RegisterNodeCertificatesRequest): Promise<RegisterNodeCertificatesResponse>;
     }
 }