@espressif/rainmaker-admin-sdk 1.0.0

package/dist/cjs/services/ESPRMStorage/ESPRMStorage.cjs

@@ -0,0 +1,55 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var constants = require('../../utils/constants.cjs');
+var ESPConfigError = require('../../utils/error/ESPConfigError.cjs');
+var ESPStorageAdapterError = require('../../utils/error/ESPStorageAdapterError.cjs');
+var DefaultStorageAdapter = require('./DefaultStorageAdapter.cjs');
+
+/**
+ * Static facade over the configured storage adapter. All operations return the
+ * adapter's promise so callers can await persistence (important for custom
+ * asynchronous adapters such as IndexedDB or React Native AsyncStorage).
+ */
+class ESPRMStorage {
+    static #instance;
+    #storageAdapter;
+    constructor(customStorageAdapter) {
+        if (customStorageAdapter) {
+            this.#storageAdapter = customStorageAdapter;
+            return;
+        }
+        if (typeof window === "undefined" ||
+            typeof window.localStorage === "undefined") {
+            throw new ESPStorageAdapterError.ESPStorageAdapterError(constants.StorageAdapterErrorCodes.UNSUPPORTED_DEFAULT_STORAGE_ADAPTER_API);
+        }
+        this.#storageAdapter = new DefaultStorageAdapter.DefaultStorageAdapter();
+    }
+    static initialize(customStorageAdapter) {
+        ESPRMStorage.#instance = new ESPRMStorage(customStorageAdapter);
+    }
+    static #getInstance() {
+        if (!ESPRMStorage.#instance) {
+            throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.SDK_NOT_CONFIGURED);
+        }
+        return ESPRMStorage.#instance;
+    }
+    static async setItem(name, value) {
+        return ESPRMStorage.#getInstance().#storageAdapter.setItem(name, value);
+    }
+    static async getItem(name) {
+        return ESPRMStorage.#getInstance().#storageAdapter.getItem(name);
+    }
+    static async removeItem(name) {
+        return ESPRMStorage.#getInstance().#storageAdapter.removeItem(name);
+    }
+    static async clear() {
+        return ESPRMStorage.#getInstance().#storageAdapter.clear();
+    }
+}
+
+exports.ESPRMStorage = ESPRMStorage;

package/dist/cjs/types/common.cjs

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+/** Mode for property checking. */
+exports.PropertyCheckMode = void 0;
+(function (PropertyCheckMode) {
+    PropertyCheckMode["OwnPropertyOnly"] = "OwnPropertyOnly";
+    PropertyCheckMode["PrototypeChain"] = "PrototypeChain";
+})(exports.PropertyCheckMode || (exports.PropertyCheckMode = {}));

package/dist/cjs/utils/constants.cjs

