@alextheman/utility 1.16.3 → 1.18.0

package/dist/index.cjs

@@ -61,10 +61,12 @@ __export(index_exports, {
   formatDateAndTime: () => formatDateAndTime_default,
   getRandomNumber: () => getRandomNumber_default,
   httpErrorCodeLookup: () => httpErrorCodeLookup,
+  interpolateObjects: () => interpolateObjects_default,
   isLeapYear: () => isLeapYear_default,
   isMonthlyMultiple: () => isMonthlyMultiple_default,
   isSameDate: () => isSameDate_default,
   parseEnv: () => Env_default,
+  parseUUID: () => UUID_default,
   randomiseArray: () => randomiseArray_default,
   range: () => range_default,
   truncate: () => truncate_default,
@@ -255,7 +257,7 @@ function truncate(stringToTruncate, maxLength = 5) {
 var truncate_default = truncate;
 
 // src/functions/validateUUID.ts
-var import_zod2 = __toESM(require("zod"), 1);
+var import_zod3 = __toESM(require("zod"), 1);
 
 // src/types/APIError.ts
 var httpErrorCodeLookup = {
@@ -293,10 +295,18 @@ function parseEnv(data = "development") {
 }
 var Env_default = parseEnv;
 
+// src/types/UUID.ts
+var import_zod2 = __toESM(require("zod"), 1);
+var uuidSchema = import_zod2.default.uuid();
+function parseUUID(UUID) {
+  return uuidSchema.parse(UUID);
+}
+var UUID_default = parseUUID;
+
 // src/functions/validateUUID.ts
 function validateUUID(UUID, error = new APIError_default(400, "INVALID_UUID")) {
-  const uuidSchema = import_zod2.default.uuid();
-  const parsedUUID = uuidSchema.safeParse(UUID);
+  const uuidSchema2 = import_zod3.default.uuid();
+  const parsedUUID = uuidSchema2.safeParse(UUID);
   if (!parsedUUID.success) {
     throw error;
   }
@@ -313,6 +323,19 @@ function wait(seconds) {
   });
 }
 var wait_default = wait;
+
+// src/functions/taggedTemplate/interpolateObjects.ts
+function interpolateObjects(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i !== strings.length - 1) {
+      result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
+    }
+  }
+  return result;
+}
+var interpolateObjects_default = interpolateObjects;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APIError,
@@ -324,10 +347,12 @@ var wait_default = wait;
   formatDateAndTime,
   getRandomNumber,
   httpErrorCodeLookup,
+  interpolateObjects,
   isLeapYear,
   isMonthlyMultiple,
   isSameDate,
   parseEnv,
+  parseUUID,
   randomiseArray,
   range,
   truncate,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import z$1, { z } from 'zod';
 
 declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
 
@@ -41,8 +41,17 @@ declare const envSchema: z.ZodEnum<{
 type Env = z.infer<typeof envSchema>;
 declare function parseEnv(data?: unknown): Env;
 
+declare const uuidSchema: z$1.ZodUUID;
+type UUID = z$1.infer<typeof uuidSchema>;
+declare function parseUUID(UUID: unknown): UUID;
+
+/**
+ * @deprecated validateUUID() is deprecated in favour of parseUUID()
+ */
 declare function validateUUID(UUID: string, error?: Error | APIError): string;
 
 declare function wait(seconds: number): Promise<void>;
 
-export { APIError, type Env, type HTTPErrorCodes, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, fillArrayAsync, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, isLeapYear, isMonthlyMultiple, isSameDate, parseEnv, randomiseArray, range, truncate, validateUUID, wait };
+declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
+
+export { APIError, type Env, type HTTPErrorCodes, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, fillArrayAsync, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, parseEnv, parseUUID, randomiseArray, range, truncate, validateUUID, wait };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import z$1, { z } from 'zod';
 
 declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
 
@@ -41,8 +41,17 @@ declare const envSchema: z.ZodEnum<{
 type Env = z.infer<typeof envSchema>;
 declare function parseEnv(data?: unknown): Env;
 
+declare const uuidSchema: z$1.ZodUUID;
+type UUID = z$1.infer<typeof uuidSchema>;
+declare function parseUUID(UUID: unknown): UUID;
+
+/**
+ * @deprecated validateUUID() is deprecated in favour of parseUUID()
+ */
 declare function validateUUID(UUID: string, error?: Error | APIError): string;
 
 declare function wait(seconds: number): Promise<void>;
 
-export { APIError, type Env, type HTTPErrorCodes, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, fillArrayAsync, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, isLeapYear, isMonthlyMultiple, isSameDate, parseEnv, randomiseArray, range, truncate, validateUUID, wait };
+declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
+
+export { APIError, type Env, type HTTPErrorCodes, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, fillArrayAsync, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, parseEnv, parseUUID, randomiseArray, range, truncate, validateUUID, wait };

package/dist/index.js

@@ -204,7 +204,7 @@ function truncate(stringToTruncate, maxLength = 5) {
 var truncate_default = truncate;
 
 // src/functions/validateUUID.ts
-import z2 from "zod";
+import z3 from "zod";
 
 // src/types/APIError.ts
 var httpErrorCodeLookup = {
@@ -242,10 +242,18 @@ function parseEnv(data = "development") {
 }
 var Env_default = parseEnv;
 
+// src/types/UUID.ts
+import z2 from "zod";
+var uuidSchema = z2.uuid();
+function parseUUID(UUID) {
+  return uuidSchema.parse(UUID);
+}
+var UUID_default = parseUUID;
+
 // src/functions/validateUUID.ts
 function validateUUID(UUID, error = new APIError_default(400, "INVALID_UUID")) {
-  const uuidSchema = z2.uuid();
-  const parsedUUID = uuidSchema.safeParse(UUID);
+  const uuidSchema2 = z3.uuid();
+  const parsedUUID = uuidSchema2.safeParse(UUID);
   if (!parsedUUID.success) {
     throw error;
   }
@@ -262,6 +270,19 @@ function wait(seconds) {
   });
 }
 var wait_default = wait;
+
+// src/functions/taggedTemplate/interpolateObjects.ts
+function interpolateObjects(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i !== strings.length - 1) {
+      result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
+    }
+  }
+  return result;
+}
+var interpolateObjects_default = interpolateObjects;
 export {
   APIError_default as APIError,
   addDaysToDate_default as addDaysToDate,
@@ -272,10 +293,12 @@ export {
   formatDateAndTime_default as formatDateAndTime,
   getRandomNumber_default as getRandomNumber,
   httpErrorCodeLookup,
+  interpolateObjects_default as interpolateObjects,
   isLeapYear_default as isLeapYear,
   isMonthlyMultiple_default as isMonthlyMultiple,
   isSameDate_default as isSameDate,
   Env_default as parseEnv,
+  UUID_default as parseUUID,
   randomiseArray_default as randomiseArray,
   range_default as range,
   truncate_default as truncate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "1.16.3",
+  "version": "1.18.0",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,22 +26,22 @@
   "description": "",
   "devDependencies": {
     "@alextheman/eslint-plugin": "^1.14.1",
-    "@eslint/js": "^9.35.0",
-    "@types/node": "^24.3.2",
-    "eslint": "^9.35.0",
+    "@eslint/js": "^9.36.0",
+    "@types/node": "^24.5.2",
+    "eslint": "^9.36.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
     "husky": "^9.1.7",
-    "jsdom": "^26.1.0",
+    "jsdom": "^27.0.0",
     "prettier": "^3.6.2",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.43.0",
+    "typescript-eslint": "^8.44.0",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "zod": "^4.1.8"
+    "zod": "^4.1.9"
   }
 }