@espressif/rainmaker-admin-sdk 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -3,7 +3,113 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and follows the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format.
 
-## [Unreleased]
+## [1.1.1] - 2026-09-23
+
+Patch release for the simple time series data endpoint. The time range
+becomes optional, as the backend always allowed, and optional query
+parameters that are left undefined are no longer sent as the literal text
+`undefined`. No breaking changes; every existing call keeps working as before.
+
+### Changed
+
+- **Simple time series data**
+  - `start_time` and `end_time` on `GetSimpleTimeSeriesDataParams` are now
+    optional, matching the backend: omitting them queries from the oldest
+    record up to now. Existing callers that pass both are unaffected.
+
+### Fixed
+
+- **Query parameter serialisation**
+  - `ESPRMAPIManager.request()` no longer sends optional query parameters
+    that are `undefined` or `null`. Previously `URLSearchParams` turned them
+    into the literal text `undefined` / `null`, which the backend rejected
+    (for example `start_time=undefined` on `/admin/nodes/simple_tsdata`).
+    Numbers and booleans are stringified explicitly, and a params object
+    with no remaining entries produces no `?` at all.
+
+## [1.1.0] - 2026-09-18
+
+OTA job and OTA image lifecycle management. Adds cancel/archive for jobs and
+archive/unarchive plus delete for images, and corrects several OTA request
+shapes that did not match the backend.
+
+### Added
+
+- **OTA job lifecycle**
+  - Added `cancelJob()` on `ESPRMAdminOTAJob`, marking an in-flight job and all of
+    its pending nodes as cancelled. Only active jobs can be cancelled.
+  - Added `archiveJob()` on `ESPRMAdminOTAJob`, hiding a job from the default
+    listing. Only finished, cancelled or expired jobs can be archived, and only
+    once — archiving is one-way, so `ArchiveOTAJobRequest` deliberately carries no
+    `archive` flag.
+  - Both return the job's full updated record as `OTAJobUpdateResponse`; the
+    backend re-reads the job after applying the update.
+  - Added `archived` to `OTAJobInfo`. Present and `true` once archived; absent
+    rather than `false` otherwise.
+
+- **OTA image delete**
+  - Added `deletePackage()` on `ESPRMAdminOTAImage` for images uploaded as part of
+    a package. The plain delete endpoint rejects these outright, so they could not
+    previously be removed through the SDK.
+  - Added `force_delete` to the new `DeleteOTAImageParams`, for deleting an image
+    still referenced by non-active OTA jobs. A reference from an *active* job is
+    rejected regardless of the flag.
+
+- **OTA image listing**
+  - Added `all` to `GetOTAImagesParams`, returning archived and unarchived images
+    together. Honoured by the unfiltered listing only — the `ota_image_id`,
+    `image_name`, `type` and `model` lookups span both states regardless.
+  - Added `package` to `OTAImageInfo`, naming the archive an image was extracted
+    from. Images carrying it can only be removed via `deletePackage()`.
+
+- **Errors**
+  - Added the `MISSING_ARCHIVE_FLAG` API-call validation code.
+
+### Fixed
+
+- **`archiveImage()` sent its parameters in the request body**, which this endpoint
+  ignores — every call failed with "OTA Image Id is missing". Parameters are now
+  sent as query parameters, and `archive` is serialised as the literal `"true"` /
+  `"false"` the backend requires. **This method could not have worked before.**
+- **`retriggerJob()` targeted the wrong endpoint and method.** It sent `PUT
+  admin/otajob`; it now sends `POST admin/otajob/retrigger`.
+
+### Changed
+
+- **`retriggerJob()`** returns `OTAJobRetriggerResponse` (`ota_job_id`, `status`)
+  instead of a bare success response. Delivery is dispatched asynchronously, so a
+  success means the retrigger was accepted, not that any node has received it.
+- **`RetriggerOTAJobRequest.node_ids` was removed.** The endpoint accepts no such
+  field; a retrigger always covers every node still pending.
+- **`deleteImage()` now takes a `DeleteOTAImageParams` object** rather than a bare
+  `ota_image_id` string, matching `archiveImage()` and making room for
+  `force_delete`.
+
+### Removed
+
+- **`deleteJob()` on `ESPRMAdminOTAJob`.** OTA jobs cannot be deleted; the method
+  issued a `DELETE` the backend does not implement. Use `cancelJob()` to stop an
+  in-flight job and `archiveJob()` to remove one from the default listing.
+- **`APIEndpoints.ADMIN_OTA_JOB_ACTION`**, an alias of `ADMIN_OTA_JOB`, replaced by
+  `ADMIN_OTA_JOB_RETRIGGER`.
+
+### Deprecated
+
+Documentation-only; no runtime behaviour changed. These fields are accepted or
+returned by the SDK types but are inert against the current backend.
+
+- `GetOTAImagesParams.fw_version` — no such filter exists on this endpoint.
+- `OTAImageInfo.status` and `OTAImageInfo.timestamp` — never returned for images;
+  they were carried over from the OTA job type. Use `upload_timestamp`.
+- `GetOTAImagesResponse.total` — never sent for images.
+
+### Notes
+
+- `GetOTAImagesParams.contains` is a bool-as-string flag (`"true"`) and applies to
+  `image_name` only. Without it, a name lookup is an exact match rather than a
+  search.
+- `OTAImageInfo.archived` is omitted rather than set to `false` for images that
+  have never been archived.
 
 ## [1.0.0] - 2026-09-07
 

