@espressif/rainmaker-admin-sdk 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -3,7 +3,29 @@
 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
 

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/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/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-cjs/types/time_series.d.cts

@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@espressif/rainmaker-admin-sdk",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "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",