@ztimson/utils 0.21.5 → 0.22.0

package/README.md

@@ -1,91 +1,91 @@
-<!-- Header -->
-<div id="top" align="center">
-  <br />
-
-  <!-- Logo -->
-  <img src="https://git.zakscode.com/repo-avatars/77dbab78e5fb3302dc9e751c4d6315a64df8d3a714d5cd5719b0dc39e6619119" alt="Logo" width="200" height="200">
-
-  <!-- Title -->
-### @ztimson/utils
-
-  <!-- Description -->
-Javascript/Typescript Utilities
-
-  <!-- Repo badges -->
-[![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/utils/tags&query=$[0].name)](https://git.zakscode.com/ztimson/utils/tags)
-[![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/utils&query=open_pr_counter)](https://git.zakscode.com/ztimson/utils/pulls)
-[![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/utils&query=open_issues_count)](https://git.zakscode.com/ztimson/utils/issues)
-
-  <!-- Links -->
-
-  ---
-  <div>
-    <a href="https://utils.docs.zakscode.com" target="_blank">Documentation</a>
-    • <a href="https://git.zakscode.com/ztimson/utils/releases" target="_blank">Release Notes</a>
-    • <a href="https://git.zakscode.com/ztimson/utils/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
-    • <a href="https://git.zakscode.com/ztimson/utils/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
-  </div>
-
-  ---
-</div>
-
-## Table of Contents
-- [@ztimson/utils](#top)
-	- [About](#about)
-		- [Built With](#built-with)
-	- [Setup](#setup)
-		- [Production](#production)
-		- [Development](#development)
-	- [Documentation](https://utils.docs.zakscode.com/)
-	- [License](#license)
-
-## About
-
-A collection of utilities to make life a little easier
-
-### Built With
-[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://typescriptlang.org/)
-
-## Setup
-
-<details>
-<summary>
-  <h3 id="production" style="display: inline">
-    Production
-  </h3>
-</summary>
-
-#### Prerequisites
-- [Node.js](https://nodejs.org/en/download)
-
-#### Instructions
-1. Install persist: `npm i @ztimosn/utils`
-
-</details>
-
-<details>
-<summary>
-  <h3 id="development" style="display: inline">
-    Development
-  </h3>
-</summary>
-
-#### Prerequisites
-- [Node.js](https://nodejs.org/en/download)
-
-#### Instructions
-1. Install the dependencies: `npm i`
-2. Build library: `npm build`
-3. Run unit tests: `npm test`
-
-</details>
-
-## Documentation
-
-[Available Here](https://utils.docs.zakscode.com/)
-
-## License
-
-Copyright © 2023 Zakary Timson | Available under MIT Licensing
-
-See the [license](_media/LICENSE) for more information.
+<!-- Header -->
+<div id="top" align="center">
+  <br />
+
+  <!-- Logo -->
+  <img src="https://git.zakscode.com/repo-avatars/77dbab78e5fb3302dc9e751c4d6315a64df8d3a714d5cd5719b0dc39e6619119" alt="Logo" width="200" height="200">
+
+  <!-- Title -->
+### @ztimson/utils
+
+  <!-- Description -->
+Javascript/Typescript Utilities
+
+  <!-- Repo badges -->
+[![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/utils/tags&query=$[0].name)](https://git.zakscode.com/ztimson/utils/tags)
+[![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/utils&query=open_pr_counter)](https://git.zakscode.com/ztimson/utils/pulls)
+[![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/utils&query=open_issues_count)](https://git.zakscode.com/ztimson/utils/issues)
+
+  <!-- Links -->
+
+  ---
+  <div>
+    <a href="https://utils.docs.zakscode.com" target="_blank">Documentation</a>
+    • <a href="https://git.zakscode.com/ztimson/utils/releases" target="_blank">Release Notes</a>
+    • <a href="https://git.zakscode.com/ztimson/utils/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
+    • <a href="https://git.zakscode.com/ztimson/utils/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
+  </div>
+
+  ---
+</div>
+
+## Table of Contents
+- [@ztimson/utils](#top)
+	- [About](#about)
+		- [Built With](#built-with)
+	- [Setup](#setup)
+		- [Production](#production)
+		- [Development](#development)
+	- [Documentation](https://utils.docs.zakscode.com/)
+	- [License](#license)
+
+## About
+
+A collection of utilities to make life a little easier
+
+### Built With
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://typescriptlang.org/)
+
+## Setup
+
+<details>
+<summary>
+  <h3 id="production" style="display: inline">
+    Production
+  </h3>
+</summary>
+
+#### Prerequisites
+- [Node.js](https://nodejs.org/en/download)
+
+#### Instructions
+1. Install persist: `npm i @ztimosn/utils`
+
+</details>
+
+<details>
+<summary>
+  <h3 id="development" style="display: inline">
+    Development
+  </h3>
+</summary>
+
+#### Prerequisites
+- [Node.js](https://nodejs.org/en/download)
+
+#### Instructions
+1. Install the dependencies: `npm i`
+2. Build library: `npm build`
+3. Run unit tests: `npm test`
+
+</details>
+
+## Documentation
+
+[Available Here](https://utils.docs.zakscode.com/)
+
+## License
+
+Copyright © 2023 Zakary Timson | Available under MIT Licensing
+
+See the [license](_media/LICENSE) for more information.

package/dist/errors.d.ts

@@ -74,4 +74,4 @@ export declare class GatewayTimeoutError extends CustomError {
  * @param {string} message Override default error message
  * @return {CustomError} The proper error type
  */
-export declare function errorFromCode(code: number, message?: string): CustomError | null;
+export declare function errorFromCode(code: number, message?: string): CustomError;

package/dist/index.cjs

@@ -711,7 +711,6 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
   }
   __publicField(GatewayTimeoutError, "code", 504);
   function errorFromCode(code, message) {
-    if (code >= 200 && code < 300) return null;
     switch (code) {
       case 400:
         return new BadRequestError(message);
@@ -997,6 +996,11 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       return c;
     }).join("");
   }
+  function strSplice(str, start, deleteCount, insert = "") {
+    const before = str.slice(0, start);
+    const after = str.slice(start + deleteCount);
+    return before + insert + after;
+  }
   function matchAll(value, regex) {
     if (typeof regex === "string") {
       regex = new RegExp(regex, "g");
@@ -1320,14 +1324,153 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       emitter.on("*", (event, ...args) => this.emit(event, ...args));
     }
   }
-  function formatDate(date) {
+  function adjustedInterval(cb, ms) {
+    let cancel = false, timeout = null;
+    const p = async () => {
+      if (cancel) return;
+      const start = (/* @__PURE__ */ new Date()).getTime();
+      await cb();
+      const end = (/* @__PURE__ */ new Date()).getTime();
+      timeout = setTimeout(() => p(), ms - (end - start) || 1);
+    };
+    p();
+    return () => {
+      cancel = true;
+      if (timeout) clearTimeout(timeout);
+    };
+  }
+  function formatDate(date, format = "YYYY-MM-DD H:mm ") {
     if (typeof date == "number" || typeof date == "string") date = new Date(date);
-    let hours = date.getHours(), postfix = "AM";
-    if (hours >= 12) {
-      if (hours > 12) hours -= 12;
-      postfix = "PM";
-    } else if (hours == 0) hours = 12;
-    return `${date.getFullYear()}-${(date.getMonth() + 1).toString().padStart(2, "0")}-${date.getDate().toString().padStart(2, "0")}, ${hours}:${date.getMinutes().toString().padStart(2, "0")} ${postfix}`;
+    function day(num) {
+      switch (num) {
+        case 0:
+          return "Sunday";
+        case 1:
+          return "Monday";
+        case 2:
+          return "Tuesday";
+        case 3:
+          return "Wednesday";
+        case 4:
+          return "Thursday";
+        case 5:
+          return "Friday";
+        case 6:
+          return "Saturday";
+        default:
+          return "Unknown";
+      }
+    }
+    function doy(date2) {
+      const start = /* @__PURE__ */ new Date(`${date2.getFullYear()}-01-01 0:00:00`);
+      return Math.ceil((date2.getTime() - start.getTime()) / (1e3 * 60 * 60 * 24));
+    }
+    function month(num) {
+      switch (num) {
+        case 0:
+          return "January";
+        case 1:
+          return "February";
+        case 2:
+          return "March";
+        case 3:
+          return "April";
+        case 4:
+          return "May";
+        case 5:
+          return "June";
+        case 6:
+          return "July";
+        case 7:
+          return "August";
+        case 8:
+          return "September";
+        case 9:
+          return "October";
+        case 10:
+          return "November";
+        case 11:
+          return "December";
+        default:
+          return "Unknown";
+      }
+    }
+    function suffix(num) {
+      let n = num.toString();
+      switch (n.at(-1)) {
+        case "1":
+          return num + "st";
+        case "2":
+          return num + "nd";
+        case "3":
+          return num + "rd";
+        default:
+          return num + "th";
+      }
+    }
+    function tzOffset(offset) {
+      const hours = ~~(offset / 60);
+      const minutes = offset % 60;
+      return (offset > 0 ? "-" : "") + `${hours}:${minutes.toString().padStart(2, "0")}`;
+    }
+    function timezone(offset) {
+      const hours = offset / 60;
+      switch (hours) {
+        case -12:
+          return "IDLW";
+        case -11:
+          return "SST";
+        case -10:
+          return "HST";
+        case -9:
+          return "AKST";
+        case -8:
+          return "PST";
+        case -7:
+          return "MST";
+        case -6:
+          return "CST";
+        case -5:
+          return "EST";
+        case -4:
+          return "AST";
+        case -3:
+          return "ART";
+        case -2:
+          return "FNT";
+        case -1:
+          return "AZOT";
+        case 0:
+          return "UTC";
+        case 1:
+          return "CET";
+        case 2:
+          return "EET";
+        case 3:
+          return "MSK";
+        case 4:
+          return "SAMT";
+        case 5:
+          return "YEKT";
+        case 6:
+          return "OMST";
+        case 7:
+          return "KRAT";
+        case 8:
+          return "CST";
+        case 9:
+          return "JST";
+        case 10:
+          return "AEST";
+        case 11:
+          return "SBT";
+        case 12:
+          return "NZST";
+        default:
+          return "";
+      }
+    }
+    return format.replaceAll("YYYY", date.getFullYear().toString()).replaceAll("YY", date.getFullYear().toString().slice(2)).replaceAll("MMMM", month(date.getMonth())).replaceAll("MMM", month(date.getMonth()).slice(0, 2)).replaceAll("MM", (date.getMonth() + 1).toString().padStart(2, "0")).replaceAll("M", (date.getMonth() + 1).toString()).replaceAll("DDD", doy(date).toString()).replaceAll("DD", date.getDate().toString().padStart(2, "0")).replaceAll("Do", suffix(date.getDate())).replaceAll("D", date.getDate().toString()).replaceAll("dddd", day(date.getDay())).replaceAll("ddd", day(date.getDay()).slice(0, 2)).replaceAll("dd", date.getDate().toString().padStart(2, "0")).replaceAll("d", date.getDay().toString()).replaceAll("HH", date.getHours().toString().padStart(2, "0")).replaceAll("H", date.getHours().toString()).replaceAll("hh", (date.getHours() > 12 ? date.getHours() - 12 : date.getHours()).toString().padStart(2, "0")).replaceAll("h", (date.getHours() > 12 ? date.getHours() - 12 : date.getHours()).toString()).replaceAll("mm", date.getMinutes().toString().padStart(2, "0")).replaceAll("m", date.getMinutes().toString()).replaceAll("ss", date.getSeconds().toString().padStart(2, "0")).replaceAll("s", date.getSeconds().toString()).replaceAll("SSS", date.getMilliseconds().toString()).replaceAll("SS", date.getMilliseconds().toString().slice(0, 1)).replaceAll("S", date.getMilliseconds().toString()[0]).replaceAll("A", date.getHours() >= 12 ? "PM" : "AM").replaceAll("a", date.getHours() >= 12 ? "pm" : "am").replaceAll("ZZ", tzOffset(date.getTimezoneOffset()).replace(":", "")).replaceAll("Z", tzOffset(date.getTimezoneOffset())).replaceAll("z", timezone(date.getTimezoneOffset()));
   }
   function sleep(ms) {
     return new Promise((res) => setTimeout(res, ms));
@@ -1372,6 +1515,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
   exports2.TypedEmitter = TypedEmitter;
   exports2.UnauthorizedError = UnauthorizedError;
   exports2.addUnique = addUnique;
+  exports2.adjustedInterval = adjustedInterval;
   exports2.arrayDiff = arrayDiff;
   exports2.caseInsensitiveSort = caseInsensitiveSort;
   exports2.clean = clean;
@@ -1412,6 +1556,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
   exports2.sleep = sleep;
   exports2.sleepWhile = sleepWhile;
   exports2.sortByProp = sortByProp;
+  exports2.strSplice = strSplice;
   exports2.timeUntil = timeUntil;
   exports2.timestampFilename = timestampFilename;
   exports2.tyoeKeys = tyoeKeys;