@@ -0,0 +1,197 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+const HTTPMethods = {
+    GET: "GET",
+    PUT: "PUT",
+    POST: "POST",
+    DELETE: "DELETE",
+};
+const APIEndpoints = {
+    USER: "user2",
+    FORGOTPASSWORD: "forgotpassword2",
+    LOGIN: "login2",
+    PASSWORD: "password2",
+    LOGOUT: "logout2",
+    ADMIN_USER: "admin/user2",
+    ADMIN_USER_SUMMARY: "admin/user2/summary",
+    ADMIN_NODES: "admin/nodes",
+    ADMIN_NODE_TAGS: "admin/nodes/tags",
+    ADMIN_OTA_IMAGE: "admin/otaimage",
+    ADMIN_OTA_IMAGE_UPLOAD_REQUEST: "admin/otaimage/upload_request",
+    ADMIN_OTA_IMAGE_UPLOAD_CONFIRM: "admin/otaimage/upload_confirm",
+    ADMIN_OTA_IMAGE_PACKAGE_UPLOAD: "admin/otaimage/package/upload",
+    ADMIN_OTA_IMAGE_PACKAGE: "admin/otaimage/package",
+    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_NODE_GROUP: "admin/node_group",
+    ADMIN_TAGS: "admin/tags",
+    ADMIN_TAG_NAMES: "admin/tags/names",
+    ADMIN_CMD: "admin/nodes/cmd",
+    ADMIN_EVENT_FILTER: "admin/event_filter",
+    ADMIN_TSDATA: "admin/nodes/tsdata",
+    ADMIN_SIMPLE_TSDATA: "admin/nodes/simple_tsdata",
+    ADMIN_CUSTOM_DATA: "admin/custom_data",
+    ADMIN_ROLE: "admin/role",
+    ADMIN_POLICY: "admin/policy",
+    ADMIN_USER_ROLE: "admin/user_role",
+    ADMIN_KEY: "admin/key",
+    ADMIN_SECURE_SIGN: "admin/secure_sign",
+    ADMIN_SECURE_SIGN_IMAGES: "admin/secure_sign/signed_images",
+    ADMIN_SECURE_SIGN_KEYS: "admin/secure_sign/signing_keys",
+    ADMIN_FILE: "admin/file",
+    ADMIN_FILE_UPLOAD_REQUEST: "admin/file/upload_request",
+    ADMIN_FILE_UPLOAD_CONFIRM: "admin/file/upload_confirm",
+    ADMIN_USER_NODES: "admin/user/nodes",
+    ADMIN_USER_NODES_HISTORY: "admin/user/nodes/history",
+    ADMIN_API_PATHS: "admin/api_paths_methods",
+    ADMIN_COGNITO_APPCLIENT: "admin/cognito_appclient",
+    ADMIN_COGNITO_DOMAIN: "admin/cognito_domain",
+    ADMIN_IDENTITY_PROVIDER: "admin/identity_provider",
+    ADMIN_MESSAGE_TEMPLATE: "admin/message_template",
+    ADMIN_SES_VERIFIED_EMAIL: "admin/ses_verified_email",
+    ADMIN_DASHBOARD_UPDATE: "admin/dashboard/update",
+    ADMIN_DASHBOARD_VERSION_MAPPING: "admin/dashboard/update/version_mapping",
+    ADMIN_UPDATE_APIGATEWAY: "admin/update_apigateway",
+    ADMIN_TERMS_POLICY: "admin/terms_policy",
+    ADMIN_CLOUDWATCH_LOG: "admin/cloudwatchlog",
+    ADMIN_LOGS: "admin/logs",
+    ADMIN_DEPLOYMENT_CAPABILITIES: "admin/deployment_capabilities",
+    ADMIN_LICENSE_FILE: "admin/license_file",
+    ADMIN_LICENSE_QUOTA: "admin/license_quota",
+    ADMIN_MQTT_HOST: "admin/mqtt_host",
+    ADMIN_CUSTOM_MQTT_HOST: "admin/custom_mqtt_host",
+    ADMIN_NODE_IDS: "admin/node_ids",
+    ADMIN_NODE_CERTIFICATES: "admin/node_certificates",
+    ADMIN_NODE_CERTIFICATES_REGISTER: "admin/node_certificates/register",
+    ADMIN_API_STATS: "admin/api_stats",
+    ADMIN_MQTT_STATS: "admin/mqtt_stats",
+    ADMIN_CHANGE_SUPER_ADMIN: "admin/change_super_admin",
+    ADMIN_CHANGE_SENDER_EMAIL: "admin/change_sender_email",
+    ADMIN_NODE_PARAMS: "admin/user/nodes/params",
+    ADMIN_COMMON_CUSTOM_DATA: "admin/common_custom_data",
+    ADMIN_DEPLOYMENT_DETAILS: "admin/rainmaker_deployment_details",
+    ADMIN_DEPLOYMENT_SETTINGS: "admin/deployment_settings",
+    ADMIN_DEPLOYMENT_SETTINGS_CONFIG: "admin/deployment_settings/config",
+    ADMIN_NOTIFICATIONS: "admin/notifications",
+    ADMIN_IOT_DEVICE_RATE_RULE: "admin/iot_device_rate_rule",
+    ADMIN_PUSH_NOTIFICATION_TEMPLATE: "admin/push_notification/custom_message_template",
+    ADMIN_MOBILE_PLATFORM: "admin/push_notification/mobile_platform",
+    ADMIN_PUBLISH_MESSAGE: "admin/push_notification/publish_message",
+    ADMIN_PASSTHROUGH_CONFIG: "admin/passthrough/config",
+    ADMIN_NODE_CA_CERTIFICATE: "admin/node_ca_certificate",
+    ADMIN_WEBHOOK_INTEGRATION: "admin/webhook_integration",
+    ADMIN_WEBHOOK_EVENT_MAPPING: "admin/webhook_event_mapping",
+    ADMIN_STATS_INFO: "admin/stats_info",
+    ADMIN_STATS_INIT: "admin/stats_init",
+    ADMIN_API_RATE_LIMIT: "admin/api_rate_limit",
+    ADMIN_MATTER_AUTH: "admin/matter/auth",
+    ADMIN_MATTER_BATCH: "admin/matter/batch",
+    ADMIN_MATTER_BATCH_NODES: "admin/matter/batch/nodes",
+    ADMIN_MAIL_FAILURES: "admin/mail_failures",
+};
+const StorageKeys = {
+    ACCESSTOKEN: "com.esprmbase.accessToken",
+    IDTOKEN: "com.esprmbase.idToken",
+    REFRESHTOKEN: "com.esprmbase.refreshToken",
+};
+const ConfigErrorCodes = {
+    SDK_NOT_CONFIGURED: "SDK_NOT_CONFIGURED",
+    INVALID_CONFIG_OBJECT: "INVALID_CONFIG_OBJECT",
+    INVALID_BASE_URL: "INVALID_BASE_URL",
+};
+const ValidationErrorCodes = {
+    MISSING_LOGIN_PASSWORD: "MISSING_LOGIN_PASSWORD",
+    MISSING_USERNAME: "MISSING_USERNAME",
+    MISSING_VERIFICATION_CODE: "MISSING_VERIFICATION_CODE",
+};
+const StorageAdapterErrorCodes = {
+    UNSUPPORTED_DEFAULT_STORAGE_ADAPTER_API: "UNSUPPORTED_DEFAULT_STORAGE_ADAPTER_API",
+};
+const APICallValidationErrorCodes = {
+    MISSING_NODE_ID: "MISSING_NODE_ID",
+    MISSING_OTA_IMAGE_ID: "MISSING_OTA_IMAGE_ID",
+    MISSING_OTA_JOB_ID: "MISSING_OTA_JOB_ID",
+    MISSING_GROUP_ID: "MISSING_GROUP_ID",
+    MISSING_GROUP_NAME: "MISSING_GROUP_NAME",
+    MISSING_USER_NAME: "MISSING_USER_NAME",
+    MISSING_RESOURCE_TYPE: "MISSING_RESOURCE_TYPE",
+    MISSING_RESOURCE_ID: "MISSING_RESOURCE_ID",
+    MISSING_EVENT_TYPE: "MISSING_EVENT_TYPE",
+    MISSING_ENTITY_ID: "MISSING_ENTITY_ID",
+    MISSING_ENTITY_TYPE: "MISSING_ENTITY_TYPE",
+    MISSING_ROLE_NAME: "MISSING_ROLE_NAME",
+    MISSING_POLICY_NAME: "MISSING_POLICY_NAME",
+    MISSING_KEY_NAME: "MISSING_KEY_NAME",
+    MISSING_FILE_NAME: "MISSING_FILE_NAME",
+    MISSING_FILE_ID: "MISSING_FILE_ID",
+    MISSING_REQUEST_ID: "MISSING_REQUEST_ID",
+    MISSING_CLIENT_ID: "MISSING_CLIENT_ID",
+    MISSING_CLIENT_NAME: "MISSING_CLIENT_NAME",
+    MISSING_DOMAIN_PREFIX: "MISSING_DOMAIN_PREFIX",
+    MISSING_PROVIDER_NAME: "MISSING_PROVIDER_NAME",
+    MISSING_PROVIDER_TYPE: "MISSING_PROVIDER_TYPE",
+    MISSING_TEMPLATE_ID: "MISSING_TEMPLATE_ID",
+    MISSING_SERVICE_NAME: "MISSING_SERVICE_NAME",
+    MISSING_SERVICE_ID: "MISSING_SERVICE_ID",
+    MISSING_SERVICE: "MISSING_SERVICE",
+    MISSING_ENDPOINT_NAME: "MISSING_ENDPOINT_NAME",
+    MISSING_WEBHOOK_NAME: "MISSING_WEBHOOK_NAME",
+    MISSING_EVENT_NAME: "MISSING_EVENT_NAME",
+    MISSING_NEW_SUPER_ADMIN_EMAIL: "MISSING_NEW_SUPER_ADMIN_EMAIL",
+    MISSING_SENDER_EMAIL: "MISSING_SENDER_EMAIL",
+    MISSING_PLATFORM_NAME: "MISSING_PLATFORM_NAME",
+    MISSING_PLATFORM_APPLICATION_ARN: "MISSING_PLATFORM_APPLICATION_ARN",
+    MISSING_BATCH_ID: "MISSING_BATCH_ID",
+};
+const TokenErrorCodes = {
+    MISSING_ACCESS_TOKEN: "MISSING_ACCESS_TOKEN",
+    MISSING_REFRESH_TOKEN: "MISSING_REFRESH_TOKEN",
+    EXTEND_SESSION_FAILED: "EXTEND_SESSION_FAILED",
+    MALFORMED_TOKEN: "MALFORMED_TOKEN",
+};
+const ErrorLabels = {
+    ESPAPICallValidationError: "ESPAPICallValidationError",
+    ESPConfigError: "ESPConfigError",
+    ESPTokenError: "ESPTokenError",
+    ESPStorageAdapterError: "ESPStorageAdapterError",
+    ESPValidationError: "ESPValidationError",
+};
+const HTTPStatusCodes = {
+    UNAUTHORIZED: 401,
+};
+const AdditionalInfo = {
+    AUTHENTICATION_REQUIRED: "Please login again or re-authenticate",
+};
+const DEFAULT_REST_API_VERSION = "v1";
+/** Default per-request timeout (ms). Override via ESPRMBaseConfig.timeoutMs. */
+const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
+/** Tokens expiring within this many seconds are refreshed proactively. */
+const TOKEN_EXPIRY_MARGIN_SECONDS = 30;
+/** errorCode values the SDK itself sets on ESPAPIError for non-HTTP failures. */
+const APIErrorCodes = {
+    REQUEST_TIMEOUT: "REQUEST_TIMEOUT",
+    NETWORK_ERROR: "NETWORK_ERROR",
+};
+
+exports.APICallValidationErrorCodes = APICallValidationErrorCodes;
+exports.APIEndpoints = APIEndpoints;
+exports.APIErrorCodes = APIErrorCodes;
+exports.AdditionalInfo = AdditionalInfo;
+exports.ConfigErrorCodes = ConfigErrorCodes;
+exports.DEFAULT_REQUEST_TIMEOUT_MS = DEFAULT_REQUEST_TIMEOUT_MS;
+exports.DEFAULT_REST_API_VERSION = DEFAULT_REST_API_VERSION;
+exports.ErrorLabels = ErrorLabels;
+exports.HTTPMethods = HTTPMethods;
+exports.HTTPStatusCodes = HTTPStatusCodes;
+exports.StorageAdapterErrorCodes = StorageAdapterErrorCodes;
+exports.StorageKeys = StorageKeys;
+exports.TOKEN_EXPIRY_MARGIN_SECONDS = TOKEN_EXPIRY_MARGIN_SECONDS;
+exports.TokenErrorCodes = TokenErrorCodes;
+exports.ValidationErrorCodes = ValidationErrorCodes;

