@alextheman/utility 1.12.1 → 1.13.1

package/dist/index.cjs

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,19 +17,22 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  APIError: () => APIError_default,
   addDaysToDate: () => addDaysToDate_default,
   appendSemicolon: () => appendSemicolon_default,
   convertFileToBase64: () => convertFileToBase64_default,
   formatDateAndTime: () => formatDateAndTime_default,
   getRandomNumber: () => getRandomNumber_default,
+  httpErrorCodeLookup: () => httpErrorCodeLookup,
   isLeapYear: () => isLeapYear_default,
   isMonthlyMultiple: () => isMonthlyMultiple_default,
   isSameDate: () => isSameDate_default,
-  newEnv: () => newEnv_default,
+  newEnv: () => Env_default,
   randomiseArray: () => randomiseArray_default,
   range: () => range_default,
   truncate: () => truncate_default,
@@ -36,7 +40,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/addDaysToDate.ts
+// src/functions/addDaysToDate.ts
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
   const newDate = currentDate;
   newDate.setDate(newDate.getDate() + dayIncrement);
@@ -44,7 +48,7 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 }
 var addDaysToDate_default = addDaysToDate;
 
-// src/appendSemicolon.ts
+// src/functions/appendSemicolon.ts
 function appendSemicolon(stringToAppendTo) {
   if (stringToAppendTo.includes("\n")) {
     throw new Error("MULTIPLE_LINE_ERROR");
@@ -57,7 +61,7 @@ function appendSemicolon(stringToAppendTo) {
 }
 var appendSemicolon_default = appendSemicolon;
 
-// src/convertFileToBase64.ts
+// src/functions/convertFileToBase64.ts
 function convertFileToBase64(file) {
   return new Promise((resolve, reject) => {
     const reader = new FileReader();
@@ -76,13 +80,13 @@ function convertFileToBase64(file) {
 }
 var convertFileToBase64_default = convertFileToBase64;
 
-// src/isSameDate.ts
+// src/functions/isSameDate.ts
 function isSameDate(firstDate, secondDate) {
   return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
 var isSameDate_default = isSameDate;
 
-// src/formatDateAndTime.ts
+// src/functions/formatDateAndTime.ts
 function formatDateAndTime(inputDate) {
   const yesterday = addDaysToDate_default(/* @__PURE__ */ new Date(), -1);
   const today = /* @__PURE__ */ new Date();
@@ -100,7 +104,7 @@ function formatDateAndTime(inputDate) {
 }
 var formatDateAndTime_default = formatDateAndTime;
 
-// src/getRandomNumber.ts
+// src/functions/getRandomNumber.ts
 function getRandomNumber(lowerBound, upperBound) {
   if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
     throw new Error("NON_INTEGER_INPUTS");
@@ -109,7 +113,7 @@ function getRandomNumber(lowerBound, upperBound) {
 }
 var getRandomNumber_default = getRandomNumber;
 
-// src/isLeapYear.ts
+// src/functions/isLeapYear.ts
 function isLeapYear(year) {
   if (year % 1 !== 0) {
     throw new Error("NON_INTEGER_INPUT");
@@ -118,7 +122,7 @@ function isLeapYear(year) {
 }
 var isLeapYear_default = isLeapYear;
 
-// src/isMonthlyMultiple.ts
+// src/functions/isMonthlyMultiple.ts
 function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
   if ([3, 5, 8, 10].includes(firstDate.getMonth())) {
     return firstDate.getDate() === 30 && secondDate.getDate() === 31;
@@ -155,15 +159,7 @@ function isMonthlyMultiple(firstDate, secondDate) {
 }
 var isMonthlyMultiple_default = isMonthlyMultiple;
 
-// src/newEnv.ts
-var import_zod = require("zod");
-var envSchema = import_zod.z.enum(["test", "development", "production"]);
-function newEnv(data = "development") {
-  return envSchema.parse(data);
-}
-var newEnv_default = newEnv;
-
-// src/randomiseArray.ts
+// src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
   const outputArray = [];
@@ -175,7 +171,7 @@ function randomiseArray(array) {
 }
 var randomiseArray_default = randomiseArray;
 
-// src/range.ts
+// src/functions/range.ts
 function range(start, stop, step = 1) {
   const numbers = [];
   if (step === 0) {
@@ -199,13 +195,13 @@ function range(start, stop, step = 1) {
 }
 var range_default = range;
 
-// src/truncate.ts
+// src/functions/truncate.ts
 function truncate(stringToTruncate, maxLength = 5) {
   return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
 var truncate_default = truncate;
 
-// src/wait.ts
+// src/functions/wait.ts
 function wait(seconds) {
   return new Promise((resolve, _) => {
     setTimeout(() => {
@@ -214,13 +210,51 @@ function wait(seconds) {
   });
 }
 var wait_default = wait;
+
+// src/types/Env.ts
+var import_zod = require("zod");
+var envSchema = import_zod.z.enum(["test", "development", "production"]);
+function newEnv(data = "development") {
+  return envSchema.parse(data);
+}
+var Env_default = newEnv;
+
+// src/types/APIError.ts
+var httpErrorCodeLookup = {
+  400: "BAD_REQUEST",
+  401: "UNAUTHORISED",
+  403: "FORBIDDEN",
+  404: "NOT_FOUND",
+  /* Supporting this one too because it's funny. You'll never use it in practice because 
+                why would an error give a teapot, but it's funny. Do not question me. */
+  418: "I_AM_A_TEAPOT",
+  500: "INTERNAL_SERVER_ERROR"
+};
+var APIError = class extends Error {
+  constructor(status = 500, message, options) {
+    var _a;
+    super(message, options);
+    __publicField(this, "status");
+    this.status = status;
+    if (message) {
+      this.message = message;
+    } else {
+      this.message = (_a = httpErrorCodeLookup[this.status]) != null ? _a : "API_ERROR";
+    }
+    Object.defineProperty(this, "message", { enumerable: true });
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var APIError_default = APIError;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  APIError,
   addDaysToDate,
   appendSemicolon,
   convertFileToBase64,
   formatDateAndTime,
   getRandomNumber,
+  httpErrorCodeLookup,
   isLeapYear,
   isMonthlyMultiple,
   isSameDate,

package/dist/index.d.cts

@@ -16,6 +16,14 @@ declare function isMonthlyMultiple(firstDate: Date, secondDate: Date): boolean;
 
 declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 
+declare function randomiseArray(array: unknown[]): unknown[];
+
+declare function range(start: number, stop: number, step?: number): number[];
+
+declare function truncate(stringToTruncate: string, maxLength?: number): string;
+
+declare function wait(seconds: number): Promise<void>;
+
 declare const envSchema: z.ZodEnum<{
     test: "test";
     development: "development";
@@ -24,12 +32,11 @@ declare const envSchema: z.ZodEnum<{
 type Env = z.infer<typeof envSchema>;
 declare function newEnv(data?: unknown): Env;
 
-declare function randomiseArray(array: unknown[]): unknown[];
-
-declare function range(start: number, stop: number, step?: number): number[];
-
-declare function truncate(stringToTruncate: string, maxLength?: number): string;
-
-declare function wait(seconds: number): Promise<void>;
+type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
+declare const httpErrorCodeLookup: Record<HTTPErrorCodes, string>;
+declare class APIError extends Error {
+    status: number;
+    constructor(status?: number, message?: string, options?: ErrorOptions);
+}
 
-export { type Env, addDaysToDate, appendSemicolon, convertFileToBase64, formatDateAndTime, getRandomNumber, isLeapYear, isMonthlyMultiple, isSameDate, newEnv, randomiseArray, range, truncate, wait };
+export { APIError, type Env, type HTTPErrorCodes, addDaysToDate, appendSemicolon, convertFileToBase64, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, isLeapYear, isMonthlyMultiple, isSameDate, newEnv, randomiseArray, range, truncate, wait };

package/dist/index.d.ts

@@ -16,6 +16,14 @@ declare function isMonthlyMultiple(firstDate: Date, secondDate: Date): boolean;
 
 declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 
+declare function randomiseArray(array: unknown[]): unknown[];
+
+declare function range(start: number, stop: number, step?: number): number[];
+
+declare function truncate(stringToTruncate: string, maxLength?: number): string;
+
+declare function wait(seconds: number): Promise<void>;
+
 declare const envSchema: z.ZodEnum<{
     test: "test";
     development: "development";
@@ -24,12 +32,11 @@ declare const envSchema: z.ZodEnum<{
 type Env = z.infer<typeof envSchema>;
 declare function newEnv(data?: unknown): Env;
 
-declare function randomiseArray(array: unknown[]): unknown[];
-
-declare function range(start: number, stop: number, step?: number): number[];
-
-declare function truncate(stringToTruncate: string, maxLength?: number): string;
-
-declare function wait(seconds: number): Promise<void>;
+type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
+declare const httpErrorCodeLookup: Record<HTTPErrorCodes, string>;
+declare class APIError extends Error {
+    status: number;
+    constructor(status?: number, message?: string, options?: ErrorOptions);
+}
 
-export { type Env, addDaysToDate, appendSemicolon, convertFileToBase64, formatDateAndTime, getRandomNumber, isLeapYear, isMonthlyMultiple, isSameDate, newEnv, randomiseArray, range, truncate, wait };
+export { APIError, type Env, type HTTPErrorCodes, addDaysToDate, appendSemicolon, convertFileToBase64, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, isLeapYear, isMonthlyMultiple, isSameDate, newEnv, randomiseArray, range, truncate, wait };

package/dist/index.js

@@ -1,4 +1,8 @@
-// src/addDaysToDate.ts
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/functions/addDaysToDate.ts
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
   const newDate = currentDate;
   newDate.setDate(newDate.getDate() + dayIncrement);
@@ -6,7 +10,7 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 }
 var addDaysToDate_default = addDaysToDate;
 
-// src/appendSemicolon.ts
+// src/functions/appendSemicolon.ts
 function appendSemicolon(stringToAppendTo) {
   if (stringToAppendTo.includes("\n")) {
     throw new Error("MULTIPLE_LINE_ERROR");
@@ -19,7 +23,7 @@ function appendSemicolon(stringToAppendTo) {
 }
 var appendSemicolon_default = appendSemicolon;
 
-// src/convertFileToBase64.ts
+// src/functions/convertFileToBase64.ts
 function convertFileToBase64(file) {
   return new Promise((resolve, reject) => {
     const reader = new FileReader();
@@ -38,13 +42,13 @@ function convertFileToBase64(file) {
 }
 var convertFileToBase64_default = convertFileToBase64;
 
-// src/isSameDate.ts
+// src/functions/isSameDate.ts
 function isSameDate(firstDate, secondDate) {
   return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
 var isSameDate_default = isSameDate;
 
-// src/formatDateAndTime.ts
+// src/functions/formatDateAndTime.ts
 function formatDateAndTime(inputDate) {
   const yesterday = addDaysToDate_default(/* @__PURE__ */ new Date(), -1);
   const today = /* @__PURE__ */ new Date();
@@ -62,7 +66,7 @@ function formatDateAndTime(inputDate) {
 }
 var formatDateAndTime_default = formatDateAndTime;
 
-// src/getRandomNumber.ts
+// src/functions/getRandomNumber.ts
 function getRandomNumber(lowerBound, upperBound) {
   if (lowerBound % 1 !== 0 || upperBound % 1 !== 0) {
     throw new Error("NON_INTEGER_INPUTS");
@@ -71,7 +75,7 @@ function getRandomNumber(lowerBound, upperBound) {
 }
 var getRandomNumber_default = getRandomNumber;
 
-// src/isLeapYear.ts
+// src/functions/isLeapYear.ts
 function isLeapYear(year) {
   if (year % 1 !== 0) {
     throw new Error("NON_INTEGER_INPUT");
@@ -80,7 +84,7 @@ function isLeapYear(year) {
 }
 var isLeapYear_default = isLeapYear;
 
-// src/isMonthlyMultiple.ts
+// src/functions/isMonthlyMultiple.ts
 function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
   if ([3, 5, 8, 10].includes(firstDate.getMonth())) {
     return firstDate.getDate() === 30 && secondDate.getDate() === 31;
@@ -117,15 +121,7 @@ function isMonthlyMultiple(firstDate, secondDate) {
 }
 var isMonthlyMultiple_default = isMonthlyMultiple;
 
-// src/newEnv.ts
-import { z } from "zod";
-var envSchema = z.enum(["test", "development", "production"]);
-function newEnv(data = "development") {
-  return envSchema.parse(data);
-}
-var newEnv_default = newEnv;
-
-// src/randomiseArray.ts
+// src/functions/randomiseArray.ts
 function randomiseArray(array) {
   const mutableArray = [...array];
   const outputArray = [];
@@ -137,7 +133,7 @@ function randomiseArray(array) {
 }
 var randomiseArray_default = randomiseArray;
 
-// src/range.ts
+// src/functions/range.ts
 function range(start, stop, step = 1) {
   const numbers = [];
   if (step === 0) {
@@ -161,13 +157,13 @@ function range(start, stop, step = 1) {
 }
 var range_default = range;
 
-// src/truncate.ts
+// src/functions/truncate.ts
 function truncate(stringToTruncate, maxLength = 5) {
   return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
 var truncate_default = truncate;
 
-// src/wait.ts
+// src/functions/wait.ts
 function wait(seconds) {
   return new Promise((resolve, _) => {
     setTimeout(() => {
@@ -176,16 +172,54 @@ function wait(seconds) {
   });
 }
 var wait_default = wait;
+
+// src/types/Env.ts
+import { z } from "zod";
+var envSchema = z.enum(["test", "development", "production"]);
+function newEnv(data = "development") {
+  return envSchema.parse(data);
+}
+var Env_default = newEnv;
+
+// src/types/APIError.ts
+var httpErrorCodeLookup = {
+  400: "BAD_REQUEST",
+  401: "UNAUTHORISED",
+  403: "FORBIDDEN",
+  404: "NOT_FOUND",
+  /* Supporting this one too because it's funny. You'll never use it in practice because 
+                why would an error give a teapot, but it's funny. Do not question me. */
+  418: "I_AM_A_TEAPOT",
+  500: "INTERNAL_SERVER_ERROR"
+};
+var APIError = class extends Error {
+  constructor(status = 500, message, options) {
+    var _a;
+    super(message, options);
+    __publicField(this, "status");
+    this.status = status;
+    if (message) {
+      this.message = message;
+    } else {
+      this.message = (_a = httpErrorCodeLookup[this.status]) != null ? _a : "API_ERROR";
+    }
+    Object.defineProperty(this, "message", { enumerable: true });
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var APIError_default = APIError;
 export {
+  APIError_default as APIError,
   addDaysToDate_default as addDaysToDate,
   appendSemicolon_default as appendSemicolon,
   convertFileToBase64_default as convertFileToBase64,
   formatDateAndTime_default as formatDateAndTime,
   getRandomNumber_default as getRandomNumber,
+  httpErrorCodeLookup,
   isLeapYear_default as isLeapYear,
   isMonthlyMultiple_default as isMonthlyMultiple,
   isSameDate_default as isSameDate,
-  newEnv_default as newEnv,
+  Env_default as newEnv,
   randomiseArray_default as randomiseArray,
   range_default as range,
   truncate_default as truncate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "1.12.1",
+  "version": "1.13.1",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,10 +25,10 @@
   "license": "ISC",
   "description": "",
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^1.6.5",
-    "@eslint/js": "^9.33.0",
+    "@alextheman/eslint-plugin": "^1.6.8",
+    "@eslint/js": "^9.34.0",
     "@types/node": "^24.3.0",
-    "eslint": "^9.33.0",
+    "eslint": "^9.34.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.3.0",
@@ -42,6 +42,6 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "zod": "^4.0.17"
+    "zod": "^4.1.0"
   }
 }