myio-js-library 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MyIO
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,328 @@
+# myio-js-library
+
+A clean, standalone JavaScript SDK for **MYIO** projects.  
+Works in **Node.js (>=18)** and modern browsers.  
+Distributed as **ESM**, **CJS**, and **UMD** (with a pre-minified build for CDN usage).
+
+---
+
+## 🚀 Features
+
+- 🔑 **Core codecs** — e.g., `decodePayloadBase64Xor`.
+- 🌐 **HTTP wrapper** — with retries, timeout, and backoff.
+- 🏷️ **Namespace utilities** — add prefixes/suffixes to object keys.
+- 📱 **Device detection** — context-aware device type identification.
+- 🧩 **String utilities** — normalization helpers.
+- 🔢 **Number utilities** — safe fixed formatting, percentages.
+- ⚡ **Dual module support** — ESM and CJS.
+- 🌍 **Browser-ready** — UMD global + CDN link.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install myio-js-library
+# or
+yarn add myio-js-library
+# or
+pnpm add myio-js-library
+```
+
+## 🛠 Usage
+
+### Node.js (ESM)
+```javascript
+import { 
+  decodePayload, 
+  fetchWithRetry, 
+  addNamespace, 
+  detectDeviceType,
+  strings, 
+  numbers 
+} from 'myio-js-library';
+
+// Decode with string key
+const text = decodePayload('AwAVBwo=', 'key'); // "hello"
+console.log(text);
+
+// HTTP request with retries
+const response = await fetchWithRetry('https://api.example.com/data', {
+  retries: 3,
+  timeout: 5000
+});
+
+// Add namespace to object keys
+const data = { temperature: 25, humidity: 60 };
+const namespaced = addNamespace(data, 'sensor1'); 
+// { "temperature (sensor1)": 25, "humidity (sensor1)": 60 }
+
+// Detect device type from context
+const deviceType = detectDeviceType('building', 'floor2-room101');
+console.log(deviceType); // "room" or "unknown"
+```
+
+### Node.js (CJS)
+```javascript
+const { 
+  decodePayload, 
+  fetchWithRetry, 
+  addNamespace, 
+  detectDeviceType,
+  strings, 
+  numbers 
+} = require('myio-js-library');
+```
+
+### Browser (CDN/UMD)
+```html
+<script src="https://unpkg.com/myio-js-library@0.1.0/dist/myio-js-library.umd.min.js"></script>
+<script>
+  // Decode payload
+  const text = MyIOJSLibrary.decodePayload('AwAVBwo=', 'key');
+  console.log(text); // "hello"
+  
+  // Add namespace to data
+  const data = { temperature: 25, humidity: 60 };
+  const namespaced = MyIOJSLibrary.addNamespace(data, 'sensor1');
+  console.log(namespaced); // { "temperature (sensor1)": 25, "humidity (sensor1)": 60 }
+  
+  // Detect device type
+  const deviceType = MyIOJSLibrary.detectDeviceType('building', 'floor2-room101');
+  console.log(deviceType); // "room"
+</script>
+```
+
+## 📚 API
+
+### Codec Functions
+
+#### `decodePayload(encoded: string, key: string | number | null | undefined): string`
+
+Advanced base64 XOR decoder with flexible key support:
+- **String key**: Repeats the key over the bytes (e.g., "abc" -> "abcabcabc...")
+- **Number key**: Applies single byte (0-255) to all bytes
+- **Empty/null/undefined key**: No XOR applied (plain base64 decode)
+
+```javascript
+import { decodePayload } from 'myio-js-library';
+
+// String key (repeating)
+const result1 = decodePayload('AwAVBwo=', 'key'); // "hello"
+
+// Number key (single byte)
+const result2 = decodePayload('SGVsbG8=', 73); // XOR with 73
+
+// No key (plain decode)
+const result3 = decodePayload('aGVsbG8=', ''); // "hello"
+```
+
+#### `decodePayloadBase64Xor(encoded: string, xorKey?: number): string`
+
+Legacy compatibility function for single-byte XOR (defaults to 73).
+
+```javascript
+import { decodePayloadBase64Xor } from 'myio-js-library';
+
+const result = decodePayloadBase64Xor('SGVsbG8=', 73);
+```
+
+### HTTP Functions
+
+#### `fetchWithRetry(url: string, options?: object): Promise<Response>`
+
+Enhanced fetch wrapper with retry logic, timeout, and exponential backoff.
+
+**Options:**
+- `retries?: number` - Number of retry attempts (default: 0)
+- `retryDelay?: number` - Base delay between retries in ms (default: 100)
+- `timeout?: number` - Request timeout in ms (default: 10000)
+- `retryCondition?: (error, response) => boolean` - Custom retry logic
+- All standard `fetch` options (method, headers, body, signal, etc.)
+
+```javascript
+import { fetchWithRetry } from 'myio-js-library';
+
+const response = await fetchWithRetry('https://api.example.com/data', {
+  retries: 3,
+  retryDelay: 200,
+  timeout: 5000,
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ data: 'example' })
+});
+```
+
+#### `http(url: string, options?: object): Promise<Response>`
+
+Alias for `fetchWithRetry`.
+
+### Namespace Utilities
+
+#### `addNamespace(payload: object, namespace?: string): object`
+
+Adds a namespace suffix to all keys in an object. Useful for prefixing data from different sources or sensors.
+
+**Parameters:**
+- `payload: object` - The object whose keys will be namespaced (must be a plain object, not array)
+- `namespace?: string` - The namespace to append (optional, defaults to empty string)
+
+**Returns:** New object with namespaced keys in format `"originalKey (namespace)"`
+
+**Throws:** Error if payload is not a plain object
+
+```javascript
+import { addNamespace } from 'myio-js-library';
+
+// Basic usage
+const data = { temperature: 25, humidity: 60 };
+const result = addNamespace(data, 'sensor1');
+// { "temperature (sensor1)": 25, "humidity (sensor1)": 60 }
+
+// Empty namespace (no suffix added)
+const result2 = addNamespace(data, '');
+// { "temperature": 25, "humidity": 60 }
+
+// Whitespace handling
+const result3 = addNamespace(data, '  room-101  ');
+// { "temperature (room-101)": 25, "humidity (room-101)": 60 }
+```
+
+### Device Detection Utilities
+
+#### `detectDeviceType(context: string, deviceId: string): string`
+
+Detects device type based on context and device ID patterns. Uses built-in detection contexts for common environments.
+
+**Parameters:**
+- `context: string` - The context environment ('building', 'mall', etc.)
+- `deviceId: string` - The device identifier to analyze
+
+**Returns:** Detected device type or 'unknown' if no pattern matches
+
+**Built-in contexts:**
+- **building**: Detects rooms, floors, elevators, stairs, parking, entrance, exit
+- **mall**: Detects stores, corridors, escalators, elevators, parking, entrance, exit, food court, restrooms
+
+```javascript
+import { detectDeviceType } from 'myio-js-library';
+
+// Building context
+detectDeviceType('building', 'floor2-room101'); // "room"
+detectDeviceType('building', 'elevator-A'); // "elevator"
+detectDeviceType('building', 'parking-level1'); // "parking"
+
+// Mall context  
+detectDeviceType('mall', 'store-nike-001'); // "store"
+detectDeviceType('mall', 'corridor-main'); // "corridor"
+detectDeviceType('mall', 'food-court-area'); // "food_court"
+
+// Unknown patterns
+detectDeviceType('building', 'unknown-device'); // "unknown"
+```
+
+#### `getAvailableContexts(): string[]`
+
+Returns list of all available detection contexts.
+
+```javascript
+import { getAvailableContexts } from 'myio-js-library';
+
+const contexts = getAvailableContexts();
+// ['building', 'mall']
+```
+
+#### `addDetectionContext(contextName: string, patterns: object): void`
+
+Adds a new detection context with custom patterns.
+
+**Parameters:**
+- `contextName: string` - Name of the new context
+- `patterns: object` - Object mapping device types to regex patterns
+
+```javascript
+import { addDetectionContext, detectDeviceType } from 'myio-js-library';
+
+// Add custom hospital context
+addDetectionContext('hospital', {
+  room: /^(room|ward|chamber)-/i,
+  operating_room: /^(or|surgery|operating)-/i,
+  emergency: /^(er|emergency|trauma)-/i
+});
+
+// Use the new context
+detectDeviceType('hospital', 'room-icu-101'); // "room"
+detectDeviceType('hospital', 'or-surgery-3'); // "operating_room"
+```
+
+### String Utilities
+
+#### `strings.normalizeRecipients(val: unknown): string`
+
+Normalizes various list formats into a comma-separated string.
+
+**Supported inputs:**
+- Arrays: `['a', 'b', 'c']` → `"a,b,c"`
+- JSON strings: `'["a", "b", "c"]'` → `"a,b,c"`
+- Delimited strings: `"a; b, c"` → `"a,b,c"`
+
+```javascript
+import { strings } from 'myio-js-library';
+
+strings.normalizeRecipients(['user1', 'user2']); // "user1,user2"
+strings.normalizeRecipients('["a", "b"]'); // "a,b"
+strings.normalizeRecipients('a; b, c'); // "a,b,c"
+```
+
+### Number Utilities
+
+#### `numbers.fmtPerc(x: number, digits?: number): string`
+
+Formats a ratio (0-1) as a percentage string.
+
+```javascript
+import { numbers } from 'myio-js-library';
+
+numbers.fmtPerc(0.1234); // "12.34%"
+numbers.fmtPerc(0.1234, 1); // "12.3%"
+numbers.fmtPerc(NaN); // "—"
+```
+
+#### `numbers.toFixedSafe(x: number, digits?: number): string`
+
+Safely formats a number to fixed decimals (returns "—" for invalid numbers).
+
+```javascript
+import { numbers } from 'myio-js-library';
+
+numbers.toFixedSafe(3.14159, 2); // "3.14"
+numbers.toFixedSafe(NaN); // "—"
+numbers.toFixedSafe(Infinity); // "—"
+```
+
+## 🧪 Development
+
+```bash
+# install dependencies
+npm install
+
+# run tests
+npm test
+
+# build (esm+cjs+umd+min)
+npm run build
+```
+
+## 🔄 Versioning
+
+Uses [SemVer](https://semver.org/).
+
+Managed via [Changesets](https://github.com/changesets/changesets) for changelogs & automated npm publishing.
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## 📜 License
+
+MIT © 2025 MYIO

package/dist/index.cjs

@@ -0,0 +1,266 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.js
+var index_exports = {};
+__export(index_exports, {
+  addDetectionContext: () => addDetectionContext,
+  addNamespace: () => addNamespace,
+  decodePayload: () => decodePayload,
+  decodePayloadBase64Xor: () => decodePayloadBase64Xor,
+  detectDeviceType: () => detectDeviceType,
+  fetchWithRetry: () => fetchWithRetry,
+  getAvailableContexts: () => getAvailableContexts,
+  http: () => http,
+  numbers: () => numbers_exports,
+  strings: () => strings_exports
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/codec/decodePayload.js
+function decodePayload(encoded, key) {
+  const bytes = base64ToBytesStrict(encoded);
+  if (bytes.length === 0) return "";
+  if (key === "" || key === void 0 || key === null) {
+    return new TextDecoder().decode(bytes);
+  }
+  if (typeof key === "number" && Number.isFinite(key)) {
+    const k = key & 255;
+    for (let i = 0; i < bytes.length; i++) bytes[i] ^= k;
+    return new TextDecoder().decode(bytes);
+  }
+  const keyStr = String(key);
+  const keyBytes = new TextEncoder().encode(keyStr);
+  if (keyBytes.length === 0) {
+    return new TextDecoder().decode(bytes);
+  }
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] ^= keyBytes[i % keyBytes.length];
+  }
+  return new TextDecoder().decode(bytes);
+}
+function decodePayloadBase64Xor(encoded, xorKey = 73) {
+  const bytes = base64ToBytesStrict(encoded);
+  for (let i = 0; i < bytes.length; i++) bytes[i] ^= xorKey & 255;
+  return new TextDecoder().decode(bytes);
+}
+function base64ToBytesStrict(b64) {
+  if (b64 === "" || b64 === void 0 || b64 === null) return new Uint8Array();
+  const s = String(b64).replace(/\s+/g, "");
+  const re = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+  if (!re.test(s)) throw new Error("Invalid base64");
+  if (typeof Buffer !== "undefined" && Buffer.from) {
+    return Uint8Array.from(Buffer.from(s, "base64"));
+  }
+  const bin = atob(s);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+
+// src/net/http.js
+async function fetchWithRetry(url, options = {}) {
+  const {
+    retries = 0,
+    retryDelay = 100,
+    timeout = 1e4,
+    retryCondition,
+    ...passThrough
+  } = options;
+  const baseInit = { ...passThrough, timeout };
+  let attempt = 0;
+  while (true) {
+    try {
+      const res = await withTimeout(fetch(url, baseInit), timeout);
+      if (!res.ok) {
+        const doRetry = typeof retryCondition === "function" && retryCondition(null, res) || res.status >= 500;
+        if (doRetry && attempt < retries) {
+          await delay(expBackoff(retryDelay, attempt));
+          attempt++;
+          continue;
+        }
+        const msg = `HTTP ${res.status}: ${res.statusText || ""}`.trim();
+        throw new Error(msg);
+      }
+      return res;
+    } catch (err) {
+      if (err && err.message === "Request timeout") {
+        if (attempt < retries) {
+          await delay(expBackoff(retryDelay, attempt));
+          attempt++;
+          continue;
+        }
+        throw err;
+      }
+      const doRetry = typeof retryCondition === "function" && retryCondition(err, void 0) || isRetryableNetworkError(err);
+      if (doRetry && attempt < retries) {
+        await delay(expBackoff(retryDelay, attempt));
+        attempt++;
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+var http = fetchWithRetry;
+function withTimeout(promise, ms) {
+  return new Promise((resolve, reject) => {
+    const t = setTimeout(() => reject(new Error("Request timeout")), ms);
+    promise.then(
+      (v) => {
+        clearTimeout(t);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(t);
+        reject(e);
+      }
+    );
+  });
+}
+function delay(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function expBackoff(base, attempt) {
+  return base * Math.pow(2, attempt);
+}
+function isRetryableNetworkError(err) {
+  if (!err) return false;
+  const msg = String(err.message || "").toLowerCase();
+  return msg.includes("network") || err.name === "AbortError";
+}
+
+// src/utils/namespace.js
+function addNamespace(payload, namespace = "") {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    throw new Error("Payload must be an object.");
+  }
+  const keys = Object.keys(payload);
+  const suffix = namespace.trim() ? ` (${namespace.trim()})` : "";
+  return keys.reduce((acc, key) => {
+    acc[`${key}${suffix}`] = payload[key];
+    return acc;
+  }, {});
+}
+
+// src/utils/deviceType.js
+var contexts = {
+  building: (name) => {
+    const upper = name.toUpperCase();
+    if (upper.includes("COMPRESSOR")) return "COMPRESSOR";
+    if (upper.includes("VENT")) return "VENTILADOR";
+    if (upper.includes("AUTOMATICO") || upper.includes("AUTOM\xC1TICO")) return "SELETOR_AUTO_MANUAL";
+    if (upper.includes("TERMOSTATO")) return "TERMOSTATO";
+    if (upper.includes("3F")) return "3F_MEDIDOR";
+    if (upper.includes("TERMO") || upper.includes("TEMP")) return "TERMOSTATO";
+    if (upper.includes("HIDR")) return "HIDROMETRO";
+    if (upper.includes("ABRE")) return "SOLENOIDE";
+    if (upper.includes("RECALQUE")) return "MOTOR";
+    if (upper.includes("AUTOMACAO") || upper.includes("AUTOMA\xC7\xC3O")) return "GLOBAL_AUTOMACAO";
+    if (upper.includes("AC")) return "CONTROLE REMOTO";
+    if (upper.includes("SCD")) return "CAIXA_D_AGUA";
+    return "default";
+  },
+  mall: (name) => {
+    const upper = name.toUpperCase();
+    if (upper.includes("CHILLER")) return "CHILLER";
+    if (upper.includes("ESCADA")) return "ESCADA_ROLANTE";
+    if (upper.includes("LOJA")) return "LOJA_SENSOR";
+    if (upper.includes("ILUMINACAO") || upper.includes("ILUMINA\xC7\xC3O")) return "ILUMINACAO";
+    return "default";
+  }
+};
+function detectDeviceType(name, context = "building") {
+  if (typeof name !== "string") {
+    throw new Error("Device name must be a string.");
+  }
+  const detectFunction = contexts[context];
+  if (!detectFunction) {
+    console.warn(`[myio-js-library] Context "${context}" not found. Using default fallback.`);
+    return contexts.building(name);
+  }
+  return detectFunction(name);
+}
+function getAvailableContexts() {
+  return Object.keys(contexts);
+}
+function addDetectionContext(contextName, detectFunction) {
+  if (typeof contextName !== "string") {
+    throw new Error("Context name must be a string.");
+  }
+  if (typeof detectFunction !== "function") {
+    throw new Error("Detection function must be a function.");
+  }
+  contexts[contextName] = detectFunction;
+}
+
+// src/utils/strings.js
+var strings_exports = {};
+__export(strings_exports, {
+  normalizeRecipients: () => normalizeRecipients
+});
+function normalizeRecipients(val) {
+  if (val === null || val === void 0 || val === "") return "";
+  if (Object.prototype.toString.call(val) === "[object Array]") {
+    return (
+      /** @type {unknown[]} */
+      val.filter(Boolean).join(",")
+    );
+  }
+  let s = String(val).trim();
+  if (/^\s*\[/.test(s)) {
+    try {
+      const arr = JSON.parse(s);
+      if (Object.prototype.toString.call(arr) === "[object Array]") {
+        return arr.filter(Boolean).join(",");
+      }
+    } catch {
+    }
+  }
+  s = s.replace(/[;\s]+/g, ",");
+  s = s.replace(/,+/g, ",").replace(/^,|,$/g, "");
+  return s;
+}
+
+// src/utils/numbers.js
+var numbers_exports = {};
+__export(numbers_exports, {
+  fmtPerc: () => fmtPerc,
+  toFixedSafe: () => toFixedSafe
+});
+function fmtPerc(x, digits = 2) {
+  if (!Number.isFinite(x)) return "\u2014";
+  return (x * 100).toFixed(digits) + "%";
+}
+function toFixedSafe(x, digits = 2) {
+  if (!Number.isFinite(x)) return "\u2014";
+  return x.toFixed(digits);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addDetectionContext,
+  addNamespace,
+  decodePayload,
+  decodePayloadBase64Xor,
+  detectDeviceType,
+  fetchWithRetry,
+  getAvailableContexts,
+  http,
+  numbers,
+  strings
+});

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+export function decodePayload(encoded: string, key: string | number): string;
+export function decodePayloadBase64Xor(encoded: string, xorKey?: number): string;
+
+export function fetchWithRetry(
+  url: string | URL,
+  options?: RequestInit & {
+    retries?: number;
+    retryDelay?: number;
+    timeout?: number;
+    retryCondition?: (error?: unknown, response?: Response) => boolean;
+  }
+): Promise<Response>;
+
+export const http: typeof fetchWithRetry;
+
+export namespace strings {
+  function normalizeRecipients(val: unknown): string;
+}
+export namespace numbers {
+  function fmtPerc(x: number, digits?: number): string;
+  function toFixedSafe(x: number, digits?: number): string;
+}
+
+export function addNamespace(payload: object, namespace?: string): object;
+
+export function detectDeviceType(name: string, context?: string): string;
+export function getAvailableContexts(): string[];
+export function addDetectionContext(contextName: string, detectFunction: (name: string) => string): void;

package/dist/index.js

@@ -0,0 +1,237 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/codec/decodePayload.js
+function decodePayload(encoded, key) {
+  const bytes = base64ToBytesStrict(encoded);
+  if (bytes.length === 0) return "";
+  if (key === "" || key === void 0 || key === null) {
+    return new TextDecoder().decode(bytes);
+  }
+  if (typeof key === "number" && Number.isFinite(key)) {
+    const k = key & 255;
+    for (let i = 0; i < bytes.length; i++) bytes[i] ^= k;
+    return new TextDecoder().decode(bytes);
+  }
+  const keyStr = String(key);
+  const keyBytes = new TextEncoder().encode(keyStr);
+  if (keyBytes.length === 0) {
+    return new TextDecoder().decode(bytes);
+  }
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] ^= keyBytes[i % keyBytes.length];
+  }
+  return new TextDecoder().decode(bytes);
+}
+function decodePayloadBase64Xor(encoded, xorKey = 73) {
+  const bytes = base64ToBytesStrict(encoded);
+  for (let i = 0; i < bytes.length; i++) bytes[i] ^= xorKey & 255;
+  return new TextDecoder().decode(bytes);
+}
+function base64ToBytesStrict(b64) {
+  if (b64 === "" || b64 === void 0 || b64 === null) return new Uint8Array();
+  const s = String(b64).replace(/\s+/g, "");
+  const re = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+  if (!re.test(s)) throw new Error("Invalid base64");
+  if (typeof Buffer !== "undefined" && Buffer.from) {
+    return Uint8Array.from(Buffer.from(s, "base64"));
+  }
+  const bin = atob(s);
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+
+// src/net/http.js
+async function fetchWithRetry(url, options = {}) {
+  const {
+    retries = 0,
+    retryDelay = 100,
+    timeout = 1e4,
+    retryCondition,
+    ...passThrough
+  } = options;
+  const baseInit = { ...passThrough, timeout };
+  let attempt = 0;
+  while (true) {
+    try {
+      const res = await withTimeout(fetch(url, baseInit), timeout);
+      if (!res.ok) {
+        const doRetry = typeof retryCondition === "function" && retryCondition(null, res) || res.status >= 500;
+        if (doRetry && attempt < retries) {
+          await delay(expBackoff(retryDelay, attempt));
+          attempt++;
+          continue;
+        }
+        const msg = `HTTP ${res.status}: ${res.statusText || ""}`.trim();
+        throw new Error(msg);
+      }
+      return res;
+    } catch (err) {
+      if (err && err.message === "Request timeout") {
+        if (attempt < retries) {
+          await delay(expBackoff(retryDelay, attempt));
+          attempt++;
+          continue;
+        }
+        throw err;
+      }
+      const doRetry = typeof retryCondition === "function" && retryCondition(err, void 0) || isRetryableNetworkError(err);
+      if (doRetry && attempt < retries) {
+        await delay(expBackoff(retryDelay, attempt));
+        attempt++;
+        continue;
+      }
+      throw err;
+    }
+  }
+}
+var http = fetchWithRetry;
+function withTimeout(promise, ms) {
+  return new Promise((resolve, reject) => {
+    const t = setTimeout(() => reject(new Error("Request timeout")), ms);
+    promise.then(
+      (v) => {
+        clearTimeout(t);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(t);
+        reject(e);
+      }
+    );
+  });
+}
+function delay(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function expBackoff(base, attempt) {
+  return base * Math.pow(2, attempt);
+}
+function isRetryableNetworkError(err) {
+  if (!err) return false;
+  const msg = String(err.message || "").toLowerCase();
+  return msg.includes("network") || err.name === "AbortError";
+}
+
+// src/utils/namespace.js
+function addNamespace(payload, namespace = "") {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    throw new Error("Payload must be an object.");
+  }
+  const keys = Object.keys(payload);
+  const suffix = namespace.trim() ? ` (${namespace.trim()})` : "";
+  return keys.reduce((acc, key) => {
+    acc[`${key}${suffix}`] = payload[key];
+    return acc;
+  }, {});
+}
+
+// src/utils/deviceType.js
+var contexts = {
+  building: (name) => {
+    const upper = name.toUpperCase();
+    if (upper.includes("COMPRESSOR")) return "COMPRESSOR";
+    if (upper.includes("VENT")) return "VENTILADOR";
+    if (upper.includes("AUTOMATICO") || upper.includes("AUTOM\xC1TICO")) return "SELETOR_AUTO_MANUAL";
+    if (upper.includes("TERMOSTATO")) return "TERMOSTATO";
+    if (upper.includes("3F")) return "3F_MEDIDOR";
+    if (upper.includes("TERMO") || upper.includes("TEMP")) return "TERMOSTATO";
+    if (upper.includes("HIDR")) return "HIDROMETRO";
+    if (upper.includes("ABRE")) return "SOLENOIDE";
+    if (upper.includes("RECALQUE")) return "MOTOR";
+    if (upper.includes("AUTOMACAO") || upper.includes("AUTOMA\xC7\xC3O")) return "GLOBAL_AUTOMACAO";
+    if (upper.includes("AC")) return "CONTROLE REMOTO";
+    if (upper.includes("SCD")) return "CAIXA_D_AGUA";
+    return "default";
+  },
+  mall: (name) => {
+    const upper = name.toUpperCase();
+    if (upper.includes("CHILLER")) return "CHILLER";
+    if (upper.includes("ESCADA")) return "ESCADA_ROLANTE";
+    if (upper.includes("LOJA")) return "LOJA_SENSOR";
+    if (upper.includes("ILUMINACAO") || upper.includes("ILUMINA\xC7\xC3O")) return "ILUMINACAO";
+    return "default";
+  }
+};
+function detectDeviceType(name, context = "building") {
+  if (typeof name !== "string") {
+    throw new Error("Device name must be a string.");
+  }
+  const detectFunction = contexts[context];
+  if (!detectFunction) {
+    console.warn(`[myio-js-library] Context "${context}" not found. Using default fallback.`);
+    return contexts.building(name);
+  }
+  return detectFunction(name);
+}
+function getAvailableContexts() {
+  return Object.keys(contexts);
+}
+function addDetectionContext(contextName, detectFunction) {
+  if (typeof contextName !== "string") {
+    throw new Error("Context name must be a string.");
+  }
+  if (typeof detectFunction !== "function") {
+    throw new Error("Detection function must be a function.");
+  }
+  contexts[contextName] = detectFunction;
+}
+
+// src/utils/strings.js
+var strings_exports = {};
+__export(strings_exports, {
+  normalizeRecipients: () => normalizeRecipients
+});
+function normalizeRecipients(val) {
+  if (val === null || val === void 0 || val === "") return "";
+  if (Object.prototype.toString.call(val) === "[object Array]") {
+    return (
+      /** @type {unknown[]} */
+      val.filter(Boolean).join(",")
+    );
+  }
+  let s = String(val).trim();
+  if (/^\s*\[/.test(s)) {
+    try {
+      const arr = JSON.parse(s);
+      if (Object.prototype.toString.call(arr) === "[object Array]") {
+        return arr.filter(Boolean).join(",");
+      }
+    } catch {
+    }
+  }
+  s = s.replace(/[;\s]+/g, ",");
+  s = s.replace(/,+/g, ",").replace(/^,|,$/g, "");
+  return s;
+}
+
+// src/utils/numbers.js
+var numbers_exports = {};
+__export(numbers_exports, {
+  fmtPerc: () => fmtPerc,
+  toFixedSafe: () => toFixedSafe
+});
+function fmtPerc(x, digits = 2) {
+  if (!Number.isFinite(x)) return "\u2014";
+  return (x * 100).toFixed(digits) + "%";
+}
+function toFixedSafe(x, digits = 2) {
+  if (!Number.isFinite(x)) return "\u2014";
+  return x.toFixed(digits);
+}
+export {
+  addDetectionContext,
+  addNamespace,
+  decodePayload,
+  decodePayloadBase64Xor,
+  detectDeviceType,
+  fetchWithRetry,
+  getAvailableContexts,
+  http,
+  numbers_exports as numbers,
+  strings_exports as strings
+};

package/dist/myio-js-library.umd.js

@@ -0,0 +1,314 @@
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+  typeof define === 'function' && define.amd ? define(['exports'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.MyIOJSLibrary = {}));
+})(this, (function (exports) { 'use strict';
+
+  // XOR sobre bytes decodificados de base64.
+  // - key string: repete a chave sobre os bytes
+  // - key number: aplica 1 byte (0..255) em todos os bytes
+  // - key vazia/undefined: sem XOR
+  function decodePayload(encoded, key) {
+    const bytes = base64ToBytesStrict(encoded);
+    if (bytes.length === 0) return '';
+
+    if (key === '' || key === undefined || key === null) {
+      return new TextDecoder().decode(bytes);
+    }
+
+    if (typeof key === 'number' && Number.isFinite(key)) {
+      const k = key & 0xff;
+      for (let i = 0; i < bytes.length; i++) bytes[i] ^= k;
+      return new TextDecoder().decode(bytes);
+    }
+
+    const keyStr = String(key);
+    const keyBytes = new TextEncoder().encode(keyStr);
+    if (keyBytes.length === 0) {
+      return new TextDecoder().decode(bytes);
+    }
+    for (let i = 0; i < bytes.length; i++) {
+      bytes[i] ^= keyBytes[i % keyBytes.length];
+    }
+    return new TextDecoder().decode(bytes);
+  }
+
+  // Compat já existente (1 byte XOR)
+  function decodePayloadBase64Xor(encoded, xorKey = 73) {
+    const bytes = base64ToBytesStrict(encoded);
+    for (let i = 0; i < bytes.length; i++) bytes[i] ^= (xorKey & 0xff);
+    return new TextDecoder().decode(bytes);
+  }
+
+  function base64ToBytesStrict(b64) {
+    if (b64 === '' || b64 === undefined || b64 === null) return new Uint8Array();
+    const s = String(b64).replace(/\s+/g, '');
+    // valida base64 (com padding)
+    const re = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+    if (!re.test(s)) throw new Error('Invalid base64');
+
+    if (typeof Buffer !== 'undefined' && Buffer.from) {
+      return Uint8Array.from(Buffer.from(s, 'base64'));
+    }
+    const bin = atob(s); // lança se inválido
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+    return out;
+  }
+
+  /**
+   * fetchWithRetry(url, {
+   *   retries?: number = 0,
+   *   retryDelay?: number = 100,
+   *   timeout?: number = 10000,
+   *   retryCondition?: (error, response) => boolean,
+   *   ...RequestInit (method, headers, body, signal, etc.)
+   * })
+   *
+   * Observação: os testes verificam que o objeto de options passado ao fetch
+   * contém a prop `timeout`, então mantemos `{ timeout }` no init.
+   */
+  async function fetchWithRetry(url, options = {}) {
+    const {
+      retries = 0,
+      retryDelay = 100,
+      timeout = 10000,
+      retryCondition,
+      ...passThrough
+    } = options;
+
+    const baseInit = { ...passThrough, timeout }; // manter timeout no objeto
+
+    let attempt = 0;
+    while (true) {
+      try {
+        const res = await withTimeout(fetch(url, baseInit), timeout);
+        if (!res.ok) {
+          const doRetry =
+            (typeof retryCondition === 'function' && retryCondition(null, res)) ||
+            res.status >= 500; // padrão: 5xx
+          if (doRetry && attempt < retries) {
+            await delay(expBackoff(retryDelay, attempt));
+            attempt++;
+            continue;
+          }
+          const msg = `HTTP ${res.status}: ${res.statusText || ''}`.trim();
+          throw new Error(msg);
+        }
+        return res;
+      } catch (err) {
+        if (err && err.message === 'Request timeout') {
+          if (attempt < retries) {
+            await delay(expBackoff(retryDelay, attempt));
+            attempt++;
+            continue;
+          }
+          throw err;
+        }
+        const doRetry =
+          (typeof retryCondition === 'function' && retryCondition(err, undefined)) ||
+          isRetryableNetworkError(err);
+        if (doRetry && attempt < retries) {
+          await delay(expBackoff(retryDelay, attempt));
+          attempt++;
+          continue;
+        }
+        throw err;
+      }
+    }
+  }
+
+  const http = fetchWithRetry; // alias para manter compat
+
+  function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+      const t = setTimeout(() => reject(new Error('Request timeout')), ms);
+      promise.then(
+        (v) => { clearTimeout(t); resolve(v); },
+        (e) => { clearTimeout(t); reject(e); }
+      );
+    });
+  }
+
+  function delay(ms) { return new Promise((r) => setTimeout(r, ms)); }
+  function expBackoff(base, attempt) { return base * Math.pow(2, attempt); } // 0->base,1->2x,...
+  function isRetryableNetworkError(err) {
+    if (!err) return false;
+    const msg = String(err.message || '').toLowerCase();
+    return msg.includes('network') || err.name === 'AbortError';
+  }
+
+  /**
+   * Adds a namespace (e.g., building name or location) to the keys of a payload object.
+   * 
+   * @param {object} payload - Original object with simple keys (e.g., { temperature: 22 }).
+   * @param {string} namespace - Text to be appended as a suffix to the keys (e.g., "BB Campos dos Goytacazes").
+   * @returns {object} - New object with renamed keys.
+   * @throws {Error} - If payload is not an object.
+   */
+  function addNamespace(payload, namespace = '') {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+      throw new Error('Payload must be an object.');
+    }
+
+    const keys = Object.keys(payload);
+    const suffix = namespace.trim() ? ` (${namespace.trim()})` : '';
+
+    return keys.reduce((acc, key) => {
+      acc[`${key}${suffix}`] = payload[key];
+      return acc;
+    }, {});
+  }
+
+  /**
+   * Device detection contexts for different environments
+   */
+  const contexts = {
+    building: (name) => {
+      const upper = name.toUpperCase();
+
+      if (upper.includes('COMPRESSOR')) return 'COMPRESSOR';
+      if (upper.includes('VENT')) return 'VENTILADOR';
+      if (upper.includes('AUTOMATICO') || upper.includes('AUTOMÁTICO')) return 'SELETOR_AUTO_MANUAL';
+      if (upper.includes('TERMOSTATO')) return 'TERMOSTATO';
+      if (upper.includes('3F')) return '3F_MEDIDOR';
+      if (upper.includes('TERMO') || upper.includes('TEMP')) return 'TERMOSTATO';
+      if (upper.includes('HIDR')) return 'HIDROMETRO';
+      if (upper.includes('ABRE')) return 'SOLENOIDE';
+      if (upper.includes('RECALQUE')) return 'MOTOR';
+      if (upper.includes('AUTOMACAO') || upper.includes('AUTOMAÇÃO')) return 'GLOBAL_AUTOMACAO';
+      if (upper.includes('AC')) return 'CONTROLE REMOTO';
+      if (upper.includes('SCD')) return 'CAIXA_D_AGUA';
+
+      return 'default';
+    },
+
+    mall: (name) => {
+      const upper = name.toUpperCase();
+
+      if (upper.includes('CHILLER')) return 'CHILLER';
+      if (upper.includes('ESCADA')) return 'ESCADA_ROLANTE';
+      if (upper.includes('LOJA')) return 'LOJA_SENSOR';
+      if (upper.includes('ILUMINACAO') || upper.includes('ILUMINAÇÃO')) return 'ILUMINACAO';
+
+      return 'default';
+    }
+  };
+
+  /**
+   * Detects the device type based on the given name and context.
+   * Uses the specified detection context to identify device types.
+   * If the specified context does not exist, falls back to 'building' context.
+   * 
+   * @param {string} name - The name of the device (e.g., "Compressor 7 Andar").
+   * @param {string} [context='building'] - The detection context (e.g., "mall", "building").
+   * @returns {string} - The detected device type (e.g., "COMPRESSOR", "VENTILADOR", or "default").
+   */
+  function detectDeviceType(name, context = 'building') {
+    if (typeof name !== 'string') {
+      throw new Error('Device name must be a string.');
+    }
+
+    const detectFunction = contexts[context];
+    
+    if (!detectFunction) {
+      console.warn(`[myio-js-library] Context "${context}" not found. Using default fallback.`);
+      return contexts.building(name);
+    }
+
+    return detectFunction(name);
+  }
+
+  /**
+   * Get available detection contexts
+   * @returns {string[]} Array of available context names
+   */
+  function getAvailableContexts() {
+    return Object.keys(contexts);
+  }
+
+  /**
+   * Add a custom detection context
+   * @param {string} contextName - Name of the new context
+   * @param {function} detectFunction - Function that takes a device name and returns a device type
+   */
+  function addDetectionContext(contextName, detectFunction) {
+    if (typeof contextName !== 'string') {
+      throw new Error('Context name must be a string.');
+    }
+    
+    if (typeof detectFunction !== 'function') {
+      throw new Error('Detection function must be a function.');
+    }
+
+    contexts[contextName] = detectFunction;
+  }
+
+  /**
+   * Normalize list-like inputs into a comma-separated string.
+   * Accepts array, JSON-stringified array, or delimited strings (; , space).
+   * @param {unknown} val
+   * @returns {string}
+   */
+  function normalizeRecipients(val) {
+    if (val === null || val === undefined || val === '') return '';
+    if (Object.prototype.toString.call(val) === '[object Array]') {
+      return /** @type {unknown[]} */(val).filter(Boolean).join(',');
+    }
+    let s = String(val).trim();
+    if (/^\s*\[/.test(s)) {
+      try {
+        const arr = JSON.parse(s);
+        if (Object.prototype.toString.call(arr) === '[object Array]') {
+          return arr.filter(Boolean).join(',');
+        }
+      } catch { /* fall through */ }
+    }
+    s = s.replace(/[;\s]+/g, ',');
+    s = s.replace(/,+/g, ',').replace(/^,|,$/g, '');
+    return s;
+  }
+
+  var strings = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    normalizeRecipients: normalizeRecipients
+  });
+
+  /**
+   * Format ratio 0..1 as percentage string (e.g., 0.1234 -> "12.34%").
+   * @param {number} x
+   * @param {number} [digits=2]
+   */
+  function fmtPerc(x, digits = 2) {
+    if (!Number.isFinite(x)) return '—';
+    return (x * 100).toFixed(digits) + '%';
+  }
+
+  /**
+   * Safe fixed decimal formatting (returns string, or '—' if NaN/Inf).
+   * @param {number} x
+   * @param {number} [digits=2]
+   */
+  function toFixedSafe(x, digits = 2) {
+    if (!Number.isFinite(x)) return '—';
+    return x.toFixed(digits);
+  }
+
+  var numbers = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    fmtPerc: fmtPerc,
+    toFixedSafe: toFixedSafe
+  });
+
+  exports.addDetectionContext = addDetectionContext;
+  exports.addNamespace = addNamespace;
+  exports.decodePayload = decodePayload;
+  exports.decodePayloadBase64Xor = decodePayloadBase64Xor;
+  exports.detectDeviceType = detectDeviceType;
+  exports.fetchWithRetry = fetchWithRetry;
+  exports.getAvailableContexts = getAvailableContexts;
+  exports.http = http;
+  exports.numbers = numbers;
+  exports.strings = strings;
+
+}));

package/dist/myio-js-library.umd.min.js

@@ -0,0 +1 @@
+(function(global,factory){typeof exports==="object"&&typeof module!=="undefined"?factory(exports):typeof define==="function"&&define.amd?define(["exports"],factory):(global=typeof globalThis!=="undefined"?globalThis:global||self,factory(global.MyIOJSLibrary={}))})(this,function(exports){"use strict";function decodePayload(encoded,key){const bytes=base64ToBytesStrict(encoded);if(bytes.length===0)return"";if(key===""||key===undefined||key===null){return(new TextDecoder).decode(bytes)}if(typeof key==="number"&&Number.isFinite(key)){const k=key&255;for(let i=0;i<bytes.length;i++)bytes[i]^=k;return(new TextDecoder).decode(bytes)}const keyStr=String(key);const keyBytes=(new TextEncoder).encode(keyStr);if(keyBytes.length===0){return(new TextDecoder).decode(bytes)}for(let i=0;i<bytes.length;i++){bytes[i]^=keyBytes[i%keyBytes.length]}return(new TextDecoder).decode(bytes)}function decodePayloadBase64Xor(encoded,xorKey=73){const bytes=base64ToBytesStrict(encoded);for(let i=0;i<bytes.length;i++)bytes[i]^=xorKey&255;return(new TextDecoder).decode(bytes)}function base64ToBytesStrict(b64){if(b64===""||b64===undefined||b64===null)return new Uint8Array;const s=String(b64).replace(/\s+/g,"");const re=/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;if(!re.test(s))throw new Error("Invalid base64");if(typeof Buffer!=="undefined"&&Buffer.from){return Uint8Array.from(Buffer.from(s,"base64"))}const bin=atob(s);const out=new Uint8Array(bin.length);for(let i=0;i<bin.length;i++)out[i]=bin.charCodeAt(i);return out}async function fetchWithRetry(url,options={}){const{retries:retries=0,retryDelay:retryDelay=100,timeout:timeout=1e4,retryCondition:retryCondition,...passThrough}=options;const baseInit={...passThrough,timeout:timeout};let attempt=0;while(true){try{const res=await withTimeout(fetch(url,baseInit),timeout);if(!res.ok){const doRetry=typeof retryCondition==="function"&&retryCondition(null,res)||res.status>=500;if(doRetry&&attempt<retries){await delay(expBackoff(retryDelay,attempt));attempt++;continue}const msg=`HTTP ${res.status}: ${res.statusText||""}`.trim();throw new Error(msg)}return res}catch(err){if(err&&err.message==="Request timeout"){if(attempt<retries){await delay(expBackoff(retryDelay,attempt));attempt++;continue}throw err}const doRetry=typeof retryCondition==="function"&&retryCondition(err,undefined)||isRetryableNetworkError(err);if(doRetry&&attempt<retries){await delay(expBackoff(retryDelay,attempt));attempt++;continue}throw err}}}const http=fetchWithRetry;function withTimeout(promise,ms){return new Promise((resolve,reject)=>{const t=setTimeout(()=>reject(new Error("Request timeout")),ms);promise.then(v=>{clearTimeout(t);resolve(v)},e=>{clearTimeout(t);reject(e)})})}function delay(ms){return new Promise(r=>setTimeout(r,ms))}function expBackoff(base,attempt){return base*Math.pow(2,attempt)}function isRetryableNetworkError(err){if(!err)return false;const msg=String(err.message||"").toLowerCase();return msg.includes("network")||err.name==="AbortError"}function addNamespace(payload,namespace=""){if(!payload||typeof payload!=="object"||Array.isArray(payload)){throw new Error("Payload must be an object.")}const keys=Object.keys(payload);const suffix=namespace.trim()?` (${namespace.trim()})`:"";return keys.reduce((acc,key)=>{acc[`${key}${suffix}`]=payload[key];return acc},{})}const contexts={building:name=>{const upper=name.toUpperCase();if(upper.includes("COMPRESSOR"))return"COMPRESSOR";if(upper.includes("VENT"))return"VENTILADOR";if(upper.includes("AUTOMATICO")||upper.includes("AUTOMÁTICO"))return"SELETOR_AUTO_MANUAL";if(upper.includes("TERMOSTATO"))return"TERMOSTATO";if(upper.includes("3F"))return"3F_MEDIDOR";if(upper.includes("TERMO")||upper.includes("TEMP"))return"TERMOSTATO";if(upper.includes("HIDR"))return"HIDROMETRO";if(upper.includes("ABRE"))return"SOLENOIDE";if(upper.includes("RECALQUE"))return"MOTOR";if(upper.includes("AUTOMACAO")||upper.includes("AUTOMAÇÃO"))return"GLOBAL_AUTOMACAO";if(upper.includes("AC"))return"CONTROLE REMOTO";if(upper.includes("SCD"))return"CAIXA_D_AGUA";return"default"},mall:name=>{const upper=name.toUpperCase();if(upper.includes("CHILLER"))return"CHILLER";if(upper.includes("ESCADA"))return"ESCADA_ROLANTE";if(upper.includes("LOJA"))return"LOJA_SENSOR";if(upper.includes("ILUMINACAO")||upper.includes("ILUMINAÇÃO"))return"ILUMINACAO";return"default"}};function detectDeviceType(name,context="building"){if(typeof name!=="string"){throw new Error("Device name must be a string.")}const detectFunction=contexts[context];if(!detectFunction){console.warn(`[myio-js-library] Context "${context}" not found. Using default fallback.`);return contexts.building(name)}return detectFunction(name)}function getAvailableContexts(){return Object.keys(contexts)}function addDetectionContext(contextName,detectFunction){if(typeof contextName!=="string"){throw new Error("Context name must be a string.")}if(typeof detectFunction!=="function"){throw new Error("Detection function must be a function.")}contexts[contextName]=detectFunction}function normalizeRecipients(val){if(val===null||val===undefined||val==="")return"";if(Object.prototype.toString.call(val)==="[object Array]"){return val.filter(Boolean).join(",")}let s=String(val).trim();if(/^\s*\[/.test(s)){try{const arr=JSON.parse(s);if(Object.prototype.toString.call(arr)==="[object Array]"){return arr.filter(Boolean).join(",")}}catch{}}s=s.replace(/[;\s]+/g,",");s=s.replace(/,+/g,",").replace(/^,|,$/g,"");return s}var strings=Object.freeze({__proto__:null,normalizeRecipients:normalizeRecipients});function fmtPerc(x,digits=2){if(!Number.isFinite(x))return"—";return(x*100).toFixed(digits)+"%"}function toFixedSafe(x,digits=2){if(!Number.isFinite(x))return"—";return x.toFixed(digits)}var numbers=Object.freeze({__proto__:null,fmtPerc:fmtPerc,toFixedSafe:toFixedSafe});exports.addDetectionContext=addDetectionContext;exports.addNamespace=addNamespace;exports.decodePayload=decodePayload;exports.decodePayloadBase64Xor=decodePayloadBase64Xor;exports.detectDeviceType=detectDeviceType;exports.fetchWithRetry=fetchWithRetry;exports.getAvailableContexts=getAvailableContexts;exports.http=http;exports.numbers=numbers;exports.strings=strings});

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "myio-js-library",
+  "version": "0.1.0",
+  "description": "A clean, standalone JS SDK for MYIO projects",
+  "license": "MIT",
+  "repository": "github:gh-myio/myio-js-library",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build:tsup": "tsup src/index.js --format esm,cjs --clean --outDir dist",
+    "build:umd": "rollup -c",
+    "minify:umd": "terser dist/myio-js-library.umd.js -o dist/myio-js-library.umd.min.js --comments=false",
+    "postbuild": "node scripts/copy-dts.js",
+    "build": "npm run clean && npm run build:tsup && npm run build:umd && npm run minify:umd",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "dev:test": "vitest",
+    "release": "npm run build && npm publish --access public"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.34.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "eslint": "^9.11.1",
+    "globals": "^16.3.0",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.21.0",
+    "terser": "^5.31.6",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.1"
+  }
+}