package/dist/cjs/utils/error/ESPAPICallValidationError.cjs

@@ -0,0 +1,18 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var errorMessages = require('./errorMessages.cjs');
+var ESPBaseError = require('./ESPBaseError.cjs');
+var constants = require('../constants.cjs');
+
+class ESPAPICallValidationError extends ESPBaseError.ESPBaseError {
+    constructor(code) {
+        super(constants.ErrorLabels.ESPAPICallValidationError, code, errorMessages.apiCallValidationErrorMessages);
+    }
+}
+
+exports.ESPAPICallValidationError = ESPAPICallValidationError;

package/dist/cjs/utils/error/ESPBaseError.cjs

@@ -0,0 +1,21 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var errorMessages = require('./errorMessages.cjs');
+
+class ESPBaseError extends Error {
+    code;
+    label;
+    constructor(label, code, errorMessages$1, defaultMessage = errorMessages.defaultErrorMessages.UNKNOWN_ERROR) {
+        const message = errorMessages$1[code] || defaultMessage;
+        super(message);
+        this.label = label;
+        this.code = code;
+    }
+}
+
+exports.ESPBaseError = ESPBaseError;

package/dist/cjs/utils/error/ESPConfigError.cjs

@@ -0,0 +1,18 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var constants = require('../constants.cjs');
+var errorMessages = require('./errorMessages.cjs');
+var ESPBaseError = require('./ESPBaseError.cjs');
+
+class ESPConfigError extends ESPBaseError.ESPBaseError {
+    constructor(code) {
+        super(constants.ErrorLabels.ESPConfigError, code, errorMessages.configErrorMessages, errorMessages.defaultErrorMessages.CONFIGURATION_ERROR);
+    }
+}
+
+exports.ESPConfigError = ESPConfigError;

