@rzl-zone/utils-js 3.4.0 → 3.5.1

package/dist/chunk-QBKAEVYG.js

@@ -1 +1,113 @@
-import{isInteger as r}from"./chunk-WVSPXFTY.js";import{safeStableStringify as e}from"./chunk-PET42Z7W.js";import{getPreciseType as t,isNull as o}from"./chunk-CMW2TBOQ.js";var n=class extends Promise{_value;_error;_finish=[];constructor(r){let e,t;super((r,o)=>{e=r,t=o}),r(r=>{this._value=r,e(r),this._finish.forEach(e=>e(r,void 0))},r=>{this._error=r,t(r),this._finish.forEach(e=>e(void 0,r))}),Object.setPrototypeOf(this,new.target.prototype)}then(r,e){return super.then(r,e)}catch(r){return super.catch(r)}finish(r){return void 0!==this._value||void 0!==this._error?r(this._value,this._error):this._finish.push(r),this}},i=class extends Error{constructor(r="The operation was aborted",e="AbortError"){super(r),this.name=e}},s=(n=1e3,s)=>{if(!r(n)||n<=0)throw new TypeError(`First parameter (\`milliSeconds\`) must be of type \`number\` and value must be a \`non-zero\`, \`non-NaN\`, \`non-negative\`, and \`integer-number\`, but received: \`${t(n)}\`, with value: \`${e(n)}\`.`);if(o(s)||s&&!(s instanceof AbortSignal))throw new TypeError("Second parameter (`signal`) must be an `instance of AbortSignal` if provided.");return new Promise((r,e)=>{const t=setTimeout(()=>{o(),r()},n),o=()=>{clearTimeout(t),s&&s.removeEventListener("abort",a)},a=()=>{o(),e(new i("Function `delay` from `@rzl-zone/utils-js` was aborted.","AbortError"))};s&&(s.aborted?a():s.addEventListener("abort",a,{once:!0}))})};export{n as CustomPromise,s as delay};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+import { isInteger } from './chunk-WVSPXFTY.js';
+import { safeStableStringify } from './chunk-PET42Z7W.js';
+import { getPreciseType, isNull } from './chunk-CMW2TBOQ.js';
+
+var CustomPromise = class extends Promise {
+  _value;
+  _error;
+  _finish = [];
+  constructor(executor) {
+    let resolveOuter;
+    let rejectOuter;
+    super((resolve, reject) => {
+      resolveOuter = resolve;
+      rejectOuter = reject;
+    });
+    executor(
+      (v) => {
+        this._value = v;
+        resolveOuter(v);
+        this._finish.forEach((f) => f(v, void 0));
+      },
+      (e) => {
+        this._error = e;
+        rejectOuter(e);
+        this._finish.forEach((f) => f(void 0, e));
+      }
+    );
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  then(onfulfilled, onrejected) {
+    return super.then(onfulfilled, onrejected);
+  }
+  catch(onrejected) {
+    return super.catch(onrejected);
+  }
+  /**
+   * Registers a callback to be invoked **exactly once** when the
+   * promise settles, with access to both the resolved value and
+   * the rejection reason.
+   *
+   * If the promise is already settled when `finish` is called,
+   * the callback executes immediately on the same tick.
+   *
+   * @param cb Callback receiving the final `(value, error)`.
+   * @returns `this` for fluent chaining.
+   */
+  finish(cb) {
+    if (this._value !== void 0 || this._error !== void 0) {
+      cb(this._value, this._error);
+    } else {
+      this._finish.push(cb);
+    }
+    return this;
+  }
+};
+
+var AbortError = class extends Error {
+  constructor(message = "The operation was aborted", name = "AbortError") {
+    super(message);
+    this.name = name;
+  }
+};
+var delay = (milliSeconds = 1e3, signal) => {
+  if (!isInteger(milliSeconds) || milliSeconds <= 0) {
+    throw new TypeError(
+      `First parameter (\`milliSeconds\`) must be of type \`number\` and value must be a \`non-zero\`, \`non-NaN\`, \`non-negative\`, and \`integer-number\`, but received: \`${getPreciseType(
+        milliSeconds
+      )}\`, with value: \`${safeStableStringify(milliSeconds)}\`.`
+    );
+  }
+  if (isNull(signal) || signal && !(signal instanceof AbortSignal)) {
+    throw new TypeError(
+      "Second parameter (`signal`) must be an `instance of AbortSignal` if provided."
+    );
+  }
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      cleanup();
+      resolve();
+    }, milliSeconds);
+    const cleanup = () => {
+      clearTimeout(timer);
+      if (signal) signal.removeEventListener("abort", onAbort);
+    };
+    const onAbort = () => {
+      cleanup();
+      reject(
+        new AbortError(
+          "Function `delay` from `@rzl-zone/utils-js` was aborted.",
+          "AbortError"
+        )
+      );
+    };
+    if (signal) {
+      if (signal.aborted) {
+        onAbort();
+      } else {
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
+    }
+  });
+};
+
+export { CustomPromise, delay };

