@vbarbarosh/node-helpers 3.61.0 → 3.63.0

package/README.md

@@ -1,16 +1,38 @@
 A set of helpers for JavaScript/Node.js
 
-![](img/node-helpers-by-chat-gpt.webp)
+
+<p align="center">
+<a href="https://github.com/vbarbarosh/node-helpers/actions"><img src="https://github.com/vbarbarosh/node-helpers/actions/workflows/node.js.yml/badge.svg" alt="@vbarbarosh/node-helpers CI status" /></a>
+<a href="https://opensource.org/licenses/MIT" rel="nofollow"><img src="https://img.shields.io/github/license/vbarbarosh/node-helpers" alt="License" /></a>
+<a href="https://www.npmjs.com/package/@vbarbarosh/node-helpers" rel="nofollow"><img src="https://img.shields.io/npm/dw/@vbarbarosh/node-helpers.svg" alt="npm" /></a>
+<a href="https://github.com/vbarbarosh/node-helpers" rel="nofollow"><img src="https://img.shields.io/github/stars/vbarbarosh/node-helpers" alt="stars" /></a>
+</p>
+
+<p align="center">
+<img src="img/node-helpers-by-chat-gpt.webp" style="max-height:400px;" />
+</p>
 
 ## Installation
 
-    npm install @vbarbarosh/node-helpers
+```sh
+npm install @vbarbarosh/node-helpers
+```
+
+A subset of `@vbarbarosh/node-helpers` is available for browser:
+
+```html
+<script src="https://unpkg.com/@vbarbarosh/node-helpers@latest/dist/browser.js"></script>
+```
+
+⚠️ All supported functions are exposed globally.
 
 ## Test
 
-    bin/test
+```sh
+bin/test
+```
 
-## Conventions
+## 📖 Conventions
 
 `concurrency` - limit for parallel processes.
 

package/dist/browser.js