package/dist/cjs/utils/error/ESPStorageAdapterError.cjs

@@ -0,0 +1,18 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var constants = require('../constants.cjs');
+var errorMessages = require('./errorMessages.cjs');
+var ESPBaseError = require('./ESPBaseError.cjs');
+
+class ESPStorageAdapterError extends ESPBaseError.ESPBaseError {
+    constructor(code) {
+        super(constants.ErrorLabels.ESPStorageAdapterError, code, errorMessages.storageAdapterErrorMessages);
+    }
+}
+
+exports.ESPStorageAdapterError = ESPStorageAdapterError;

package/dist/cjs/utils/error/ESPTokenError.cjs

@@ -0,0 +1,18 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var constants = require('../constants.cjs');
+var errorMessages = require('./errorMessages.cjs');
+var ESPBaseError = require('./ESPBaseError.cjs');
+
+class ESPTokenError extends ESPBaseError.ESPBaseError {
+    constructor(code) {
+        super(constants.ErrorLabels.ESPTokenError, code, errorMessages.tokenErrorMessages);
+    }
+}
+
+exports.ESPTokenError = ESPTokenError;

package/dist/cjs/utils/error/ESPValidationError.cjs

@@ -0,0 +1,18 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var constants = require('../constants.cjs');
+var errorMessages = require('./errorMessages.cjs');
+var ESPBaseError = require('./ESPBaseError.cjs');
+
+class ESPValidationError extends ESPBaseError.ESPBaseError {
+    constructor(code) {
+        super(constants.ErrorLabels.ESPValidationError, code, errorMessages.validationErrorMessages);
+    }
+}
+
+exports.ESPValidationError = ESPValidationError;

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