package/dist/chunk-QNKGP5DY.js

@@ -1 +1,14 @@
-var t=t=>"bigint"==typeof t;export{t as isBigInt};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+var isBigInt = (value) => {
+  return typeof value === "bigint";
+};
+
+export { isBigInt };

package/dist/chunk-RIPKY4RU.js

@@ -1 +1,417 @@
-import{isNonEmptyString as s}from"./chunk-CMW2TBOQ.js";var a=new Set(["txt","md","rtf","tex","doc","docx","odt","ott","pdf","djvu","epub","mobi","azw","azw3","xls","xlsx","ods","csv","tsv","ppt","pptx","odp","pps","md","bib","tex","log","jpg","jpeg","png","gif","bmp","tif","tiff","webp","svg","ico","heif","heic","raw","cr2","nef","orf","sr2","dng","dds","psd","exr","xcf","ai","eps","cdr","psd","indd","mp3","wav","ogg","flac","aac","m4a","wma","alac","aiff","amr","mid","midi","opus","au","caf","ape","opus","mp4","mkv","avi","mov","flv","wmv","webm","mpeg","mpg","3gp","3g2","m4v","ts","mts","asf","rm","rmvb","vob","f4v","ogv","m2ts","mod","dav","zip","rar","7z","tar","gz","bz2","xz","tgz","tbz2","txz","lz","lzma","z","cab","arj","ace","iso","dmg","rpm","deb","pkg","apk","jar","iso","img","vhd","vmdk","qcow2","dmg","sql","db","dbf","mdb","accdb","json","xml","yaml","yml","toml","ini","plist","yaml","pkl","msgpack","h5","hdf5","parquet","avro","orc","ndjson","db","pdb","sqlite","sqlite3","dbx","sdf","js","jsx","ts","tsx","c","cpp","h","hpp","java","py","rb","go","rs","php","pl","sh","bat","cmd","ps1","lua","swift","kt","scala","cs","vb","dart","m","r","jl","fs","vbproj","sln","pri","Makefile","html","htm","xhtml","css","scss","sass","less","xml","json","yaml","yml","xlf","xlf","po","pot","jsp","asp","aspx","php","jspf","cgi","cfm","pl","env","conf","config","xml","ini","cfg","toml","yaml","dockerfile","gitignore","gitconfig","gitattributes","npmignore","lock","gradle","pom","yaml","prettierrc","eslintrc","babelrc","editorconfig","ttf","otf","woff","woff2","eot","dwg","dxf","shp","kml","kmz","gpx","stl","step","iges","3ds","3dm","fbx","obj","exe","msi","bin","run","com","cmd","apk","app","deb","rpm","elf","dll","so","dylib","sys","pem","crt","cer","key","der","csr","p12","pfx","jks","iso","cue","bin","nes","sfc","gba","nds","nes","sav","rom","pak","vpk","bik","epub","mobi","azw","azw3","fb2","lit","lrf","cbr","cbz","cbt","cba","opds","fasta","fa","fas","ffn","faa","fna","frn","fastq","fq","gb","gbk","sam","bam","vcf","gff","bed","log","bak","tmp","old","backup","swp","part","crdownload","torrent","ics","vcf","ics","ical","ics","ical","calendar","srt","sub","idx","cue","cdf","hdf","h5","nc","grib","fits","netcdf","sdf","vtk","xmind","drawio","jar","war","ear","crx","xpi","plugin","vsix","safariextz"]),t=new Set(["tar.gz","tar.bz2","tar.xz","tar.lz","tar.lzma","tar.Z","tar.zst","tar.xz"]),r=r=>{if(!s(r))return;let p=r.split("/").pop();if(""===p)return"";if(p){for(const s of t){const a=`.${s}`;if(p.toLowerCase().endsWith(a))return p.slice(0,-a.length)}for(;;){const s=p.lastIndexOf(".");if(-1===s)break;const t=p.slice(s+1).toLowerCase();if(!a.has(t))break;p=p.slice(0,s)}return p}};export{r as extractFileName};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+import { isNonEmptyString } from './chunk-CMW2TBOQ.js';
+
+var KNOWN_EXTENSIONS = /* @__PURE__ */ new Set([
+  // 📄 Text & Document
+  "txt",
+  "md",
+  "rtf",
+  "tex",
+  "doc",
+  "docx",
+  "odt",
+  "ott",
+  "pdf",
+  "djvu",
+  "epub",
+  "mobi",
+  "azw",
+  "azw3",
+  "xls",
+  "xlsx",
+  "ods",
+  "csv",
+  "tsv",
+  "ppt",
+  "pptx",
+  "odp",
+  "pps",
+  "md",
+  "bib",
+  "tex",
+  "log",
+  // 🖼️ Image
+  "jpg",
+  "jpeg",
+  "png",
+  "gif",
+  "bmp",
+  "tif",
+  "tiff",
+  "webp",
+  "svg",
+  "ico",
+  "heif",
+  "heic",
+  "raw",
+  "cr2",
+  "nef",
+  "orf",
+  "sr2",
+  "dng",
+  "dds",
+  "psd",
+  "exr",
+  "xcf",
+  "ai",
+  "eps",
+  "cdr",
+  "psd",
+  "indd",
+  // 🎵 Audio
+  "mp3",
+  "wav",
+  "ogg",
+  "flac",
+  "aac",
+  "m4a",
+  "wma",
+  "alac",
+  "aiff",
+  "amr",
+  "mid",
+  "midi",
+  "opus",
+  "au",
+  "caf",
+  "ape",
+  "opus",
+  // 🎥 Video
+  "mp4",
+  "mkv",
+  "avi",
+  "mov",
+  "flv",
+  "wmv",
+  "webm",
+  "mpeg",
+  "mpg",
+  "3gp",
+  "3g2",
+  "m4v",
+  "ts",
+  "mts",
+  "asf",
+  "rm",
+  "rmvb",
+  "vob",
+  "f4v",
+  "ogv",
+  "m2ts",
+  "mod",
+  "dav",
+  // 🗃️ Archive & Compression
+  "zip",
+  "rar",
+  "7z",
+  "tar",
+  "gz",
+  "bz2",
+  "xz",
+  "tgz",
+  "tbz2",
+  "txz",
+  "lz",
+  "lzma",
+  "z",
+  "cab",
+  "arj",
+  "ace",
+  "iso",
+  "dmg",
+  "rpm",
+  "deb",
+  "pkg",
+  "apk",
+  "jar",
+  // 💾 Disk Image
+  "iso",
+  "img",
+  "vhd",
+  "vmdk",
+  "qcow2",
+  "dmg",
+  // 🗃️ Database & Data
+  "sql",
+  "db",
+  "dbf",
+  "mdb",
+  "accdb",
+  "json",
+  "xml",
+  "yaml",
+  "yml",
+  "toml",
+  "ini",
+  "plist",
+  "yaml",
+  "pkl",
+  "msgpack",
+  "h5",
+  "hdf5",
+  "parquet",
+  "avro",
+  "orc",
+  "ndjson",
+  "db",
+  "pdb",
+  "sqlite",
+  "sqlite3",
+  "dbx",
+  "sdf",
+  // 💻 Code & Script
+  "js",
+  "jsx",
+  "ts",
+  "tsx",
+  "c",
+  "cpp",
+  "h",
+  "hpp",
+  "java",
+  "py",
+  "rb",
+  "go",
+  "rs",
+  "php",
+  "pl",
+  "sh",
+  "bat",
+  "cmd",
+  "ps1",
+  "lua",
+  "swift",
+  "kt",
+  "scala",
+  "cs",
+  "vb",
+  "dart",
+  "m",
+  "r",
+  "jl",
+  "fs",
+  "vbproj",
+  "sln",
+  "pri",
+  "Makefile",
+  // 🌐 Web & Config
+  "html",
+  "htm",
+  "xhtml",
+  "css",
+  "scss",
+  "sass",
+  "less",
+  "xml",
+  "json",
+  "yaml",
+  "yml",
+  "xlf",
+  "xlf",
+  "po",
+  "pot",
+  "jsp",
+  "asp",
+  "aspx",
+  "php",
+  "jspf",
+  "cgi",
+  "cfm",
+  "pl",
+  "env",
+  "conf",
+  "config",
+  "xml",
+  "ini",
+  "cfg",
+  "toml",
+  "yaml",
+  "dockerfile",
+  "gitignore",
+  "gitconfig",
+  "gitattributes",
+  "npmignore",
+  "lock",
+  "gradle",
+  "pom",
+  "yaml",
+  "prettierrc",
+  "eslintrc",
+  "babelrc",
+  "editorconfig",
+  // 🔠 Font
+  "ttf",
+  "otf",
+  "woff",
+  "woff2",
+  "eot",
+  // 🗺️ CAD & GIS
+  "dwg",
+  "dxf",
+  "shp",
+  "kml",
+  "kmz",
+  "gpx",
+  "stl",
+  "step",
+  "iges",
+  "3ds",
+  "3dm",
+  "fbx",
+  "obj",
+  // 🔧 System / Binary / Execution
+  "exe",
+  "msi",
+  "bin",
+  "run",
+  "com",
+  "cmd",
+  "apk",
+  "app",
+  "deb",
+  "rpm",
+  "elf",
+  "dll",
+  "so",
+  "dylib",
+  "sys",
+  // 🔐 Certificates / Crypto
+  "pem",
+  "crt",
+  "cer",
+  "key",
+  "der",
+  "csr",
+  "p12",
+  "pfx",
+  "jks",
+  // 🎮 Games & Projects
+  "iso",
+  "cue",
+  "bin",
+  "nes",
+  "sfc",
+  "gba",
+  "nds",
+  "nes",
+  "sav",
+  "rom",
+  "pak",
+  "vpk",
+  "bik",
+  // 📚 E-books and Comics
+  "epub",
+  "mobi",
+  "azw",
+  "azw3",
+  "fb2",
+  "lit",
+  "lrf",
+  "cbr",
+  "cbz",
+  "cbt",
+  "cba",
+  "opds",
+  // 🔬 Bioinformatics
+  "fasta",
+  "fa",
+  "fas",
+  "ffn",
+  "faa",
+  "fna",
+  "frn",
+  "fastq",
+  "fq",
+  "gb",
+  "gbk",
+  "sam",
+  "bam",
+  "vcf",
+  "gff",
+  "bed",
+  // 📝 Etc
+  "log",
+  "bak",
+  "tmp",
+  "old",
+  "backup",
+  "swp",
+  "part",
+  "crdownload",
+  "torrent",
+  "ics",
+  "vcf",
+  "ics",
+  "ical",
+  "ics",
+  "ical",
+  "calendar",
+  "srt",
+  "sub",
+  "idx",
+  "cue",
+  // 🧠 Other broad (technical & scientific extensions)
+  "cdf",
+  "hdf",
+  "h5",
+  "nc",
+  "grib",
+  "fits",
+  "netcdf",
+  "sdf",
+  "vtk",
+  "xmind",
+  "drawio",
+  // ⚙️ Packages & Plugins
+  "jar",
+  "war",
+  "ear",
+  "crx",
+  "xpi",
+  "plugin",
+  "vsix",
+  "safariextz"
+]);
+var DOUBLE_EXTENSIONS = /* @__PURE__ */ new Set([
+  "tar.gz",
+  "tar.bz2",
+  "tar.xz",
+  "tar.lz",
+  "tar.lzma",
+  "tar.Z",
+  "tar.zst",
+  "tar.xz"
+]);
+var extractFileName = (url) => {
+  if (!isNonEmptyString(url)) return void 0;
+  let fileName = url.split("/").pop();
+  if (fileName === "") return "";
+  if (!fileName) return void 0;
+  for (const ext of DOUBLE_EXTENSIONS) {
+    const fullExt = `.${ext}`;
+    if (fileName.toLowerCase().endsWith(fullExt)) {
+      return fileName.slice(0, -fullExt.length);
+    }
+  }
+  while (true) {
+    const lastDot = fileName.lastIndexOf(".");
+    if (lastDot === -1) break;
+    const ext = fileName.slice(lastDot + 1).toLowerCase();
+    if (KNOWN_EXTENSIONS.has(ext)) {
+      fileName = fileName.slice(0, lastDot);
+    } else {
+      break;
+    }
+  }
+  return fileName;
+};
+
+export { extractFileName };