@@ -0,0 +1,949 @@
+/******/ (() => { // webpackBootstrap
+/******/ 	var __webpack_modules__ = ({
+
+/***/ "./src sync recursive \\b(array%7Cdate%7Chttp_delete%7Chttp_get_blob%7Chttp_get_buffer%7Chttp_get_json%7Chttp_get_utf8%7Chttp_head%7Chttp_patch_json%7Chttp_post_json%7Chttp_post_multipart%7Chttp_put_buffer%7Chttp_put_json%7Chttp_put_utf8%7Cidentity%7Cignore).*(?<%21\\.test)\\.js$":
+/*!***********************************************************************************************************************************************************************************************************************************************************************************!*\
+  !*** ./src/ sync \b(array%7Cdate%7Chttp_delete%7Chttp_get_blob%7Chttp_get_buffer%7Chttp_get_json%7Chttp_get_utf8%7Chttp_head%7Chttp_patch_json%7Chttp_post_json%7Chttp_post_multipart%7Chttp_put_buffer%7Chttp_put_json%7Chttp_put_utf8%7Cidentity%7Cignore).*(?<%21\.test)\.js$ ***!
+  \***********************************************************************************************************************************************************************************************************************************************************************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+var map = {
+	"./array_chunk.js": "./src/array_chunk.js",
+	"./array_gcd.js": "./src/array_gcd.js",
+	"./array_group.js": "./src/array_group.js",
+	"./array_group_map.js": "./src/array_group_map.js",
+	"./array_index.js": "./src/array_index.js",
+	"./array_max.js": "./src/array_max.js",
+	"./array_min.js": "./src/array_min.js",
+	"./array_permutations.js": "./src/array_permutations.js",
+	"./array_shuffle.js": "./src/array_shuffle.js",
+	"./array_sort.js": "./src/array_sort.js",
+	"./array_sort_other.js": "./src/array_sort_other.js",
+	"./array_sum.js": "./src/array_sum.js",
+	"./array_unique.js": "./src/array_unique.js",
+	"./array_unique_last.js": "./src/array_unique_last.js",
+	"./date_add_months.js": "./src/date_add_months.js",
+	"./date_is_leap_year.js": "./src/date_is_leap_year.js",
+	"./http_delete.js": "./src/http_delete.js",
+	"./http_get_blob.js": "./src/http_get_blob.js",
+	"./http_get_buffer.js": "./src/http_get_buffer.js",
+	"./http_get_json.js": "./src/http_get_json.js",
+	"./http_get_utf8.js": "./src/http_get_utf8.js",
+	"./http_head.js": "./src/http_head.js",
+	"./http_patch_json.js": "./src/http_patch_json.js",
+	"./http_post_json.js": "./src/http_post_json.js",
+	"./http_post_multipart.js": "./src/http_post_multipart.js",
+	"./http_put_buffer.js": "./src/http_put_buffer.js",
+	"./http_put_json.js": "./src/http_put_json.js",
+	"./http_put_utf8.js": "./src/http_put_utf8.js",
+	"./identity.js": "./src/identity.js",
+	"./ignore.js": "./src/ignore.js"
+};
+
+
+function webpackContext(req) {
+	var id = webpackContextResolve(req);
+	return __webpack_require__(id);
+}
+function webpackContextResolve(req) {
+	if(!__webpack_require__.o(map, req)) {
+		var e = new Error("Cannot find module '" + req + "'");
+		e.code = 'MODULE_NOT_FOUND';
+		throw e;
+	}
+	return map[req];
+}
+webpackContext.keys = function webpackContextKeys() {
+	return Object.keys(map);
+};
+webpackContext.resolve = webpackContextResolve;
+module.exports = webpackContext;
+webpackContext.id = "./src sync recursive \\b(array%7Cdate%7Chttp_delete%7Chttp_get_blob%7Chttp_get_buffer%7Chttp_get_json%7Chttp_get_utf8%7Chttp_head%7Chttp_patch_json%7Chttp_post_json%7Chttp_post_multipart%7Chttp_put_buffer%7Chttp_put_json%7Chttp_put_utf8%7Cidentity%7Cignore).*(?<%21\\.test)\\.js$";
+
+/***/ }),
+
+/***/ "./src/array_chunk.js":
+/*!****************************!*\
+  !*** ./src/array_chunk.js ***!
+  \****************************/
+/***/ ((module) => {
+
+/**
+ * Split an array into chunks.
+ *
+ * @param array
+ * @param limit
+ * @returns {*[]}
+ */
+function array_chunk(array = [], limit = 1)
+{
+    if (limit < 1) {
+        throw new Error('Limit value should be greater than 1');
+    }
+
+    const out = [];
+    for (let i = 0, end = array.length; i < end; i += limit) {
+        out.push(array.slice(i, i + limit));
+    }
+    return out;
+}
+
+module.exports = array_chunk;
+
+
+/***/ }),
+
+/***/ "./src/array_gcd.js":
+/*!**************************!*\
+  !*** ./src/array_gcd.js ***!
+  \**************************/
+/***/ ((module) => {
+
+// https://stackoverflow.com/a/39764792/1478566
+function array_gcd(array, fn = Number)
+{
+    return array.reduce((a,b) => gcd(fn(a), fn(b)));
+}
+
+// https://stackoverflow.com/a/39764792/1478566
+function gcd(a, b)
+{
+    if (b) {
+        return gcd(b, a % b);
+    }
+    return a;
+}
+
+module.exports = array_gcd;
+
+
+/***/ }),
+
+/***/ "./src/array_group.js":
+/*!****************************!*\
+  !*** ./src/array_group.js ***!
+  \****************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const array_group_map = __webpack_require__(/*! ./array_group_map */ "./src/array_group_map.js");
+
+/**
+ * Group items by common key and return an array of groups.
+ *
+ * @param array
+ * @param fn
+ * @returns {unknown[]}
+ */
+function array_group(array, fn)
+{
+    return Object.values(array_group_map(array, fn));
+}
+
+module.exports = array_group;
+
+
+/***/ }),
+
+/***/ "./src/array_group_map.js":
+/*!********************************!*\
+  !*** ./src/array_group_map.js ***!
+  \********************************/
+/***/ ((module) => {
+
+/**
+ * Group items by common key and return an object of items grouped by key.
+ *
+ * @param array
+ * @param fn
+ * @returns {{}}
+ */
+function array_group_map(array, fn)
+{
+    const out = {};
+    array.forEach(function (item) {
+        const key = fn(item);
+        out[key] = out[key] || {key, items: []};
+        out[key].items.push(item);
+    });
+    return out;
+}
+
+module.exports = array_group_map;
+
+
+/***/ }),
+
+/***/ "./src/array_index.js":
+/*!****************************!*\
+  !*** ./src/array_index.js ***!
+  \****************************/
+/***/ ((module) => {
+
+/**
+ * Usage:
+ *     array_index(items, v => v.name)
+ *
+ * Seems, there is a native way to do it:
+ *     Object.fromEntries(items.map(v => [v.name, v]));
+ */
+function array_index(array, fn)
+{
+    const out = {};
+    array.forEach(v => out[fn(v)] = v);
+    return out;
+}
+
+module.exports = array_index;
+
+
+/***/ }),
+
+/***/ "./src/array_max.js":
+/*!**************************!*\
+  !*** ./src/array_max.js ***!
+  \**************************/
+/***/ ((module) => {
+
+/**
+ * Return first among maximum values.
+ *
+ * @param array
+ * @param fn
+ */
+function array_max(array, fn = identity)
+{
+    let out = null;
+    let out_value = null;
+    array.forEach(function (item) {
+        const item_value = fn(item);
+        if (item_value > out_value || out_value === null) {
+            out = item;
+            out_value = item_value;
+        }
+    });
+    return out;
+}
+
+function identity(value)
+{
+    return value;
+}
+
+module.exports = array_max;
+
+
+/***/ }),
+
+/***/ "./src/array_min.js":
+/*!**************************!*\
+  !*** ./src/array_min.js ***!
+  \**************************/
+/***/ ((module) => {
+
+/**
+ * Return first among minimum values.
+ *
+ * @param array
+ * @param fn
+ */
+function array_min(array, fn = identity)
+{
+    let out = null;
+    let out_value = null;
+    array.forEach(function (item) {
+        const item_value = fn(item);
+        if (item_value < out_value || out_value === null) {
+            out = item;
+            out_value = item_value;
+        }
+    });
+    return out;
+}
+
+function identity(value)
+{
+    return value;
+}
+
+module.exports = array_min;
+
+
+/***/ }),
+
+/***/ "./src/array_permutations.js":
+/*!***********************************!*\
+  !*** ./src/array_permutations.js ***!
+  \***********************************/
+/***/ ((module) => {
+
+// https://stackoverflow.com/a/37580979/23502239
+function array_permutations(array)
+{
+    var length = array.length,
+        out = [array.slice()],
+        c = new Array(length).fill(0),
+        i = 1, k, p;
+
+    while (i < length) {
+        if (c[i] < i) {
+            k = i % 2 && c[i];
+            p = array[i];
+            array[i] = array[k];
+            array[k] = p;
+            ++c[i];
+            i = 1;
+            out.push(array.slice());
+        }
+        else {
+            c[i] = 0;
+            ++i;
+        }
+    }
+    return out;
+}
+
+module.exports = array_permutations;
+
+
+/***/ }),
+
+/***/ "./src/array_shuffle.js":
+/*!******************************!*\
+  !*** ./src/array_shuffle.js ***!
+  \******************************/
+/***/ ((module) => {
+
+/**
+ * Shuffles an array using Durstenfeld shuffle algorithm.
+ *
+ * Note: This function performs shuffle in-place. In order
+ * to get a shuffled copy use call slice before calling, e.g.
+ * array_shuffle(items.slice()).
+ *
+ * @param array
+ * @returns array
+ * @link https://stackoverflow.com/a/6274381/1478566
+ * @link https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle
+ */
+function array_shuffle(array)
+{
+    for (let i = array.length; --i > 0; ) {
+        const j = Math.floor(Math.random() * (i + 1));
+        const x = array[i];
+        array[i] = array[j];
+        array[j] = x;
+    }
+    return array;
+}
+
+module.exports = array_shuffle;
+
+
+/***/ }),
+
+/***/ "./src/array_sort.js":
+/*!***************************!*\
+  !*** ./src/array_sort.js ***!
+  \***************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const fcmp_strings = __webpack_require__(/*! ./fcmp_strings */ "./src/fcmp_strings.js");
+
+/**
+ * Sort items in an `array`.
+ *
+ * @param array
+ * @param fn
+ * @param fcmp
+ * @returns {*}
+ */
+function array_sort(array, fn = identity, fcmp = fcmp_strings)
+{
+    return array.sort(function (a, b) {
+        return fcmp(fn(a), fn(b));
+    });
+}
+
+function identity(v)
+{
+    return v;
+}
+
+module.exports = array_sort;
+
+
+/***/ }),
+
+/***/ "./src/array_sort_other.js":
+/*!*********************************!*\
+  !*** ./src/array_sort_other.js ***!
+  \*********************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const fcmp_strings = __webpack_require__(/*! ./fcmp_strings */ "./src/fcmp_strings.js");
+
+/**
+ * Sort items in an `array` at the same order as in `other`. Values which
+ * are not in the `other` are added to the end of the result defined by `fcmp`.
+ *
+ * @param array
+ * @param fn
+ * @param other
+ * @param fcmp
+ * @returns {*}
+ */
+function array_sort_other(array, fn, other, fcmp = fcmp_strings)
+{
+    const other_map = {};
+    other.forEach((v,i) => other_map[v] = i + 1);
+    return array.sort(function (a, b) {
+        const ax = other_map[fn(a)];
+        const bx = other_map[fn(b)];
+        if (ax && bx) {
+            return ax - bx;
+        }
+        if (ax) {
+            return -1;
+        }
+        if (bx) {
+            return 1;
+        }
+        return fcmp(a, b);
+    });
+}
+
+module.exports = array_sort_other;
+
+
+/***/ }),
+
+/***/ "./src/array_sum.js":
+/*!**************************!*\
+  !*** ./src/array_sum.js ***!
+  \**************************/
+/***/ ((module) => {
+
+function array_sum(array, fn = Number)
+{
+    let out = 0;
+    array.forEach(function (item) {
+        out += fn(item);
+    });
+    return out;
+}
+
+module.exports = array_sum;
+
+
+/***/ }),
+
+/***/ "./src/array_unique.js":
+/*!*****************************!*\
+  !*** ./src/array_unique.js ***!
+  \*****************************/
+/***/ ((module) => {
+
+function array_unique(values)
+{
+    const set = new Set();
+    return values.filter(function (item) {
+        if (set.has(item)) {
+            return false;
+        }
+        set.add(item);
+        return true;
+    });
+}
+
+module.exports = array_unique;
+
+
+/***/ }),
+
+/***/ "./src/array_unique_last.js":
+/*!**********************************!*\
+  !*** ./src/array_unique_last.js ***!
+  \**********************************/
+/***/ ((module) => {
+
+/**
+ * Return only unique values. If there are many values - prefer last one.
+ *
+ * @param array
+ * @param fn
+ * @returns {*[]}
+ */
+function array_unique_last(array, fn = identity)
+{
+    const out = [];
+    const taken = {};
+    for (let i = array.length; --i >= 0; ) {
+        const item = array[i];
+        const pk = fn(item);
+        if (!taken[pk]) {
+            taken[pk] = true;
+            out.push(item);
+        }
+    }
+    return out.reverse();
+}
+
+function identity(value)
+{
+    return value;
+}
+
+module.exports = array_unique_last;
+
+
+/***/ }),
+
+/***/ "./src/date_add_months.js":
+/*!********************************!*\
+  !*** ./src/date_add_months.js ***!
+  \********************************/
+/***/ ((module) => {
+
+/**
+ * @link https://stackoverflow.com/a/7937257
+ */
+function date_add_months(d, months)
+{
+    if (!months) {
+        return d;
+    }
+
+    // https://github.com/briannesbitt/Carbon/blob/f01cfa96468f4c38325f507ab81a4f1d2cd93cfe/src/Carbon/Traits/Units.php#L360C1-L361C1
+    // > } elseif (isset($canOverflow, $day) && $canOverflow && $day !== $date?->day) {
+    // >     $date = $date?->modify('last day of previous month');
+    // > }
+
+    const date0 = d.getDate();
+    d.setMonth(d.getMonth() + months);
+    if (d.getDate() !== date0) {
+        d.setDate(0);
+    }
+
+    return d;
+}
+
+module.exports = date_add_months;
+
+
+/***/ }),
+
+/***/ "./src/date_is_leap_year.js":
+/*!**********************************!*\
+  !*** ./src/date_is_leap_year.js ***!
+  \**********************************/
+/***/ ((module) => {
+
+/**
+ * @link https://github.com/moment/moment/blob/18aba135ab927ffe7f868ee09276979bed6993a6/src/lib/utils/is-leap-year.js
+ * @link https://en.wikipedia.org/wiki/Leap_year
+ * > Each leap year has 366 days instead of 365. This extra leap day
+ * > occurs in each year that is a multiple of 4, except for years
+ * > evenly divisible by 100 but not by 400.
+ */
+function date_is_leap_year(d)
+{
+    const year = d.getFullYear();
+    // return (year % 4 === 0) && !(year % 100 === 0 && year % 400 !== 0);
+    return (year % 4 === 0 && year % 100 !== 0) || (year % 400 === 0);
+}
+
+module.exports = date_is_leap_year;
+
+
+/***/ }),
+
+/***/ "./src/fcmp_strings.js":
+/*!*****************************!*\
+  !*** ./src/fcmp_strings.js ***!
+  \*****************************/
+/***/ ((module) => {
+
+function fcmp_strings(a, b)
+{
+    return String(a).localeCompare(b);
+}
+
+module.exports = fcmp_strings;
+
+
+/***/ }),
+
+/***/ "./src/http_delete.js":
+/*!****************************!*\
+  !*** ./src/http_delete.js ***!
+  \****************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_delete(url, options)
+{
+    return axios.delete(url, {responseType: 'json', ...options}).then(v => v.data);
+}
+
+module.exports = http_delete;
+
+
+/***/ }),
+
+/***/ "./src/http_get_blob.js":
+/*!******************************!*\
+  !*** ./src/http_get_blob.js ***!
+  \******************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_get_blob(url, options)
+{
+    return axios.get(url, {responseType: 'blob', ...options}).then(v => v.data);
+}
+
+module.exports = http_get_blob;
+
+
+/***/ }),
+
+/***/ "./src/http_get_buffer.js":
+/*!********************************!*\
+  !*** ./src/http_get_buffer.js ***!
+  \********************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_get_buffer(url, options)
+{
+    return axios.get(url, {responseType: 'arraybuffer', ...options}).then(v => v.data);
+}
+
+module.exports = http_get_buffer;
+
+
+/***/ }),
+
+/***/ "./src/http_get_json.js":
+/*!******************************!*\
+  !*** ./src/http_get_json.js ***!
+  \******************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_get_json(url, options)
+{
+    return axios.get(url, {responseType: 'json', ...options}).then(v => v.data);
+}
+
+module.exports = http_get_json;
+
+
+/***/ }),
+
+/***/ "./src/http_get_utf8.js":
+/*!******************************!*\
+  !*** ./src/http_get_utf8.js ***!
+  \******************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_get_utf8(url, options)
+{
+    return axios.get(url, {responseType: 'text', responseEncoding: 'utf8', ...options}).then(v => v.data);
+}
+
+module.exports = http_get_utf8;
+
+
+/***/ }),
+
+/***/ "./src/http_head.js":
+/*!**************************!*\
+  !*** ./src/http_head.js ***!
+  \**************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_head(url, options)
+{
+    return axios.head(url, options).then(v => v.request.res.headers);
+}
+
+module.exports = http_head;
+
+
+/***/ }),
+
+/***/ "./src/http_patch_json.js":
+/*!********************************!*\
+  !*** ./src/http_patch_json.js ***!
+  \********************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_patch_json(url, body, options)
+{
+    return axios.patch(url, body, options).then(v => v.data);
+}
+
+module.exports = http_patch_json;
+
+
+/***/ }),
+
+/***/ "./src/http_post_json.js":
+/*!*******************************!*\
+  !*** ./src/http_post_json.js ***!
+  \*******************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_post_json(url, body, options)
+{
+    return axios.post(url, body, options).then(v => v.data);
+}
+
+module.exports = http_post_json;
+
+
+/***/ }),
+
+/***/ "./src/http_post_multipart.js":
+/*!************************************!*\
+  !*** ./src/http_post_multipart.js ***!
+  \************************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const FormData = __webpack_require__(/*! form-data */ "form-data");
+const axios = __webpack_require__(/*! axios */ "axios");
+
+// Provide examples for the following common tasks:
+//
+// * send plain text
+// * send json
+// * send image
+// * send attachment
+
+// import fetch from 'node-fetch';
+//
+// async function http_post_multipart(url, rows)
+// {
+//     const form = new FormData();
+//     for (let i = 0, end = rows.length; i < end; ++i) {
+//         const {name, body} = rows[i];
+//         form.append(name, body);
+//     }
+//     return await fetch(url, {method: 'POST', body: form});
+// }
+//
+// Example:
+//
+// const rows = [];
+// rows.push({name: 'from', body: MAILGUN_FROM});
+// rows.push({name: 'to', body: to});
+// rows.push({name: 'subject', body: subject});
+// rows.push({name: 'text', body: text});
+// rows.push({name: 'attachment', body: fs_read_stream(__filename), options: {filename: 'hello.txt'}});
+// return http_post_multipart(`${MAILGUN_BASE}/messages`, rows, options);
+
+// https://github.com/axios/axios/issues/318#issuecomment-344620216
+// https://github.com/axios/axios/issues/1006#issuecomment-320165427
+function http_post_multipart(url, items, options)
+{
+    const form = new FormData();
+    for (let i = 0, end = items.length; i < end; ++i) {
+        const item = items[i];
+        // Without this, all string vales (ordinary fields) will
+        // be empty in _Chrome 59.0.3071.86 (Official Build) (64-bit)_
+        if (item.options) {
+            form.append(item.name, item.body, item.options);
+        }
+        else {
+            form.append(item.name, item.body);
+        }
+    }
+    // For Node
+    // import FormData from 'form-data'
+    // noinspection JSUnresolvedVariable
+    if (form.getHeaders) {
+        const options2 = {...options};
+        options2.headers = {...options2.headers, ...form.getHeaders()};
+        return Promise.resolve(axios.post(url, form, options2)).then(v => v.data);
+    }
+    // For Browser
+    // webpack.config.js
+    //   externals: {"form-data": "FormData"}
+    return Promise.resolve(axios.post(url, form, options)).then(v => v.data);
+}
+
+module.exports = http_post_multipart;
+
+
+/***/ }),
+
+/***/ "./src/http_put_buffer.js":
+/*!********************************!*\
+  !*** ./src/http_put_buffer.js ***!
+  \********************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_put_buffer(url, body, options)
+{
+    return axios.put(url, body, options).then(v => v.data);
+}
+
+module.exports = http_put_buffer;
+
+
+/***/ }),
+
+/***/ "./src/http_put_json.js":
+/*!******************************!*\
+  !*** ./src/http_put_json.js ***!
+  \******************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+function http_put_json(url, body, options)
+{
+    return axios.put(url, body, options).then(v => v.data);
+}
+
+module.exports = http_put_json;
+
+
+/***/ }),
+
+/***/ "./src/http_put_utf8.js":
+/*!******************************!*\
+  !*** ./src/http_put_utf8.js ***!
+  \******************************/
+/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
+
+const axios = __webpack_require__(/*! axios */ "axios");
+
+async function http_put_utf8(url, utf8, options)
+{
+    return axios.put(url, utf8, options).then(v => v.data);
+}
+
+module.exports = http_put_utf8;
+
+
+/***/ }),
+
+/***/ "./src/identity.js":
+/*!*************************!*\
+  !*** ./src/identity.js ***!
+  \*************************/
+/***/ ((module) => {
+
+function identity(value)
+{
+    return value;
+}
+
+module.exports = identity;
+
+
+/***/ }),
+
+/***/ "./src/ignore.js":
+/*!***********************!*\
+  !*** ./src/ignore.js ***!
+  \***********************/
+/***/ ((module) => {
+
+function ignore()
+{
+}
+
+module.exports = ignore;
+
+
+/***/ }),
+
+/***/ "axios":
+/*!************************!*\
+  !*** external "axios" ***!
+  \************************/
+/***/ ((module) => {
+
+"use strict";
+module.exports = axios;
+
+/***/ }),
+
+/***/ "form-data":
+/*!***************************!*\
+  !*** external "FormData" ***!
+  \***************************/
+/***/ ((module) => {
+
+"use strict";
+module.exports = FormData;
+
+/***/ })
+
+/******/ 	});
+/************************************************************************/
+/******/ 	// The module cache
+/******/ 	var __webpack_module_cache__ = {};
+/******/ 	
+/******/ 	// The require function
+/******/ 	function __webpack_require__(moduleId) {
+/******/ 		// Check if module is in cache
+/******/ 		var cachedModule = __webpack_module_cache__[moduleId];
+/******/ 		if (cachedModule !== undefined) {
+/******/ 			return cachedModule.exports;
+/******/ 		}
+/******/ 		// Create a new module (and put it into the cache)
+/******/ 		var module = __webpack_module_cache__[moduleId] = {
+/******/ 			// no module.id needed
+/******/ 			// no module.loaded needed
+/******/ 			exports: {}
+/******/ 		};
+/******/ 	
+/******/ 		// Execute the module function
+/******/ 		__webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+/******/ 	
+/******/ 		// Return the exports of the module
+/******/ 		return module.exports;
+/******/ 	}
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+// This entry needs to be wrapped in an IIFE because it needs to be isolated against other modules in the chunk.
+(() => {
+/*!******************************!*\
+  !*** ./src/browser/index.js ***!
+  \******************************/
+// https://github.com/webpack/webpack/issues/625
+// https://webpack.js.org/guides/dependency-management/#require-context
+const require_tmp = __webpack_require__("./src sync recursive \\b(array%7Cdate%7Chttp_delete%7Chttp_get_blob%7Chttp_get_buffer%7Chttp_get_json%7Chttp_get_utf8%7Chttp_head%7Chttp_patch_json%7Chttp_post_json%7Chttp_post_multipart%7Chttp_put_buffer%7Chttp_put_json%7Chttp_put_utf8%7Cidentity%7Cignore).*(?<%21\\.test)\\.js$");
+require_tmp.keys().forEach(function (key) {
+    const [, basename] = key.match(/([^/]+)\.js$/);
+    window[basename] = require_tmp(key);
+});
+
+})();
+
+/******/ })()
+;