@@ -0,0 +1,73 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+const configErrorMessages = {
+    SDK_NOT_CONFIGURED: "ESPRMBase is not configured yet",
+    INVALID_CONFIG_OBJECT: "Configuration Error: Config must be a non-null object.",
+    INVALID_BASE_URL: "Configuration Error: BaseUrl must be a non-empty valid URL string.",
+};
+const validationErrorMessages = {
+    MISSING_LOGIN_PASSWORD: "Validation Error: Password is required.",
+    MISSING_USERNAME: "Validation Error: Username is required.",
+    MISSING_VERIFICATION_CODE: "Validation Error: Verification code is required.",
+};
+const storageAdapterErrorMessages = {
+    UNSUPPORTED_DEFAULT_STORAGE_ADAPTER_API: "ESPStorageAdapterError: It seems like your environment doesn't support window.localstorage, you can define your own storage adapter while configuring the ESPRMBase instance. Please refer docs for more information.",
+};
+const apiCallValidationErrorMessages = {
+    MISSING_NODE_ID: "ESPAPICallValidationError: Node ID is required.",
+    MISSING_OTA_IMAGE_ID: "ESPAPICallValidationError: OTA image ID is required.",
+    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.",
+    MISSING_USER_NAME: "ESPAPICallValidationError: User name is required.",
+    MISSING_RESOURCE_TYPE: "ESPAPICallValidationError: Resource type is required.",
+    MISSING_RESOURCE_ID: "ESPAPICallValidationError: Resource ID is required.",
+    MISSING_EVENT_TYPE: "ESPAPICallValidationError: Event type is required.",
+    MISSING_ENTITY_ID: "ESPAPICallValidationError: Entity ID is required.",
+    MISSING_ENTITY_TYPE: "ESPAPICallValidationError: Entity type is required.",
+    MISSING_ROLE_NAME: "ESPAPICallValidationError: Role name is required.",
+    MISSING_POLICY_NAME: "ESPAPICallValidationError: Policy name is required.",
+    MISSING_KEY_NAME: "ESPAPICallValidationError: Key name is required.",
+    MISSING_FILE_NAME: "ESPAPICallValidationError: File name is required.",
+    MISSING_FILE_ID: "ESPAPICallValidationError: File ID is required.",
+    MISSING_REQUEST_ID: "ESPAPICallValidationError: Request ID is required.",
+    MISSING_CLIENT_ID: "ESPAPICallValidationError: Client ID is required.",
+    MISSING_CLIENT_NAME: "ESPAPICallValidationError: Client name is required.",
+    MISSING_DOMAIN_PREFIX: "ESPAPICallValidationError: Domain name is required.",
+    MISSING_PROVIDER_NAME: "ESPAPICallValidationError: Provider name is required.",
+    MISSING_PROVIDER_TYPE: "ESPAPICallValidationError: Provider type is required.",
+    MISSING_TEMPLATE_ID: "ESPAPICallValidationError: Template ID is required.",
+    MISSING_SERVICE_NAME: "ESPAPICallValidationError: Service name is required.",
+    MISSING_SERVICE_ID: "ESPAPICallValidationError: Service ID is required.",
+    MISSING_SERVICE: "ESPAPICallValidationError: Service is required.",
+    MISSING_ENDPOINT_NAME: "ESPAPICallValidationError: Endpoint name is required.",
+    MISSING_WEBHOOK_NAME: "ESPAPICallValidationError: Webhook name is required.",
+    MISSING_EVENT_NAME: "ESPAPICallValidationError: Event name is required.",
+    MISSING_NEW_SUPER_ADMIN_EMAIL: "ESPAPICallValidationError: New super admin email is required.",
+    MISSING_SENDER_EMAIL: "ESPAPICallValidationError: Sender email is required.",
+    MISSING_PLATFORM_NAME: "ESPAPICallValidationError: Platform name is required.",
+    MISSING_PLATFORM_APPLICATION_ARN: "ESPAPICallValidationError: Platform application ARN is required.",
+    MISSING_BATCH_ID: "ESPAPICallValidationError: Batch ID is required.",
+};
+const tokenErrorMessages = {
+    MISSING_ACCESS_TOKEN: "ESPTokenError: Access token is missing. User needs to authenticate.",
+    MISSING_REFRESH_TOKEN: "ESPTokenError: Refresh token is missing. Cannot renew access token.",
+    EXTEND_SESSION_FAILED: "ESPTokenError: Unable to extend session",
+    MALFORMED_TOKEN: "ESPTokenError: Token is malformed or could not be decoded.",
+};
+const defaultErrorMessages = {
+    UNKNOWN_ERROR: "An unknown error occurred.",
+    CONFIGURATION_ERROR: "An unknown error occurred while configuring.",
+};
+
+exports.apiCallValidationErrorMessages = apiCallValidationErrorMessages;
+exports.configErrorMessages = configErrorMessages;
+exports.defaultErrorMessages = defaultErrorMessages;
+exports.storageAdapterErrorMessages = storageAdapterErrorMessages;
+exports.tokenErrorMessages = tokenErrorMessages;
+exports.validationErrorMessages = validationErrorMessages;

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

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+const parseAPIErrorResponse = (error, statusCode) => {
+    let status = "";
+    let errorCode = "";
+    let description = "An error has occurred";
+    if (error) {
+        status = error.status ?? "";
+        errorCode = error.error_code ?? "";
+        description = error.description ?? "An error has occurred";
+    }
+    else {
+        throw error;
+    }
+    return {
+        status,
+        statusCode,
+        errorCode,
+        description,
+    };
+};
+
+exports.parseAPIErrorResponse = parseAPIErrorResponse;

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