package/dist/cjs/entries/ESPRMAdminOTAImage.cjs

@@ -13,6 +13,7 @@ require('../methods/ESPRMAdminOTAImage/ConfirmPackageUpload.cjs');
 require('../methods/ESPRMAdminOTAImage/GetImages.cjs');
 require('../methods/ESPRMAdminOTAImage/ArchiveImage.cjs');
 require('../methods/ESPRMAdminOTAImage/DeleteImage.cjs');
+require('../methods/ESPRMAdminOTAImage/DeletePackage.cjs');
 var ESPRMAdminOTAImage = require('../ESPRMAdminOTAImage.cjs');
 
 

package/dist/cjs/entries/ESPRMAdminOTAJob.cjs

@@ -8,7 +8,8 @@
 require('../methods/ESPRMAdminOTAJob/CreateJob.cjs');
 require('../methods/ESPRMAdminOTAJob/GetJob.cjs');
 require('../methods/ESPRMAdminOTAJob/UpdateJob.cjs');
-require('../methods/ESPRMAdminOTAJob/DeleteJob.cjs');
+require('../methods/ESPRMAdminOTAJob/CancelJob.cjs');
+require('../methods/ESPRMAdminOTAJob/ArchiveJob.cjs');
 require('../methods/ESPRMAdminOTAJob/GetJobStatus.cjs');
 require('../methods/ESPRMAdminOTAJob/GetJobStatusSummary.cjs');
 require('../methods/ESPRMAdminOTAJob/RetriggerJob.cjs');

package/dist/cjs/index.cjs

@@ -90,10 +90,12 @@ require('./methods/ESPRMAdminOTAImage/ConfirmPackageUpload.cjs');
 require('./methods/ESPRMAdminOTAImage/GetImages.cjs');
 require('./methods/ESPRMAdminOTAImage/ArchiveImage.cjs');
 require('./methods/ESPRMAdminOTAImage/DeleteImage.cjs');
+require('./methods/ESPRMAdminOTAImage/DeletePackage.cjs');
 require('./methods/ESPRMAdminOTAJob/CreateJob.cjs');
 require('./methods/ESPRMAdminOTAJob/GetJob.cjs');
 require('./methods/ESPRMAdminOTAJob/UpdateJob.cjs');
-require('./methods/ESPRMAdminOTAJob/DeleteJob.cjs');
+require('./methods/ESPRMAdminOTAJob/CancelJob.cjs');
+require('./methods/ESPRMAdminOTAJob/ArchiveJob.cjs');
 require('./methods/ESPRMAdminOTAJob/GetJobStatus.cjs');
 require('./methods/ESPRMAdminOTAJob/GetJobStatusSummary.cjs');
 require('./methods/ESPRMAdminOTAJob/RetriggerJob.cjs');

package/dist/cjs/methods/ESPRMAdminOTAImage/ArchiveImage.cjs

@@ -14,10 +14,19 @@ ESPRMAdminOTAImage.ESPRMAdminOTAImage.prototype.archiveImage = async function (p
     if (!params.ota_image_id) {
         throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_OTA_IMAGE_ID);
     }
+    if (typeof params.archive !== "boolean") {
+        throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_ARCHIVE_FLAG);
+    }
     const requestConfig = {
         url: constants.APIEndpoints.ADMIN_OTA_IMAGE,
         method: constants.HTTPMethods.PUT,
-        data: params,
+        // This endpoint reads query parameters only — a JSON body is ignored and the
+        // request fails with "OTA Image Id is missing". `archive` is stringified
+        // explicitly because the backend accepts only the literals "true"/"false".
+        params: {
+            ota_image_id: params.ota_image_id,
+            archive: String(params.archive),
+        },
     };
     const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

