@vbarbarosh/node-helpers 3.76.1 → 3.77.0

package/README.md

@@ -20,7 +20,7 @@ npm install @vbarbarosh/node-helpers
 A subset of `@vbarbarosh/node-helpers` is available for browser:
 
 ```html
-<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.76.1/dist/browser.js"></script>
+<script src="https://unpkg.com/@vbarbarosh/node-helpers@3.77.0/dist/browser.js"></script>
 ```
 
 ⚠️ All browser functions are exposed globally.

package/dist/browser.js

@@ -1 +1 @@
-(()=>{var t={932(t){t.exports=function(t){return"number"==typeof t&&isFinite(t)}},5392(t,e,n){const r=n(932);t.exports=function(t,e){return r(t)&&t>e}},4106(t,e){function n(t,e){var n=[],r=[];return null==e&&(e=function(t,e){return n[0]===e?"[Circular ~]":"[Circular ~."+r.slice(0,n.indexOf(e)).join(".")+"]"}),function(o,s){if(n.length>0){var u=n.indexOf(this);~u?n.splice(u+1):n.push(this),~u?r.splice(u,1/0,o):r.push(o),~n.indexOf(s)&&(s=e.call(this,o,s))}else n.push(s);return null==t?s:t.call(this,o,s)}}(t.exports=function(t,e,r,o){return JSON.stringify(t,n(e,o),r)}).getSerialize=n},6083(t){t.exports=function(t=[],e=1){if(e<1)throw new Error("Limit value should be at least 1");const n=[];for(let r=0,o=t.length;r<o;r+=e)n.push(t.slice(r,r+e));return n}},2458(t,e,n){const r=n(7727);t.exports=function(t=[],e=1,n=1){const o=r(1,e,Math.floor(t.length/n)),s=Math.floor(t.length/o);let u=t.length%o;const c=[];for(let e=0;e<t.length;){const n=s+(u?1:0);c.push(t.slice(e,e+n)),e+=n,u&&u--}return c}},353(t,e,n){const r=n(4476),o=1e-5;t.exports=function(t,e){const n=Math.floor(t*e);if(n<=1)return[0];const s=[];for(let e=0;e<n;++e)s.push(r(e/(n-1)*(t-o),o));return s}},6372(t,e,n){const r=n(6785);t.exports=function(t,e=Number){return t.map(t=>e(t)).reduce((t,e)=>r(t,e),0)}},3537(t){t.exports=function(t,e){const n=new Map;return t.forEach(function(t){const r=e(t);n.has(r)||n.set(r,{key:r,items:[]}),n.get(r).items.push(t)}),n.values().toArray()}},2976(t){t.exports=function(t,e){const n={};return t.forEach(function(t){const r=e(t);n[r]=n[r]||{key:r,items:[]},n[r].items.push(t)}),n}},2166(t,e,n){const r=n(956);t.exports=function(t,e=r){const n={};return t.forEach(t=>n[e(t)]=t),n}},7866(t,e,n){const r=n(7347);t.exports=function(t,e=Number){return t.map(t=>e(t)).reduce((t,e)=>r(t,e),1)}},6772(t,e,n){const r=n(956);t.exports=function(t,e=r){let n=null,o=null,s=!1;return t.forEach(function(t){const r=e(t);Number.isNaN(r)||(!s||o<r)&&(s=!0,o=r,n=t)}),n}},42(t,e,n){const r=n(956);t.exports=function(t,e=r){let n=null,o=null,s=!1;return t.forEach(function(t){const r=e(t);Number.isNaN(r)||(!s||o>r)&&(s=!0,o=r,n=t)}),n}},3685(t){t.exports=function t(e,n=e.length){if(n!==e.length)return function(e,n){if(0===n)return[[]];if(e.length<n)return[];const r=[];for(let o=0;o<e.length;o++){const s=e.slice(0,o).concat(e.slice(o+1));for(const u of t(s,n-1))r.push([e[o],...u])}return r}(e,n);let r,o,s=(e=e.slice()).length,u=[e.slice()],c=new Array(s).fill(0),a=1;for(;a<s;)c[a]<a?(r=a%2&&c[a],o=e[a],e[a]=e[r],e[r]=o,++c[a],a=1,u.push(e.slice())):(c[a]=0,++a);return u}},4943(t){t.exports=function(t){for(let e=t.length;--e>0;){const n=Math.floor(Math.random()*(e+1)),r=t[e];t[e]=t[n],t[n]=r}return t}},2356(t,e,n){const r=n(8310),o=n(4332);t.exports=function(t,e,n=r){const s=new Map;return t.sort(function(t,r){if(!s.has(t)){const n=e(t);s.set(t,Array.isArray(n)?n:[n])}if(!s.has(r)){const t=e(r);s.set(r,Array.isArray(t)?t:[t])}return o(s.get(t),s.get(r),n)})}},5181(t,e,n){const r=n(8310);t.exports=function(t,e,n,o=r){const s=Object.create(null);return n.forEach((t,e)=>s[t]=e+1),t.sort(function(t,n){const r=s[e(t)],u=s[e(n)];return r&&u?r-u:r?-1:u?1:o(t,n)})}},453(t){t.exports=function(t,e=Number){let n=0;return t.forEach(function(t){n+=e(t)}),n}},3523(t,e,n){const r=n(956);t.exports=function(t,e=r){const n=new Set;return t.filter(function(t){const r=e(t);return!n.has(r)&&(n.add(r),!0)})}},6382(t,e,n){const r=n(956);t.exports=function(t,e=r){const n=[],o=new Set;for(let r=t.length;--r>=0;){const s=t[r],u=e(s);o.has(u)||(o.add(u),n.push(s))}return n.reverse()}},7727(t){t.exports=function(t,e,n){return Math.max(t,Math.min(e,n))}},9870(t){t.exports=function(t,e){return t.setHours(t.getHours()+e),t}},5799(t){t.exports=function(t,e){return t.setMilliseconds(t.getMilliseconds()+e),t}},3160(t){t.exports=function(t,e){return t.setMinutes(t.getMinutes()+e),t}},1570(t){t.exports=function(t,e){if(!e)return t;const n=t.getDate();return t.setMonth(t.getMonth()+e),t.getDate()!==n&&t.setDate(0),t}},9296(t){t.exports=function(t,e){return t.setSeconds(t.getSeconds()+e),t}},5488(t){t.exports=function(t,e){return Math.floor((t.getTime()-e.getTime())/1e3)}},3752(t){t.exports=function(t){const e=t.getFullYear();return e%4==0&&e%100!=0||e%400==0}},3150(t){t.exports=function(t){return t=Math.trunc(Math.abs(t)),[Math.floor(t/36e5),Math.floor(t%36e5/6e4),Math.floor(t%6e4/1e3),t%1e3]}},2806(t){t.exports=function(t,e){return t.getTime()-e.getTime()}},8310(t,e,n){const r=n(7668);t.exports=function(t,e){return"string"==typeof t&&"string"==typeof e?r(t,e):t<e?-1:t>e?1:0}},2092(t,e,n){const r=n(8310);t.exports=function(t,e){return r(e,t)}},3553(t){function e(t){return"-"===t[0]?(t=t.slice(1),function(e,r){return n(r[t],e[t])}):function(e,r){return n(e[t],r[t])}}function n(t,e){return"string"==typeof t&&"string"==typeof e?t.localeCompare(e):t-e}t.exports=function(t){const n=t.map(e);switch(n.length){case 0:return()=>0;case 1:return n[0];case 2:return function(t,e){return n[0](t,e)||n[1](t,e)};case 3:return function(t,e){return n[0](t,e)||n[1](t,e)||n[2](t,e)};default:return function(t,e){for(let r=0;r<n.length;++r){const o=n[r](t,e);if(o)return o}return 0}}}},3129(t){t.exports=function(t,e){return t-e}},4332(t,e,n){const r=n(8310);t.exports=function(t,e,n=r){const o=Math.min(t.length,e.length);for(let r=0;r<o;++r){const o=n(t[r],e[r]);if(o)return o}return 0}},3106(t){t.exports=function(t,e){return t<e?-1:t>e?1:0}},2271(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{sensitivity:"base"})}},4457(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{sensitivity:"variant"})}},7668(t){function e(t,e){const r=t.replace(/^0+/,""),o=e.replace(/^0+/,"");return r.length-o.length||n(r,o)||t.length-e.length}function n(t,e){return t<e?-1:t>e?1:0}t.exports=function(t,r){const o=t.match(/\d+|\D+/g)||[],s=r.match(/\d+|\D+/g)||[],u=Math.min(o.length,s.length);for(let t=0;t<u;++t){const r=o[t][0]<="9"&&s[t][0]<="9"&&o[t][0]>="0"&&s[t][0]>="0"?e(o[t],s[t]):n(o[t],s[t]);if(r)return r}return o.length-s.length}},4385(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{numeric:!0,sensitivity:"base"})}},8951(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{numeric:!0,sensitivity:"variant"})}},4734(t,e,n){const r=n(8310),o=n(2092),s=n(956),u=Symbol("fcmpx.missing");function c(t){const{read:e,fcmp:n}=a(t);return function(t,r){return n(e(t),e(r))}}function a(t){if("function"==typeof t)return{read:i(t),fcmp:f(r)};if("string"==typeof t){const e=t.startsWith("-");return{read:i(e?t.slice(1):t),fcmp:f(e?o:r)}}const e=t.fcmp,n=i(t.read),s=f(t.desc?e?(t,n)=>e(n,t):o:e??r);if(Array.isArray(t.top)){const e=new Map(t.top.map((t,e)=>[t,e]));return{read:t=>e.get(n(t))??e.size,fcmp:s}}if(Array.isArray(t.bottom)){const e=new Map(t.bottom.map((t,e)=>[t,e]));return{read:t=>e.get(n(t))??-1,fcmp:s}}return{read:n,fcmp:s}}function i(t){if(void 0===t||""===t||"."===t)return s;if("function"==typeof t)return function(e){return t(e)??u};if("string"==typeof t){const e=t.split("."),[n,r,o,s,c]=e;switch(e.length){case 1:return t=>t?.[n]??u;case 2:return t=>t?.[n]?.[r]??u;case 3:return t=>t?.[n]?.[r]?.[o]??u;case 4:return t=>t?.[n]?.[r]?.[o]?.[s]??u;case 5:return t=>t?.[n]?.[r]?.[o]?.[s]?.[c]??u;default:return t=>e.reduce((t,e)=>t?.[e],t)??u}}return e=>e?.[t]??u}function f(t){return function(e,n){return e===u?n===u?0:1:n===u?-1:t(e,n)}}t.exports=function t(e){if("string"==typeof e)return e.includes(",")?t(e.split(",")):c(e);if(!Array.isArray(e))return c(e);const n=e.map(a);return function(t,e){const r=n.map(e=>e.read(t)),o=n.map(t=>t.read(e));for(let t=0;t<n.length;++t){const e=n[t].fcmp(r[t],o[t]);if(e)return e}return 0}}},7960(t){function e(t){let e,n,r;return e=t.replaceAll("^",""),n=e.length!==t.length,e=(t=e).replaceAll("$",""),r=e.length!==t.length,e=(t=e).replaceAll("!",""),(t.length-e.length)%2?n&&r?t=>!(t.startsWith(e)&&t.endsWith(e)):n?t=>!t.startsWith(e):r?t=>!t.endsWith(e):t=>!t.includes(e):n&&r?t=>t.startsWith(e)&&t.endsWith(e):n?t=>t.startsWith(e):r?t=>t.endsWith(e):t=>t.includes(e)}t.exports=function(t){let n,r,o,s;const u=function(t){return t.split("/").filter(t=>t).map(e)}(t);switch(u.length){case 0:return()=>!0;case 1:return u[0];case 2:return[n,r]=u,t=>n(t)&&r(t);case 3:return[n,r,o]=u,t=>n(t)&&r(t)&&o(t);case 4:return[n,r,o,s]=u,t=>n(t)&&r(t)&&o(t)&&s(t);default:return t=>u.every(e=>e(t))}}},6017(t){t.exports=function(t){if("number"!=typeof t||Number.isNaN(t))return"n/a";if(!t)return"0KB";if(t<1024)return"1KB";const e=Math.floor(Math.log(t)/Math.log(1024));return`${(t/1024**e).toFixed(t>1048576?2:0)}${["B","KB","MB","GB","TB","PB"][e]}`.replace(/\.00/,".0")}},1284(t){t.exports=function(t){return t.getFullYear()+`/0${t.getMonth()+1}/0${t.getDate()} 0${t.getHours()}:0${t.getMinutes()}:0${t.getSeconds()}`.replace(/0(\d\d)/g,"$1")}},5224(t){function e(t){return t>9?`${t}`:`0${t}`}t.exports=function(t){return t.getFullYear()+e(t.getMonth()+1)+e(t.getDate())+"_"+(e(t.getHours())+e(t.getMinutes())+e(t.getSeconds()))}},1690(t){function e(t){return t>9?`${t}`:`0${t}`}t.exports=function(t){return t.getFullYear()+"/"+e(t.getMonth()+1)+"/"+e(t.getDate())+" "+e(t.getHours())+":"+e(t.getMinutes())+":"+e(t.getSeconds())}},6997(t){t.exports=function(t){return t.getFullYear()+`/0${t.getMonth()+1}/0${t.getDate()}`.replace(/0(\d\d)/g,"$1")}},9009(t,e,n){const r=n(3332);t.exports=function(t){return t?t.response?.status&&t.response?.statusText&&t.response?.config?function(t){return`\n${t.message??"n/a"}\n\n--- REQUEST ---\n\n${(t.response.config.method||"").toUpperCase()} ${t.response.config.url}\n\n${JSON.stringify(t.response.config.headers||{},null,4).slice(1,-1).replace(/^\s+|,$/gm,"").trim()}\n\n--- RESPONSE ---\n\n${t.response.status} ${t.response.statusText}\n\n${String(t.response.data??"").slice(0,10240)||"n/a"}\n\n--- STACK ---\n\n${t.stack??"n/a"}\n`.trimStart()}(t):t.config?function(t){return`\n${t.message??"n/a"}\n\n--- REQUEST ---\n\n${(t.config.method||"").toUpperCase()} ${t.config.url}\n\n${JSON.stringify(t.config.headers||{},null,4).slice(1,-1).replace(/^\s+|,$/gm,"").trim()}\n\n--- STACK ---\n\n${t.stack??"n/a"}\n`.trimStart()}(t):r({code:t.code,name:t.name,message:t.message??"n/a",stack:t.stack&&t.stack.split(/\n\s*/)},null,4):r({error:void 0===t?"---undefined---":t})}},6015(t){t.exports=function(t,e=6){const[n,r]=t;return(n+r/1e9).toFixed(e)+"s"}},4153(t){t.exports=function(t){if("number"!=typeof t||Number.isNaN(t))return"n/a";if(!t)return"0";if(t<1e3)return t.toFixed(0);const e=parseInt(Math.floor(Math.log(t)/Math.log(1e3)),10);return`${(t/1e3**e).toFixed(2)}${["","K","M","G","T","P"][e]}`}},1120(t,e,n){const r=n(3150);t.exports=function(t){t||(t=0);const e=t<0?"-":"",[n,o,s]=r(t);return n?e+`0${n}:0${o}:0${s}`.replace(/0+(?=\d\d)/g,""):e+`0${o}:0${s}`.replace(/0+(?=\d\d)/g,"")}},7336(t,e,n){const r=n(3150);t.exports=function(t){t||(t=0);const e=t<0?"-":"",[n,o,s,u]=r(10*Math.round(Math.abs(t)/10));return n?e+`0${n}:0${o}:0${s}.0${u/10}`.replace(/0+(?=\d\d)/g,""):e+`0${o}:0${s}.0${u/10}`.replace(/0+(?=\d\d)/g,"")}},495(t,e,n){const r=n(3150);t.exports=function(t,e=!1){t||(t=0);const n=t<0?"-":"",[o,s,u,c]=r(t);return o||e?n+`0${o}:0${s}:0${u}.00${c}`.replace(/0+(?=\d\d+[:.]|\d\d\d)/g,""):n+`0${s}:0${u}.00${c}`.replace(/0+(?=\d\d+[:.]|\d\d\d)/g,"")}},7882(t){t.exports=function(t){return(100*t).toFixed(2).replace(/^(0|100).00$/,"$1")+"%"}},7111(t,e,n){const r=n(6017),o=n(7882),s=n(3527),u=n(5392);t.exports=function({percents:t,total:e,done:n,rate:c,eta:a,duration:i}){const f=u(c,0)?`${r(c)}/s`:"~";if(n>e)return`${r(n)} at ${f} duration=${s(i)}`;if(u(e,0)){const c=u(a,0)?s(a):"~";return`${o(t)} | ${r(n)} of ${r(e)} at ${f} ETA ${c} duration=${s(i)}`}return u(n,0)?`${r(n)} of ~ at ${f} duration=${s(i)}`:u(i,0)?`~ duration=${s(i)}`:"~"}},5051(t,e,n){const r=n(4153),o=n(7882),s=n(3527),u=n(5392);t.exports=function({percents:t,total:e,done:n,rate:c,eta:a,duration:i}){const f=u(c,0)?`${r(c)}/s`:"~";if(n>e)return`${r(n)} at ${f} duration=${s(i)}`;if(u(e,0)){const c=u(a,0)?s(a):"~";return`${o(t)} | ${r(n)} of ${r(e)} at ${f} ETA ${c} duration=${s(i)}`}return u(n,0)?`${r(n)} of ~ at ${f} duration=${s(i)}`:u(i,0)?`~ duration=${s(i)}`:"~"}},3527(t){t.exports=function(t){const e=Math.abs(Math.trunc(t)),n=`0${Math.floor(e/60/60)}:0${Math.floor(e/60)%60}:0${e%60}`.replace(/0(\d\d)/g,"$1");return t<=-1?"-"+n:n}},2677(t){t.exports=function(t){return t.toString().replace(/\B(?<!\.\d*)(?=(\d{3})+(?!\d))/g,",")}},4206(t,e,n){const r=n(3719);t.exports=function(t,e){return r.delete(t,{responseType:"json",...e}).then(t=>t.data)}},4131(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"blob",...e}).then(t=>t.data)}},706(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"arraybuffer",...e}).then(t=>t.data)}},3066(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"json",...e}).then(t=>t.data)}},3019(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"text",responseEncoding:"utf8",...e}).then(t=>t.data)}},7379(t,e,n){const r=n(3719);t.exports=function(t,e){return r.head(t,e).then(t=>t.request.res.headers)}},2552(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.patch(t,e,n).then(t=>t.data)}},7484(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.post(t,e,n).then(t=>t.data)}},5420(t,e,n){const r=n(8241),o=n(3719);t.exports=function(t,e,n){const s=new r;for(let t=0,n=e.length;t<n;++t){const n=e[t];n.options?s.append(n.name,n.body,n.options):s.append(n.name,n.body)}if(s.getHeaders){const e={...n};return e.headers={...e.headers,...s.getHeaders()},Promise.resolve(o.post(t,s,e)).then(t=>t.data)}return Promise.resolve(o.post(t,s,n)).then(t=>t.data)}},4605(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.put(t,e,n).then(t=>t.data)}},6357(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.put(t,e,n).then(t=>t.data)}},2380(t,e,n){const r=n(3719);t.exports=async function(t,e,n){return r.put(t,e,n).then(t=>t.data)}},956(t){t.exports=function(t){return t}},1828(t){t.exports=function(){}},3332(t,e,n){const r=n(4106);t.exports=r},6785(t){t.exports=function t(e,n){return n?t(n,e%n):Math.abs(e)}},7347(t,e,n){const r=n(6785);t.exports=function(t,e){return Math.abs(t*e)/r(t,e)}},792(t){t.exports=function(t,e,n,r){return 0===t&&"string"==typeof r?r:t%10==1&&t%100!=11?e.split("#").join(t):n.split("#").join(t)}},131(t){t.exports=function(t,e){return Math.floor(Math.random()*(e-t+1)+t)}},4476(t){t.exports=function(t,e=1){if(0===e)return t;const n=1/e,r=Math.sign(t),o=function(t){if(Math.floor(t)===t)return 0;const[e,n]=t.toExponential().split("e"),r=(e.split(".")[1]||"").length;return Math.max(0,r-parseInt(n,10))}(e),s=1e-12*r,u=Math.round(t*n+s)/n;return Number(u.toFixed(o))}},7233(t){t.exports=function(t,e){const n=String(t||""),r=Object.entries(e||{});if(!r.length)return n;const o=n.indexOf("#"),s=-1===o?"":n.slice(o),u=-1===o?n:n.slice(0,o),c=u.indexOf("?"),a=-1===c?u:u.slice(0,c),i=-1===c?"":u.slice(c+1),f=new URLSearchParams(i);r.forEach(function([t,e]){switch(e){case null:case void 0:f.delete(t);break;case!0:f.set(t,"1");break;case!1:f.set(t,"0");break;default:f.set(t,String(e))}});const p=f.toString();return a+(p?`?${p}`:"")+s}},6966(t,e,n){const r=n(2468);t.exports=function(t){return new r(function(e,n){t(function(t,r){t?n(t):e(r)})})}},7072(t,e,n){const r={"./array_chunk.js":6083,"./array_chunk_balanced.js":2458,"./array_fps.js":353,"./array_gcd.js":6372,"./array_group.js":3537,"./array_group_map.js":2976,"./array_index.js":2166,"./array_lcm.js":7866,"./array_max.js":6772,"./array_min.js":42,"./array_permutations.js":3685,"./array_shuffle.js":4943,"./array_sort.js":2356,"./array_sort_other.js":5181,"./array_sum.js":453,"./array_unique.js":3523,"./array_unique_last.js":6382,"./date_add_hours.js":9870,"./date_add_milliseconds.js":5799,"./date_add_minutes.js":3160,"./date_add_months.js":1570,"./date_add_seconds.js":9296,"./date_diff_seconds.js":5488,"./date_is_leap_year.js":3752,"./fcmp_dates.js":2806,"./fcmp_default.js":8310,"./fcmp_default_desc.js":2092,"./fcmp_from_spec.js":3553,"./fcmp_numbers.js":3129,"./fcmp_tuples.js":4332,"./fcmp_utf8_bin.js":3106,"./fcmp_utf8_ci.js":2271,"./fcmp_utf8_cs.js":4457,"./fcmp_utf8_natural_bin.js":7668,"./fcmp_utf8_natural_ci.js":4385,"./fcmp_utf8_natural_cs.js":8951,"./fcmpx.js":4734,"./filter1_from_spec.js":7960,"./format_bytes.js":6017,"./format_date.js":1284,"./format_date_fs.js":5224,"./format_date_human.js":1690,"./format_date_ymd.js":6997,"./format_error_report.js":9009,"./format_hrtime.js":6015,"./format_kilo.js":4153,"./format_ms.js":1120,"./format_ms2.js":7336,"./format_ms3.js":495,"./format_percents.js":7882,"./format_progress_bytes.js":7111,"./format_progress_kilo.js":5051,"./format_seconds.js":3527,"./format_thousands.js":2677,"./http_delete.js":4206,"./http_get_blob.js":4131,"./http_get_buffer.js":706,"./http_get_json.js":3066,"./http_get_utf8.js":3019,"./http_head.js":7379,"./http_patch_json.js":2552,"./http_post_json.js":7484,"./http_post_multipart.js":5420,"./http_put_buffer.js":4605,"./http_put_json.js":6357,"./http_put_utf8.js":2380,"./identity.js":956,"./ignore.js":1828,"./plural.js":792,"./random_int.js":131,"./urlmod.js":7233,"./waitcb.js":6966};function o(t){const e=s(t);return n(e)}function s(t){if(!n.o(r,t)){const e=new Error("Cannot find module '"+t+"'");throw e.code="MODULE_NOT_FOUND",e}return r[t]}o.keys=function(){return Object.keys(r)},o.resolve=s,t.exports=o,o.id=7072},8241(t){"use strict";t.exports=FormData},2468(t){"use strict";t.exports=Promise},3719(t){"use strict";t.exports=axios}};const e={};function n(r){const o=e[r];if(void 0!==o)return o.exports;const s=e[r]={exports:{}};return t[r](s,s.exports,n),s.exports}n.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e);const r=new URL(document.currentScript.src).searchParams.get("var")??"h";if(void 0!==window[r])console.log(`❌ @vbarbarosh/node-helpers@3.76.1 was not injected — window.${r} is already in use`);else{console.log(`🎉 @vbarbarosh/node-helpers@3.76.1 successfully exposed as window.${r}`),window[r]={};const t=n(7072);t.keys().forEach(function(e){const[,n]=e.match(/([^/]+)\.js$/);window[r][n]=t(e)})}})();
+(()=>{var t={932(t){t.exports=function(t){return"number"==typeof t&&isFinite(t)}},5392(t,e,n){const r=n(932);t.exports=function(t,e){return r(t)&&t>e}},4106(t,e){function n(t,e){var n=[],r=[];return null==e&&(e=function(t,e){return n[0]===e?"[Circular ~]":"[Circular ~."+r.slice(0,n.indexOf(e)).join(".")+"]"}),function(o,s){if(n.length>0){var u=n.indexOf(this);~u?n.splice(u+1):n.push(this),~u?r.splice(u,1/0,o):r.push(o),~n.indexOf(s)&&(s=e.call(this,o,s))}else n.push(s);return null==t?s:t.call(this,o,s)}}(t.exports=function(t,e,r,o){return JSON.stringify(t,n(e,o),r)}).getSerialize=n},6083(t){t.exports=function(t=[],e=1){if(e<1)throw new Error("Limit value should be at least 1");const n=[];for(let r=0,o=t.length;r<o;r+=e)n.push(t.slice(r,r+e));return n}},2458(t,e,n){const r=n(7727);t.exports=function(t=[],e=1,n=1){const o=r(1,e,Math.floor(t.length/n)),s=Math.floor(t.length/o);let u=t.length%o;const c=[];for(let e=0;e<t.length;){const n=s+(u?1:0);c.push(t.slice(e,e+n)),e+=n,u&&u--}return c}},353(t,e,n){const r=n(4476),o=1e-5;t.exports=function(t,e){const n=Math.floor(t*e);if(n<=1)return[0];const s=[];for(let e=0;e<n;++e)s.push(r(e/(n-1)*(t-o),o));return s}},6372(t,e,n){const r=n(6785);t.exports=function(t,e=Number){return t.map(t=>e(t)).reduce((t,e)=>r(t,e),0)}},3537(t){t.exports=function(t,e){const n=new Map;return t.forEach(function(t){const r=e(t);n.has(r)||n.set(r,{key:r,items:[]}),n.get(r).items.push(t)}),n.values().toArray()}},2976(t){t.exports=function(t,e){const n={};return t.forEach(function(t){const r=e(t);n[r]=n[r]||{key:r,items:[]},n[r].items.push(t)}),n}},2166(t,e,n){const r=n(956);t.exports=function(t,e=r){const n={};return t.forEach(t=>n[e(t)]=t),n}},7866(t,e,n){const r=n(7347);t.exports=function(t,e=Number){return t.map(t=>e(t)).reduce((t,e)=>r(t,e),1)}},6772(t,e,n){const r=n(956);t.exports=function(t,e=r){let n=null,o=null,s=!1;return t.forEach(function(t){const r=e(t);Number.isNaN(r)||(!s||o<r)&&(s=!0,o=r,n=t)}),n}},42(t,e,n){const r=n(956);t.exports=function(t,e=r){let n=null,o=null,s=!1;return t.forEach(function(t){const r=e(t);Number.isNaN(r)||(!s||o>r)&&(s=!0,o=r,n=t)}),n}},3685(t){t.exports=function t(e,n=e.length){if(n!==e.length)return function(e,n){if(0===n)return[[]];if(e.length<n)return[];const r=[];for(let o=0;o<e.length;o++){const s=e.slice(0,o).concat(e.slice(o+1));for(const u of t(s,n-1))r.push([e[o],...u])}return r}(e,n);let r,o,s=(e=e.slice()).length,u=[e.slice()],c=new Array(s).fill(0),a=1;for(;a<s;)c[a]<a?(r=a%2&&c[a],o=e[a],e[a]=e[r],e[r]=o,++c[a],a=1,u.push(e.slice())):(c[a]=0,++a);return u}},4943(t){t.exports=function(t){for(let e=t.length;--e>0;){const n=Math.floor(Math.random()*(e+1)),r=t[e];t[e]=t[n],t[n]=r}return t}},2356(t,e,n){const r=n(8310),o=n(4332);t.exports=function(t,e,n=r){const s=new Map;return t.sort(function(t,r){if(!s.has(t)){const n=e(t);s.set(t,Array.isArray(n)?n:[n])}if(!s.has(r)){const t=e(r);s.set(r,Array.isArray(t)?t:[t])}return o(s.get(t),s.get(r),n)})}},5181(t,e,n){const r=n(8310);t.exports=function(t,e,n,o=r){const s=Object.create(null);return n.forEach((t,e)=>s[t]=e+1),t.sort(function(t,n){const r=s[e(t)],u=s[e(n)];return r&&u?r-u:r?-1:u?1:o(t,n)})}},453(t){t.exports=function(t,e=Number){let n=0;return t.forEach(function(t){n+=e(t)}),n}},3523(t,e,n){const r=n(956);t.exports=function(t,e=r){const n=new Set;return t.filter(function(t){const r=e(t);return!n.has(r)&&(n.add(r),!0)})}},6382(t,e,n){const r=n(956);t.exports=function(t,e=r){const n=[],o=new Set;for(let r=t.length;--r>=0;){const s=t[r],u=e(s);o.has(u)||(o.add(u),n.push(s))}return n.reverse()}},7727(t){t.exports=function(t,e,n){return Math.max(t,Math.min(e,n))}},9870(t){t.exports=function(t,e){return t.setHours(t.getHours()+e),t}},5799(t){t.exports=function(t,e){return t.setMilliseconds(t.getMilliseconds()+e),t}},3160(t){t.exports=function(t,e){return t.setMinutes(t.getMinutes()+e),t}},1570(t){t.exports=function(t,e){if(!e)return t;const n=t.getDate();return t.setMonth(t.getMonth()+e),t.getDate()!==n&&t.setDate(0),t}},9296(t){t.exports=function(t,e){return t.setSeconds(t.getSeconds()+e),t}},5488(t){t.exports=function(t,e){return Math.floor((t.getTime()-e.getTime())/1e3)}},3752(t){t.exports=function(t){const e=t.getFullYear();return e%4==0&&e%100!=0||e%400==0}},3150(t){t.exports=function(t){return t=Math.trunc(Math.abs(t)),[Math.floor(t/36e5),Math.floor(t%36e5/6e4),Math.floor(t%6e4/1e3),t%1e3]}},2806(t){t.exports=function(t,e){return t.getTime()-e.getTime()}},8310(t,e,n){const r=n(7668);t.exports=function(t,e){return"string"==typeof t&&"string"==typeof e?r(t,e):t<e?-1:t>e?1:0}},2092(t,e,n){const r=n(8310);t.exports=function(t,e){return r(e,t)}},3553(t){function e(t){return"-"===t[0]?(t=t.slice(1),function(e,r){return n(r[t],e[t])}):function(e,r){return n(e[t],r[t])}}function n(t,e){return"string"==typeof t&&"string"==typeof e?t.localeCompare(e):t-e}t.exports=function(t){const n=t.map(e);switch(n.length){case 0:return()=>0;case 1:return n[0];case 2:return function(t,e){return n[0](t,e)||n[1](t,e)};case 3:return function(t,e){return n[0](t,e)||n[1](t,e)||n[2](t,e)};default:return function(t,e){for(let r=0;r<n.length;++r){const o=n[r](t,e);if(o)return o}return 0}}}},3129(t){t.exports=function(t,e){return t-e}},4332(t,e,n){const r=n(8310);t.exports=function(t,e,n=r){const o=Math.min(t.length,e.length);for(let r=0;r<o;++r){const o=n(t[r],e[r]);if(o)return o}return 0}},3106(t){t.exports=function(t,e){return t<e?-1:t>e?1:0}},2271(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{sensitivity:"base"})}},4457(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{sensitivity:"variant"})}},7668(t){function e(t,e){const r=t.replace(/^0+/,""),o=e.replace(/^0+/,"");return r.length-o.length||n(r,o)||t.length-e.length}function n(t,e){return t<e?-1:t>e?1:0}t.exports=function(t,r){const o=t.match(/\d+|\D+/g)||[],s=r.match(/\d+|\D+/g)||[],u=Math.min(o.length,s.length);for(let t=0;t<u;++t){const r=o[t][0]<="9"&&s[t][0]<="9"&&o[t][0]>="0"&&s[t][0]>="0"?e(o[t],s[t]):n(o[t],s[t]);if(r)return r}return o.length-s.length}},4385(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{numeric:!0,sensitivity:"base"})}},8951(t){t.exports=function(t,e){return t.localeCompare(e,void 0,{numeric:!0,sensitivity:"variant"})}},4734(t,e,n){const r=n(8310),o=n(2092),s=n(956),u=Symbol("fcmpx.missing");function c(t){const{read:e,fcmp:n}=a(t);return function(t,r){return n(e(t),e(r))}}function a(t){if("function"==typeof t)return{read:i(t),fcmp:f(r)};if("string"==typeof t){const e=t.startsWith("-");return{read:i(e?t.slice(1):t),fcmp:f(e?o:r)}}const e=t.fcmp,n=i(t.read),s=f(t.desc?e?(t,n)=>e(n,t):o:e??r);if(Array.isArray(t.top)){const e=new Map(t.top.map((t,e)=>[t,e]));return{read:t=>e.get(n(t))??e.size,fcmp:s}}if(Array.isArray(t.bottom)){const e=new Map(t.bottom.map((t,e)=>[t,e]));return{read:t=>e.get(n(t))??-1,fcmp:s}}return{read:n,fcmp:s}}function i(t){if(void 0===t||""===t||"."===t)return s;if("function"==typeof t)return function(e){return t(e)??u};if("string"==typeof t){const e=t.split("."),[n,r,o,s,c]=e;switch(e.length){case 1:return t=>t?.[n]??u;case 2:return t=>t?.[n]?.[r]??u;case 3:return t=>t?.[n]?.[r]?.[o]??u;case 4:return t=>t?.[n]?.[r]?.[o]?.[s]??u;case 5:return t=>t?.[n]?.[r]?.[o]?.[s]?.[c]??u;default:return t=>e.reduce((t,e)=>t?.[e],t)??u}}return e=>e?.[t]??u}function f(t){return function(e,n){return e===u?n===u?0:1:n===u?-1:t(e,n)}}t.exports=function t(e){if("string"==typeof e)return e.includes(",")?t(e.split(",")):c(e);if(!Array.isArray(e))return c(e);const n=e.map(a);return function(t,e){const r=n.map(e=>e.read(t)),o=n.map(t=>t.read(e));for(let t=0;t<n.length;++t){const e=n[t].fcmp(r[t],o[t]);if(e)return e}return 0}}},7960(t){function e(t){let e,n,r;return e=t.replaceAll("^",""),n=e.length!==t.length,e=(t=e).replaceAll("$",""),r=e.length!==t.length,e=(t=e).replaceAll("!",""),(t.length-e.length)%2?n&&r?t=>!(t.startsWith(e)&&t.endsWith(e)):n?t=>!t.startsWith(e):r?t=>!t.endsWith(e):t=>!t.includes(e):n&&r?t=>t.startsWith(e)&&t.endsWith(e):n?t=>t.startsWith(e):r?t=>t.endsWith(e):t=>t.includes(e)}t.exports=function(t){let n,r,o,s;const u=function(t){return t.split("/").filter(t=>t).map(e)}(t);switch(u.length){case 0:return()=>!0;case 1:return u[0];case 2:return[n,r]=u,t=>n(t)&&r(t);case 3:return[n,r,o]=u,t=>n(t)&&r(t)&&o(t);case 4:return[n,r,o,s]=u,t=>n(t)&&r(t)&&o(t)&&s(t);default:return t=>u.every(e=>e(t))}}},6017(t){t.exports=function(t){if("number"!=typeof t||Number.isNaN(t))return"n/a";if(!t)return"0KB";if(t<1024)return"1KB";const e=Math.floor(Math.log(t)/Math.log(1024));return`${(t/1024**e).toFixed(t>1048576?2:0)}${["B","KB","MB","GB","TB","PB"][e]}`.replace(/\.00/,".0")}},1284(t){t.exports=function(t){return t.getFullYear()+`/0${t.getMonth()+1}/0${t.getDate()} 0${t.getHours()}:0${t.getMinutes()}:0${t.getSeconds()}`.replace(/0(\d\d)/g,"$1")}},5224(t){function e(t){return t>9?`${t}`:`0${t}`}t.exports=function(t){return t.getFullYear()+e(t.getMonth()+1)+e(t.getDate())+"_"+(e(t.getHours())+e(t.getMinutes())+e(t.getSeconds()))}},1690(t){function e(t){return t>9?`${t}`:`0${t}`}t.exports=function(t){return t.getFullYear()+"/"+e(t.getMonth()+1)+"/"+e(t.getDate())+" "+e(t.getHours())+":"+e(t.getMinutes())+":"+e(t.getSeconds())}},6997(t){t.exports=function(t){return t.getFullYear()+`/0${t.getMonth()+1}/0${t.getDate()}`.replace(/0(\d\d)/g,"$1")}},9009(t,e,n){const r=n(3332);t.exports=function(t){return t?t.response?.status&&t.response?.statusText&&t.response?.config?function(t){return`\n${t.message??"n/a"}\n\n--- REQUEST ---\n\n${(t.response.config.method||"").toUpperCase()} ${t.response.config.url}\n\n${JSON.stringify(t.response.config.headers||{},null,4).slice(1,-1).replace(/^\s+|,$/gm,"").trim()}\n\n--- RESPONSE ---\n\n${t.response.status} ${t.response.statusText}\n\n${String(t.response.data??"").slice(0,10240)||"n/a"}\n\n--- STACK ---\n\n${t.stack??"n/a"}\n`.trimStart()}(t):t.config?function(t){return`\n${t.message??"n/a"}\n\n--- REQUEST ---\n\n${(t.config.method||"").toUpperCase()} ${t.config.url}\n\n${JSON.stringify(t.config.headers||{},null,4).slice(1,-1).replace(/^\s+|,$/gm,"").trim()}\n\n--- STACK ---\n\n${t.stack??"n/a"}\n`.trimStart()}(t):r({code:t.code,name:t.name,message:t.message??"n/a",stack:t.stack&&t.stack.split(/\n\s*/)},null,4):r({error:void 0===t?"---undefined---":t})}},6015(t){t.exports=function(t,e=6){const[n,r]=t;return(n+r/1e9).toFixed(e)+"s"}},4153(t){t.exports=function(t){if("number"!=typeof t||Number.isNaN(t))return"n/a";if(!t)return"0";if(t<1e3)return t.toFixed(0);const e=parseInt(Math.floor(Math.log(t)/Math.log(1e3)),10);return`${(t/1e3**e).toFixed(2)}${["","K","M","G","T","P"][e]}`}},1120(t,e,n){const r=n(3150);t.exports=function(t){t||(t=0);const e=t<0?"-":"",[n,o,s]=r(t);return n?e+`0${n}:0${o}:0${s}`.replace(/0+(?=\d\d)/g,""):e+`0${o}:0${s}`.replace(/0+(?=\d\d)/g,"")}},7336(t,e,n){const r=n(3150);t.exports=function(t){t||(t=0);const e=t<0?"-":"",[n,o,s,u]=r(10*Math.round(Math.abs(t)/10));return n?e+`0${n}:0${o}:0${s}.0${u/10}`.replace(/0+(?=\d\d)/g,""):e+`0${o}:0${s}.0${u/10}`.replace(/0+(?=\d\d)/g,"")}},495(t,e,n){const r=n(3150);t.exports=function(t,e=!1){t||(t=0);const n=t<0?"-":"",[o,s,u,c]=r(t);return o||e?n+`0${o}:0${s}:0${u}.00${c}`.replace(/0+(?=\d\d+[:.]|\d\d\d)/g,""):n+`0${s}:0${u}.00${c}`.replace(/0+(?=\d\d+[:.]|\d\d\d)/g,"")}},7882(t){t.exports=function(t){return(100*t).toFixed(2).replace(/^(0|100).00$/,"$1")+"%"}},7111(t,e,n){const r=n(6017),o=n(7882),s=n(3527),u=n(5392);t.exports=function({percents:t,total:e,done:n,rate:c,eta:a,duration:i}){const f=u(c,0)?`${r(c)}/s`:"~";if(n>e)return`${r(n)} at ${f} duration=${s(i)}`;if(u(e,0)){const c=u(a,0)?s(a):"~";return`${o(t)} | ${r(n)} of ${r(e)} at ${f} ETA ${c} duration=${s(i)}`}return u(n,0)?`${r(n)} of ~ at ${f} duration=${s(i)}`:u(i,0)?`~ duration=${s(i)}`:"~"}},5051(t,e,n){const r=n(4153),o=n(7882),s=n(3527),u=n(5392);t.exports=function({percents:t,total:e,done:n,rate:c,eta:a,duration:i}){const f=u(c,0)?`${r(c)}/s`:"~";if(n>e)return`${r(n)} at ${f} duration=${s(i)}`;if(u(e,0)){const c=u(a,0)?s(a):"~";return`${o(t)} | ${r(n)} of ${r(e)} at ${f} ETA ${c} duration=${s(i)}`}return u(n,0)?`${r(n)} of ~ at ${f} duration=${s(i)}`:u(i,0)?`~ duration=${s(i)}`:"~"}},3527(t){t.exports=function(t){const e=Math.abs(Math.trunc(t)),n=`0${Math.floor(e/60/60)}:0${Math.floor(e/60)%60}:0${e%60}`.replace(/0(\d\d)/g,"$1");return t<=-1?"-"+n:n}},2677(t){t.exports=function(t){return t.toString().replace(/\B(?<!\.\d*)(?=(\d{3})+(?!\d))/g,",")}},4206(t,e,n){const r=n(3719);t.exports=function(t,e){return r.delete(t,{responseType:"json",...e}).then(t=>t.data)}},4131(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"blob",...e}).then(t=>t.data)}},706(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"arraybuffer",...e}).then(t=>t.data)}},3066(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"json",...e}).then(t=>t.data)}},3019(t,e,n){const r=n(3719);t.exports=function(t,e){return r.get(t,{responseType:"text",responseEncoding:"utf8",...e}).then(t=>t.data)}},7379(t,e,n){const r=n(3719);t.exports=function(t,e){return r.head(t,e).then(t=>t.request.res.headers)}},2552(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.patch(t,e,n).then(t=>t.data)}},7484(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.post(t,e,n).then(t=>t.data)}},5420(t,e,n){const r=n(8241),o=n(3719);t.exports=function(t,e,n){const s=new r;for(let t=0,n=e.length;t<n;++t){const n=e[t];n.options?s.append(n.name,n.body,n.options):s.append(n.name,n.body)}if(s.getHeaders){const e={...n};return e.headers={...e.headers,...s.getHeaders()},Promise.resolve(o.post(t,s,e)).then(t=>t.data)}return Promise.resolve(o.post(t,s,n)).then(t=>t.data)}},4605(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.put(t,e,n).then(t=>t.data)}},6357(t,e,n){const r=n(3719);t.exports=function(t,e,n){return r.put(t,e,n).then(t=>t.data)}},2380(t,e,n){const r=n(3719);t.exports=async function(t,e,n){return r.put(t,e,n).then(t=>t.data)}},956(t){t.exports=function(t){return t}},1828(t){t.exports=function(){}},3332(t,e,n){const r=n(4106);t.exports=r},6785(t){t.exports=function t(e,n){return n?t(n,e%n):Math.abs(e)}},7347(t,e,n){const r=n(6785);t.exports=function(t,e){return Math.abs(t*e)/r(t,e)}},792(t){t.exports=function(t,e,n,r){return 0===t&&"string"==typeof r?r:t%10==1&&t%100!=11?e.split("#").join(t):n.split("#").join(t)}},131(t){t.exports=function(t,e){return Math.floor(Math.random()*(e-t+1)+t)}},4476(t){t.exports=function(t,e=1){if(0===e)return t;const n=1/e,r=Math.sign(t),o=function(t){if(Math.floor(t)===t)return 0;const[e,n]=t.toExponential().split("e"),r=(e.split(".")[1]||"").length;return Math.max(0,r-parseInt(n,10))}(e),s=1e-12*r,u=Math.round(t*n+s)/n;return Number(u.toFixed(o))}},7233(t){t.exports=function(t,e){const n=String(t||""),r=Object.entries(e||{});if(!r.length)return n;const o=n.indexOf("#"),s=-1===o?"":n.slice(o),u=-1===o?n:n.slice(0,o),c=u.indexOf("?"),a=-1===c?u:u.slice(0,c),i=-1===c?"":u.slice(c+1),f=new URLSearchParams(i);r.forEach(function([t,e]){switch(e){case null:case void 0:f.delete(t);break;case!0:f.set(t,"1");break;case!1:f.set(t,"0");break;default:f.set(t,String(e))}});const p=f.toString();return a+(p?`?${p}`:"")+s}},6966(t,e,n){const r=n(2468);t.exports=function(t){return new r(function(e,n){t(function(t,r){t?n(t):e(r)})})}},7072(t,e,n){const r={"./array_chunk.js":6083,"./array_chunk_balanced.js":2458,"./array_fps.js":353,"./array_gcd.js":6372,"./array_group.js":3537,"./array_group_map.js":2976,"./array_index.js":2166,"./array_lcm.js":7866,"./array_max.js":6772,"./array_min.js":42,"./array_permutations.js":3685,"./array_shuffle.js":4943,"./array_sort.js":2356,"./array_sort_other.js":5181,"./array_sum.js":453,"./array_unique.js":3523,"./array_unique_last.js":6382,"./date_add_hours.js":9870,"./date_add_milliseconds.js":5799,"./date_add_minutes.js":3160,"./date_add_months.js":1570,"./date_add_seconds.js":9296,"./date_diff_seconds.js":5488,"./date_is_leap_year.js":3752,"./fcmp_dates.js":2806,"./fcmp_default.js":8310,"./fcmp_default_desc.js":2092,"./fcmp_from_spec.js":3553,"./fcmp_numbers.js":3129,"./fcmp_tuples.js":4332,"./fcmp_utf8_bin.js":3106,"./fcmp_utf8_ci.js":2271,"./fcmp_utf8_cs.js":4457,"./fcmp_utf8_natural_bin.js":7668,"./fcmp_utf8_natural_ci.js":4385,"./fcmp_utf8_natural_cs.js":8951,"./fcmpx.js":4734,"./filter1_from_spec.js":7960,"./format_bytes.js":6017,"./format_date.js":1284,"./format_date_fs.js":5224,"./format_date_human.js":1690,"./format_date_ymd.js":6997,"./format_error_report.js":9009,"./format_hrtime.js":6015,"./format_kilo.js":4153,"./format_ms.js":1120,"./format_ms2.js":7336,"./format_ms3.js":495,"./format_percents.js":7882,"./format_progress_bytes.js":7111,"./format_progress_kilo.js":5051,"./format_seconds.js":3527,"./format_thousands.js":2677,"./http_delete.js":4206,"./http_get_blob.js":4131,"./http_get_buffer.js":706,"./http_get_json.js":3066,"./http_get_utf8.js":3019,"./http_head.js":7379,"./http_patch_json.js":2552,"./http_post_json.js":7484,"./http_post_multipart.js":5420,"./http_put_buffer.js":4605,"./http_put_json.js":6357,"./http_put_utf8.js":2380,"./identity.js":956,"./ignore.js":1828,"./plural.js":792,"./random_int.js":131,"./urlmod.js":7233,"./waitcb.js":6966};function o(t){const e=s(t);return n(e)}function s(t){if(!n.o(r,t)){const e=new Error("Cannot find module '"+t+"'");throw e.code="MODULE_NOT_FOUND",e}return r[t]}o.keys=function(){return Object.keys(r)},o.resolve=s,t.exports=o,o.id=7072},8241(t){"use strict";t.exports=FormData},2468(t){"use strict";t.exports=Promise},3719(t){"use strict";t.exports=axios}};const e={};function n(r){const o=e[r];if(void 0!==o)return o.exports;const s=e[r]={exports:{}};return t[r](s,s.exports,n),s.exports}n.o=(t,e)=>Object.prototype.hasOwnProperty.call(t,e);const r=new URL(document.currentScript.src).searchParams.get("var")??"h";if(void 0!==window[r])console.log(`❌ @vbarbarosh/node-helpers@3.77.0 was not injected — window.${r} is already in use`);else{console.log(`🎉 @vbarbarosh/node-helpers@3.77.0 successfully exposed as window.${r}`),window[r]={};const t=n(7072);t.keys().forEach(function(e){const[,n]=e.match(/([^/]+)\.js$/);window[r][n]=t(e)})}})();

