@ptolemy2002/regex-utils 2.1.0 → 2.2.1

package/README.md

@@ -127,7 +127,7 @@ Checks if a string is a valid set of regular expression flags.
 
 ### interpretZodError
 #### Description
-Given a zod error, interprets it to `null` if no error is found, a single error message if there is a single error, or an array of error messages if there are multiple errors.
+Given a zod error, interprets it to `null` if no error is found, a single error message if there is a single error, or an array of error messages if there are multiple errors. The error messages will be in the format `<path>: <message>`.
 
 #### Parameters
 - `e` (`ZodError`): The zod error to be interpreted.
@@ -216,6 +216,15 @@ Uses `zodValidate` to check if a string is a valid Social Security Number (SSN).
 #### Returns
 `boolean` - `true` if the string is a valid SSN, `false` otherwise.
 
+## Schemas
+The following schemas are available in the library:
+
+### ZodCoercedBooleanEnum
+A zod schema that specifies an enum of strings that can be interpreted as booleans. This is used within `ZodCoercedBoolean` to actually perform the coercion.
+
+### ZodCoercedBoolean
+A zod schema that takes in a value accepted by `ZodCoercedBooleanEnum` and coerces it to a boolean. This is useful when you want to accept multiple values that can be interpreted as booleans.
+
 ## Peer Dependencies
 These should be installed in order to use the library, as npm does not automatically add peer dependencies to your project.
 - zod: ^3.23.8

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ZodError, ZodSchema } from "zod";
+import { z, ZodError, ZodSchema } from "zod";
 export type RegexInput = string | RegExp;
 export declare function combineFlags(...flags: string[]): string;
 export declare function escapeRegex(value: RegexInput, flags?: string): RegExp;
@@ -26,3 +26,5 @@ export declare function isValidEmail(v: string): boolean;
 export declare function isValidURL(v: string): boolean;
 export declare function isValidPhoneNumber(v: string): boolean;
 export declare function isValidSSN(v: string): boolean;
+export declare const ZodCoercedBooleanEnum: z.ZodEnum<["true", "false", "t", "f", "yes", "no", "y", "n", "1", "0", "on", "off"]>;
+export declare const ZodCoercedBoolean: z.ZodEffects<z.ZodEnum<["true", "false", "t", "f", "yes", "no", "y", "n", "1", "0", "on", "off"]>, boolean, "0" | "1" | "true" | "false" | "t" | "f" | "yes" | "no" | "y" | "n" | "on" | "off">;

package/dist/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZodCoercedBoolean = exports.ZodCoercedBooleanEnum = void 0;
 exports.combineFlags = combineFlags;
 exports.escapeRegex = escapeRegex;
 exports.regexAccentInsensitive = regexAccentInsensitive;
@@ -112,11 +113,17 @@ function isValidRegexFlags(value) {
 }
 function interpretZodError(e) {
     const { errors } = e;
+    function formatIssue(issue) {
+        const { path, message } = issue;
+        if (path.length === 0)
+            return message;
+        return `${path.join(".")}: ${message}`;
+    }
     if (errors.length === 0)
         return null;
     if (errors.length === 1)
-        return e.errors[0].message;
-    return errors.map((e) => e.message);
+        return formatIssue(errors[0]);
+    return errors.map((e) => formatIssue(e));
 }
 function zodValidate(p) {
     return (v) => {
@@ -157,3 +164,29 @@ function isValidPhoneNumber(v) {
 function isValidSSN(v) {
     return zodValidate(zod_1.z.coerce.string().regex(/^\d{3}-?\d{2}-?\d{4}$/))(v);
 }
+exports.ZodCoercedBooleanEnum = zod_1.z.enum([
+    "true", "false",
+    "t", "f",
+    "yes", "no",
+    "y", "n",
+    "1", "0",
+    "on", "off"
+]);
+exports.ZodCoercedBoolean = exports.ZodCoercedBooleanEnum.transform((val) => {
+    switch (val) {
+        case "true":
+        case "t":
+        case "yes":
+        case "y":
+        case "1":
+        case "on":
+            return true;
+        case "false":
+        case "f":
+        case "no":
+        case "n":
+        case "0":
+        case "off":
+            return false;
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ptolemy2002/regex-utils",
-    "version": "2.1.0",
+    "version": "2.2.1",
     "private": false,
     "main": "dist/index.js",
     "types": "dist/index.d.ts",