@alextheman/utility 4.6.0 → 4.8.0

package/dist/index.cjs

@@ -857,27 +857,37 @@ var parseBoolean_default = parseBoolean;
 *
 * @category Parsers
 *
-* @template Output - The Zod output type.
-* @template Input - The Zod input type.
-* @template Internals - The Zod internal types based on the output and input types.
+* @template SchemaType - The Zod schema type.
 * @template ErrorType - The type of error to throw on invalid data.
 *
 * @param schema - The Zod schema to use in parsing.
 * @param data - The data to parse.
-* @param error - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error.
+* @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
 *
 * @throws {DataError} If the given data cannot be parsed according to the schema.
 *
 * @returns The parsed data from the Zod schema.
 */
-function parseZodSchema(schema, data, error) {
+function parseZodSchema(schema, data, onError) {
 	const parsedResult = schema.safeParse(data);
 	if (!parsedResult.success) {
-		if (error) {
-			if (error instanceof Error) throw error;
-			else if (typeof error === "function") throw error(parsedResult.error);
+		if (onError) {
+			if (onError instanceof Error) throw onError;
+			else if (typeof onError === "function") {
+				const evaluatedError = onError(parsedResult.error);
+				if (evaluatedError instanceof Error) throw evaluatedError;
+			}
+		}
+		const allErrorCodes = {};
+		for (const issue of parsedResult.error.issues) {
+			const code = issue.code.toUpperCase();
+			allErrorCodes[code] = (allErrorCodes[code] ?? 0) + 1;
 		}
-		throw new DataError_default(data, parsedResult.error.issues[0]?.code.toUpperCase(), parsedResult.error.issues[0].message);
+		throw new DataError_default(data, Object.entries(allErrorCodes).toSorted(([_, firstCount], [__, secondCount]) => {
+			return secondCount - firstCount;
+		}).map(([code, count], _, allErrorCodes$1) => {
+			return allErrorCodes$1.length === 1 && count === 1 ? code : `${code}×${count}`;
+		}).join(","), `\n\n${zod.z.prettifyError(parsedResult.error)}\n`);
 	}
 	return parsedResult.data;
 }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { DotenvParseOutput } from "dotenv";
-import { ZodError, ZodType, core } from "zod";
+import { ZodError, ZodType, z } from "zod";
 
 //#region src/constants/NAMESPACE_EXPORT_REGEX.d.ts
 declare const NAMESPACE_EXPORT_REGEX = "export\\s+\\*\\s+from";
@@ -684,20 +684,18 @@ declare function parseVersionType(data: unknown): VersionType;
  *
  * @category Parsers
  *
- * @template Output - The Zod output type.
- * @template Input - The Zod input type.
- * @template Internals - The Zod internal types based on the output and input types.
+ * @template SchemaType - The Zod schema type.
  * @template ErrorType - The type of error to throw on invalid data.
  *
  * @param schema - The Zod schema to use in parsing.
  * @param data - The data to parse.
- * @param error - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error.
+ * @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
  *
  * @throws {DataError} If the given data cannot be parsed according to the schema.
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<Output, Input, Internals extends core.$ZodTypeInternals<Output, Input>, ErrorType extends Error>(schema: ZodType<Output, Input, Internals>, data: unknown, error?: ErrorType | ((zodError: ZodError) => ErrorType)): core.output<ZodType<Output, Input, Internals>>;
+declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error>(schema: SchemaType, data: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
 //#endregion
 //#region src/functions/recursive/deepCopy.d.ts
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ZodError, ZodType, core } from "zod";
+import { ZodError, ZodType, z as z$1 } from "zod";
 import { DotenvParseOutput } from "dotenv";
 
 //#region src/constants/NAMESPACE_EXPORT_REGEX.d.ts
@@ -684,20 +684,18 @@ declare function parseVersionType(data: unknown): VersionType;
  *
  * @category Parsers
  *
- * @template Output - The Zod output type.
- * @template Input - The Zod input type.
- * @template Internals - The Zod internal types based on the output and input types.
+ * @template SchemaType - The Zod schema type.
  * @template ErrorType - The type of error to throw on invalid data.
  *
  * @param schema - The Zod schema to use in parsing.
  * @param data - The data to parse.
- * @param error - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error.
+ * @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
  *
  * @throws {DataError} If the given data cannot be parsed according to the schema.
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<Output, Input, Internals extends core.$ZodTypeInternals<Output, Input>, ErrorType extends Error>(schema: ZodType<Output, Input, Internals>, data: unknown, error?: ErrorType | ((zodError: ZodError) => ErrorType)): core.output<ZodType<Output, Input, Internals>>;
+declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error>(schema: SchemaType, data: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z$1.infer<SchemaType>;
 //#endregion
 //#region src/functions/recursive/deepCopy.d.ts
 /**

package/dist/index.js

@@ -827,27 +827,37 @@ var parseBoolean_default = parseBoolean;
 *
 * @category Parsers
 *
-* @template Output - The Zod output type.
-* @template Input - The Zod input type.
-* @template Internals - The Zod internal types based on the output and input types.
+* @template SchemaType - The Zod schema type.
 * @template ErrorType - The type of error to throw on invalid data.
 *
 * @param schema - The Zod schema to use in parsing.
 * @param data - The data to parse.
-* @param error - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error.
+* @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
 *
 * @throws {DataError} If the given data cannot be parsed according to the schema.
 *
 * @returns The parsed data from the Zod schema.
 */
-function parseZodSchema(schema, data, error) {
+function parseZodSchema(schema, data, onError) {
 	const parsedResult = schema.safeParse(data);
 	if (!parsedResult.success) {
-		if (error) {
-			if (error instanceof Error) throw error;
-			else if (typeof error === "function") throw error(parsedResult.error);
+		if (onError) {
+			if (onError instanceof Error) throw onError;
+			else if (typeof onError === "function") {
+				const evaluatedError = onError(parsedResult.error);
+				if (evaluatedError instanceof Error) throw evaluatedError;
+			}
+		}
+		const allErrorCodes = {};
+		for (const issue of parsedResult.error.issues) {
+			const code = issue.code.toUpperCase();
+			allErrorCodes[code] = (allErrorCodes[code] ?? 0) + 1;
 		}
-		throw new DataError_default(data, parsedResult.error.issues[0]?.code.toUpperCase(), parsedResult.error.issues[0].message);
+		throw new DataError_default(data, Object.entries(allErrorCodes).toSorted(([_, firstCount], [__, secondCount]) => {
+			return secondCount - firstCount;
+		}).map(([code, count], _, allErrorCodes$1) => {
+			return allErrorCodes$1.length === 1 && count === 1 ? code : `${code}×${count}`;
+		}).join(","), `\n\n${z$1.prettifyError(parsedResult.error)}\n`);
 	}
 	return parsedResult.data;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "4.6.0",
+  "version": "4.8.0",
   "description": "Helpful utility functions.",
   "repository": {
     "type": "git",
@@ -23,20 +23,20 @@
   "devDependencies": {
     "@alextheman/eslint-plugin": "^5.4.2",
     "@types/libsodium-wrappers": "^0.7.14",
-    "@types/node": "^25.0.5",
-    "@typescript-eslint/types": "^8.52.0",
-    "alex-c-line": "^1.17.0",
+    "@types/node": "^25.0.9",
+    "@typescript-eslint/types": "^8.53.0",
+    "alex-c-line": "^1.18.4",
     "dotenv-cli": "^11.0.0",
     "eslint": "^9.39.2",
     "globals": "^17.0.0",
     "husky": "^9.1.7",
     "jsdom": "^27.4.0",
-    "prettier": "^3.7.4",
-    "tsdown": "^0.18.4",
-    "typedoc": "^0.28.15",
+    "prettier": "^3.8.0",
+    "tsdown": "^0.19.0",
+    "typedoc": "^0.28.16",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^6.0.4",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.17"
   },
   "engines": {
     "node": ">=22.0.0"