@espressif/rainmaker-admin-sdk 1.1.0 → 1.2.0

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

@@ -8,5 +8,8 @@ import "./GetNodeIds.js";
 import "./GetNodeCertificates.js";
 import "./GetNodeCertificateRegistrationStatus.js";
 import "./RegisterNodeCertificates.js";
+import "./GetNodeCertificateUploadUrl.js";
 import "./GetMQTTHost.js";
 import "./GetCustomMQTTHost.js";
+import "./ListNodeRegistrationRequests.js";
+import "./GetNodeRegistrationRequest.js";

package/dist/types/types/command_response.d.ts

@@ -3,6 +3,19 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Lifecycle status of a command request.
+ *
+ * - `requested`: created, not yet delivered to the node
+ * - `in_progress`: delivered to the node, awaiting its response
+ * - `success` / `failure`: the node reported the result
+ * - `timed_out`: the timeout elapsed before the command completed
+ * - `overridden`: replaced by a later request sent with `override: true`
+ * - `cancelled`: cancelled through the cancel API
+ */
+export type CommandRequestStatus = "requested" | "in_progress" | "success" | "failure" | "timed_out" | "overridden" | "cancelled";
+/** Error marker set when stored request or response data cannot be decoded. */
+export type CommandRequestDataError = "ERROR_DESERIALIZE_JSON";
 /** Parameters for listing command requests. */
 export interface GetCommandRequestsParams {
     /** Filter by specific request ID. */
@@ -10,10 +23,13 @@ export interface GetCommandRequestsParams {
     /** Filter by node ID. */
     node_id?: string;
     /** Filter by request status. */
-    status?: string;
-    /** Filter requests created after this timestamp. */
+    status?: CommandRequestStatus;
+    /**
+     * Start of the request time range, in epoch seconds. Must be sent with
+     * `end_time`, and requires the `cmd_resp_history` deployment setting.
+     */
     start_time?: number;
-    /** Filter requests created before this timestamp. */
+    /** End of the request time range, in epoch seconds. Must be sent with `start_time`. */
     end_time?: number;
     /** Filter by command ID. */
     cmd_id?: number;
@@ -44,25 +60,37 @@ export interface CommandRequestInfo {
     /** Unique identifier of the command request. */
     request_id: string;
     /** Current status of the request. */
-    status: string;
+    status: CommandRequestStatus;
     /** Device-reported status code. */
     device_status?: number;
     /** Human-readable description of the status. */
     status_description?: string;
     /** Data sent in the request. */
     request_data?: unknown;
+    /** Set instead of `request_data` when the stored request data cannot be decoded. */
+    request_data_error?: CommandRequestDataError;
     /** Data received in the response. */
     response_data?: unknown;
+    /** Set instead of `response_data` when the stored response data cannot be decoded. */
+    response_data_error?: CommandRequestDataError;
+    /** Whether the data is a base64-encoded string rather than JSON. */
+    is_base64?: boolean;
     /** Node ID the command was sent to. */
     node_id: string;
-    /** Timestamp when the request was created. */
+    /** Timestamp when the request was created, in epoch seconds. */
     request_timestamp?: number;
-    /** Timestamp when the response was received. */
+    /** Timestamp when the response was received, in epoch seconds. */
     response_timestamp?: number;
-    /** Timestamp when the request expires. */
+    /** Timestamp when the request expires, in epoch seconds. */
     expiration_timestamp?: number;
+    /** Whether the request never expires (sent with a timeout of -1). */
+    indefinite_timeout?: boolean;
     /** Command identifier. */
     cmd?: number;
+    /** Name of the user who created the request. */
+    user_name?: string;
+    /** Whether the request was created through the user API rather than by a device. */
+    for_user?: boolean;
 }
 /** Paginated response containing a list of command requests. */
 export interface GetCommandRequestsResponse {
@@ -80,3 +108,24 @@ export interface AddCommandRequestResponse {
     /** Status of the command submission. */
     status: string;
 }
+/**
+ * Parameters for cancelling pending command requests.
+ *
+ * Provide `request_id` to cancel one request, or `node_id` to cancel every
+ * pending request for a node (optionally narrowed by `cmd_id`).
+ */
+export interface CancelCommandRequestsParams {
+    /** Cancel this specific request. */
+    request_id?: string;
+    /** Cancel all pending requests for this node. */
+    node_id?: string;
+    /** Cancel only requests with this command ID. Requires `node_id`. */
+    cmd_id?: number;
+}
+/** Response returned after cancelling command requests. */
+export interface CancelCommandRequestsResponse {
+    /** Status of the cancel operation. */
+    status: string;
+    /** Number of requests that were cancelled. */
+    total_cancelled: number;
+}

package/dist/types/types/input.d.ts

@@ -11,7 +11,7 @@ export type { GetAdminNodesParams, ActivateDeactivateNodesParams, GetNodeTagsPar
 export type { CreateOTAImageRequest, GetOTAImagesParams, ArchiveOTAImageParams, DeleteOTAImageParams, GetOTAImageUploadUrlParams, ConfirmOTAImageUploadRequest, GetOTAPackageUploadUrlParams, ConfirmOTAPackageUploadRequest, CreateOTAJobRequest, CreateOTAJobQueryOptions, OtaJobDownloadWindow, OtaJobValidity, OtaJobMetadata, OtaSecureBoot, OtaNetworkSerialisation, GetOTAJobParams, UpdateOTAJobParams, CancelOTAJobRequest, ArchiveOTAJobRequest, GetOTAJobStatusParams, GetOTAJobStatusSummaryParams, RetriggerOTAJobRequest, } from "./ota.js";
 export type { CreateAdminGroupRequest, UpdateAdminGroupRequest, GetAdminGroupsParams, } from "./group.js";
 export type { GetAdminTagsParams, AttachDetachTagsParams, GetTagNamesParams, } from "./tag.js";
-export type { GetCommandRequestsParams, AddCommandRequestBody, } from "./command_response.js";
+export type { GetCommandRequestsParams, AddCommandRequestBody, CancelCommandRequestsParams, CommandRequestStatus, } from "./command_response.js";
 export type { CreateEventFilterRequest, UpdateEventFilterRequest, GetEventFiltersParams, DeleteEventFilterRequest, } from "./event_filter.js";
 export type { GetTimeSeriesDataParams, GetSimpleTimeSeriesDataParams, } from "./time_series.js";
 export type { GetAdminCustomDataParams, SetAdminCustomDataParams, } from "./custom_data.js";

package/dist/types/types/node_registration.d.ts

@@ -34,13 +34,73 @@ export interface GetNodeCertificatesParams {
     /** The maximum number of records to return. */
     num_records?: number;
 }
-/** Request body for registering node certificates. */
+/** Parameters for fetching a pre-signed URL to upload a node certificates CSV. */
+export interface GetNodeCertificateUploadUrlParams {
+    /** Name of the CSV file to upload. */
+    file_name: string;
+}
+/** Response containing the pre-signed upload URL for a node certificates CSV. */
+export interface NodeCertificateUploadUrlResponse {
+    /** The API call status. */
+    status: string;
+    /** Pre-signed S3 PUT URL (valid for 1 hour). Upload without an `Authorization` header. */
+    url: string;
+    /** ID of the registration request; pass it to `registerNodeCertificates`. */
+    request_id: string;
+}
+/**
+ * Request body for registering node certificates from an uploaded CSV.
+ *
+ * Upload the CSV to the URL from `getNodeCertificateUploadUrl` first, then
+ * trigger the registration with the same `request_id`.
+ */
 export interface RegisterNodeCertificatesRequest {
-    /** List of node IDs to register certificates for. */
-    node_ids: string[];
-    /** List of certificates corresponding to the node IDs. */
-    certs: string[];
-    [key: string]: unknown;
+    /** Name of the uploaded CSV file. */
+    file_name: string;
+    /** Hex MD5 digest of the uploaded CSV file. */
+    file_md5: string;
+    /** Request ID returned by `getNodeCertificateUploadUrl`. */
+    request_id: string;
+    /**
+     * The caller's refresh token. The backend requires it and uses it to add
+     * the registered nodes to their group.
+     */
+    refresh_token: string;
+    /** The node type. */
+    type?: string;
+    /** The node model. */
+    model?: string;
+    /** The node subtype. */
+    subtype?: string;
+    /**
+     * Group to add the nodes to. When omitted, the backend creates a group named
+     * after the type/model and the current date.
+     */
+    group_name?: string;
+    /** ID of the parent group when `group_name` is a subgroup. Takes precedence over `parent_group_name`. */
+    parent_group_id?: string;
+    /** Name of the parent group when `group_name` is a subgroup. */
+    parent_group_name?: string;
+    /**
+     * Comma-separated tags. Static tags are `key:value`; CSV-column tags are
+     * `key:@column` and take each node's value from that CSV column.
+     */
+    tags?: string;
+    /** Ignore duplicate node registrations and update existing certificates. */
+    force?: boolean;
+    /** Only update type, model, subtype and tags of existing nodes. Cannot be combined with `node_policies`. */
+    update_nodes?: boolean;
+    /** Comma-separated IoT policies to attach: `mqtt`, `videostream`. */
+    node_policies?: string;
+    /** The tenant ID, required when multi-tenancy is enabled. */
+    tenant_id?: string;
+}
+/** Response returned after triggering a node certificate registration. */
+export interface RegisterNodeCertificatesResponse {
+    /** The API call status. */
+    status: string;
+    /** ID of the registration request. */
+    request_id: string;
 }
 /** Parameters for checking node certificate registration status. */
 export interface GetNodeCertificateRegistrationParams {
@@ -85,17 +145,109 @@ export interface GetNodeCertificatesResponse {
     /** The total number of certificates. */
     total?: number;
 }
-/** Response containing node certificate registration status. */
+/**
+ * Response containing node certificate registration status.
+ *
+ * Unlike `getNodeRegistrationRequest`, this call checks the batch job and
+ * reports `failure` when it has died while the request was still `requested`.
+ */
 export interface NodeCertificateRegistrationStatusResponse {
-    /** The registration request ID. */
-    request_id?: string;
     /** The registration status. */
-    status?: string;
-    [key: string]: unknown;
+    status: NodeRegistrationRequestStatus;
+    /** Number of nodes registered so far. */
+    completed_count?: number;
+    /** Total number of nodes in the request. */
+    total_count?: number;
+    /** Failure reason, when the request failed. */
+    description?: string;
+    /** Nodes that failed to register, as reported by the backend. */
+    failed_registration?: string;
+    /** Name of the group the nodes are added to. */
+    group_name?: string;
+    /** ID of the group the nodes are added to. */
+    group_id?: string;
 }
-/** Response containing the MQTT host endpoint. */
+/** Response containing the deployment's node endpoints. */
 export interface GetMQTTHostResponse {
     /** The MQTT broker host address. */
     mqtt_host?: string;
+    /** The AWS IoT credential provider endpoint (written to node NVS as `mqtt_cred_host`). */
+    mqtt_cred_host?: string;
+    /** The HTTPS node endpoint, when the deployment has one configured. */
+    https_host?: string;
     [key: string]: unknown;
 }
+/**
+ * Status of a node certificate registration request.
+ *
+ * `failed` and `failure` both mean the request failed: the backend writes
+ * `failed` when submitting the batch job fails and `failure` when the batch
+ * job itself fails.
+ */
+export type NodeRegistrationRequestStatus = "requested" | "in_progress" | "success" | "failed" | "failure";
+/** Parameters for listing node certificate registration requests. */
+export interface ListNodeRegistrationRequestsParams {
+    /** Filter results by request status. */
+    status?: NodeRegistrationRequestStatus;
+    /** The maximum number of records to return (the backend caps this at 25). */
+    num_records?: number;
+    /** The `next_id` from the previous response, to fetch the next page. */
+    start_id?: string;
+}
+/** A node certificate registration request, as returned in the list. */
+export interface NodeRegistrationRequest {
+    /** The registration request ID. */
+    request_id: string;
+    /** The request status. */
+    status: NodeRegistrationRequestStatus;
+    /** Name of the uploaded certificates CSV file. */
+    file_name?: string;
+    /** Time the request was created, in epoch seconds. */
+    request_timestamp?: number;
+    /** Number of nodes registered so far. */
+    completed_count?: number;
+    /** Total number of nodes in the request. */
+    total_count?: number;
+}
+/** Response containing a page of node certificate registration requests. */
+export interface ListNodeRegistrationRequestsResponse {
+    /** The API call status. */
+    status: string;
+    /** Registration requests, newest first. */
+    requests?: NodeRegistrationRequest[];
+    /** Pagination cursor for the next page; absent on the last page. */
+    next_id?: string;
+}
+/** Full detail of a single node certificate registration request. */
+export interface NodeRegistrationRequestDetail extends NodeRegistrationRequest {
+    /** Pre-signed download URL of the original CSV (valid for 1 hour). */
+    url?: string;
+    /** Additional context from the backend, e.g. a batch job failure reason. */
+    additional_comments?: string;
+    /** Number of nodes that failed to register (omitted when 0). */
+    failed_registration_count?: number;
+    /** Name of the group the nodes were added to. */
+    group_name?: string;
+    /** ID of the group the nodes were added to. */
+    group_id?: string;
+    /** The node type. */
+    type?: string;
+    /** The node model. */
+    model?: string;
+    /** The node subtype. */
+    subtype?: string;
+    /** ID of the parent group. */
+    parent_group_id?: string;
+    /** Name of the parent group. */
+    parent_group_name?: string;
+    /** Comma-separated `key:value` tags applied to the nodes. */
+    tags?: string;
+    /** Whether existing registrations were overwritten. */
+    force?: boolean;
+    /** Whether existing nodes were updated. */
+    update_nodes?: boolean;
+    /** The tenant ID. */
+    tenant_id?: string;
+    /** Policies attached to the nodes. */
+    node_policies?: string;
+}

package/dist/types/types/output.d.ts

@@ -10,7 +10,7 @@ export type { AdminNodeInfo, AdminNodeListResponse, GetNodeTagsResponse, NodeSta
 export type { OTAImageInfo, OTAImageRelatedFile, OTAImageCreateResponse, GetOTAImagesResponse, OTAImageUploadUrlResponse, ConfirmOTAImageUploadResponse, OTAPackageUploadUrlResponse, ConfirmOTAPackageUploadResponse, OTAJobInfo, OTAJobCreateResponse, OTAJobUpdateResponse, OTAJobRetriggerResponse, GetOTAJobsResponse, NodeOTAJobStatusEntry, OTAJobStatusResponse, OTAJobStatusSummaryResponse, } from "./ota.js";
 export type { AdminGroupInfo, CreateAdminGroupResponse, GetAdminGroupsResponse, } from "./group.js";
 export type { TagResourceInfo, GetAdminTagsResponse, GetTagNamesResponse, } from "./tag.js";
-export type { CommandRequestInfo, GetCommandRequestsResponse, AddCommandRequestResponse, } from "./command_response.js";
+export type { CommandRequestInfo, GetCommandRequestsResponse, AddCommandRequestResponse, CancelCommandRequestsResponse, CommandRequestDataError, } from "./command_response.js";
 export type { EventFilterInfo, GetEventFiltersResponse } from "./event_filter.js";
 export type { TimeSeriesParamData, TimeSeriesNodeData, GetTimeSeriesDataResponse, GetSimpleTimeSeriesDataResponse, } from "./time_series.js";
 export type { CustomDataResponse } from "./custom_data.js";

package/dist/types/types/time_series.d.ts

@@ -42,10 +42,16 @@ export interface GetSimpleTimeSeriesDataParams {
     node_id: string;
     /** Parameter name to query. */
     param_name: string;
-    /** Start of the time range (epoch seconds). */
-    start_time: number;
-    /** End of the time range (epoch seconds). */
-    end_time: number;
+    /**
+     * Start of the time range (epoch seconds). Omit to start from the oldest
+     * stored record. The backend rejects a range whose start is after its end.
+     */
+    start_time?: number;
+    /**
+     * End of the time range (epoch seconds). Omit to include records up to
+     * the current time.
+     */
+    end_time?: number;
     /**
      * Expected data type of the parameter values (GET query param `type`,
      * e.g. `int`, `float`).
@@ -53,7 +59,7 @@ export interface GetSimpleTimeSeriesDataParams {
     type: string;
     /** ID to start pagination from. */
     start_id?: string;
-    /** Maximum number of records to return. */
+    /** Maximum number of records to return. The backend caps this at 200. */
     num_records?: number;
 }
 /** Time series data for a single parameter. */

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

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

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

@@ -52,6 +52,8 @@ declare const apiCallValidationErrorMessages: {
     MISSING_PLATFORM_NAME: string;
     MISSING_PLATFORM_APPLICATION_ARN: string;
     MISSING_BATCH_ID: string;
+    MISSING_CANCEL_COMMAND_SCOPE: string;
+    CMD_ID_REQUIRES_NODE_ID: string;
 };
 declare const tokenErrorMessages: {
     MISSING_ACCESS_TOKEN: string;

package/dist/types-cjs/methods/ESPRMAdminNode/CancelCommandRequests.d.cts

@@ -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.cjs";
+declare module "../../ESPRMAdminNode.cjs" {
+    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-cjs/methods/ESPRMAdminNode/index.d.cts

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

package/dist/types-cjs/methods/ESPRMAdminNodeRegistration/GetMQTTHost.d.cts

@@ -7,9 +7,10 @@ import { GetMQTTHostResponse } from "../../types/node_registration.cjs";
 declare module "../../ESPRMAdminNodeRegistration.cjs" {
     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-cjs/methods/ESPRMAdminNodeRegistration/GetNodeCertificateUploadUrl.d.cts

@@ -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.cjs";
+declare module "../../ESPRMAdminNodeRegistration.cjs" {
+    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-cjs/methods/ESPRMAdminNodeRegistration/GetNodeRegistrationRequest.d.cts

@@ -0,0 +1,17 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { NodeRegistrationRequestDetail } from "../../types/node_registration.cjs";
+declare module "../../ESPRMAdminNodeRegistration.cjs" {
+    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-cjs/methods/ESPRMAdminNodeRegistration/ListNodeRegistrationRequests.d.cts

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ListNodeRegistrationRequestsParams } from "../../types/node_registration.cjs";
+import { ListNodeRegistrationRequestsResponse } from "../../types/node_registration.cjs";
+declare module "../../ESPRMAdminNodeRegistration.cjs" {
+    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-cjs/methods/ESPRMAdminNodeRegistration/RegisterNodeCertificates.d.cts

@@ -3,16 +3,16 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
-import { RegisterNodeCertificatesRequest } from "../../types/node_registration.cjs";
-import { ESPAPISuccessResponse } from "../../types/api.cjs";
+import { RegisterNodeCertificatesRequest, RegisterNodeCertificatesResponse } from "../../types/node_registration.cjs";
 declare module "../../ESPRMAdminNodeRegistration.cjs" {
     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>;
     }
 }

package/dist/types-cjs/methods/ESPRMAdminNodeRegistration/index.d.cts

@@ -8,5 +8,8 @@ import "./GetNodeIds.cjs";
 import "./GetNodeCertificates.cjs";
 import "./GetNodeCertificateRegistrationStatus.cjs";
 import "./RegisterNodeCertificates.cjs";
+import "./GetNodeCertificateUploadUrl.cjs";
 import "./GetMQTTHost.cjs";
 import "./GetCustomMQTTHost.cjs";
+import "./ListNodeRegistrationRequests.cjs";
+import "./GetNodeRegistrationRequest.cjs";

package/dist/types-cjs/types/command_response.d.cts

@@ -3,6 +3,19 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Lifecycle status of a command request.
+ *
+ * - `requested`: created, not yet delivered to the node
+ * - `in_progress`: delivered to the node, awaiting its response
+ * - `success` / `failure`: the node reported the result
+ * - `timed_out`: the timeout elapsed before the command completed
+ * - `overridden`: replaced by a later request sent with `override: true`
+ * - `cancelled`: cancelled through the cancel API
+ */
+export type CommandRequestStatus = "requested" | "in_progress" | "success" | "failure" | "timed_out" | "overridden" | "cancelled";
+/** Error marker set when stored request or response data cannot be decoded. */
+export type CommandRequestDataError = "ERROR_DESERIALIZE_JSON";
 /** Parameters for listing command requests. */
 export interface GetCommandRequestsParams {
     /** Filter by specific request ID. */
@@ -10,10 +23,13 @@ export interface GetCommandRequestsParams {
     /** Filter by node ID. */
     node_id?: string;
     /** Filter by request status. */
-    status?: string;
-    /** Filter requests created after this timestamp. */
+    status?: CommandRequestStatus;
+    /**
+     * Start of the request time range, in epoch seconds. Must be sent with
+     * `end_time`, and requires the `cmd_resp_history` deployment setting.
+     */
     start_time?: number;
-    /** Filter requests created before this timestamp. */
+    /** End of the request time range, in epoch seconds. Must be sent with `start_time`. */
     end_time?: number;
     /** Filter by command ID. */
     cmd_id?: number;
@@ -44,25 +60,37 @@ export interface CommandRequestInfo {
     /** Unique identifier of the command request. */
     request_id: string;
     /** Current status of the request. */
-    status: string;
+    status: CommandRequestStatus;
     /** Device-reported status code. */
     device_status?: number;
     /** Human-readable description of the status. */
     status_description?: string;
     /** Data sent in the request. */
     request_data?: unknown;
+    /** Set instead of `request_data` when the stored request data cannot be decoded. */
+    request_data_error?: CommandRequestDataError;
     /** Data received in the response. */
     response_data?: unknown;
+    /** Set instead of `response_data` when the stored response data cannot be decoded. */
+    response_data_error?: CommandRequestDataError;
+    /** Whether the data is a base64-encoded string rather than JSON. */
+    is_base64?: boolean;
     /** Node ID the command was sent to. */
     node_id: string;
-    /** Timestamp when the request was created. */
+    /** Timestamp when the request was created, in epoch seconds. */
     request_timestamp?: number;
-    /** Timestamp when the response was received. */
+    /** Timestamp when the response was received, in epoch seconds. */
     response_timestamp?: number;
-    /** Timestamp when the request expires. */
+    /** Timestamp when the request expires, in epoch seconds. */
     expiration_timestamp?: number;
+    /** Whether the request never expires (sent with a timeout of -1). */
+    indefinite_timeout?: boolean;
     /** Command identifier. */
     cmd?: number;
+    /** Name of the user who created the request. */
+    user_name?: string;
+    /** Whether the request was created through the user API rather than by a device. */
+    for_user?: boolean;
 }
 /** Paginated response containing a list of command requests. */
 export interface GetCommandRequestsResponse {
@@ -80,3 +108,24 @@ export interface AddCommandRequestResponse {
     /** Status of the command submission. */
     status: string;
 }
+/**
+ * Parameters for cancelling pending command requests.
+ *
+ * Provide `request_id` to cancel one request, or `node_id` to cancel every
+ * pending request for a node (optionally narrowed by `cmd_id`).
+ */
+export interface CancelCommandRequestsParams {
+    /** Cancel this specific request. */
+    request_id?: string;
+    /** Cancel all pending requests for this node. */
+    node_id?: string;
+    /** Cancel only requests with this command ID. Requires `node_id`. */
+    cmd_id?: number;
+}
+/** Response returned after cancelling command requests. */
+export interface CancelCommandRequestsResponse {
+    /** Status of the cancel operation. */
+    status: string;
+    /** Number of requests that were cancelled. */
+    total_cancelled: number;
+}

package/dist/types-cjs/types/input.d.cts

@@ -11,7 +11,7 @@ export type { GetAdminNodesParams, ActivateDeactivateNodesParams, GetNodeTagsPar
 export type { CreateOTAImageRequest, GetOTAImagesParams, ArchiveOTAImageParams, DeleteOTAImageParams, GetOTAImageUploadUrlParams, ConfirmOTAImageUploadRequest, GetOTAPackageUploadUrlParams, ConfirmOTAPackageUploadRequest, CreateOTAJobRequest, CreateOTAJobQueryOptions, OtaJobDownloadWindow, OtaJobValidity, OtaJobMetadata, OtaSecureBoot, OtaNetworkSerialisation, GetOTAJobParams, UpdateOTAJobParams, CancelOTAJobRequest, ArchiveOTAJobRequest, GetOTAJobStatusParams, GetOTAJobStatusSummaryParams, RetriggerOTAJobRequest, } from "./ota.cjs";
 export type { CreateAdminGroupRequest, UpdateAdminGroupRequest, GetAdminGroupsParams, } from "./group.cjs";
 export type { GetAdminTagsParams, AttachDetachTagsParams, GetTagNamesParams, } from "./tag.cjs";
-export type { GetCommandRequestsParams, AddCommandRequestBody, } from "./command_response.cjs";
+export type { GetCommandRequestsParams, AddCommandRequestBody, CancelCommandRequestsParams, CommandRequestStatus, } from "./command_response.cjs";
 export type { CreateEventFilterRequest, UpdateEventFilterRequest, GetEventFiltersParams, DeleteEventFilterRequest, } from "./event_filter.cjs";
 export type { GetTimeSeriesDataParams, GetSimpleTimeSeriesDataParams, } from "./time_series.cjs";
 export type { GetAdminCustomDataParams, SetAdminCustomDataParams, } from "./custom_data.cjs";