@espressif/rainmaker-admin-sdk 1.1.1 → 1.3.0

package/CHANGELOG.md

@@ -3,6 +3,215 @@
 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.
 
+## [1.3.0] - 2026-10-06
+
+Minor release that adds node deletion, node claiming through the standalone
+claiming service (new `ESPRMClaim` module) and a delete helper for common
+custom data. It also folds in the fixes prepared for 1.2.1, which was never
+published: corrected webhook integration, event filter and common custom data
+types, and a fix for `activateDeactivateNodes`, which could not have worked
+before.
+
+Some request and response types change shape to match the backend. In every
+case the old shape was never accepted or returned by the backend, so no
+working caller breaks at runtime, but code built on the old types will no
+longer type-check.
+
+### Added
+
+- **Node deletion** (`ESPRMAdminNode`)
+  - `deleteNode(nodeId)` → `DELETE admin/nodes?node_id=<id>&delete_node=true`.
+    Permanently deletes one node (certificates, IoT thing, data, user and
+    group mappings). Public deployments only; the backend rejects it on
+    customer deployments with error 105059.
+  - `MAX_NODE_ACTIVATION_BATCH_SIZE` constant (25), plus validation error
+    codes `MISSING_NODE_IDS` and `TOO_MANY_NODE_IDS`.
+  - `ActivateDeactivateNodesResponse`, `NodeActivationMultiStatusResponse`,
+    `NodeActivationSuccessResult` and `NodeActivationFailureResult` types.
+
+- **Node claiming** (`ESPRMClaim`, new module)
+  - `initiateClaim({ mac_addr, platform })` → `POST claim/initiate`, returns
+    `{ node_id }`.
+  - `verifyClaim({ csr, send_mqtt_host?, node_policies? }, { matter?, test? })`
+    → `POST claim/verify`, returns `{ certificate, mqtt_host?, mqtt_cred_host? }`.
+    `test` is only sent when `matter` is true.
+  - Both call the standalone claiming service (public deployments only), not
+    the RainMaker API. Configure it with the new optional
+    `ESPRMBase.configure({ claimingBaseUrl })`; calls without it throw
+    `ESPConfigError` `CLAIMING_NOT_CONFIGURED`. An invalid URL throws
+    `INVALID_CLAIMING_BASE_URL` at configure time.
+  - Validation error codes `MISSING_MAC_ADDRESS`, `MISSING_CLAIM_PLATFORM`
+    and `MISSING_CSR`.
+  - Only authenticated claiming is supported; the unauthenticated
+    challenge/response variant is not exposed.
+  - Available from the package root and the new
+    `@espressif/rainmaker-admin-sdk/ESPRMClaim` sub-path.
+
+- **Common custom data** (`ESPRMAdminCommonCustomData`)
+  - `deleteCommonCustomData({ name })`. The backend has no DELETE method for
+    this resource; it deletes an entry when `PUT admin/common_custom_data`
+    receives `value: null`. Callers no longer need to know that.
+  - `CommonCustomDataItem` (`{ name, value, perms? }`) and
+    `DeleteCommonCustomDataRequest` types.
+  - Validation error codes `MISSING_COMMON_CUSTOM_DATA_NAME` and
+    `MISSING_COMMON_CUSTOM_DATA_VALUE`.
+
+### Fixed
+
+- **Node activation** (`ESPRMAdminNode`) — **breaking**
+  - `activateDeactivateNodes` sent `node_id` and `activate` as a JSON body,
+    but `PUT admin/nodes` reads them from the query string only (the body is
+    parsed as tags), so every call failed with error 105018. They are now
+    sent as query parameters.
+  - `ActivateDeactivateNodesParams` is now `{ node_ids: string[]; activate }`
+    (was `{ node_id: string; activate }`), matching the backend's batch
+    support of up to 25 comma-separated IDs. The method throws
+    `ESPAPICallValidationError` for an empty list or more than 25 IDs.
+    The endpoint is supported on private (customer) deployments only.
+  - The return type is `ActivateDeactivateNodesResponse`: a single success,
+    or a 207 `{ responses }` list with per-node results when outcomes differ.
+    Since the old call never succeeded, no working caller breaks at runtime.
+
+- **Common custom data** (`ESPRMAdminCommonCustomData`)
+  - `GetCommonCustomDataResponse` is now `CommonCustomDataItem[]` instead of
+    a `{ [key: string]: unknown }` map. `GET admin/common_custom_data` has
+    always returned an array, including a single-element array when `name`
+    is given. Code that indexed the old map type will no longer type-check.
+  - `setCommonCustomData` now throws `ESPAPICallValidationError` when `name`
+    is empty or `value` is `null`/`undefined`. The backend treats a null or
+    missing value as a delete, and `JSON.stringify` drops `undefined`, so an
+    accidental `undefined` used to wipe the entry.
+  - Documented the PUT merge semantics on `SetCommonCustomDataRequest`:
+    object values are deep merged (omitted keys are kept, nested `null`
+    deletes a key); other value types replace the stored value.
+
+- **Webhook integrations** (`ESPRMAdminWebhook`)
+  - `GetWebhookIntegrationsResponse` now declares `integration_info_list`
+    (`WebhookIntegrationInfo[] | null`) instead of `webhooks_endpoints`.
+    `GET admin/webhook_integration` has always returned
+    `integration_info_list`, and returns `null` when no integrations are
+    configured. The backend never sent `webhooks_endpoints`, so no working
+    caller can break at runtime, but code that read that field will no
+    longer type-check.
+
+- **Event filters** (`ESPRMAdminEventFilter`)
+  - `UpdateEventFilterRequest.enabled_for_integrations` is now optional.
+    `PUT admin/event_filter` keeps the stored integration list when the
+    field is omitted, so callers can change only `enabled`. Existing
+    callers that pass the field are unaffected.
+  - Documented the update semantics: the list adds (`enabled: true`) or
+    removes (`enabled: false`) integrations rather than replacing the
+    stored list, and a non-empty list makes the backend derive `enabled`.
+    The call fails with error `113109` when the mapping does not exist; it
+    never creates one.
+
+### Security
+
+- `claimingBaseUrl` receives the user's access token on every `ESPRMClaim`
+  call. Set it only to a trusted Espressif claiming endpoint.
+
+## [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