package/dist/index.html

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <link href="https://unpkg.com/@vbarbarosh/smcss@1.2.0/dist/reset.css" rel="stylesheet">
+    <link href="https://unpkg.com/@vbarbarosh/smcss@1.2.0/dist/sm.css" rel="stylesheet">
+    <title>@vbarbarsh/node-helpers</title>
+</head>
+<body>
+
+<div id="app"></div>
+
+<script src="https://unpkg.com/axios@1.7.9/dist/axios.js"></script>
+<script src="https://unpkg.com/bluebird@3.7.2/js/browser/bluebird.js"></script>
+<script src="browser.js"></script>
+
+</body>
+</html>

package/package.json

@@ -2,13 +2,18 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.61.0",
+    "version": "3.63.0",
     "description": "A set of helpers for JavaScript/Node.js",
+    "unpkg": "dist/browser.js",
+    "jsdelivr": "dist/browser.js",
+    "homepage": "https://vbarbarosh.github.io/node-helpers/",
     "files": [
+        "dist",
         "src"
     ],
     "scripts": {
-        "test": "echo \"Error: no test specified\" && exit 1"
+        "build": "rm -rf dist; webpack",
+        "test": "mocha src/**/*.test.js"
     },
     "keywords": [
         "js",
@@ -29,17 +34,22 @@
         "form-data": "^4.0.1",
         "htmlparser2": "^10.0.0",
         "json-stable-stringify": "^1.2.1",
+        "json-stringify-safe": "^5.0.1",
         "mime-types": "^2.1.35",
         "sanitize-filename": "^1.6.3",
         "split": "^1.0.1",
         "ssh2": "^1.16.0"
     },
     "devDependencies": {
+        "copy-webpack-plugin": "^12.0.2",
+        "express": "^4.21.2",
         "mocha": "^11.0.1",
         "redis-v1": "npm:redis@1",
         "redis-v2": "npm:redis@2",
         "redis-v3": "npm:redis@3",
         "redis-v4": "npm:redis@4",
-        "throttle": "^1.0.3"
+        "throttle": "^1.0.3",
+        "webpack": "^5.98.0",
+        "webpack-cli": "^6.0.1"
     }
 }