package/package.json

@@ -2,7 +2,7 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.76.1",
+    "version": "3.77.0",
     "description": "A set of helpers for JavaScript/Node.js",
     "unpkg": "dist/browser.js",
     "jsdelivr": "dist/browser.js",

package/src/assert_positive_integer.js

@@ -0,0 +1,10 @@
+const is_num_gt = require('@vbarbarosh/type-helpers/src/is_num_gt');
+
+function assert_positive_integer(value, name = 'value')
+{
+    if (!is_num_gt(value, 0) || !Number.isInteger(value)) {
+        throw new Error(`[${name}] should be a positive integer.`);
+    }
+}
+
+module.exports = assert_positive_integer;

package/src/assert_positive_integer.md

@@ -0,0 +1,8 @@
+Asserts that `value` is a finite integer greater than or equal to `1`.
+The optional `name` is included in the error message.
+
+```js
+assert_positive_integer(3, 'concurrency')   // returns undefined
+assert_positive_integer(0, 'concurrency')   // throws Error
+assert_positive_integer(1.5, 'concurrency') // throws Error
+```

package/src/fastdl.js

@@ -1,12 +1,17 @@
 const UserFriendlyError = require('./errors/UserFriendlyError');
+const assert_positive_integer = require('./assert_positive_integer');
 const format_bytes = require('./format_bytes');
 const format_progress_bytes = require('./format_progress_bytes');
 const format_thousands = require('./format_thousands');
 const fs = require('fs');
 const fs_path_basename = require('./fs_path_basename');