package/README.md

@@ -121,9 +121,10 @@ const adminNode = new ESPRMAdminNode();
 
 const nodes = await adminNode.getNodes({ num_records: "50" });
 await adminNode.activateDeactivateNodes({
-  node_id: "<NODE_ID>",
+  node_ids: ["<NODE_ID_1>", "<NODE_ID_2>"], // up to 25 per call
   activate: true,
 });
+await adminNode.deleteNode("<NODE_ID>"); // public deployments only
 ```
 
 ### OTA

package/dist/cjs/ESPRMBase.cjs

@@ -38,6 +38,7 @@ class ESPRMBase {
             baseUrl: config.baseUrl,
             version,
             timeoutMs: config.timeoutMs,
+            claimingBaseUrl: config.claimingBaseUrl,
         });
         ESPRMStorage.ESPRMStorage.initialize(config.customStorageAdapter);
     }

package/dist/cjs/ESPRMClaim.cjs

@@ -0,0 +1,16 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+/**
+ * Shell class for the standalone ESP RainMaker claiming service.
+ * Requires `claimingBaseUrl` in {@link ESPRMBase.configure}.
+ * Methods are added via prototype augmentation in methods/ESPRMClaim/*.
+ */
+class ESPRMClaim {
+}
+
+exports.ESPRMClaim = ESPRMClaim;

package/dist/cjs/entries/ESPRMAdminCommonCustomData.cjs

@@ -7,6 +7,7 @@
 
 require('../methods/ESPRMAdminCommonCustomData/SetCommonCustomData.cjs');
 require('../methods/ESPRMAdminCommonCustomData/GetCommonCustomData.cjs');
+require('../methods/ESPRMAdminCommonCustomData/DeleteCommonCustomData.cjs');
 var ESPRMAdminCommonCustomData = require('../ESPRMAdminCommonCustomData.cjs');
 
 

package/dist/cjs/entries/ESPRMAdminNode.cjs

@@ -9,9 +9,11 @@ require('../methods/ESPRMAdminNode/GetNodes.cjs');
 require('../methods/ESPRMAdminNode/ActivateDeactivateNodes.cjs');
 require('../methods/ESPRMAdminNode/AttachNodeTags.cjs');
 require('../methods/ESPRMAdminNode/RemoveNodeTags.cjs');
+require('../methods/ESPRMAdminNode/DeleteNode.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/entries/ESPRMClaim.cjs

@@ -0,0 +1,14 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+require('../methods/ESPRMClaim/InitiateClaim.cjs');
+require('../methods/ESPRMClaim/VerifyClaim.cjs');
+var ESPRMClaim = require('../ESPRMClaim.cjs');
+
+
+
+exports.ESPRMClaim = ESPRMClaim.ESPRMClaim;

package/dist/cjs/index.cjs

@@ -56,6 +56,7 @@ var ESPRMAdminAPIStatistics = require('./ESPRMAdminAPIStatistics.cjs');
 var ESPRMAdminMQTTStatistics = require('./ESPRMAdminMQTTStatistics.cjs');
 var ESPRMAdminMatter = require('./ESPRMAdminMatter.cjs');
 var ESPRMAdminNodeParams = require('./ESPRMAdminNodeParams.cjs');
+var ESPRMClaim = require('./ESPRMClaim.cjs');
 require('./methods/ESPRMAuth/Login.cjs');
 require('./methods/ESPRMAuth/Logout.cjs');
 require('./methods/ESPRMAuth/ForgotPassword.cjs');
@@ -77,9 +78,11 @@ require('./methods/ESPRMAdminNode/GetNodes.cjs');
 require('./methods/ESPRMAdminNode/ActivateDeactivateNodes.cjs');
 require('./methods/ESPRMAdminNode/AttachNodeTags.cjs');
 require('./methods/ESPRMAdminNode/RemoveNodeTags.cjs');
+require('./methods/ESPRMAdminNode/DeleteNode.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,12 +163,16 @@ 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');
 require('./methods/ESPRMAdminCommonCustomData/GetCommonCustomData.cjs');
+require('./methods/ESPRMAdminCommonCustomData/DeleteCommonCustomData.cjs');
 require('./methods/ESPRMAdminDeploymentSetting/GetDeploymentSettings.cjs');
 require('./methods/ESPRMAdminDeploymentSetting/UpdateDeploymentConfig.cjs');
 require('./methods/ESPRMAdminConfiguration/GetNotifications.cjs');
@@ -188,6 +195,8 @@ require('./methods/ESPRMAdminPassthrough/CreatePassthroughConfig.cjs');
 require('./methods/ESPRMAdminPassthrough/UpdatePassthroughConfig.cjs');
 require('./methods/ESPRMAdminNodeCertificateCA/UpdateNodeCACertificate.cjs');
 require('./methods/ESPRMAdminNodeCertificateCA/GetNodeCACertificate.cjs');
+require('./methods/ESPRMClaim/InitiateClaim.cjs');
+require('./methods/ESPRMClaim/VerifyClaim.cjs');
 require('./methods/ESPRMAdminWebhook/CreateWebhookIntegration.cjs');
 require('./methods/ESPRMAdminWebhook/UpdateWebhookIntegration.cjs');
 require('./methods/ESPRMAdminWebhook/GetWebhookIntegrations.cjs');
@@ -279,6 +288,7 @@ exports.ESPRMAdminAPIStatistics = ESPRMAdminAPIStatistics.ESPRMAdminAPIStatistic
 exports.ESPRMAdminMQTTStatistics = ESPRMAdminMQTTStatistics.ESPRMAdminMQTTStatistics;
 exports.ESPRMAdminMatter = ESPRMAdminMatter.ESPRMAdminMatter;
 exports.ESPRMAdminNodeParams = ESPRMAdminNodeParams.ESPRMAdminNodeParams;
+exports.ESPRMClaim = ESPRMClaim.ESPRMClaim;
 exports.APICallValidationErrorCodes = constants.APICallValidationErrorCodes;
 exports.APIEndpoints = constants.APIEndpoints;
 exports.APIErrorCodes = constants.APIErrorCodes;
@@ -289,6 +299,7 @@ exports.DEFAULT_REST_API_VERSION = constants.DEFAULT_REST_API_VERSION;
 exports.ErrorLabels = constants.ErrorLabels;
 exports.HTTPMethods = constants.HTTPMethods;
 exports.HTTPStatusCodes = constants.HTTPStatusCodes;
+exports.MAX_NODE_ACTIVATION_BATCH_SIZE = constants.MAX_NODE_ACTIVATION_BATCH_SIZE;
 exports.StorageAdapterErrorCodes = constants.StorageAdapterErrorCodes;
 exports.StorageKeys = constants.StorageKeys;
 exports.TOKEN_EXPIRY_MARGIN_SECONDS = constants.TOKEN_EXPIRY_MARGIN_SECONDS;

package/dist/cjs/methods/ESPRMAdminCommonCustomData/DeleteCommonCustomData.cjs

@@ -0,0 +1,24 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMAdminCommonCustomData = require('../../ESPRMAdminCommonCustomData.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+
+ESPRMAdminCommonCustomData.ESPRMAdminCommonCustomData.prototype.deleteCommonCustomData = async function (params) {
+    if (!params.name) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_COMMON_CUSTOM_DATA_NAME);
+    }
+    const requestConfig = {
+        url: constants.APIEndpoints.ADMIN_COMMON_CUSTOM_DATA,
+        method: constants.HTTPMethods.PUT,
+        data: { name: params.name, value: null },
+    };
+    const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+    return response;
+};

package/dist/cjs/methods/ESPRMAdminCommonCustomData/SetCommonCustomData.cjs

@@ -8,8 +8,15 @@
 var ESPRMAdminCommonCustomData = require('../../ESPRMAdminCommonCustomData.cjs');
 var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
 var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
 
 ESPRMAdminCommonCustomData.ESPRMAdminCommonCustomData.prototype.setCommonCustomData = async function (params) {
+    if (!params.name) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_COMMON_CUSTOM_DATA_NAME);
+    }
+    if (params.value === null || params.value === undefined) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_COMMON_CUSTOM_DATA_VALUE);
+    }
     const requestConfig = {
         url: constants.APIEndpoints.ADMIN_COMMON_CUSTOM_DATA,
         method: constants.HTTPMethods.PUT,

package/dist/cjs/methods/ESPRMAdminNode/ActivateDeactivateNodes.cjs

@@ -8,12 +8,22 @@
 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.activateDeactivateNodes = async function (params) {
+    const nodeIds = params.node_ids?.filter(Boolean) ?? [];
+    if (nodeIds.length === 0) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_NODE_IDS);
+    }
+    if (nodeIds.length > constants.MAX_NODE_ACTIVATION_BATCH_SIZE) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.TOO_MANY_NODE_IDS);
+    }
+    // The backend reads both values from the query string only; a JSON body
+    // on this endpoint is parsed as node tags.
     const requestConfig = {
         url: constants.APIEndpoints.ADMIN_NODES,
         method: constants.HTTPMethods.PUT,
-        data: params,
+        params: { node_id: nodeIds.join(","), activate: params.activate },
     };
     const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

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/ESPRMAdminNode/DeleteNode.cjs

@@ -0,0 +1,24 @@
+/*
+ * 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.deleteNode = async function (nodeId) {
+    if (!nodeId) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_NODE_ID);
+    }
+    const requestConfig = {
+        url: constants.APIEndpoints.ADMIN_NODES,
+        method: constants.HTTPMethods.DELETE,
+        params: { node_id: nodeId, delete_node: true },
+    };
+    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/methods/ESPRMClaim/InitiateClaim.cjs

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMClaim = require('../../ESPRMClaim.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+
+ESPRMClaim.ESPRMClaim.prototype.initiateClaim = async function (params) {
+    if (!params.mac_addr) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_MAC_ADDRESS);
+    }
+    if (!params.platform) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_CLAIM_PLATFORM);
+    }
+    const requestConfig = {
+        baseURL: ESPRMAPIManager.ESPRMAPIManager.getClaimingBaseUrl(),
+        url: constants.APIEndpoints.CLAIM_INITIATE,
+        method: constants.HTTPMethods.POST,
+        data: params,
+    };
+    const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+    return response;
+};

package/dist/cjs/methods/ESPRMClaim/VerifyClaim.cjs

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var ESPRMClaim = require('../../ESPRMClaim.cjs');
+var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
+var constants = require('../../utils/constants.cjs');
+var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+
+ESPRMClaim.ESPRMClaim.prototype.verifyClaim = async function (params, options = {}) {
+    if (!params.csr) {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_CSR);
+    }
+    const matter = options.matter ?? false;
+    const requestConfig = {
+        baseURL: ESPRMAPIManager.ESPRMAPIManager.getClaimingBaseUrl(),
+        url: constants.APIEndpoints.CLAIM_VERIFY,
+        method: constants.HTTPMethods.POST,
+        data: params,
+        // The service ignores `test` unless `matter` is true.
+        params: matter ? { matter, test: options.test ?? false } : { matter },
+    };
+    const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
+    return response;
+};

package/dist/cjs/services/ESPRMAPIManager.cjs

@@ -21,10 +21,12 @@ class ESPRMAPIManager {
     static #instance;
     #baseUrl;
     #timeoutMs;
+    #claimingBaseUrl;
     constructor(config) {
-        const { baseUrl, version, timeoutMs } = config;
+        const { baseUrl, version, timeoutMs, claimingBaseUrl } = config;
         this.#baseUrl = `${baseUrl}/${version}`;
         this.#timeoutMs = timeoutMs ?? constants.DEFAULT_REQUEST_TIMEOUT_MS;
+        this.#claimingBaseUrl = claimingBaseUrl?.replace(/\/+$/, "");
     }
     static initialize(config) {
         ESPRMAPIManager.#instance = new ESPRMAPIManager(config);
@@ -35,6 +37,18 @@ class ESPRMAPIManager {
         }
         return ESPRMAPIManager.#instance;
     }
+    /**
+     * Base URL of the claiming service set through `claimingBaseUrl`.
+     *
+     * @throws ESPConfigError `CLAIMING_NOT_CONFIGURED` when it was not configured.
+     */
+    static getClaimingBaseUrl() {
+        const claimingBaseUrl = ESPRMAPIManager.#getInstance().#claimingBaseUrl;
+        if (!claimingBaseUrl) {
+            throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.CLAIMING_NOT_CONFIGURED);
+        }
+        return claimingBaseUrl;
+    }
     /**
      * Send a request with the current user's access token in the
      * `Authorization` header, refreshing the token first if it has expired.