@hy_ong/zod-kit 0.0.4 → 0.0.6

package/eslint.config.mts

@@ -0,0 +1,8 @@
+import eslintJs from "@eslint/js"
+import eslintTs from "typescript-eslint"
+
+export default eslintTs.config(eslintJs.configs.recommended, eslintTs.configs.recommended, {
+  rules: {
+    "@typescript-eslint/no-explicit-any": "off",
+  },
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hy_ong/zod-kit",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Zod Kit",
   "keywords": [
     "hy_ong",
@@ -19,7 +19,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "ISC",
+  "license": "MIT",
   "author": "Ong Hoe Yuan",
   "type": "module",
   "main": "dist/index.cjs",
@@ -29,7 +29,7 @@
     ".": {
       "import": "./dist/index.js",
       "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
@@ -37,17 +37,18 @@
     "test": "vitest"
   },
   "dependencies": {
-    "dayjs": "^1.11.13",
-    "zod": "^4.0.15"
+    "dayjs": "^1.11.14",
+    "zod": "^4.1.4"
   },
   "devDependencies": {
-    "@eslint/js": "^9.32.0",
-    "@types/node": "^22.17.0",
-    "eslint": "^9.32.0",
+    "@eslint/js": "^9.34.0",
+    "@types/node": "^20.19.11",
+    "eslint": "^9.34.0",
+    "jiti": "^2.5.1",
     "prettier": "^3.6.2",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.39.0",
+    "typescript-eslint": "^8.41.0",
     "vitest": "^3.2.4"
   }
 }

package/src/config.ts

@@ -1,6 +1,6 @@
 export type Locale = "zh-TW" | "en"
 
-let currentLocale: Locale = "zh-TW"
+let currentLocale: Locale = "en"
 
 export const setLocale = (locale: Locale) => {
   currentLocale = locale

package/src/i18n/locales/en.json

@@ -2,25 +2,40 @@
   "common": {
     "boolean": {
       "required": "Required",
-      "shouldBe": {
-        "true": "Must be True",
-        "false": "Must be False"
-      }
+      "shouldBeTrue": "Must be True",
+      "shouldBeFalse": "Must be False",
+      "invalid": "Must be a boolean value"
     },
     "email": {
       "required": "Required",
-      "min": "Must be at least ${min} characters",
-      "max": "Must be at most ${max} characters",
+      "invalid": "Invalid email format",
+      "minLength": "Must be at least ${minLength} characters",
+      "maxLength": "Must be at most ${maxLength} characters",
       "includes": "Must include ${includes}",
-      "invalid": "Invalid format",
-      "domain": "Must be under the domain @${domain}"
+      "domain": "Must be from domain: ${domain}",
+      "domainBlacklist": "Domain ${domain} is not allowed",
+      "businessOnly": "Only business email addresses are allowed",
+      "noDisposable": "Disposable email addresses are not allowed"
     },
     "url": {
       "required": "Required",
+      "invalid": "Invalid URL format",
       "min": "Must be at least ${min} characters",
       "max": "Must be at most ${max} characters",
       "includes": "Must include ${includes}",
-      "invalid": "Invalid format"
+      "excludes": "Must not contain ${excludes}",
+      "protocol": "Protocol must be one of: ${protocols}",
+      "domain": "Domain must be one of: ${domains}",
+      "domainBlacklist": "Domain ${domain} is not allowed",
+      "port": "Port must be one of: ${ports}",
+      "pathStartsWith": "Path must start with ${path}",
+      "pathEndsWith": "Path must end with ${path}",
+      "hasQuery": "URL must have query parameters",
+      "noQuery": "URL must not have query parameters",
+      "hasFragment": "URL must have a fragment",
+      "noFragment": "URL must not have a fragment",
+      "localhost": "Localhost URLs are not allowed",
+      "noLocalhost": "Localhost URLs are not allowed"
     },
     "password": {
       "required": "Required",
@@ -29,40 +44,161 @@
       "uppercase": "Must include at least one uppercase letter",
       "lowercase": "Must include at least one lowercase letter",
       "digits": "Must include at least one digit",
-      "special": "Must include at least one special character"
+      "special": "Must include at least one special character",
+      "noRepeating": "Must not contain repeating characters",
+      "noSequential": "Must not contain sequential characters",
+      "noCommonWords": "Must not contain common words or patterns",
+      "minStrength": "Password strength must be at least ${minStrength}",
+      "excludes": "Must not contain ${excludes}",
+      "includes": "Must include ${includes}",
+      "invalid": "Invalid password format"
     },
     "number": {
       "required": "Required",
-      "min": "Must be at least ${min}",
-      "max": "Must be at most ${max}"
-    },
-    "integer": {
-      "required": "Required",
+      "invalid": "Must be a valid number",
+      "integer": "Must be an integer",
+      "float": "Must be a decimal number",
       "min": "Must be at least ${min}",
       "max": "Must be at most ${max}",
-      "integer": "Must be an integer"
+      "positive": "Must be positive",
+      "negative": "Must be negative", 
+      "nonNegative": "Must be non-negative",
+      "nonPositive": "Must be non-positive",
+      "multipleOf": "Must be a multiple of ${multipleOf}",
+      "finite": "Must be a finite number",
+      "precision": "Must have at most ${precision} decimal places"
     },
-    "float": {
+    "id": {
       "required": "Required",
-      "min": "Must be at least ${min}",
-      "max": "Must be at most ${max}",
-      "float": "Must be an float"
+      "invalid": "Invalid ID format",
+      "minLength": "Must be at least ${minLength} characters",
+      "maxLength": "Must be at most ${maxLength} characters",
+      "numeric": "Must be a numeric ID",
+      "uuid": "Must be a valid UUID",
+      "objectId": "Must be a valid MongoDB ObjectId",
+      "nanoid": "Must be a valid Nano ID",
+      "snowflake": "Must be a valid Snowflake ID",
+      "cuid": "Must be a valid CUID",
+      "ulid": "Must be a valid ULID",
+      "shortid": "Must be a valid Short ID",
+      "customFormat": "Invalid ID format",
+      "includes": "Must include ${includes}",
+      "excludes": "Must not contain ${excludes}",
+      "startsWith": "Must start with ${startsWith}",
+      "endsWith": "Must end with ${endsWith}"
     },
     "text": {
       "required": "Required",
-      "min": "Must be at least ${min} characters",
-      "max": "Must be at most ${max} characters",
+      "notEmpty": "Cannot be empty or whitespace only",
+      "minLength": "Must be at least ${minLength} characters",
+      "maxLength": "Must be at most ${maxLength} characters",
       "startsWith": "Must start with ${startsWith}",
       "endsWith": "Must end with ${endsWith}",
       "includes": "Must include ${includes}",
+      "excludes": "Must not contain ${excludes}",
       "invalid": "Invalid format"
     },
     "date": {
       "required": "Required",
-      "min": "Must be at least ${min} characters",
-      "max": "Must be at most ${max} characters",
+      "invalid": "Invalid date",
+      "format": "Must be in ${format} format",
+      "min": "Date must be on or after ${min}",
+      "max": "Date must be on or before ${max}",
+      "includes": "Must include ${includes}",
+      "excludes": "Must not contain ${excludes}",
+      "past": "Date must be in the past",
+      "future": "Date must be in the future",
+      "today": "Date must be today",
+      "notToday": "Date must not be today",
+      "weekday": "Date must be a weekday (Monday-Friday)",
+      "weekend": "Date must be a weekend (Saturday-Sunday)"
+    },
+    "time": {
+      "required": "Required",
+      "invalid": "Invalid time format",
+      "format": "Must be in ${format} format",
+      "min": "Time must be after ${min}",
+      "max": "Time must be before ${max}",
+      "hour": "Hour must be between ${minHour} and ${maxHour}",
+      "minute": "Minutes must be in ${minuteStep}-minute intervals",
+      "second": "Seconds must be in ${secondStep}-second intervals",
       "includes": "Must include ${includes}",
-      "format": "Must be in ${format} format"
+      "excludes": "Must not contain ${excludes}",
+      "customRegex": "Invalid time format",
+      "notInWhitelist": "Time is not in the allowed list"
+    },
+    "datetime": {
+      "required": "Required",
+      "invalid": "Invalid datetime format",
+      "format": "Must be in ${format} format",
+      "min": "DateTime must be after ${min}",
+      "max": "DateTime must be before ${max}",
+      "hour": "Hour must be between ${minHour} and ${maxHour}",
+      "minute": "Minutes must be in ${minuteStep}-minute intervals",
+      "includes": "Must include ${includes}",
+      "excludes": "Must not contain ${excludes}",
+      "past": "DateTime must be in the past",
+      "future": "DateTime must be in the future",
+      "today": "DateTime must be today",
+      "notToday": "DateTime must not be today",
+      "weekday": "DateTime must be a weekday (Monday-Friday)",
+      "weekend": "DateTime must be a weekend (Saturday-Sunday)",
+      "customRegex": "Invalid datetime format",
+      "notInWhitelist": "DateTime is not in the allowed list"
+    },
+    "file": {
+      "required": "Required",
+      "invalid": "Invalid file format",
+      "size": "File size must not exceed ${size}",
+      "minSize": "File size must be at least ${minSize}",
+      "maxSize": "File size must not exceed ${maxSize}",
+      "type": "File type must be one of: ${type}",
+      "extension": "File extension must be one of: ${extension}",
+      "extensionBlacklist": "File extension ${extension} is not allowed",
+      "name": "File name must match pattern ${pattern}",
+      "nameBlacklist": "File name must not match pattern ${pattern}",
+      "imageOnly": "Only image files are allowed",
+      "documentOnly": "Only document files are allowed",
+      "videoOnly": "Only video files are allowed",
+      "audioOnly": "Only audio files are allowed",
+      "archiveOnly": "Only archive files are allowed"
+    }
+  },
+  "taiwan": {
+    "businessId": {
+      "required": "Required",
+      "invalid": "Invalid Taiwan Business ID"
+    },
+    "nationalId": {
+      "required": "Required",
+      "invalid": "Invalid Taiwan National ID"
+    },
+    "mobile": {
+      "required": "Required",
+      "invalid": "Invalid Taiwan mobile phone format",
+      "notInWhitelist": "Not in allowed mobile phone list"
+    },
+    "tel": {
+      "required": "Required",
+      "invalid": "Invalid Taiwan telephone format",
+      "notInWhitelist": "Not in allowed telephone list"
+    },
+    "fax": {
+      "required": "Required",
+      "invalid": "Invalid Taiwan fax format",
+      "notInWhitelist": "Not in allowed fax list"
+    },
+    "postalCode": {
+      "required": "Required",
+      "invalid": "Invalid Taiwan postal code",
+      "invalidFormat": "Invalid postal code format",
+      "invalidRange": "Postal code is outside valid range",
+      "legacy5DigitWarning": "5-digit postal codes are legacy format, consider using 6-digit format",
+      "format3Only": "Only 3-digit postal codes are allowed",
+      "format5Only": "Only 5-digit postal codes are allowed",
+      "format6Only": "Only 6-digit postal codes are allowed",
+      "invalidSuffix": "Invalid postal code suffix - must be 01-99 for 5-digit or 001-999 for 6-digit codes",
+      "deprecated5Digit": "5-digit postal codes are deprecated and no longer supported"
     }
   }
 }

package/src/i18n/locales/zh-TW.json

@@ -2,25 +2,40 @@
   "common": {
     "boolean": {
       "required": "必填",
-      "shouldBe": {
-        "true": "必須為是",
-        "false": "必須為否"
-      }
+      "shouldBeTrue": "必須為是",
+      "shouldBeFalse": "必須為否",
+      "invalid": "必須為布林值"
     },
     "email": {
       "required": "必填",
-      "min": "長度至少 ${min} 字元",
-      "max": "長度最多 ${max} 字元",
+      "invalid": "電子郵件格式錯誤",
+      "minLength": "長度至少 ${minLength} 字元",
+      "maxLength": "長度最多 ${maxLength} 字元",
       "includes": "必須包含「${includes}」",
-      "invalid": "格式錯誤",
-      "domain": "必須為 @${domain} 網域"
+      "domain": "必須為 ${domain} 網域",
+      "domainBlacklist": "不允許使用 ${domain} 網域",
+      "businessOnly": "僅允許企業郵箱地址",
+      "noDisposable": "不允許使用臨時郵箱地址"
     },
     "url": {
       "required": "必填",
+      "invalid": "無效的 URL 格式",
       "min": "長度至少 ${min} 字元",
       "max": "長度最多 ${max} 字元",
       "includes": "必須包含「${includes}」",
-      "invalid": "格式錯誤"
+      "excludes": "不得包含「${excludes}」",
+      "protocol": "協議必須為：${protocols}",
+      "domain": "網域必須為：${domains}",
+      "domainBlacklist": "不允許使用網域 ${domain}",
+      "port": "連接埠必須為：${ports}",
+      "pathStartsWith": "路徑必須以「${path}」開頭",
+      "pathEndsWith": "路徑必須以「${path}」結尾",
+      "hasQuery": "URL 必須包含查詢參數",
+      "noQuery": "URL 不得包含查詢參數",
+      "hasFragment": "URL 必須包含錨點",
+      "noFragment": "URL 不得包含錨點",
+      "localhost": "不允許使用本機 URL",
+      "noLocalhost": "不允許使用本機 URL"
     },
     "password": {
       "required": "必填",
@@ -29,37 +44,161 @@
       "uppercase": "必須包含至少一個大寫字母",
       "lowercase": "必須包含至少一個小寫字母",
       "digits": "必須包含至少一個數字",
-      "special": "必須包含至少一個特殊符號"
+      "special": "必須包含至少一個特殊符號",
+      "noRepeating": "不可包含重複字元",
+      "noSequential": "不可包含連續字元",
+      "noCommonWords": "不可包含常見密碼或模式",
+      "minStrength": "密碼強度必須至少為 ${minStrength}",
+      "excludes": "不得包含「${excludes}」",
+      "includes": "必須包含「${includes}」",
+      "invalid": "密碼格式錯誤"
     },
     "number": {
       "required": "必填",
-      "min": "最小值 ${min}",
-      "max": "最大值 ${max}"
-    },
-    "id": {
-      "required": "請選擇",
-      "invalid": "無效"
-    },
-    "integer": {
-      "required": "必填",
+      "invalid": "必須為有效數字",
+      "integer": "必須為整數",
+      "float": "必須為小數",
       "min": "最小值 ${min}",
       "max": "最大值 ${max}",
-      "integer": "必須為整數"
+      "positive": "必須為正數",
+      "negative": "必須為負數",
+      "nonNegative": "不可為負數",
+      "nonPositive": "不可為正數",
+      "multipleOf": "必須為 ${multipleOf} 的倍數",
+      "finite": "必須為有限數字",
+      "precision": "小數位數不可超過 ${precision} 位"
     },
-    "float": {
+    "id": {
       "required": "必填",
-      "float": "必須為浮點數",
-      "min": "最小值 ${min}",
-      "max": "最大值 ${max}"
+      "invalid": "無效的 ID 格式",
+      "minLength": "長度至少 ${minLength} 字元",
+      "maxLength": "長度最多 ${maxLength} 字元",
+      "numeric": "必須為數字 ID",
+      "uuid": "必須為有效的 UUID",
+      "objectId": "必須為有效的 MongoDB ObjectId",
+      "nanoid": "必須為有效的 Nano ID",
+      "snowflake": "必須為有效的 Snowflake ID",
+      "cuid": "必須為有效的 CUID",
+      "ulid": "必須為有效的 ULID",
+      "shortid": "必須為有效的 Short ID",
+      "customFormat": "無效的 ID 格式",
+      "includes": "必須包含「${includes}」",
+      "excludes": "不得包含「${excludes}」",
+      "startsWith": "必須以「${startsWith}」開頭",
+      "endsWith": "必須以「${endsWith}」結尾"
     },
     "text": {
       "required": "必填",
-      "min": "長度至少 ${min} 字元",
-      "max": "長度最多 ${max} 字元",
+      "notEmpty": "不可為空白或僅含空格",
+      "minLength": "長度至少 ${minLength} 字元",
+      "maxLength": "長度最多 ${maxLength} 字元",
       "startsWith": "必須以「${startsWith}」開頭",
       "endsWith": "必須以「${endsWith}」結尾",
       "includes": "必須包含「${includes}」",
+      "excludes": "不得包含「${excludes}」",
       "invalid": "格式錯誤"
+    },
+    "date": {
+      "required": "必填",
+      "invalid": "無效日期",
+      "format": "必須為 ${format} 格式",
+      "min": "日期不得早於 ${min}",
+      "max": "日期不得晚於 ${max}",
+      "includes": "必須包含「${includes}」",
+      "excludes": "不得包含「${excludes}」",
+      "past": "必須為過去的日期",
+      "future": "必須為未來的日期",
+      "today": "必須為今天",
+      "notToday": "不得為今天",
+      "weekday": "必須為工作日（週一至週五）",
+      "weekend": "必須為週末（週六至週日）"
+    },
+    "time": {
+      "required": "必填",
+      "invalid": "無效的時間格式",
+      "format": "必須為 ${format} 格式",
+      "min": "時間不得早於 ${min}",
+      "max": "時間不得晚於 ${max}",
+      "hour": "小時必須介於 ${minHour} 與 ${maxHour} 之間",
+      "minute": "分鐘必須為 ${minuteStep} 分鐘間隔",
+      "second": "秒數必須為 ${secondStep} 秒間隔",
+      "includes": "必須包含「${includes}」",
+      "excludes": "不得包含「${excludes}」",
+      "customRegex": "無效的時間格式",
+      "notInWhitelist": "時間不在允許清單中"
+    },
+    "datetime": {
+      "required": "必填",
+      "invalid": "無效的日期時間格式",
+      "format": "必須為 ${format} 格式",
+      "min": "日期時間不得早於 ${min}",
+      "max": "日期時間不得晚於 ${max}",
+      "hour": "小時必須介於 ${minHour} 與 ${maxHour} 之間",
+      "minute": "分鐘必須為 ${minuteStep} 分鐘間隔",
+      "includes": "必須包含「${includes}」",
+      "excludes": "不得包含「${excludes}」",
+      "past": "必須為過去的日期時間",
+      "future": "必須為未來的日期時間",
+      "today": "必須為今天",
+      "notToday": "不得為今天",
+      "weekday": "必須為工作日（週一至週五）",
+      "weekend": "必須為週末（週六至週日）",
+      "customRegex": "無效的日期時間格式",
+      "notInWhitelist": "日期時間不在允許清單中"
+    },
+    "file": {
+      "required": "必填",
+      "invalid": "無效的檔案格式",
+      "size": "檔案大小不得超過 ${size}",
+      "minSize": "檔案大小至少 ${minSize}",
+      "maxSize": "檔案大小不得超過 ${maxSize}",
+      "type": "檔案類型必須為：${type}",
+      "extension": "副檔名必須為：${extension}",
+      "extensionBlacklist": "不允許使用副檔名 ${extension}",
+      "name": "檔案名稱必須符合格式 ${pattern}",
+      "nameBlacklist": "檔案名稱不得符合格式 ${pattern}",
+      "imageOnly": "僅允許圖片檔案",
+      "documentOnly": "僅允許文件檔案",
+      "videoOnly": "僅允許影片檔案",
+      "audioOnly": "僅允許音訊檔案",
+      "archiveOnly": "僅允許壓縮檔案"
+    }
+  },
+  "taiwan": {
+    "businessId": {
+      "required": "必填",
+      "invalid": "無效的統一編號"
+    },
+    "nationalId": {
+      "required": "必填",
+      "invalid": "無效的身分證字號"
+    },
+    "mobile": {
+      "required": "必填",
+      "invalid": "無效的手機號碼格式",
+      "notInWhitelist": "不在允許的手機號碼清單中"
+    },
+    "tel": {
+      "required": "必填",
+      "invalid": "無效的市話號碼格式",
+      "notInWhitelist": "不在允許的市話號碼清單中"
+    },
+    "fax": {
+      "required": "必填",
+      "invalid": "無效的傳真號碼格式",
+      "notInWhitelist": "不在允許的傳真號碼清單中"
+    },
+    "postalCode": {
+      "required": "必填",
+      "invalid": "無效的郵遞區號",
+      "invalidFormat": "郵遞區號格式錯誤",
+      "invalidRange": "郵遞區號超出有效範圍",
+      "legacy5DigitWarning": "5 碼郵遞區號為舊式格式，建議使用 6 碼格式",
+      "format3Only": "僅允許 3 碼郵遞區號",
+      "format5Only": "僅允許 5 碼郵遞區號",
+      "format6Only": "僅允許 6 碼郵遞區號",
+      "invalidSuffix": "無效的郵遞區號後碼 - 5 碼格式須為 01-99，6 碼格式須為 001-999",
+      "deprecated5Digit": "5 碼郵遞區號已棄用且不再支援"
     }
   }
 }

package/src/index.ts

@@ -1,8 +1,18 @@
-export * from "./common/boolean"
-export * from "./common/email"
-export * from "./common/url"
-export * from "./common/text"
-export * from "./common/number"
-export * from "./common/password"
-export * from "./common/integer"
+export * from "./validators/common/boolean"
+export * from "./validators/common/date"
+export * from "./validators/common/datetime"
+export * from "./validators/common/email"
+export * from "./validators/common/file"
+export * from "./validators/common/id"
+export * from "./validators/common/number"
+export * from "./validators/common/password"
+export * from "./validators/common/text"
+export * from "./validators/common/time"
+export * from "./validators/common/url"
+export * from "./validators/taiwan/business-id"
+export * from "./validators/taiwan/national-id"
+export * from "./validators/taiwan/mobile"
+export * from "./validators/taiwan/postal-code"
+export * from "./validators/taiwan/tel"
+export * from "./validators/taiwan/fax"
 export * from "./config"