package/dist/chunk-RZW35UN5.cjs

@@ -1 +1,116 @@
-"use strict";var e=require("./chunk-DVMHRLKP.cjs"),r=require("./chunk-T7PU2V7X.cjs"),t=require("./chunk-PZQ6I4JJ.cjs"),s=class extends Error{constructor(e="The operation was aborted",r="AbortError"){super(e),this.name=r}};exports.CustomPromise=class extends Promise{_value;_error;_finish=[];constructor(e){let r,t;super((e,s)=>{r=e,t=s}),e(e=>{this._value=e,r(e),this._finish.forEach(r=>r(e,void 0))},e=>{this._error=e,t(e),this._finish.forEach(r=>r(void 0,e))}),Object.setPrototypeOf(this,new.target.prototype)}then(e,r){return super.then(e,r)}catch(e){return super.catch(e)}finish(e){return void 0!==this._value||void 0!==this._error?e(this._value,this._error):this._finish.push(e),this}},exports.delay=(i=1e3,o)=>{if(!e.isInteger(i)||i<=0)throw new TypeError(`First parameter (\`milliSeconds\`) must be of type \`number\` and value must be a \`non-zero\`, \`non-NaN\`, \`non-negative\`, and \`integer-number\`, but received: \`${t.getPreciseType(i)}\`, with value: \`${r.safeStableStringify(i)}\`.`);if(t.isNull(o)||o&&!(o instanceof AbortSignal))throw new TypeError("Second parameter (`signal`) must be an `instance of AbortSignal` if provided.");return new Promise((e,r)=>{const t=setTimeout(()=>{n(),e()},i),n=()=>{clearTimeout(t),o&&o.removeEventListener("abort",a)},a=()=>{n(),r(new s("Function `delay` from `@rzl-zone/utils-js` was aborted.","AbortError"))};o&&(o.aborted?a():o.addEventListener("abort",a,{once:!0}))})};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkDVMHRLKP_cjs = require('./chunk-DVMHRLKP.cjs');
+var chunkT7PU2V7X_cjs = require('./chunk-T7PU2V7X.cjs');
+var chunkPZQ6I4JJ_cjs = require('./chunk-PZQ6I4JJ.cjs');
+
+var CustomPromise = class extends Promise {
+  _value;
+  _error;
+  _finish = [];
+  constructor(executor) {
+    let resolveOuter;
+    let rejectOuter;
+    super((resolve, reject) => {
+      resolveOuter = resolve;
+      rejectOuter = reject;
+    });
+    executor(
+      (v) => {
+        this._value = v;
+        resolveOuter(v);
+        this._finish.forEach((f) => f(v, void 0));
+      },
+      (e) => {
+        this._error = e;
+        rejectOuter(e);
+        this._finish.forEach((f) => f(void 0, e));
+      }
+    );
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  then(onfulfilled, onrejected) {
+    return super.then(onfulfilled, onrejected);
+  }
+  catch(onrejected) {
+    return super.catch(onrejected);
+  }
+  /**
+   * Registers a callback to be invoked **exactly once** when the
+   * promise settles, with access to both the resolved value and
+   * the rejection reason.
+   *
+   * If the promise is already settled when `finish` is called,
+   * the callback executes immediately on the same tick.
+   *
+   * @param cb Callback receiving the final `(value, error)`.
+   * @returns `this` for fluent chaining.
+   */
+  finish(cb) {
+    if (this._value !== void 0 || this._error !== void 0) {
+      cb(this._value, this._error);
+    } else {
+      this._finish.push(cb);
+    }
+    return this;
+  }
+};
+
+var AbortError = class extends Error {
+  constructor(message = "The operation was aborted", name = "AbortError") {
+    super(message);
+    this.name = name;
+  }
+};
+var delay = (milliSeconds = 1e3, signal) => {
+  if (!chunkDVMHRLKP_cjs.isInteger(milliSeconds) || milliSeconds <= 0) {
+    throw new TypeError(
+      `First parameter (\`milliSeconds\`) must be of type \`number\` and value must be a \`non-zero\`, \`non-NaN\`, \`non-negative\`, and \`integer-number\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+        milliSeconds
+      )}\`, with value: \`${chunkT7PU2V7X_cjs.safeStableStringify(milliSeconds)}\`.`
+    );
+  }
+  if (chunkPZQ6I4JJ_cjs.isNull(signal) || signal && !(signal instanceof AbortSignal)) {
+    throw new TypeError(
+      "Second parameter (`signal`) must be an `instance of AbortSignal` if provided."
+    );
+  }
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      cleanup();
+      resolve();
+    }, milliSeconds);
+    const cleanup = () => {
+      clearTimeout(timer);
+      if (signal) signal.removeEventListener("abort", onAbort);
+    };
+    const onAbort = () => {
+      cleanup();
+      reject(
+        new AbortError(
+          "Function `delay` from `@rzl-zone/utils-js` was aborted.",
+          "AbortError"
+        )
+      );
+    };
+    if (signal) {
+      if (signal.aborted) {
+        onAbort();
+      } else {
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
+    }
+  });
+};
+
+exports.CustomPromise = CustomPromise;
+exports.delay = delay;