package/src/array_unique.js

@@ -0,0 +1,13 @@
+function array_unique(values)
+{
+    const set = new Set();
+    return values.filter(function (item) {
+        if (set.has(item)) {
+            return false;
+        }
+        set.add(item);
+        return true;
+    });
+}
+
+module.exports = array_unique;

package/src/browser/index.js

@@ -0,0 +1,7 @@
+// https://github.com/webpack/webpack/issues/625
+// https://webpack.js.org/guides/dependency-management/#require-context
+const require_tmp = require.context('..', true, /\b(array|date|http_delete|http_get_blob|http_get_buffer|http_get_json|http_get_utf8|http_head|http_patch_json|http_post_json|http_post_multipart|http_put_buffer|http_put_json|http_put_utf8|identity|ignore).*(?<!\.test)\.js$/);
+require_tmp.keys().forEach(function (key) {
+    const [, basename] = key.match(/([^/]+)\.js$/);
+    window[basename] = require_tmp(key);
+});

package/src/camel_to_snake.js

@@ -0,0 +1,9 @@
+function camel_to_snake(s)
+{
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')  // Insert underscore between lowercase/number and uppercase
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2') // Separate acronyms from regular CamelCase words
+        .toLowerCase();
+}
+
+module.exports = camel_to_snake;

