@espressif/rainmaker-admin-sdk 1.1.1 → 1.3.0

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",
@@ -95,6 +96,8 @@ const APIEndpoints = {
     ADMIN_MATTER_BATCH: "admin/matter/batch",
     ADMIN_MATTER_BATCH_NODES: "admin/matter/batch/nodes",
     ADMIN_MAIL_FAILURES: "admin/mail_failures",
+    CLAIM_INITIATE: "claim/initiate",
+    CLAIM_VERIFY: "claim/verify",
 };
 const StorageKeys = {
     ACCESSTOKEN: "com.esprmbase.accessToken",
@@ -105,6 +108,8 @@ const ConfigErrorCodes = {
     SDK_NOT_CONFIGURED: "SDK_NOT_CONFIGURED",
     INVALID_CONFIG_OBJECT: "INVALID_CONFIG_OBJECT",
     INVALID_BASE_URL: "INVALID_BASE_URL",
+    INVALID_CLAIMING_BASE_URL: "INVALID_CLAIMING_BASE_URL",
+    CLAIMING_NOT_CONFIGURED: "CLAIMING_NOT_CONFIGURED",
 };
 const ValidationErrorCodes = {
     MISSING_LOGIN_PASSWORD: "MISSING_LOGIN_PASSWORD",
@@ -150,6 +155,15 @@ 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",
+    MISSING_COMMON_CUSTOM_DATA_NAME: "MISSING_COMMON_CUSTOM_DATA_NAME",
+    MISSING_COMMON_CUSTOM_DATA_VALUE: "MISSING_COMMON_CUSTOM_DATA_VALUE",
+    MISSING_MAC_ADDRESS: "MISSING_MAC_ADDRESS",
+    MISSING_CLAIM_PLATFORM: "MISSING_CLAIM_PLATFORM",
+    MISSING_CSR: "MISSING_CSR",
+    MISSING_NODE_IDS: "MISSING_NODE_IDS",
+    TOO_MANY_NODE_IDS: "TOO_MANY_NODE_IDS",
 };
 const TokenErrorCodes = {
     MISSING_ACCESS_TOKEN: "MISSING_ACCESS_TOKEN",
@@ -175,6 +189,8 @@ const DEFAULT_REST_API_VERSION = "v1";
 const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
 /** Tokens expiring within this many seconds are refreshed proactively. */
 const TOKEN_EXPIRY_MARGIN_SECONDS = 30;
+/** Backend limit on node IDs per `PUT admin/nodes` activation request. */
+const MAX_NODE_ACTIVATION_BATCH_SIZE = 25;
 /** errorCode values the SDK itself sets on ESPAPIError for non-HTTP failures. */
 const APIErrorCodes = {
     REQUEST_TIMEOUT: "REQUEST_TIMEOUT",
@@ -191,6 +207,7 @@ exports.DEFAULT_REST_API_VERSION = DEFAULT_REST_API_VERSION;
 exports.ErrorLabels = ErrorLabels;
 exports.HTTPMethods = HTTPMethods;
 exports.HTTPStatusCodes = HTTPStatusCodes;
+exports.MAX_NODE_ACTIVATION_BATCH_SIZE = MAX_NODE_ACTIVATION_BATCH_SIZE;
 exports.StorageAdapterErrorCodes = StorageAdapterErrorCodes;
 exports.StorageKeys = StorageKeys;
 exports.TOKEN_EXPIRY_MARGIN_SECONDS = TOKEN_EXPIRY_MARGIN_SECONDS;

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

@@ -9,6 +9,8 @@ const configErrorMessages = {
     SDK_NOT_CONFIGURED: "ESPRMBase is not configured yet",
     INVALID_CONFIG_OBJECT: "Configuration Error: Config must be a non-null object.",
     INVALID_BASE_URL: "Configuration Error: BaseUrl must be a non-empty valid URL string.",
+    INVALID_CLAIMING_BASE_URL: "Configuration Error: claimingBaseUrl must be a non-empty valid URL string.",
+    CLAIMING_NOT_CONFIGURED: "Configuration Error: claimingBaseUrl is not configured. Pass it to ESPRMBase.configure to use ESPRMClaim.",
 };
 const validationErrorMessages = {
     MISSING_LOGIN_PASSWORD: "Validation Error: Password is required.",
@@ -20,6 +22,8 @@ const storageAdapterErrorMessages = {
 };
 const apiCallValidationErrorMessages = {
     MISSING_NODE_ID: "ESPAPICallValidationError: Node ID is required.",
+    MISSING_NODE_IDS: "ESPAPICallValidationError: At least one node ID is required.",
+    TOO_MANY_NODE_IDS: "ESPAPICallValidationError: Too many node IDs; at most 25 are allowed per request.",
     MISSING_OTA_IMAGE_ID: "ESPAPICallValidationError: OTA image ID is required.",
     MISSING_ARCHIVE_FLAG: "ESPAPICallValidationError: Archive flag is required and must be a boolean.",
     MISSING_OTA_JOB_ID: "ESPAPICallValidationError: OTA job ID is required.",
@@ -54,6 +58,13 @@ 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.",
+    MISSING_COMMON_CUSTOM_DATA_NAME: "ESPAPICallValidationError: Common custom data name is required.",
+    MISSING_COMMON_CUSTOM_DATA_VALUE: "ESPAPICallValidationError: Common custom data value is required. Use deleteCommonCustomData to delete an entry.",
+    MISSING_MAC_ADDRESS: "ESPAPICallValidationError: MAC address is required (12 uppercase hex characters, no separators).",
+    MISSING_CLAIM_PLATFORM: "ESPAPICallValidationError: Claim platform is required.",
+    MISSING_CSR: "ESPAPICallValidationError: Certificate signing request (CSR) is required.",
 };
 const tokenErrorMessages = {
     MISSING_ACCESS_TOKEN: "ESPTokenError: Access token is missing. User needs to authenticate.",

package/dist/cjs/utils/validator/ConfigValidator.cjs

@@ -13,12 +13,21 @@ class ConfigValidator {
     static validateConfig(config) {
         ConfigValidator.validateConfigObject(config);
         ConfigValidator.validateBaseUrl(config.baseUrl);
+        ConfigValidator.validateClaimingBaseUrl(config.claimingBaseUrl);
     }
     static validateConfigObject(config) {
         if (!validators.isValidObject(config)) {
             throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.INVALID_CONFIG_OBJECT);
         }
     }
+    static validateClaimingBaseUrl(claimingBaseUrl) {
+        if (claimingBaseUrl === undefined) {
+            return;
+        }
+        if (!validators.isNonEmptyString(claimingBaseUrl) || !validators.isValidUrl(claimingBaseUrl)) {
+            throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.INVALID_CLAIMING_BASE_URL);
+        }
+    }
     static validateBaseUrl(baseUrl) {
         if (!validators.isNonEmptyString(baseUrl) || !validators.isValidUrl(baseUrl)) {
             throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.INVALID_BASE_URL);

package/dist/esm/ESPRMBase.js

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

package/dist/esm/ESPRMClaim.js

@@ -0,0 +1,14 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * 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 {
+}
+
+export { ESPRMClaim };

package/dist/esm/entries/ESPRMAdminCommonCustomData.js

@@ -5,4 +5,5 @@
  */
 import '../methods/ESPRMAdminCommonCustomData/SetCommonCustomData.js';
 import '../methods/ESPRMAdminCommonCustomData/GetCommonCustomData.js';
+import '../methods/ESPRMAdminCommonCustomData/DeleteCommonCustomData.js';
 export { ESPRMAdminCommonCustomData } from '../ESPRMAdminCommonCustomData.js';

package/dist/esm/entries/ESPRMAdminNode.js

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

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import '../methods/ESPRMClaim/InitiateClaim.js';
+import '../methods/ESPRMClaim/VerifyClaim.js';
+export { ESPRMClaim } from '../ESPRMClaim.js';

package/dist/esm/index.js

@@ -54,6 +54,7 @@ export { ESPRMAdminAPIStatistics } from './ESPRMAdminAPIStatistics.js';
 export { ESPRMAdminMQTTStatistics } from './ESPRMAdminMQTTStatistics.js';
 export { ESPRMAdminMatter } from './ESPRMAdminMatter.js';
 export { ESPRMAdminNodeParams } from './ESPRMAdminNodeParams.js';
+export { ESPRMClaim } from './ESPRMClaim.js';
 import './methods/ESPRMAuth/Login.js';
 import './methods/ESPRMAuth/Logout.js';
 import './methods/ESPRMAuth/ForgotPassword.js';
@@ -75,9 +76,11 @@ import './methods/ESPRMAdminNode/GetNodes.js';
 import './methods/ESPRMAdminNode/ActivateDeactivateNodes.js';
 import './methods/ESPRMAdminNode/AttachNodeTags.js';
 import './methods/ESPRMAdminNode/RemoveNodeTags.js';
+import './methods/ESPRMAdminNode/DeleteNode.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,12 +161,16 @@ 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';
 import './methods/ESPRMAdminCommonCustomData/GetCommonCustomData.js';
+import './methods/ESPRMAdminCommonCustomData/DeleteCommonCustomData.js';
 import './methods/ESPRMAdminDeploymentSetting/GetDeploymentSettings.js';
 import './methods/ESPRMAdminDeploymentSetting/UpdateDeploymentConfig.js';
 import './methods/ESPRMAdminConfiguration/GetNotifications.js';
@@ -186,6 +193,8 @@ import './methods/ESPRMAdminPassthrough/CreatePassthroughConfig.js';
 import './methods/ESPRMAdminPassthrough/UpdatePassthroughConfig.js';
 import './methods/ESPRMAdminNodeCertificateCA/UpdateNodeCACertificate.js';
 import './methods/ESPRMAdminNodeCertificateCA/GetNodeCACertificate.js';
+import './methods/ESPRMClaim/InitiateClaim.js';
+import './methods/ESPRMClaim/VerifyClaim.js';
 import './methods/ESPRMAdminWebhook/CreateWebhookIntegration.js';
 import './methods/ESPRMAdminWebhook/UpdateWebhookIntegration.js';
 import './methods/ESPRMAdminWebhook/GetWebhookIntegrations.js';
@@ -215,7 +224,7 @@ import './methods/ESPRMAdminMatter/GetMatterBatch.js';
 import './methods/ESPRMAdminMatter/GetMatterBatchNodes.js';
 import './methods/ESPRMAdminNodeParams/UpdateNodeParams.js';
 import './methods/ESPRMAdminNodeParams/GetNodeParams.js';
-export { APICallValidationErrorCodes, APIEndpoints, APIErrorCodes, AdditionalInfo, ConfigErrorCodes, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_REST_API_VERSION, ErrorLabels, HTTPMethods, HTTPStatusCodes, StorageAdapterErrorCodes, StorageKeys, TOKEN_EXPIRY_MARGIN_SECONDS, TokenErrorCodes, ValidationErrorCodes } from './utils/constants.js';
+export { APICallValidationErrorCodes, APIEndpoints, APIErrorCodes, AdditionalInfo, ConfigErrorCodes, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_REST_API_VERSION, ErrorLabels, HTTPMethods, HTTPStatusCodes, MAX_NODE_ACTIVATION_BATCH_SIZE, StorageAdapterErrorCodes, StorageKeys, TOKEN_EXPIRY_MARGIN_SECONDS, TokenErrorCodes, ValidationErrorCodes } from './utils/constants.js';
 export { isNonEmptyString, isValidObject, isValidUrl } from './utils/validator/validators.js';
 export { ESPBaseError } from './utils/error/ESPBaseError.js';
 export { ESPRMAPIManager } from './services/ESPRMAPIManager.js';

package/dist/esm/methods/ESPRMAdminCommonCustomData/DeleteCommonCustomData.js

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

package/dist/esm/methods/ESPRMAdminCommonCustomData/SetCommonCustomData.js

@@ -5,9 +5,16 @@
  */
 import { ESPRMAdminCommonCustomData } from '../../ESPRMAdminCommonCustomData.js';
 import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
-import { HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
 
 ESPRMAdminCommonCustomData.prototype.setCommonCustomData = async function (params) {
+    if (!params.name) {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_COMMON_CUSTOM_DATA_NAME);
+    }
+    if (params.value === null || params.value === undefined) {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_COMMON_CUSTOM_DATA_VALUE);
+    }
     const requestConfig = {
         url: APIEndpoints.ADMIN_COMMON_CUSTOM_DATA,
         method: HTTPMethods.PUT,

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

@@ -5,13 +5,23 @@
  */
 import { ESPRMAdminNode } from '../../ESPRMAdminNode.js';
 import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
-import { HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { APICallValidationErrorCodes, MAX_NODE_ACTIVATION_BATCH_SIZE, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
 
 ESPRMAdminNode.prototype.activateDeactivateNodes = async function (params) {
+    const nodeIds = params.node_ids?.filter(Boolean) ?? [];
+    if (nodeIds.length === 0) {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_NODE_IDS);
+    }
+    if (nodeIds.length > MAX_NODE_ACTIVATION_BATCH_SIZE) {
+        throw new ESPAPICallValidationError(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: APIEndpoints.ADMIN_NODES,
         method: HTTPMethods.PUT,
-        data: params,
+        params: { node_id: nodeIds.join(","), activate: params.activate },
     };
     const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

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

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

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

package/dist/esm/methods/ESPRMClaim/VerifyClaim.js

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

package/dist/esm/services/ESPRMAPIManager.js

@@ -19,10 +19,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 ?? DEFAULT_REQUEST_TIMEOUT_MS;
+        this.#claimingBaseUrl = claimingBaseUrl?.replace(/\/+$/, "");
     }
     static initialize(config) {
         ESPRMAPIManager.#instance = new ESPRMAPIManager(config);
@@ -33,6 +35,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(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.

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",
@@ -93,6 +94,8 @@ const APIEndpoints = {
     ADMIN_MATTER_BATCH: "admin/matter/batch",
     ADMIN_MATTER_BATCH_NODES: "admin/matter/batch/nodes",
     ADMIN_MAIL_FAILURES: "admin/mail_failures",
+    CLAIM_INITIATE: "claim/initiate",
+    CLAIM_VERIFY: "claim/verify",
 };
 const StorageKeys = {
     ACCESSTOKEN: "com.esprmbase.accessToken",
@@ -103,6 +106,8 @@ const ConfigErrorCodes = {
     SDK_NOT_CONFIGURED: "SDK_NOT_CONFIGURED",
     INVALID_CONFIG_OBJECT: "INVALID_CONFIG_OBJECT",
     INVALID_BASE_URL: "INVALID_BASE_URL",
+    INVALID_CLAIMING_BASE_URL: "INVALID_CLAIMING_BASE_URL",
+    CLAIMING_NOT_CONFIGURED: "CLAIMING_NOT_CONFIGURED",
 };
 const ValidationErrorCodes = {
     MISSING_LOGIN_PASSWORD: "MISSING_LOGIN_PASSWORD",
@@ -148,6 +153,15 @@ 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",
+    MISSING_COMMON_CUSTOM_DATA_NAME: "MISSING_COMMON_CUSTOM_DATA_NAME",
+    MISSING_COMMON_CUSTOM_DATA_VALUE: "MISSING_COMMON_CUSTOM_DATA_VALUE",
+    MISSING_MAC_ADDRESS: "MISSING_MAC_ADDRESS",
+    MISSING_CLAIM_PLATFORM: "MISSING_CLAIM_PLATFORM",
+    MISSING_CSR: "MISSING_CSR",
+    MISSING_NODE_IDS: "MISSING_NODE_IDS",
+    TOO_MANY_NODE_IDS: "TOO_MANY_NODE_IDS",
 };
 const TokenErrorCodes = {
     MISSING_ACCESS_TOKEN: "MISSING_ACCESS_TOKEN",
@@ -173,10 +187,12 @@ const DEFAULT_REST_API_VERSION = "v1";
 const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
 /** Tokens expiring within this many seconds are refreshed proactively. */
 const TOKEN_EXPIRY_MARGIN_SECONDS = 30;
+/** Backend limit on node IDs per `PUT admin/nodes` activation request. */
+const MAX_NODE_ACTIVATION_BATCH_SIZE = 25;
 /** errorCode values the SDK itself sets on ESPAPIError for non-HTTP failures. */
 const APIErrorCodes = {
     REQUEST_TIMEOUT: "REQUEST_TIMEOUT",
     NETWORK_ERROR: "NETWORK_ERROR",
 };
 
-export { APICallValidationErrorCodes, APIEndpoints, APIErrorCodes, AdditionalInfo, ConfigErrorCodes, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_REST_API_VERSION, ErrorLabels, HTTPMethods, HTTPStatusCodes, StorageAdapterErrorCodes, StorageKeys, TOKEN_EXPIRY_MARGIN_SECONDS, TokenErrorCodes, ValidationErrorCodes };
+export { APICallValidationErrorCodes, APIEndpoints, APIErrorCodes, AdditionalInfo, ConfigErrorCodes, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_REST_API_VERSION, ErrorLabels, HTTPMethods, HTTPStatusCodes, MAX_NODE_ACTIVATION_BATCH_SIZE, StorageAdapterErrorCodes, StorageKeys, TOKEN_EXPIRY_MARGIN_SECONDS, TokenErrorCodes, ValidationErrorCodes };

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

@@ -7,6 +7,8 @@ const configErrorMessages = {
     SDK_NOT_CONFIGURED: "ESPRMBase is not configured yet",
     INVALID_CONFIG_OBJECT: "Configuration Error: Config must be a non-null object.",
     INVALID_BASE_URL: "Configuration Error: BaseUrl must be a non-empty valid URL string.",
+    INVALID_CLAIMING_BASE_URL: "Configuration Error: claimingBaseUrl must be a non-empty valid URL string.",
+    CLAIMING_NOT_CONFIGURED: "Configuration Error: claimingBaseUrl is not configured. Pass it to ESPRMBase.configure to use ESPRMClaim.",
 };
 const validationErrorMessages = {
     MISSING_LOGIN_PASSWORD: "Validation Error: Password is required.",
@@ -18,6 +20,8 @@ const storageAdapterErrorMessages = {
 };
 const apiCallValidationErrorMessages = {
     MISSING_NODE_ID: "ESPAPICallValidationError: Node ID is required.",
+    MISSING_NODE_IDS: "ESPAPICallValidationError: At least one node ID is required.",
+    TOO_MANY_NODE_IDS: "ESPAPICallValidationError: Too many node IDs; at most 25 are allowed per request.",
     MISSING_OTA_IMAGE_ID: "ESPAPICallValidationError: OTA image ID is required.",
     MISSING_ARCHIVE_FLAG: "ESPAPICallValidationError: Archive flag is required and must be a boolean.",
     MISSING_OTA_JOB_ID: "ESPAPICallValidationError: OTA job ID is required.",
@@ -52,6 +56,13 @@ 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.",
+    MISSING_COMMON_CUSTOM_DATA_NAME: "ESPAPICallValidationError: Common custom data name is required.",
+    MISSING_COMMON_CUSTOM_DATA_VALUE: "ESPAPICallValidationError: Common custom data value is required. Use deleteCommonCustomData to delete an entry.",
+    MISSING_MAC_ADDRESS: "ESPAPICallValidationError: MAC address is required (12 uppercase hex characters, no separators).",
+    MISSING_CLAIM_PLATFORM: "ESPAPICallValidationError: Claim platform is required.",
+    MISSING_CSR: "ESPAPICallValidationError: Certificate signing request (CSR) is required.",
 };
 const tokenErrorMessages = {
     MISSING_ACCESS_TOKEN: "ESPTokenError: Access token is missing. User needs to authenticate.",

package/dist/esm/utils/validator/ConfigValidator.js

@@ -11,12 +11,21 @@ class ConfigValidator {
     static validateConfig(config) {
         ConfigValidator.validateConfigObject(config);
         ConfigValidator.validateBaseUrl(config.baseUrl);
+        ConfigValidator.validateClaimingBaseUrl(config.claimingBaseUrl);
     }
     static validateConfigObject(config) {
         if (!isValidObject(config)) {
             throw new ESPConfigError(ConfigErrorCodes.INVALID_CONFIG_OBJECT);
         }
     }
+    static validateClaimingBaseUrl(claimingBaseUrl) {
+        if (claimingBaseUrl === undefined) {
+            return;
+        }
+        if (!isNonEmptyString(claimingBaseUrl) || !isValidUrl(claimingBaseUrl)) {
+            throw new ESPConfigError(ConfigErrorCodes.INVALID_CLAIMING_BASE_URL);
+        }
+    }
     static validateBaseUrl(baseUrl) {
         if (!isNonEmptyString(baseUrl) || !isValidUrl(baseUrl)) {
             throw new ESPConfigError(ConfigErrorCodes.INVALID_BASE_URL);

package/dist/types/ESPRMClaim.d.ts

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