@espressif/rainmaker-admin-sdk 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -3,6 +3,57 @@
 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.6.0] - 2026-10-08
+
+Minor release that makes the dashboard update endpoints usable from the
+dashboards: the update check now sends the `current_version` the backend
+requires, and the version mapping accepts its filters. Existing calls are
+unchanged; `getDashboardUpdateStatus()` is deprecated because it could never
+succeed.
+
+### Added
+
+- `ESPRMAdminDashboard.checkDashboardUpdate({ current_version })` checks for a
+  newer dashboard (`GET admin/dashboard/update?current_version=`). Returns
+  `{ version, backend_updated }` when one exists, otherwise a plain success
+  response.
+- `ESPRMAdminDashboard.getDashboardVersionMapping({ type, version })` accepts
+  optional filters. Calling it without arguments is unchanged.
+- Types `CheckDashboardUpdateParams`, `CheckDashboardUpdateResponse`,
+  `DashboardUpdateAvailable`, `GetDashboardVersionMappingParams` and
+  `DashboardVersionMappingType`.
+
+### Deprecated
+
+- `ESPRMAdminDashboard.getDashboardUpdateStatus()` sends no `current_version`,
+  which the backend requires, so it always fails with error code `110001`. Use
+  `checkDashboardUpdate` instead.
+
+## [1.5.0] - 2026-10-08
+
+Minor release that lets callers fetch a single deployment capability by name,
+which the dashboards use to read the ESP Insights URL. Calling
+`getDeploymentCapabilities()` without arguments is unchanged; the two type
+corrections below are fixes, one of which changes `errorCode` at runtime.
+
+### Added
+
+- `ESPRMAdminDeploymentCapability.getDeploymentCapabilities({ name })` fetches
+  a single capability by name (`GET admin/deployment_capabilities?name=`).
+  The parameter is optional; calling it without arguments is unchanged. The
+  backend rejects an unknown name with error code `122005`.
+- Type `GetDeploymentCapabilitiesParams`.
+
+### Fixed
+
+- `GetDeploymentCapabilitiesResponse` is now `DeploymentCapabilityInfo[]`. The
+  backend has always returned a top-level array; the old
+  `{ capabilities: [...] }` shape never matched the response.
+- `ESPAPIError.errorCode` is now always a string, as its type declares. The
+  RainMaker backend sends `error_code` as a number, which the SDK passed
+  through unchanged, so `errorCode === "122005"` was false at runtime. Callers
+  that compared against a number must compare against the string instead.
+
 ## [1.4.0] - 2026-10-07
 
 Minor release that adds OAuth 2.0 authorization-code login, so dashboards can

package/dist/cjs/entries/ESPRMAdminDashboard.cjs

@@ -7,6 +7,7 @@
 
 require('../methods/ESPRMAdminDashboard/UpdateDashboard.cjs');
 require('../methods/ESPRMAdminDashboard/GetDashboardUpdateStatus.cjs');
+require('../methods/ESPRMAdminDashboard/CheckDashboardUpdate.cjs');
 require('../methods/ESPRMAdminDashboard/GetDashboardVersionMapping.cjs');
 var ESPRMAdminDashboard = require('../ESPRMAdminDashboard.cjs');
 

package/dist/cjs/index.cjs

@@ -155,6 +155,7 @@ require('./methods/ESPRMAdminMessageTemplate/DeleteMessageTemplate.cjs');
 require('./methods/ESPRMAdminMessageTemplate/GetVerifiedEmails.cjs');
 require('./methods/ESPRMAdminDashboard/UpdateDashboard.cjs');
 require('./methods/ESPRMAdminDashboard/GetDashboardUpdateStatus.cjs');
+require('./methods/ESPRMAdminDashboard/CheckDashboardUpdate.cjs');
 require('./methods/ESPRMAdminDashboard/GetDashboardVersionMapping.cjs');
 require('./methods/ESPRMAdminLicense/UploadLicenseFile.cjs');
 require('./methods/ESPRMAdminLicense/GetLicenseFile.cjs');

package/dist/cjs/methods/ESPRMAdminDashboard/CheckDashboardUpdate.cjs

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

package/dist/cjs/methods/ESPRMAdminDashboard/GetDashboardVersionMapping.cjs