package/src/camel_to_snake.test.js

@@ -0,0 +1,17 @@
+const assert = require('assert');
+const camel_to_snake = require('./camel_to_snake');
+
+const items = [
+    ['UPC', 'upc'],
+    ['CamelCase', 'camel_case'],
+    ['SomeUPCCode', 'some_upc_code'],
+    ['XMLHTTPRequest', 'xmlhttp_request'],
+];
+
+describe('camel_to_snake', function () {
+    items.forEach(function ([input, expected],) {
+        it(`${input === '' ? '☒' : input} → ${expected}`, function () {
+            assert.deepStrictEqual(camel_to_snake(input), expected);
+        });
+    });
+});

package/src/format_error_report.d/src/1.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+const axios = require('axios');
+const cli = require('../../cli');
+const express = require('express');
+const fs_path_resolve = require('../../fs_path_resolve');
+const fs_write = require('../../fs_write');
+const json_stringify_safe = require('../../json_stringify_safe');
+
+cli(main);
+
+async function main()
+{
+    const app = express();
+    app.get('/', (req, res) => {});
+    const server = app.listen(3000);
+
+    try {
+        await axios('http://127.0.0.1:3000', {timeout: 1});
+    }
+    catch (error) {
+        await fs_write(fs_path_resolve(__dirname, '../1.json'), json_stringify_safe(error, null, 4).replaceAll(fs_path_resolve(__dirname, '../../../..'), '/app'));
+    }
+
+    server.close();
+}