@@ -0,0 +1,29 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+var validators = require('./validators.cjs');
+var ESPConfigError = require('../error/ESPConfigError.cjs');
+var constants = require('../constants.cjs');
+
+class ConfigValidator {
+    static validateConfig(config) {
+        ConfigValidator.validateConfigObject(config);
+        ConfigValidator.validateBaseUrl(config.baseUrl);
+    }
+    static validateConfigObject(config) {
+        if (!validators.isValidObject(config)) {
+            throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.INVALID_CONFIG_OBJECT);
+        }
+    }
+    static validateBaseUrl(baseUrl) {
+        if (!validators.isNonEmptyString(baseUrl) || !validators.isValidUrl(baseUrl)) {
+            throw new ESPConfigError.ESPConfigError(constants.ConfigErrorCodes.INVALID_BASE_URL);
+        }
+    }
+}
+
+exports.ConfigValidator = ConfigValidator;

package/dist/cjs/utils/validator/validators.cjs

@@ -0,0 +1,26 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+'use strict';
+
+const isValidUrl = (url) => {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch (_) {
+        return false;
+    }
+};
+const isNonEmptyString = (value) => {
+    return typeof value === "string" && value.trim() !== "";
+};
+const isValidObject = (obj) => {
+    return typeof obj === "object" && obj !== null && !Array.isArray(obj);
+};
+
+exports.isNonEmptyString = isNonEmptyString;
+exports.isValidObject = isValidObject;
+exports.isValidUrl = isValidUrl;