@@ -10,10 +10,11 @@ var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
 var constants = require('../../utils/constants.cjs');
 
 ESPRMAdminDashboard.ESPRMAdminDashboard.prototype.getDashboardVersionMapping =
-    async function () {
+    async function (params) {
         const requestConfig = {
             url: constants.APIEndpoints.ADMIN_DASHBOARD_VERSION_MAPPING,
             method: constants.HTTPMethods.GET,
+            ...(params && { params }),
         };
         const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
         return response;

package/dist/cjs/methods/ESPRMAdminDeploymentCapability/GetDeploymentCapabilities.cjs

@@ -10,10 +10,11 @@ var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
 var constants = require('../../utils/constants.cjs');
 
 ESPRMAdminDeploymentCapability.ESPRMAdminDeploymentCapability.prototype.getDeploymentCapabilities =
-    async function () {
+    async function (params) {
         const requestConfig = {
             url: constants.APIEndpoints.ADMIN_DEPLOYMENT_CAPABILITIES,
             method: constants.HTTPMethods.GET,
+            ...(params && { params }),
         };
         const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
         return response;

package/dist/cjs/utils/error/parser.cjs

@@ -11,7 +11,7 @@ const parseAPIErrorResponse = (error, statusCode) => {
     let description = "An error has occurred";
     if (error) {
         status = error.status ?? "";
-        errorCode = error.error_code ?? error.error ?? "";
+        errorCode = String(error.error_code ?? error.error ?? "");
         description =
             error.description ?? error.error_description ?? "An error has occurred";
     }

package/dist/esm/entries/ESPRMAdminDashboard.js

@@ -5,5 +5,6 @@
  */
 import '../methods/ESPRMAdminDashboard/UpdateDashboard.js';
 import '../methods/ESPRMAdminDashboard/GetDashboardUpdateStatus.js';
+import '../methods/ESPRMAdminDashboard/CheckDashboardUpdate.js';
 import '../methods/ESPRMAdminDashboard/GetDashboardVersionMapping.js';
 export { ESPRMAdminDashboard } from '../ESPRMAdminDashboard.js';

package/dist/esm/index.js

@@ -153,6 +153,7 @@ import './methods/ESPRMAdminMessageTemplate/DeleteMessageTemplate.js';
 import './methods/ESPRMAdminMessageTemplate/GetVerifiedEmails.js';
 import './methods/ESPRMAdminDashboard/UpdateDashboard.js';
 import './methods/ESPRMAdminDashboard/GetDashboardUpdateStatus.js';
+import './methods/ESPRMAdminDashboard/CheckDashboardUpdate.js';
 import './methods/ESPRMAdminDashboard/GetDashboardVersionMapping.js';
 import './methods/ESPRMAdminLicense/UploadLicenseFile.js';
 import './methods/ESPRMAdminLicense/GetLicenseFile.js';

package/dist/esm/methods/ESPRMAdminDashboard/CheckDashboardUpdate.js

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

package/dist/esm/methods/ESPRMAdminDashboard/GetDashboardVersionMapping.js

@@ -8,10 +8,11 @@ import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
 import { HTTPMethods, APIEndpoints } from '../../utils/constants.js';
 
 ESPRMAdminDashboard.prototype.getDashboardVersionMapping =
-    async function () {
+    async function (params) {
         const requestConfig = {
             url: APIEndpoints.ADMIN_DASHBOARD_VERSION_MAPPING,
             method: HTTPMethods.GET,
+            ...(params && { params }),
         };
         const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
         return response;

package/dist/esm/methods/ESPRMAdminDeploymentCapability/GetDeploymentCapabilities.js

@@ -8,10 +8,11 @@ import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
 import { HTTPMethods, APIEndpoints } from '../../utils/constants.js';
 
 ESPRMAdminDeploymentCapability.prototype.getDeploymentCapabilities =
-    async function () {
+    async function (params) {
         const requestConfig = {
             url: APIEndpoints.ADMIN_DEPLOYMENT_CAPABILITIES,
             method: HTTPMethods.GET,
+            ...(params && { params }),
         };
         const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
         return response;

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

@@ -9,7 +9,7 @@ const parseAPIErrorResponse = (error, statusCode) => {
     let description = "An error has occurred";
     if (error) {
         status = error.status ?? "";
-        errorCode = error.error_code ?? error.error ?? "";
+        errorCode = String(error.error_code ?? error.error ?? "");
         description =
             error.description ?? error.error_description ?? "An error has occurred";
     }

package/dist/types/methods/ESPRMAdminDashboard/CheckDashboardUpdate.d.ts

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CheckDashboardUpdateParams, CheckDashboardUpdateResponse } from "../../types/dashboard.js";
+declare module "../../ESPRMAdminDashboard.js" {
+    interface ESPRMAdminDashboard {
+        /**
+         * Checks whether a newer dashboard version is published for this deployment.
+         *
+         * @param params - The dashboard version currently deployed.
+         * @returns `DashboardUpdateAvailable` when an update exists, otherwise a
+         * plain success response. The backend rejects a missing or malformed
+         * `current_version` with error code 110001.
+         */
+        checkDashboardUpdate(params: CheckDashboardUpdateParams): Promise<CheckDashboardUpdateResponse>;
+    }
+}

package/dist/types/methods/ESPRMAdminDashboard/GetDashboardUpdateStatus.d.ts

@@ -9,6 +9,8 @@ declare module "../../ESPRMAdminDashboard.js" {
         /**
          * Retrieves the current status of a dashboard update operation.
          *
+         * @deprecated Sends no `current_version`, which the backend requires, so
+         * it always fails with error code 110001. Use `checkDashboardUpdate`.
          * @returns The dashboard update status response.
          */
         getDashboardUpdateStatus(): Promise<GetDashboardUpdateStatusResponse>;

package/dist/types/methods/ESPRMAdminDashboard/GetDashboardVersionMapping.d.ts

@@ -3,14 +3,16 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GetDashboardVersionMappingResponse } from "../../types/dashboard.js";
+import { GetDashboardVersionMappingParams, GetDashboardVersionMappingResponse } from "../../types/dashboard.js";
 declare module "../../ESPRMAdminDashboard.js" {
     interface ESPRMAdminDashboard {
         /**
          * Retrieves the version mapping for the dashboard, showing available versions and their associations.
          *
+         * @param params - Optional filter. `version` is only honoured together with
+         * `type`. Supported only on SAM deployments; others get error code 110010.
          * @returns The dashboard version mapping response.
          */
-        getDashboardVersionMapping(): Promise<GetDashboardVersionMappingResponse>;
+        getDashboardVersionMapping(params?: GetDashboardVersionMappingParams): Promise<GetDashboardVersionMappingResponse>;
     }
 }

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

@@ -5,4 +5,5 @@
  */
 import "./UpdateDashboard.js";
 import "./GetDashboardUpdateStatus.js";
+import "./CheckDashboardUpdate.js";
 import "./GetDashboardVersionMapping.js";

package/dist/types/methods/ESPRMAdminDeploymentCapability/GetDeploymentCapabilities.d.ts

@@ -3,14 +3,16 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GetDeploymentCapabilitiesResponse } from "../../types/deployment_capability.js";
+import { GetDeploymentCapabilitiesParams, GetDeploymentCapabilitiesResponse } from "../../types/deployment_capability.js";
 declare module "../../ESPRMAdminDeploymentCapability.js" {
     interface ESPRMAdminDeploymentCapability {
         /**
-         * Retrieves the list of deployment capabilities available for the current deployment.
+         * Retrieves the deployment capabilities of the current deployment.
          *
-         * @returns The deployment capabilities response.
+         * @param params - Optional filter. Pass `name` to fetch a single capability.
+         * @returns The matching capabilities. The backend rejects an unknown `name`
+         * with error code 122005 instead of returning an empty list.
          */
-        getDeploymentCapabilities(): Promise<GetDeploymentCapabilitiesResponse>;
+        getDeploymentCapabilities(params?: GetDeploymentCapabilitiesParams): Promise<GetDeploymentCapabilitiesResponse>;
     }
 }

package/dist/types/types/dashboard.d.ts

@@ -3,6 +3,7 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ESPAPISuccessResponse } from "./api.js";
 /** Request body for updating the dashboard version. */
 export interface UpdateDashboardRequest {
     /** The target dashboard version. */
@@ -14,10 +15,36 @@ export interface GetDashboardUpdateStatusResponse {
     version?: string;
     [key: string]: unknown;
 }
+/** Query parameters for checking dashboard updates. */
+export interface CheckDashboardUpdateParams {
+    /** The dashboard version currently deployed, e.g. `"2.6.0"`. */
+    current_version: string;
+}
+/** Returned when a newer dashboard version is published. */
+export interface DashboardUpdateAvailable {
+    /** The latest published dashboard version. */
+    version: string;
+    /** Whether the backend is already on a version that supports `version`. */
+    backend_updated: boolean;
+}
+/**
+ * Response of the dashboard update check. When no newer version exists the
+ * backend returns a plain success response instead of `DashboardUpdateAvailable`.
+ */
+export type CheckDashboardUpdateResponse = DashboardUpdateAvailable | ESPAPISuccessResponse;
+/** Which side of the version mapping to filter on. */
+export type DashboardVersionMappingType = "backend" | "frontend";
+/** Query parameters for the dashboard version mapping. */
+export interface GetDashboardVersionMappingParams {
+    /** Return only this side of the mapping. */
+    type?: DashboardVersionMappingType;
+    /** Return only the entry for this version. Requires `type`. */
+    version?: string;
+}
 /** Response containing dashboard version compatibility mappings. */
 export interface GetDashboardVersionMappingResponse {
-    /** Backend version compatibility mapping. */
+    /** Backend version to compatible dashboard versions. */
     backend?: Record<string, string[]>;
-    /** Frontend version compatibility mapping. */
+    /** Dashboard version to compatible backend versions. */
     frontend?: Record<string, string[]>;
 }

package/dist/types/types/deployment_capability.d.ts

@@ -17,9 +17,10 @@ export interface DeploymentCapabilityInfo {
     /** The capability value. */
     value?: string;
 }
-/** Response containing deployment capabilities. */
-export interface GetDeploymentCapabilitiesResponse {
-    /** List of deployment capabilities. */
-    capabilities?: DeploymentCapabilityInfo[];
-    [key: string]: unknown;
+/** Query parameters for fetching deployment capabilities. */
+export interface GetDeploymentCapabilitiesParams {
+    /** Fetch only the capability with this name. */
+    name?: string;
 }
+/** Deployment capabilities, returned by the backend as a top-level array. */
+export type GetDeploymentCapabilitiesResponse = DeploymentCapabilityInfo[];

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

@@ -26,7 +26,7 @@ export type { CreateCognitoAppClientRequest, UpdateCognitoAppClientRequest, GetC
 export type { CreateCognitoDomainRequest, GetCognitoDomainParams, DeleteCognitoDomainParams, } from "./cognito_domain.js";
 export type { CreateIdentityProviderRequest, UpdateIdentityProviderRequest, GetIdentityProvidersParams, DeleteIdentityProviderParams, } from "./identity_provider.js";
 export type { CreateMessageTemplateRequest, UpdateMessageTemplateRequest, GetMessageTemplatesParams, DeleteMessageTemplateParams, } from "./message_template.js";
-export type { UpdateDashboardRequest } from "./dashboard.js";
+export type { UpdateDashboardRequest, CheckDashboardUpdateParams, DashboardVersionMappingType, GetDashboardVersionMappingParams, } from "./dashboard.js";
 export type { UploadLicenseFileRequest, GetLicenseFileParams } from "./license.js";
 export type { GenerateNodeIdsRequest, GetNodeIdsParams, GetNodeCertificatesParams, RegisterNodeCertificatesRequest, GetNodeCertificateRegistrationParams, } from "./node_registration.js";
 export type { ChangeSuperAdminRequest } from "./super_admin.js";
@@ -49,7 +49,7 @@ export type { GetMailFailuresParams } from "./mail_failure.js";
 export type { UpdateTermsPolicyRequest, GetTermsPolicyParams, DeleteTermsPolicyParams, } from "./terms_policy.js";
 export type { AddCloudwatchLogUserRequest } from "./cloudwatch_log.js";
 export type { UpdateLogConfigRequest } from "./log_config.js";
-export type { UpdateDeploymentCapabilityRequest } from "./deployment_capability.js";
+export type { GetDeploymentCapabilitiesParams, UpdateDeploymentCapabilityRequest, } from "./deployment_capability.js";
 export type { GetAPIStatisticsParams } from "./api_statistics.js";
 export type { GetMQTTStatisticsParams } from "./mqtt_statistics.js";
 export type { CreateMatterAuthRequest, CreateMatterBatchRequest, UpdateMatterBatchRequest, GetMatterBatchParams, GetMatterBatchNodesParams, } from "./matter.js";

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

@@ -25,7 +25,7 @@ export type { CognitoAppClientInfo, GetCognitoAppClientsResponse, } from "./cogn
 export type { GetCognitoDomainResponse } from "./cognito_domain.js";
 export type { GetIdentityProvidersResponse } from "./identity_provider.js";
 export type { MessageTemplateInfo, GetMessageTemplatesResponse, GetVerifiedEmailsResponse, } from "./message_template.js";
-export type { GetDashboardUpdateStatusResponse, GetDashboardVersionMappingResponse, } from "./dashboard.js";
+export type { GetDashboardUpdateStatusResponse, GetDashboardVersionMappingResponse, CheckDashboardUpdateResponse, DashboardUpdateAvailable, } from "./dashboard.js";
 export type { LicenseFileInfo, GetLicenseFileResponse, GetLicenseQuotaResponse, } from "./license.js";
 export type { GenerateNodeIdsResponse, GetNodeIdsResponse, NodeCertificateInfo, GetNodeCertificatesResponse, NodeCertificateRegistrationStatusResponse, GetMQTTHostResponse, } from "./node_registration.js";
 export type { GetDeploymentDetailsResponse } from "./deployment_details.js";

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

@@ -6,7 +6,8 @@
 import { ESPAPIError } from "../../types/api.js";
 interface RawAPIErrorBody {
     status?: string;
-    error_code?: string;
+    /** The RainMaker backend sends a number; some endpoints send a string. */
+    error_code?: string | number;
     description?: string;
     /** RFC 6749 error code, returned by the OAuth endpoints instead of `error_code`. */
     error?: string;

package/dist/types-cjs/methods/ESPRMAdminDashboard/CheckDashboardUpdate.d.cts

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CheckDashboardUpdateParams, CheckDashboardUpdateResponse } from "../../types/dashboard.cjs";
+declare module "../../ESPRMAdminDashboard.cjs" {
+    interface ESPRMAdminDashboard {
+        /**
+         * Checks whether a newer dashboard version is published for this deployment.
+         *
+         * @param params - The dashboard version currently deployed.
+         * @returns `DashboardUpdateAvailable` when an update exists, otherwise a
+         * plain success response. The backend rejects a missing or malformed
+         * `current_version` with error code 110001.
+         */
+        checkDashboardUpdate(params: CheckDashboardUpdateParams): Promise<CheckDashboardUpdateResponse>;
+    }
+}

package/dist/types-cjs/methods/ESPRMAdminDashboard/GetDashboardUpdateStatus.d.cts

@@ -9,6 +9,8 @@ declare module "../../ESPRMAdminDashboard.cjs" {
         /**
          * Retrieves the current status of a dashboard update operation.
          *
+         * @deprecated Sends no `current_version`, which the backend requires, so
+         * it always fails with error code 110001. Use `checkDashboardUpdate`.
          * @returns The dashboard update status response.
          */
         getDashboardUpdateStatus(): Promise<GetDashboardUpdateStatusResponse>;

package/dist/types-cjs/methods/ESPRMAdminDashboard/GetDashboardVersionMapping.d.cts

@@ -3,14 +3,16 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GetDashboardVersionMappingResponse } from "../../types/dashboard.cjs";
+import { GetDashboardVersionMappingParams, GetDashboardVersionMappingResponse } from "../../types/dashboard.cjs";
 declare module "../../ESPRMAdminDashboard.cjs" {
     interface ESPRMAdminDashboard {
         /**
          * Retrieves the version mapping for the dashboard, showing available versions and their associations.
          *
+         * @param params - Optional filter. `version` is only honoured together with
+         * `type`. Supported only on SAM deployments; others get error code 110010.
          * @returns The dashboard version mapping response.
          */
-        getDashboardVersionMapping(): Promise<GetDashboardVersionMappingResponse>;
+        getDashboardVersionMapping(params?: GetDashboardVersionMappingParams): Promise<GetDashboardVersionMappingResponse>;
     }
 }

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

@@ -5,4 +5,5 @@
  */
 import "./UpdateDashboard.cjs";
 import "./GetDashboardUpdateStatus.cjs";
+import "./CheckDashboardUpdate.cjs";
 import "./GetDashboardVersionMapping.cjs";

package/dist/types-cjs/methods/ESPRMAdminDeploymentCapability/GetDeploymentCapabilities.d.cts

@@ -3,14 +3,16 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
-import { GetDeploymentCapabilitiesResponse } from "../../types/deployment_capability.cjs";
+import { GetDeploymentCapabilitiesParams, GetDeploymentCapabilitiesResponse } from "../../types/deployment_capability.cjs";
 declare module "../../ESPRMAdminDeploymentCapability.cjs" {
     interface ESPRMAdminDeploymentCapability {
         /**
-         * Retrieves the list of deployment capabilities available for the current deployment.
+         * Retrieves the deployment capabilities of the current deployment.
          *
-         * @returns The deployment capabilities response.
+         * @param params - Optional filter. Pass `name` to fetch a single capability.
+         * @returns The matching capabilities. The backend rejects an unknown `name`
+         * with error code 122005 instead of returning an empty list.
          */
-        getDeploymentCapabilities(): Promise<GetDeploymentCapabilitiesResponse>;
+        getDeploymentCapabilities(params?: GetDeploymentCapabilitiesParams): Promise<GetDeploymentCapabilitiesResponse>;
     }
 }

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

@@ -3,6 +3,7 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ESPAPISuccessResponse } from "./api.cjs";
 /** Request body for updating the dashboard version. */
 export interface UpdateDashboardRequest {
     /** The target dashboard version. */
@@ -14,10 +15,36 @@ export interface GetDashboardUpdateStatusResponse {
     version?: string;
     [key: string]: unknown;
 }
+/** Query parameters for checking dashboard updates. */
+export interface CheckDashboardUpdateParams {
+    /** The dashboard version currently deployed, e.g. `"2.6.0"`. */
+    current_version: string;
+}
+/** Returned when a newer dashboard version is published. */
+export interface DashboardUpdateAvailable {
+    /** The latest published dashboard version. */
+    version: string;
+    /** Whether the backend is already on a version that supports `version`. */
+    backend_updated: boolean;
+}
+/**
+ * Response of the dashboard update check. When no newer version exists the
+ * backend returns a plain success response instead of `DashboardUpdateAvailable`.
+ */
+export type CheckDashboardUpdateResponse = DashboardUpdateAvailable | ESPAPISuccessResponse;
+/** Which side of the version mapping to filter on. */
+export type DashboardVersionMappingType = "backend" | "frontend";
+/** Query parameters for the dashboard version mapping. */
+export interface GetDashboardVersionMappingParams {
+    /** Return only this side of the mapping. */
+    type?: DashboardVersionMappingType;
+    /** Return only the entry for this version. Requires `type`. */
+    version?: string;
+}
 /** Response containing dashboard version compatibility mappings. */
 export interface GetDashboardVersionMappingResponse {
-    /** Backend version compatibility mapping. */
+    /** Backend version to compatible dashboard versions. */
     backend?: Record<string, string[]>;
-    /** Frontend version compatibility mapping. */
+    /** Dashboard version to compatible backend versions. */
     frontend?: Record<string, string[]>;
 }

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

@@ -17,9 +17,10 @@ export interface DeploymentCapabilityInfo {
     /** The capability value. */
     value?: string;
 }
-/** Response containing deployment capabilities. */
-export interface GetDeploymentCapabilitiesResponse {
-    /** List of deployment capabilities. */
-    capabilities?: DeploymentCapabilityInfo[];
-    [key: string]: unknown;
+/** Query parameters for fetching deployment capabilities. */
+export interface GetDeploymentCapabilitiesParams {
+    /** Fetch only the capability with this name. */
+    name?: string;
 }
+/** Deployment capabilities, returned by the backend as a top-level array. */
+export type GetDeploymentCapabilitiesResponse = DeploymentCapabilityInfo[];

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

@@ -26,7 +26,7 @@ export type { CreateCognitoAppClientRequest, UpdateCognitoAppClientRequest, GetC
 export type { CreateCognitoDomainRequest, GetCognitoDomainParams, DeleteCognitoDomainParams, } from "./cognito_domain.cjs";
 export type { CreateIdentityProviderRequest, UpdateIdentityProviderRequest, GetIdentityProvidersParams, DeleteIdentityProviderParams, } from "./identity_provider.cjs";
 export type { CreateMessageTemplateRequest, UpdateMessageTemplateRequest, GetMessageTemplatesParams, DeleteMessageTemplateParams, } from "./message_template.cjs";
-export type { UpdateDashboardRequest } from "./dashboard.cjs";
+export type { UpdateDashboardRequest, CheckDashboardUpdateParams, DashboardVersionMappingType, GetDashboardVersionMappingParams, } from "./dashboard.cjs";
 export type { UploadLicenseFileRequest, GetLicenseFileParams } from "./license.cjs";
 export type { GenerateNodeIdsRequest, GetNodeIdsParams, GetNodeCertificatesParams, RegisterNodeCertificatesRequest, GetNodeCertificateRegistrationParams, } from "./node_registration.cjs";
 export type { ChangeSuperAdminRequest } from "./super_admin.cjs";
@@ -49,7 +49,7 @@ export type { GetMailFailuresParams } from "./mail_failure.cjs";
 export type { UpdateTermsPolicyRequest, GetTermsPolicyParams, DeleteTermsPolicyParams, } from "./terms_policy.cjs";
 export type { AddCloudwatchLogUserRequest } from "./cloudwatch_log.cjs";
 export type { UpdateLogConfigRequest } from "./log_config.cjs";
-export type { UpdateDeploymentCapabilityRequest } from "./deployment_capability.cjs";
+export type { GetDeploymentCapabilitiesParams, UpdateDeploymentCapabilityRequest, } from "./deployment_capability.cjs";
 export type { GetAPIStatisticsParams } from "./api_statistics.cjs";
 export type { GetMQTTStatisticsParams } from "./mqtt_statistics.cjs";
 export type { CreateMatterAuthRequest, CreateMatterBatchRequest, UpdateMatterBatchRequest, GetMatterBatchParams, GetMatterBatchNodesParams, } from "./matter.cjs";

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

@@ -25,7 +25,7 @@ export type { CognitoAppClientInfo, GetCognitoAppClientsResponse, } from "./cogn
 export type { GetCognitoDomainResponse } from "./cognito_domain.cjs";
 export type { GetIdentityProvidersResponse } from "./identity_provider.cjs";
 export type { MessageTemplateInfo, GetMessageTemplatesResponse, GetVerifiedEmailsResponse, } from "./message_template.cjs";
-export type { GetDashboardUpdateStatusResponse, GetDashboardVersionMappingResponse, } from "./dashboard.cjs";
+export type { GetDashboardUpdateStatusResponse, GetDashboardVersionMappingResponse, CheckDashboardUpdateResponse, DashboardUpdateAvailable, } from "./dashboard.cjs";
 export type { LicenseFileInfo, GetLicenseFileResponse, GetLicenseQuotaResponse, } from "./license.cjs";
 export type { GenerateNodeIdsResponse, GetNodeIdsResponse, NodeCertificateInfo, GetNodeCertificatesResponse, NodeCertificateRegistrationStatusResponse, GetMQTTHostResponse, } from "./node_registration.cjs";
 export type { GetDeploymentDetailsResponse } from "./deployment_details.cjs";

package/dist/types-cjs/utils/error/parser.d.cts

@@ -6,7 +6,8 @@
 import { ESPAPIError } from "../../types/api.cjs";
 interface RawAPIErrorBody {
     status?: string;
-    error_code?: string;
+    /** The RainMaker backend sends a number; some endpoints send a string. */
+    error_code?: string | number;
     description?: string;
     /** RFC 6749 error code, returned by the OAuth endpoints instead of `error_code`. */
     error?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@espressif/rainmaker-admin-sdk",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Espressif's Rainmaker Admin SDK enables seamless integration of admin applications with the ESP Rainmaker ecosystem.",
   "license": "Apache-2.0",
   "author": "Espressif Systems (Shanghai) CO LTD",