+const fs_rename = require('./fs_rename');
+const fs_rmf = require('./fs_rmf');
+const fs_write = require('./fs_write');
 const ignore = require('./ignore');
 const make_progress = require('./make_progress');
 const parallel = require('./parallel');
+const random_hex = require('./random_hex');
 const stream = require('stream');
 
 /**
@@ -18,13 +23,32 @@ const stream = require('stream');
  * });
  */
 async function fastdl({file, read_stream_with_range, concurrency = 60, user_friendly_status = v => console.log(v)})
+{
+    assert_positive_integer(concurrency, 'concurrency');
+    const tmp_file = `${file}.${process.pid}.${random_hex(8)}.tmp`;
+    try {
+        user_friendly_status(`Preparing destination file [${fs_path_basename(file)}]...`);
+        await fs_write(tmp_file, '', {flag: 'wx'});
+        await download({
+            concurrency,
+            file: tmp_file,
+            read_stream_with_range,
+            user_friendly_status,
+        });
+        await fs_rename(tmp_file, file);
+    }
+    finally {
+        await fs_rmf(tmp_file);
+    }
+}
+
+async function download({file, read_stream_with_range, concurrency, user_friendly_status})
 {
     const M = 1024*1024;
     const chunk_min_bytes = M;
     const chunk_max_bytes = 50*M;
-
-    user_friendly_status(`Truncating destination file [${fs_path_basename(file)}]...`);
-    await fs.promises.writeFile(file, '');
+    const active_streams = new Set();
+    const writers = new Set();
 
     user_friendly_status('Requesting first chunk to determine total size...');
     const rs0 = await read_stream_with_range(0, chunk_min_bytes);
@@ -49,6 +73,11 @@ async function fastdl({file, read_stream_with_range, concurrency = 60, user_frie
     try {
         await parallel({concurrency, spawn});
     }
+    catch (error) {
+        active_streams.forEach(v => v.destroy(error));
+        await Promise.all([...writers].map(v => v.catch(ignore)));
+        throw error;
+    }
     finally {
         tick();
         clearInterval(timer);
@@ -66,7 +95,12 @@ async function fastdl({file, read_stream_with_range, concurrency = 60, user_frie
         const last = Math.min(total - 1, first + (first === 0 ? rs0.content_range.last : chunk_size));
         next_first = last + 1;
         connections++;
-        return Promise.resolve(run()).catch(run).catch(run).finally(() => connections--);
+        const writer = Promise.resolve(run()).catch(run).catch(run).finally(function () {
+            connections--;
+            writers.delete(writer);
+        });
+        writers.add(writer);
+        return writer;
         async function run() {
             if (first > last) {
                 return;
@@ -89,8 +123,11 @@ async function fastdl({file, read_stream_with_range, concurrency = 60, user_frie
             });
             const ws = fs.createWriteStream(file, {
                 flags: fs.constants.O_WRONLY, // |fs.constants.O_CREAT,
+                flush: true,
                 start: first,
             });
+            active_streams.add(rs);
+            active_streams.add(ws);
             try {
                 await stream.promises.pipeline(rs, acc, ws);
             }
@@ -100,6 +137,10 @@ async function fastdl({file, read_stream_with_range, concurrency = 60, user_frie
                 progress.add(-counted);
                 throw error;
             }
+            finally {
+                active_streams.delete(rs);
+                active_streams.delete(ws);
+            }
         }
     }
 }

package/src/fastdl.md

@@ -1,5 +1,13 @@
 Download a file in several connections in parallel.
 
+`concurrency` defaults to `60` and must be a positive integer.
+
+All ranges are written to a unique temporary file beside `file`. After every
+range completes and the final byte count is validated, the temporary file is
+flushed, closed, and atomically renamed over `file`. A failed request, exhausted
+retry, size mismatch, or write error removes the temporary file and preserves
+an existing destination.
+
 ```js
 await fastdl({
     file: fs_path_basename(new URL(url).pathname),

package/src/http_get_file.js

@@ -1,17 +1,25 @@
 const axios = require('axios');
 const fs = require('fs');
+const fs_rename = require('./fs_rename');
+const fs_rmf = require('./fs_rmf');
+const random_hex = require('./random_hex');
 const stream = require('stream');
 
 // https://stackoverflow.com/a/61269447
 async function http_get_file(url, out_file, options)
 {
-    // Create out_file only after a successful response: a failed request
-    // (e.g. 404) should not leave an empty file behind.
-    const response = await axios.get(url, {responseType: 'stream', ...options});
-    // pipeline destroys both streams on any failure: an aborted download
-    // rejects instead of hanging forever, an unwritable out_file rejects
-    // instead of raising an uncaught 'error' event.
-    await stream.promises.pipeline(response.data, fs.createWriteStream(out_file));
+    const tmp_file = `${out_file}.${process.pid}.${random_hex(8)}.tmp`;
+    try {
+        const response = await axios.get(url, {responseType: 'stream', ...options});
+        await stream.promises.pipeline(response.data, fs.createWriteStream(tmp_file, {
+            flags: 'wx',
+            flush: true,
+        }));
+        await fs_rename(tmp_file, out_file);
+    }
+    finally {
+        await fs_rmf(tmp_file);
+    }
 }
 
 module.exports = http_get_file;

package/src/http_get_file.md

@@ -1,9 +1,13 @@
 Downloads `url` into `out_file`.
 
-- An HTTP error status (e.g. 404) rejects and does not create `out_file` —
-  the file is only created after a successful response.
+- The response is written to a unique temporary file in the destination
+  directory, flushed, closed, and atomically renamed to `out_file` only after
+  the complete download succeeds.
+- An HTTP error status (e.g. 404) rejects without creating `out_file`.
 - Rejects when the server aborts the download mid-stream (no hanging) and
-  when `out_file` is not writable; both streams are destroyed on any failure.
+  when `out_file` is not writable; both streams are destroyed and the
+  temporary file is removed on failure. An existing `out_file` remains
+  unchanged.
 - `options` are passed through to `axios.get` (after
   `responseType: 'stream'`).
 

package/src/http_get_stream_range.js

@@ -2,12 +2,15 @@ const axios = require('axios');
 const format_thousands = require('./format_thousands');
 const parse_http_content_range = require('./parse_http_content_range');
 
-async function http_get_stream_range(url, first, last)
+async function http_get_stream_range(url, first, last, options)
 {
     const a = Number.isInteger(first) ? first : '';
     const b = Number.isInteger(last) ? last : '';
-    const headers = {Range: `bytes=${a}-${b}`};
-    const res = await axios.get(url, {responseType: 'stream', headers});
+    const headers = {...options?.headers};
+    if (a !== '' || b !== '') {
+        headers.Range = `bytes=${a}-${b}`;
+    }
+    const res = await axios.get(url, {responseType: 'stream', ...options, headers});
     const out = res.data;
     out.headers = res.headers;
     try {
@@ -27,15 +30,30 @@ async function http_get_stream_range(url, first, last)
         out.destroy(); // release the socket; nobody will ever read this stream
         throw error;
     }
-    // A server reaching the end of the resource returns a shorter range than
-    // requested: `bytes=0-999999` of a 500-byte file is `bytes 0-499/500` (RFC 7233)
-    const expected_last = (b === '' || out.content_range.total === null) ? b : Math.min(b, out.content_range.total - 1);
     if (a !== '' && out.content_range.first !== a) {
         out.destroy(new Error(`First byte of a returned range (${fmt(out.content_range.first)}) is not as expected: [${fmt(a)}]`));
     }
-    else if (b !== '' && out.content_range.last !== expected_last) {
+    else if (a !== '' && b !== '') {
+        const expected_last = out.content_range.total === null ? b : Math.min(b, out.content_range.total - 1);
+        if (out.content_range.last !== expected_last) {
+            out.destroy(new Error(`Last byte of a returned range (${fmt(out.content_range.last)}) is not as expected: [${fmt(expected_last)}]`));
+        }
+    }
+    else if (a !== '' && out.content_range.total !== null && out.content_range.last !== out.content_range.total - 1) {
+        const expected_last = out.content_range.total - 1;
         out.destroy(new Error(`Last byte of a returned range (${fmt(out.content_range.last)}) is not as expected: [${fmt(expected_last)}]`));
     }
+    else if (b !== '') {
+        const actual_length = out.content_range.last - out.content_range.first + 1;
+        const expected_length = out.content_range.total === null ? Math.min(actual_length, b) : Math.min(out.content_range.total, b);
+        if (actual_length !== expected_length) {
+            out.destroy(new Error(`Length of a returned range (${fmt(actual_length)}) is not as expected: [${fmt(expected_length)}]`));
+        }
+        else if (out.content_range.total !== null && out.content_range.last !== out.content_range.total - 1) {
+            const expected_last = out.content_range.total - 1;
+            out.destroy(new Error(`Last byte of a returned range (${fmt(out.content_range.last)}) is not as expected: [${fmt(expected_last)}]`));
+        }
+    }
     out.total = out.content_range.total;
     return out;
 }

package/src/http_get_stream_range.md

@@ -1,7 +1,9 @@
 GETs `url` with a `Range: bytes=first-last` header and returns the response
-body as a readable stream. Either bound may be omitted (non-integer) to send
-an open-ended range; with both omitted a plain `bytes=-` request degrades to
-a regular GET.
+body as a readable stream. Omitting `last` requests `bytes=first-`; omitting
+`first` requests the final `last` bytes with `bytes=-last`. When both are
+omitted, the `Range` header is omitted and a regular GET is sent. Extra Axios
+options are accepted as the fourth argument; caller headers are merged with
+the computed `Range` header.
 
 The stream gets extra properties attached: `headers` (raw response headers),
 `content_range` (parsed `{type, first, last, total}`), and `total`. When the
@@ -9,11 +11,11 @@ server sends no `Content-Range`, it is synthesized from `Content-Length`; a
 chunked 200 response (neither header) is accepted as
 `{first: 0, last: null, total: null}` — body starts at byte 0, size unknown.
 
-The returned range is validated: a `first` or `last` that differs from the
-request destroys the stream with an error (reading it rejects) — this also
-catches a server that ignores the range and replies 200. A `last` clamped to
-the end of the resource is accepted: `bytes=0-999999` of a 500-byte file is
-`bytes 0-499/500` (RFC 7233).
+The returned range is validated according to the requested form. Closed ranges
+accept a `last` clamped to the end of the resource; open-ended ranges must end
+at the resource end when its size is known; suffix ranges validate their
+length and resource end. A server that ignores a range and replies 200 is
+rejected.
 
 ```js
 const rs = await http_get_stream_range(url, 100, 199);

package/src/http_stream_range.js

@@ -86,6 +86,11 @@ async function http_stream_range(req, res, file)
 
         for (let offset = first; offset <= last && !req_close; ) {
             const chunk = await fs_fread(fp, buf, offset, Math.min(buf.length, last - offset + 1));
+            if (chunk.length === 0) {
+                const error = new Error(`File ended at byte ${offset} before the requested range ended at byte ${last}`);
+                error.code = 'ERR_HTTP_STREAM_RANGE_SHORT_READ';
+                throw error;
+            }
             offset += chunk.length;
             if (res.write(chunk)) {
                 // req.log(`[http_stream_range_write] ${chunk.length}`);

package/src/http_stream_range.md

@@ -22,7 +22,10 @@ http_stream_range(req, res, file) → Promise
 `GET` and `HEAD` responses advertise `Accept-Ranges: bytes`.
 
 Reads in 2 MiB chunks with an `fs_fread` loop, respecting backpressure
-(`res.write` + `drain`) and stopping early when the client disconnects.
+(`res.write` + `drain`) and stopping early when the client disconnects. If the
+file becomes shorter than the size captured at the beginning of the request,
+the handler rejects with code `ERR_HTTP_STREAM_RANGE_SHORT_READ` instead of
+waiting indefinitely.
 
 ```js
 app.get('/file', (req, res) => http_stream_range(req, res, '/data/movie.mp4'));

package/src/mongo_stream_upsert.js

@@ -1,4 +1,5 @@
 const Promise = require('bluebird');
+const assert_positive_integer = require('./assert_positive_integer');
 const stream = require('stream');
 const wait_while = require('./wait_while');
 
@@ -7,6 +8,7 @@ const wait_while = require('./wait_while');
  */
 function mongo_stream_upsert({collection, concurrency = 1})
 {
+    assert_positive_integer(concurrency, 'concurrency');
     const errors = [];
     return new stream.Writable({
         objectMode: true,

package/src/mongo_stream_upsert.md

@@ -5,6 +5,7 @@ a `replaceOne` upsert keyed by its `_id`, and the batch goes to
 
 - Up to `concurrency` (default `1`) `bulkWrite` calls run in flight; further
   writes wait until a slot frees up.
+- `concurrency` must be a positive integer.
 - A `bulkWrite` error is reported on the next write or when the stream
   finishes. `final` and `destroy` wait for all in-flight batches first, so an
   error from the last batch is never silently dropped.

package/src/mongo_stream_write.js

@@ -1,4 +1,5 @@
 const Promise = require('bluebird');
+const assert_positive_integer = require('./assert_positive_integer');
 const stream = require('stream');
 const wait_while = require('./wait_while');
 
@@ -7,6 +8,7 @@ const wait_while = require('./wait_while');
  */
 function mongo_stream_write({collection, concurrency = 1})
 {
+    assert_positive_integer(concurrency, 'concurrency');
     const errors = [];
     return new stream.Writable({
         objectMode: true,

package/src/mongo_stream_write.md

@@ -4,6 +4,7 @@ passed to `collection.bulkWrite(operations)` as is.
 
 - Up to `concurrency` (default `1`) `bulkWrite` calls run in flight; further
   writes wait until a slot frees up.
+- `concurrency` must be a positive integer.
 - A `bulkWrite` error is reported on the next write or when the stream
   finishes. `final` and `destroy` wait for all in-flight batches first, so an
   error from the last batch is never silently dropped.

package/src/parallel.js

@@ -1,5 +1,6 @@
 const NotImplemented = require('./errors/NotImplemented');
 const Promise = require('bluebird');
+const assert_positive_integer = require('./assert_positive_integer');
 const is_fn_async = require('@vbarbarosh/type-helpers/src/is_fn_async');
 const is_fn_gen_async = require('@vbarbarosh/type-helpers/src/is_fn_gen_async');
 
@@ -12,6 +13,7 @@ const is_fn_gen_async = require('@vbarbarosh/type-helpers/src/is_fn_gen_async');
  */
 async function parallel({concurrency, spawn, progress})
 {
+    assert_positive_integer(concurrency, 'concurrency');
     if (is_fn_async(spawn) || is_fn_gen_async(spawn)) {
         throw new Error('[spawn] should not be async function. Instead, it should be a simple function returning either [null] or a [promise].');
     }

package/src/parallel.md

@@ -1,5 +1,6 @@
 - Run until `spawn` return `null`.
 - Keep no more than `concurrency` number of workers at a time.
+- `concurrency` must be a positive integer.
 
 ⚠️ Warning: `spawn` should not be async function (async functions are always return `promise`).
 Instead, it should be a simple function returning either `null` or a `promise`.

package/src/pending.js

@@ -0,0 +1,24 @@
+const Promise = require('bluebird');
+
+function pending(fn)
+{
+    let tmp_resolve, tmp_reject;
+    const promise = new Promise(function (resolve, reject) {
+        tmp_resolve = resolve;
+        tmp_reject = reject;
+    });
+    // noinspection JSUnusedAssignment
+    promise.resolve = tmp_resolve;
+    // noinspection JSUnusedAssignment
+    promise.reject = tmp_reject;
+    promise.callback = function (error, data) {
+        error ? promise.reject(error) : promise.resolve(data);
+    };
+    // noinspection EqualityComparisonWithCoercionJS
+    if (typeof fn == 'function') {
+        fn(promise.callback);
+    }
+    return promise;
+}
+
+module.exports = pending;

package/src/pending.md

@@ -0,0 +1,22 @@
+Creates a deferred: a bluebird promise with its own `resolve`, `reject`, and
+node-style `callback(error, data)` attached, so it can be settled from outside
+the executor. The optional `fn` receives `callback` immediately — handy for
+wrapping callback-style APIs that take the callback as an argument.
+
+## Signature
+
+```
+pending(fn = null) → Promise & {resolve, reject, callback}
+```
+
+## Examples
+
+```
+const promise = pending();
+setTimeout(() => promise.resolve('done'), 100);
+await promise;
+```
+
+```
+await pending(callback => legacy_api(arg1, arg2, callback));
+```

package/src/redis_poll.js

@@ -1,6 +1,7 @@
 /* eslint-disable no-unused-vars -- destructured option lists document the full options contract */
 const Promise = require('bluebird');
 const random_int = require('./random_int');
+const redis_rpush = require('./redis_rpush');
 const redis_zshift = require('./redis_zshift');
 
 async function redis_poll(options)
@@ -100,7 +101,7 @@ async function worker(log, message, options)
 
     async function user_friendly_status(value) {
         log(`[${log_worker_user_friendly_status}] ${value}`);
-        await redis.rpush_p(redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value}));
+        await redis_rpush(redis, redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value}));
     }
 }
 

package/src/redis_poll_zshift_callback_rpush.js

@@ -1,6 +1,7 @@
 /* eslint-disable no-unused-vars -- destructured option lists document the full options contract */
 const Promise = require('bluebird');
 const random_int = require('./random_int');
+const redis_rpush = require('./redis_rpush');
 const redis_zshift = require('./redis_zshift');
 
 /**
@@ -82,15 +83,15 @@ async function redis_poll_zshift_callback_rpush(options)
                 }
 
                 const value = await worker(log.spawn(), message, options);
-                const response = JSON.stringify({uid: message.uid, version, type: 'resolve', value});
-                await redis.rpush_p(redis_output_queue, response);
+                const response = JSON.stringify({uid: message.uid, version, type: 'resolve', time: new Date().toJSON(), value});
+                await redis_rpush(redis, redis_output_queue, response);
 
                 log(`[${log_waiter_rpush}]`);
             }
             catch (error) {
-                const response = JSON.stringify({uid: message.uid, version, type: 'reject', value: `${(error && (error.stack || error.message)) || 'Error N/A'}`});
+                const response = JSON.stringify({uid: message.uid, version, type: 'reject', time: new Date().toJSON(), value: `${(error && (error.stack || error.message)) || 'Error N/A'}`});
                 log(`[${log_waiter_error}] ${response}`);
-                await redis.rpush_p(redis_output_queue, response);
+                await redis_rpush(redis, redis_output_queue, response);
             }
         }
     }
@@ -133,7 +134,7 @@ async function worker(log, message, options)
 
     async function user_friendly_status(value) {
         log(`[${log_worker_user_friendly_status}] ${value}`);
-        await redis.rpush_p(redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value}));
+        await redis_rpush(redis, redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', time: new Date().toJSON(), value}));
     }
 }
 

package/src/redis_poll_zshift_callback_rpush.md

@@ -13,5 +13,6 @@ sleeps a random 500–1500ms; the loop runs at most 86400 iterations.
   `'Started...'` status is always pushed first so the consumer starts
   refreshing.
 - `options.log` must provide `spawn()`; the `log_waiter_*`/`log_worker_*`
-  options are the tag names used in log lines. The redis client must provide
-  `rpush_p`.
+  options are the tag names used in log lines. Queue access goes through
+  `redis_zshift`/`redis_rpush`, so any redis client from redis@1 to redis@6
+  works.

package/src/redis_poll_zshift_spawn_rpush.js

@@ -4,6 +4,7 @@ const fs_path_resolve = require('./fs_path_resolve');
 const fs_tempdir = require('./fs_tempdir');
 const fs_write_json = require('./fs_write_json');
 const random_int = require('./random_int');
+const redis_rpush = require('./redis_rpush');
 const redis_zshift = require('./redis_zshift');
 const stream_data_ln = require('./stream_data_ln');
 
@@ -92,14 +93,14 @@ async function redis_poll_zshift_spawn_rpush(options)
 
                 await worker(log.spawn(), message, options);
                 const response = JSON.stringify({uid: message.uid, version, type: 'resolve', value: null});
-                await redis.rpush_p(redis_output_queue, response);
+                await redis_rpush(redis, redis_output_queue, response);
 
                 log(`[${log_waiter_rpush}]`);
             }
             catch (error) {
                 const response = JSON.stringify({uid: message.uid, version, type: 'error', value: `${(error && (error.stack || error.message)) || 'Error N/A'}`});
                 log(`[${log_waiter_error}] ${response}`);
-                await redis.rpush_p(redis_output_queue, response);
+                await redis_rpush(redis, redis_output_queue, response);
             }
         }
     }
@@ -128,7 +129,7 @@ async function worker(log, request, options)
         // Promise won't update its status until at least one request would
         // be taken from the output queue. Pushing generic "Started..." request
         // will tell the promise to refresh its status.
-        await redis.rpush_p(redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value: 'Started...'}));
+        await redis_rpush(redis, redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value: 'Started...'}));
         await fs_tempdir(async function (d) {
             await fs_write_json(fs_path_resolve(d, 'request.json'), request);
             const proc = child_process.spawn(spawn_command, [], {cwd: d, stdio: ['pipe', 'pipe', 'pipe', 'pipe']});
@@ -144,7 +145,7 @@ async function worker(log, request, options)
                     end_stderr = stream_data_ln(proc.stderr, line => log(`[${log_worker_stderr}] ${line}`));
                     end_user_friendly_status = stream_data_ln(proc.stdio[3], function (line) {
                         log(`[${log_worker_user_friendly_status}] ${line}`);
-                        redis.rpush_p(redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value: line}));
+                        redis_rpush(redis, redis_output_queue, JSON.stringify({uid, version, type: 'user_friendly_status', value: line}));
                     });
                 });
             }

package/src/redis_poll_zshift_spawn_rpush.md

@@ -15,6 +15,7 @@ iterations.
 - Unparseable messages and messages without `uid` are skipped; a missing or
   past `expires_at` fails the message (payloads carry signed urls with
   limited lifetime).
-- `options.log` must provide `spawn()`; the redis client must provide
-  `rpush_p`. See `redis_poll_zshift_callback_rpush` for the in-process
+- `options.log` must provide `spawn()`; queue access goes through
+  `redis_zshift`/`redis_rpush`, so any redis client from redis@1 to redis@6
+  works. See `redis_poll_zshift_callback_rpush` for the in-process
   callback variant (which reports failures as `type: 'reject'`).

package/src/redis_rpush.js

@@ -0,0 +1,14 @@
+async function redis_rpush(redis, queue, value)
+{
+    if (redis.rpush) {
+        return new Promise(function (resolve, reject) {
+            redis.rpush(queue, value, function (error, out) {
+                error ? reject(error) : resolve(out);
+            });
+        });
+    }
+    // redis@4
+    return redis.rPush(queue, value);
+}
+
+module.exports = redis_rpush;

package/src/redis_rpush.md

@@ -0,0 +1,12 @@
+Appends `value` to the tail of a redis list (`RPUSH`). Returns the new list
+length.
+
+Works with both legacy callback clients (redis@1–3, detected by the presence
+of a lowercase `rpush` method) and promise clients (redis@4–6); the tests run
+against all six major versions.
+
+## Signature
+
+```
+redis_rpush(redis, queue, value) → Promise<number>
+```

package/src/stream_map_parallel.js

@@ -1,4 +1,5 @@
 const Promise = require('bluebird');
+const assert_positive_integer = require('./assert_positive_integer');
 const stream = require('stream');
 
 /**
@@ -10,6 +11,7 @@ const stream = require('stream');
  */
 function stream_map_parallel({handler, concurrency})
 {
+    assert_positive_integer(concurrency, 'concurrency');
     let running = 0;
     let callback_next = null;
     let callback_flush = null;

package/src/stream_map_parallel.md

@@ -1 +1,3 @@
 Transform each item using a simple function in parallel.
+
+`concurrency` must be a positive integer.

package/src/stream_multiplex.js

@@ -25,12 +25,14 @@ function stream_multiplex(...streams)
             streams.forEach(s => s.once('error', e => this.destroy(e)));
             callback();
         },
-        destroy: async function (error, callback) {
+        destroy: function (error, callback) {
             let done = 0;
+            let final_error = error;
             streams.forEach(function (stream) {
-                stream.destroy(error, function () {
+                stream.destroy(error, function (error2) {
+                    final_error = final_error || error2;
                     if (++done === streams.length) {
-                        callback();
+                        callback(final_error);
                     }
                 });
             });

package/src/stream_multiplex.md

@@ -7,6 +7,8 @@ completes only after every target accepted the chunk.
 - Ending the multiplex ends all targets; destroying it destroys all targets.
 - An error in any target destroys the multiplex (and, through it, the other
   targets) with that error — the first error wins.
+- Destroying the multiplex with an error preserves that error after all targets
+  finish cleanup.
 
 ```js
 await stream.promises.pipeline(

package/src/stream_progress.js

@@ -16,15 +16,22 @@ function stream_progress({objectMode = false, interval = 1000, total, user_frien
 {
     let done = 0;
     const timer = setInterval(tick, interval);
+    const timeout = setTimeout(tick, 0);
     const progress = make_progress(total);
     const format_progress = objectMode ? format_progress_kilo : format_progress_bytes;
-    setTimeout(tick, 0);
     return new stream.Transform({
         objectMode,
         destroy: function (error, callback) {
-            tick();
             clearInterval(timer);
-            callback();
+            clearTimeout(timeout);
+            try {
+                tick();
+            }
+            catch (error2) {
+                callback(error || error2);
+                return;
+            }
+            callback(error);
         },
         transform: function (buffer, encoding, callback) {
             if (objectMode) {

package/src/stream_progress.md

@@ -4,5 +4,6 @@ Requirements:
 
 - should emit the first message as fast as possible
 - should always emit 100% message
+- destroying the stream with an error preserves that error
 
 - Similar: https://www.npmjs.com/package/progress-stream