package/src/format_error_report.d/src/2.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const axios = require('axios');
+const cli = require('../../cli');
+const express = require('express');
+const fs_path_resolve = require('../../fs_path_resolve');
+const fs_write = require('../../fs_write');
+const json_stringify_safe = require('../../json_stringify_safe');
+
+cli(main);
+
+async function main()
+{
+    const app = express();
+    app.post('/fail', function (req, res) {
+        throw new Error('Some Error Here');
+    });
+    const server = app.listen(3000);
+
+    try {
+        await axios.post('http://127.0.0.1:3000/fail');
+    }
+    catch (error) {
+        console.log(error);
+        await fs_write(fs_path_resolve(__dirname, '../2.json'), json_stringify_safe(error, null, 4).replaceAll(fs_path_resolve(__dirname, '../../../..'), '/app'));
+    }
+
+    server.close();
+}

package/src/format_error_report.js

@@ -0,0 +1,65 @@
+const json_stringify_safe = require('./json_stringify_safe');
+
+function format_error_report(error)
+{
+    if (!error) {
+        return json_stringify_safe({error: error === undefined ? '---undefined---' : error});
+    }
+
+    if (error.response?.status && error.response?.statusText && error.response?.config) {
+        return fm_axios_response(error);
+    }
+
+    if (error.config) {
+        return fm_axios_config(error);
+    }
+
+    return json_stringify_safe({
+        code: error.code,
+        name: error.name,
+        message: error.message ?? 'n/a',
+        stack: error.stack && error.stack.split(/\n\s*/)
+    }, null, 4);
+}
+
+function fm_axios_response(error)
+{
+    return `
+${error.message ?? 'n/a'}
+
+--- REQUEST ---
+
+${(error.response.config.method||'').toUpperCase()} ${error.response.config.url}
+
+${JSON.stringify(error.response.config.headers||{}, null, 4).slice(1, -1).replace(/^\s+|,$/mg, '').trim()}
+
+--- RESPONSE ---
+
+${error.response.status} ${error.response.statusText}
+
+${(error.response.data.toString()||'').slice(0, 10240) || 'n/a'}
+
+--- STACK ---
+
+${error.stack ? error.stack.split(/\\n\\s*/) : 'n/a'}
+`.trimStart();
+}
+
+function fm_axios_config(error)
+{
+    return `
+${error.message ?? 'n/a'}
+
+--- REQUEST ---
+
+${(error.config.method||'').toUpperCase()} ${error.config.url}
+
+${JSON.stringify(error.config.headers||{}, null, 4).slice(1, -1).replace(/^\s+|,$/mg, '').trim()}
+
+--- STACK ---
+
+${error.stack ? error.stack.split(/\\n\\s*/) : 'n/a'}
+`.trimStart();
+}
+
+module.exports = format_error_report;