package/dist/esm/ESPRMAdminAPIGateway.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin API gateway operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminAPIGateway/*.
+ */
+class ESPRMAdminAPIGateway {
+}
+
+export { ESPRMAdminAPIGateway };

package/dist/esm/ESPRMAdminAPIInfo.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin API info operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminAPIInfo/*.
+ */
+class ESPRMAdminAPIInfo {
+}
+
+export { ESPRMAdminAPIInfo };

package/dist/esm/ESPRMAdminAPIRateLimit.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin API rate limit configuration operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminAPIRateLimit/*.
+ */
+class ESPRMAdminAPIRateLimit {
+}
+
+export { ESPRMAdminAPIRateLimit };

package/dist/esm/ESPRMAdminAPIStatistics.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin API statistics operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminAPIStatistics/*.
+ */
+class ESPRMAdminAPIStatistics {
+}
+
+export { ESPRMAdminAPIStatistics };

package/dist/esm/ESPRMAdminCloudwatchLog.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin cloudwatch log IAM user operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminCloudwatchLog/*.
+ */
+class ESPRMAdminCloudwatchLog {
+}
+
+export { ESPRMAdminCloudwatchLog };

package/dist/esm/ESPRMAdminCognitoAppClient.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin Cognito app client operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminCognitoAppClient/*.
+ */
+class ESPRMAdminCognitoAppClient {
+}
+
+export { ESPRMAdminCognitoAppClient };

package/dist/esm/ESPRMAdminCognitoDomain.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin Cognito domain operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminCognitoDomain/*.
+ */
+class ESPRMAdminCognitoDomain {
+}
+
+export { ESPRMAdminCognitoDomain };

package/dist/esm/ESPRMAdminCommonCustomData.js

@@ -0,0 +1,13 @@
+/*
+ * SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Shell class for admin common custom data operations.
+ * Methods are added via prototype augmentation in methods/ESPRMAdminCommonCustomData/*.
+ */
+class ESPRMAdminCommonCustomData {
+}
+
+export { ESPRMAdminCommonCustomData };