package/dist/cjs/methods/ESPRMAdminOTAImage/DeleteImage.cjs

@@ -9,15 +9,16 @@ var ESPRMAdminOTAImage = require('../../ESPRMAdminOTAImage.cjs');
 var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
 var constants = require('../../utils/constants.cjs');
 var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
+var deleteParams = require('./deleteParams.cjs');
 
-ESPRMAdminOTAImage.ESPRMAdminOTAImage.prototype.deleteImage = async function (otaImageId) {
-    if (!otaImageId) {
+ESPRMAdminOTAImage.ESPRMAdminOTAImage.prototype.deleteImage = async function (params) {
+    if (!params?.ota_image_id) {
         throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_OTA_IMAGE_ID);
     }
     const requestConfig = {
         url: constants.APIEndpoints.ADMIN_OTA_IMAGE,
         method: constants.HTTPMethods.DELETE,
-        params: { ota_image_id: otaImageId },
+        params: deleteParams.buildDeleteOTAImageParams(params),
     };
     const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

package/dist/cjs/methods/ESPRMAdminOTAImage/DeletePackage.cjs

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

package/dist/cjs/methods/ESPRMAdminOTAImage/deleteParams.cjs

@@ -0,0 +1,21 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+/**
+ * Builds the query string shared by the image and package delete endpoints.
+ *
+ * `force_delete` is sent only when requested: the backend reads it as a string and
+ * treats any value other than "true" as false, so omitting it keeps the URL clean.
+ */
+function buildDeleteOTAImageParams(params) {
+    return {
+        ota_image_id: params.ota_image_id,
+        ...(params.force_delete ? { force_delete: "true" } : {}),
+    };
+}
+
+exports.buildDeleteOTAImageParams = buildDeleteOTAImageParams;

package/dist/cjs/methods/ESPRMAdminOTAJob/ArchiveJob.cjs

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

package/dist/cjs/methods/ESPRMAdminOTAJob/{DeleteJob.cjs → CancelJob.cjs}

@@ -10,14 +10,14 @@ var ESPRMAPIManager = require('../../services/ESPRMAPIManager.cjs');
 var constants = require('../../utils/constants.cjs');
 var ESPAPICallValidationError = require('../../utils/error/ESPAPICallValidationError.cjs');
 
-ESPRMAdminOTAJob.ESPRMAdminOTAJob.prototype.deleteJob = async function (otaJobId) {
-    if (!otaJobId) {
+ESPRMAdminOTAJob.ESPRMAdminOTAJob.prototype.cancelJob = async function (params) {
+    if (!params.ota_job_id) {
         throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_OTA_JOB_ID);
     }
     const requestConfig = {
         url: constants.APIEndpoints.ADMIN_OTA_JOB,
-        method: constants.HTTPMethods.DELETE,
-        params: { ota_job_id: otaJobId },
+        method: constants.HTTPMethods.PUT,
+        data: { ota_job_id: params.ota_job_id },
     };
     const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

package/dist/cjs/methods/ESPRMAdminOTAJob/RetriggerJob.cjs

@@ -15,8 +15,8 @@ ESPRMAdminOTAJob.ESPRMAdminOTAJob.prototype.retriggerJob = async function (param
         throw new ESPAPICallValidationError.ESPAPICallValidationError(constants.APICallValidationErrorCodes.MISSING_OTA_JOB_ID);
     }
     const requestConfig = {
-        url: constants.APIEndpoints.ADMIN_OTA_JOB,
-        method: constants.HTTPMethods.PUT,
+        url: constants.APIEndpoints.ADMIN_OTA_JOB_RETRIGGER,
+        method: constants.HTTPMethods.POST,
         data: params,
     };
     const response = await ESPRMAPIManager.ESPRMAPIManager.authorizeRequest(requestConfig);

package/dist/cjs/services/ESPRMAPIManager.cjs

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

package/dist/cjs/utils/constants.cjs

@@ -29,7 +29,7 @@ const APIEndpoints = {
     ADMIN_OTA_JOB: "admin/otajob",
     ADMIN_OTA_JOB_STATUS: "admin/otajob/status",
     ADMIN_OTA_JOB_STATUS_SUMMARY: "admin/otajob/status/summary",
-    ADMIN_OTA_JOB_ACTION: "admin/otajob",
+    ADMIN_OTA_JOB_RETRIGGER: "admin/otajob/retrigger",
     ADMIN_NODE_GROUP: "admin/node_group",
     ADMIN_TAGS: "admin/tags",
     ADMIN_TAG_NAMES: "admin/tags/names",
@@ -117,6 +117,7 @@ const StorageAdapterErrorCodes = {
 const APICallValidationErrorCodes = {
     MISSING_NODE_ID: "MISSING_NODE_ID",
     MISSING_OTA_IMAGE_ID: "MISSING_OTA_IMAGE_ID",
+    MISSING_ARCHIVE_FLAG: "MISSING_ARCHIVE_FLAG",
     MISSING_OTA_JOB_ID: "MISSING_OTA_JOB_ID",
     MISSING_GROUP_ID: "MISSING_GROUP_ID",
     MISSING_GROUP_NAME: "MISSING_GROUP_NAME",

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

@@ -21,6 +21,7 @@ const storageAdapterErrorMessages = {
 const apiCallValidationErrorMessages = {
     MISSING_NODE_ID: "ESPAPICallValidationError: Node ID is required.",
     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.",
     MISSING_GROUP_ID: "ESPAPICallValidationError: Group ID is required.",
     MISSING_GROUP_NAME: "ESPAPICallValidationError: Group name is required.",

package/dist/esm/entries/ESPRMAdminOTAImage.js

@@ -11,4 +11,5 @@ import '../methods/ESPRMAdminOTAImage/ConfirmPackageUpload.js';
 import '../methods/ESPRMAdminOTAImage/GetImages.js';
 import '../methods/ESPRMAdminOTAImage/ArchiveImage.js';
 import '../methods/ESPRMAdminOTAImage/DeleteImage.js';
+import '../methods/ESPRMAdminOTAImage/DeletePackage.js';
 export { ESPRMAdminOTAImage } from '../ESPRMAdminOTAImage.js';

package/dist/esm/entries/ESPRMAdminOTAJob.js

@@ -6,7 +6,8 @@
 import '../methods/ESPRMAdminOTAJob/CreateJob.js';
 import '../methods/ESPRMAdminOTAJob/GetJob.js';
 import '../methods/ESPRMAdminOTAJob/UpdateJob.js';
-import '../methods/ESPRMAdminOTAJob/DeleteJob.js';
+import '../methods/ESPRMAdminOTAJob/CancelJob.js';
+import '../methods/ESPRMAdminOTAJob/ArchiveJob.js';
 import '../methods/ESPRMAdminOTAJob/GetJobStatus.js';
 import '../methods/ESPRMAdminOTAJob/GetJobStatusSummary.js';
 import '../methods/ESPRMAdminOTAJob/RetriggerJob.js';

package/dist/esm/index.js

@@ -88,10 +88,12 @@ import './methods/ESPRMAdminOTAImage/ConfirmPackageUpload.js';
 import './methods/ESPRMAdminOTAImage/GetImages.js';
 import './methods/ESPRMAdminOTAImage/ArchiveImage.js';
 import './methods/ESPRMAdminOTAImage/DeleteImage.js';
+import './methods/ESPRMAdminOTAImage/DeletePackage.js';
 import './methods/ESPRMAdminOTAJob/CreateJob.js';
 import './methods/ESPRMAdminOTAJob/GetJob.js';
 import './methods/ESPRMAdminOTAJob/UpdateJob.js';
-import './methods/ESPRMAdminOTAJob/DeleteJob.js';
+import './methods/ESPRMAdminOTAJob/CancelJob.js';
+import './methods/ESPRMAdminOTAJob/ArchiveJob.js';
 import './methods/ESPRMAdminOTAJob/GetJobStatus.js';
 import './methods/ESPRMAdminOTAJob/GetJobStatusSummary.js';
 import './methods/ESPRMAdminOTAJob/RetriggerJob.js';

package/dist/esm/methods/ESPRMAdminOTAImage/ArchiveImage.js

@@ -12,10 +12,19 @@ ESPRMAdminOTAImage.prototype.archiveImage = async function (params) {
     if (!params.ota_image_id) {
         throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_OTA_IMAGE_ID);
     }
+    if (typeof params.archive !== "boolean") {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_ARCHIVE_FLAG);
+    }
     const requestConfig = {
         url: APIEndpoints.ADMIN_OTA_IMAGE,
         method: HTTPMethods.PUT,
-        data: params,
+        // This endpoint reads query parameters only — a JSON body is ignored and the
+        // request fails with "OTA Image Id is missing". `archive` is stringified
+        // explicitly because the backend accepts only the literals "true"/"false".
+        params: {
+            ota_image_id: params.ota_image_id,
+            archive: String(params.archive),
+        },
     };
     const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

package/dist/esm/methods/ESPRMAdminOTAImage/DeleteImage.js

@@ -7,15 +7,16 @@ import { ESPRMAdminOTAImage } from '../../ESPRMAdminOTAImage.js';
 import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
 import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
 import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
+import { buildDeleteOTAImageParams } from './deleteParams.js';
 
-ESPRMAdminOTAImage.prototype.deleteImage = async function (otaImageId) {
-    if (!otaImageId) {
+ESPRMAdminOTAImage.prototype.deleteImage = async function (params) {
+    if (!params?.ota_image_id) {
         throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_OTA_IMAGE_ID);
     }
     const requestConfig = {
         url: APIEndpoints.ADMIN_OTA_IMAGE,
         method: HTTPMethods.DELETE,
-        params: { ota_image_id: otaImageId },
+        params: buildDeleteOTAImageParams(params),
     };
     const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

package/dist/esm/methods/ESPRMAdminOTAImage/DeletePackage.js

@@ -0,0 +1,23 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ESPRMAdminOTAImage } from '../../ESPRMAdminOTAImage.js';
+import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
+import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
+import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
+import { buildDeleteOTAImageParams } from './deleteParams.js';
+
+ESPRMAdminOTAImage.prototype.deletePackage = async function (params) {
+    if (!params?.ota_image_id) {
+        throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_OTA_IMAGE_ID);
+    }
+    const requestConfig = {
+        url: APIEndpoints.ADMIN_OTA_IMAGE_PACKAGE,
+        method: HTTPMethods.DELETE,
+        params: buildDeleteOTAImageParams(params),
+    };
+    const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
+    return response;
+};

package/dist/esm/methods/ESPRMAdminOTAImage/deleteParams.js

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Builds the query string shared by the image and package delete endpoints.
+ *
+ * `force_delete` is sent only when requested: the backend reads it as a string and
+ * treats any value other than "true" as false, so omitting it keeps the URL clean.
+ */
+function buildDeleteOTAImageParams(params) {
+    return {
+        ota_image_id: params.ota_image_id,
+        ...(params.force_delete ? { force_delete: "true" } : {}),
+    };
+}
+
+export { buildDeleteOTAImageParams };

package/dist/esm/methods/ESPRMAdminOTAJob/ArchiveJob.js

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

package/dist/esm/methods/ESPRMAdminOTAJob/{DeleteJob.js → CancelJob.js}

@@ -8,14 +8,14 @@ import { ESPRMAPIManager } from '../../services/ESPRMAPIManager.js';
 import { APICallValidationErrorCodes, HTTPMethods, APIEndpoints } from '../../utils/constants.js';
 import { ESPAPICallValidationError } from '../../utils/error/ESPAPICallValidationError.js';
 
-ESPRMAdminOTAJob.prototype.deleteJob = async function (otaJobId) {
-    if (!otaJobId) {
+ESPRMAdminOTAJob.prototype.cancelJob = async function (params) {
+    if (!params.ota_job_id) {
         throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_OTA_JOB_ID);
     }
     const requestConfig = {
         url: APIEndpoints.ADMIN_OTA_JOB,
-        method: HTTPMethods.DELETE,
-        params: { ota_job_id: otaJobId },
+        method: HTTPMethods.PUT,
+        data: { ota_job_id: params.ota_job_id },
     };
     const response = await ESPRMAPIManager.authorizeRequest(requestConfig);
     return response;

package/dist/esm/methods/ESPRMAdminOTAJob/RetriggerJob.js

@@ -13,8 +13,8 @@ ESPRMAdminOTAJob.prototype.retriggerJob = async function (params) {
         throw new ESPAPICallValidationError(APICallValidationErrorCodes.MISSING_OTA_JOB_ID);
     }
     const requestConfig = {
-        url: APIEndpoints.ADMIN_OTA_JOB,
-        method: HTTPMethods.PUT,
+        url: APIEndpoints.ADMIN_OTA_JOB_RETRIGGER,
+        method: HTTPMethods.POST,
         data: params,
     };
     const response = await ESPRMAPIManager.authorizeRequest(requestConfig);

package/dist/esm/services/ESPRMAPIManager.js

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

package/dist/esm/utils/constants.js

@@ -27,7 +27,7 @@ const APIEndpoints = {
     ADMIN_OTA_JOB: "admin/otajob",
     ADMIN_OTA_JOB_STATUS: "admin/otajob/status",
     ADMIN_OTA_JOB_STATUS_SUMMARY: "admin/otajob/status/summary",
-    ADMIN_OTA_JOB_ACTION: "admin/otajob",
+    ADMIN_OTA_JOB_RETRIGGER: "admin/otajob/retrigger",
     ADMIN_NODE_GROUP: "admin/node_group",
     ADMIN_TAGS: "admin/tags",
     ADMIN_TAG_NAMES: "admin/tags/names",
@@ -115,6 +115,7 @@ const StorageAdapterErrorCodes = {
 const APICallValidationErrorCodes = {
     MISSING_NODE_ID: "MISSING_NODE_ID",
     MISSING_OTA_IMAGE_ID: "MISSING_OTA_IMAGE_ID",
+    MISSING_ARCHIVE_FLAG: "MISSING_ARCHIVE_FLAG",
     MISSING_OTA_JOB_ID: "MISSING_OTA_JOB_ID",
     MISSING_GROUP_ID: "MISSING_GROUP_ID",
     MISSING_GROUP_NAME: "MISSING_GROUP_NAME",

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

@@ -19,6 +19,7 @@ const storageAdapterErrorMessages = {
 const apiCallValidationErrorMessages = {
     MISSING_NODE_ID: "ESPAPICallValidationError: Node ID is required.",
     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.",
     MISSING_GROUP_ID: "ESPAPICallValidationError: Group ID is required.",
     MISSING_GROUP_NAME: "ESPAPICallValidationError: Group name is required.",

package/dist/types/methods/ESPRMAdminOTAImage/ArchiveImage.d.ts

@@ -8,10 +8,13 @@ import { ESPAPISuccessResponse } from "../../types/api.js";
 declare module "../../ESPRMAdminOTAImage.js" {
     interface ESPRMAdminOTAImage {
         /**
-         * Archives an OTA firmware image by its image ID.
+         * Archives or unarchives an OTA firmware image by its image ID.
          *
-         * @param params - Parameters including the OTA image ID to archive.
-         * @returns A success response confirming the image was archived.
+         * Unlike OTA jobs, image archiving is two-way: pass `archive: false` to restore
+         * an archived image.
+         *
+         * @param params - The OTA image ID and the desired archived state.
+         * @returns A success response confirming the new archived state.
          */
         archiveImage(params: ArchiveOTAImageParams): Promise<ESPAPISuccessResponse>;
     }

package/dist/types/methods/ESPRMAdminOTAImage/DeleteImage.d.ts

@@ -3,15 +3,19 @@
  *
  * SPDX-License-Identifier: Apache-2.0
  */
+import { DeleteOTAImageParams } from "../../types/ota.js";
 import { ESPAPISuccessResponse } from "../../types/api.js";
 declare module "../../ESPRMAdminOTAImage.js" {
     interface ESPRMAdminOTAImage {
         /**
          * Deletes an OTA firmware image by its image ID.
          *
-         * @param otaImageId - The ID of the OTA image to delete.
+         * Images uploaded as part of a package are rejected by this endpoint and must
+         * be removed with {@link ESPRMAdminOTAImage.deletePackage} instead.
+         *
+         * @param params - The OTA image ID, and optionally `force_delete`.
          * @returns A success response confirming the image was deleted.
          */
-        deleteImage(otaImageId: string): Promise<ESPAPISuccessResponse>;
+        deleteImage(params: DeleteOTAImageParams): Promise<ESPAPISuccessResponse>;
     }
 }

package/dist/types/methods/ESPRMAdminOTAImage/DeletePackage.d.ts

@@ -0,0 +1,22 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DeleteOTAImageParams } from "../../types/ota.js";
+import { ESPAPISuccessResponse } from "../../types/api.js";
+declare module "../../ESPRMAdminOTAImage.js" {
+    interface ESPRMAdminOTAImage {
+        /**
+         * Deletes an OTA image that was uploaded as part of a package, removing both the
+         * image and the package archive it came from.
+         *
+         * Images uploaded as a standalone binary should use
+         * {@link ESPRMAdminOTAImage.deleteImage} instead.
+         *
+         * @param params - The OTA image ID, and optionally `force_delete`.
+         * @returns A success response confirming the package was deleted.
+         */
+        deletePackage(params: DeleteOTAImageParams): Promise<ESPAPISuccessResponse>;
+    }
+}