package/src/json_stringify_safe.js

@@ -0,0 +1,3 @@
+const json_stringify_safe = require('json-stringify-safe');
+
+module.exports = json_stringify_safe;

package/src/sanitize_var_name.js

@@ -1,8 +1,9 @@
+const camel_to_snake = require('./camel_to_snake');
 const sanitize_dash_name = require('./sanitize_dash_name');
 
 function sanitize_var_name(var_name)
 {
-    const out = sanitize_dash_name(var_name).replace(/[^a-z0-9]+/g, '_');
+    const out = sanitize_dash_name(camel_to_snake(var_name)).replace(/[^a-z0-9]+/g, '_');
     if (out.length === 0) {
         return '_';
     }

package/src/sanitize_var_name.test.js

@@ -11,6 +11,23 @@ const items = [
     ['Ópera Prima', 'opera_prima'],
     ['1000-stories', '_1000_stories'],
     ['A, C, D', 'a_c_d'],
+    ['@odata.etag', 'odata_etag'],
+    ['ItemInternalId', 'item_internal_id'],
+    ['UPC', 'upc'],
+    ['Sale_price', 'sale_price'],
+    ['% de disponibilidad de tiendas', 'de_disponibilidad_de_tiendas'],
+    ['%Tiendas con precio moda', 'tiendas_con_precio_moda'],
+
+    // https://stackoverflow.com/questions/30521224/javascript-convert-pascalcase-to-underscore-case-snake-case
+    ['TypeOfData.AlphaBeta', 'type_of_data_alpha_beta'],
+    ['thisISDifficult', 'this_is_difficult'],
+    ['thisISNT', 'this_isnt'],
+    ['thisISNT', 'this_isnt'],
+    ['somethingEasyLikeThis', 'something_easy_like_this'],
+
+    // https://github.com/Advanon/sanitize-s3-objectkey
+    // https://github.com/hamxabaig/s3-filename
+    // ['some  漢字 ćööł %  #fíłéñàmé.jpg', 'some_cool_filename_jpg'],
 ];
 
 describe('sanitize_var_name', function () {