@hy_ong/zod-kit 0.2.1 → 0.2.2

package/src/i18n/locales/id-ID.json

@@ -75,6 +75,14 @@
       "maxLength": "Harus maksimal ${maxLength} karakter",
       "numeric": "Harus berupa ID numerik",
       "uuid": "Harus berupa UUID yang valid",
+      "uuidv1": "Harus berupa UUID v1 yang valid",
+      "uuidv2": "Harus berupa UUID v2 yang valid",
+      "uuidv3": "Harus berupa UUID v3 yang valid",
+      "uuidv4": "Harus berupa UUID v4 yang valid",
+      "uuidv5": "Harus berupa UUID v5 yang valid",
+      "uuidv6": "Harus berupa UUID v6 yang valid",
+      "uuidv7": "Harus berupa UUID v7 yang valid",
+      "uuidv8": "Harus berupa UUID v8 yang valid",
       "objectId": "Harus berupa MongoDB ObjectId yang valid",
       "nanoid": "Harus berupa Nano ID yang valid",
       "snowflake": "Harus berupa Snowflake ID yang valid",

package/src/i18n/locales/ja-JP.json

@@ -75,6 +75,14 @@
       "maxLength": "${maxLength}文字以下で入力してください",
       "numeric": "数値IDである必要があります",
       "uuid": "有効なUUIDである必要があります",
+      "uuidv1": "有効なUUID v1である必要があります",
+      "uuidv2": "有効なUUID v2である必要があります",
+      "uuidv3": "有効なUUID v3である必要があります",
+      "uuidv4": "有効なUUID v4である必要があります",
+      "uuidv5": "有効なUUID v5である必要があります",
+      "uuidv6": "有効なUUID v6である必要があります",
+      "uuidv7": "有効なUUID v7である必要があります",
+      "uuidv8": "有効なUUID v8である必要があります",
       "objectId": "有効なMongoDB ObjectIdである必要があります",
       "nanoid": "有効なNano IDである必要があります",
       "snowflake": "有効なSnowflake IDである必要があります",

package/src/i18n/locales/ko-KR.json

@@ -75,6 +75,14 @@
       "maxLength": "최대 ${maxLength}자 이하여야 합니다",
       "numeric": "숫자 ID여야 합니다",
       "uuid": "유효한 UUID여야 합니다",
+      "uuidv1": "유효한 UUID v1이어야 합니다",
+      "uuidv2": "유효한 UUID v2이어야 합니다",
+      "uuidv3": "유효한 UUID v3이어야 합니다",
+      "uuidv4": "유효한 UUID v4이어야 합니다",
+      "uuidv5": "유효한 UUID v5이어야 합니다",
+      "uuidv6": "유효한 UUID v6이어야 합니다",
+      "uuidv7": "유효한 UUID v7이어야 합니다",
+      "uuidv8": "유효한 UUID v8이어야 합니다",
       "objectId": "유효한 MongoDB ObjectId여야 합니다",
       "nanoid": "유효한 Nano ID여야 합니다",
       "snowflake": "유효한 Snowflake ID여야 합니다",

package/src/i18n/locales/ms-MY.json

@@ -75,6 +75,14 @@
       "maxLength": "Mesti tidak melebihi ${maxLength} aksara",
       "numeric": "Mesti ID numerik",
       "uuid": "Mesti UUID yang sah",
+      "uuidv1": "Mesti UUID v1 yang sah",
+      "uuidv2": "Mesti UUID v2 yang sah",
+      "uuidv3": "Mesti UUID v3 yang sah",
+      "uuidv4": "Mesti UUID v4 yang sah",
+      "uuidv5": "Mesti UUID v5 yang sah",
+      "uuidv6": "Mesti UUID v6 yang sah",
+      "uuidv7": "Mesti UUID v7 yang sah",
+      "uuidv8": "Mesti UUID v8 yang sah",
       "objectId": "Mesti MongoDB ObjectId yang sah",
       "nanoid": "Mesti Nano ID yang sah",
       "snowflake": "Mesti Snowflake ID yang sah",

package/src/i18n/locales/th-TH.json

@@ -75,6 +75,14 @@
       "maxLength": "ต้องไม่เกิน ${maxLength} ตัวอักษร",
       "numeric": "ต้องเป็น ID ตัวเลข",
       "uuid": "ต้องเป็น UUID ที่ถูกต้อง",
+      "uuidv1": "ต้องเป็น UUID v1 ที่ถูกต้อง",
+      "uuidv2": "ต้องเป็น UUID v2 ที่ถูกต้อง",
+      "uuidv3": "ต้องเป็น UUID v3 ที่ถูกต้อง",
+      "uuidv4": "ต้องเป็น UUID v4 ที่ถูกต้อง",
+      "uuidv5": "ต้องเป็น UUID v5 ที่ถูกต้อง",
+      "uuidv6": "ต้องเป็น UUID v6 ที่ถูกต้อง",
+      "uuidv7": "ต้องเป็น UUID v7 ที่ถูกต้อง",
+      "uuidv8": "ต้องเป็น UUID v8 ที่ถูกต้อง",
       "objectId": "ต้องเป็น MongoDB ObjectId ที่ถูกต้อง",
       "nanoid": "ต้องเป็น Nano ID ที่ถูกต้อง",
       "snowflake": "ต้องเป็น Snowflake ID ที่ถูกต้อง",

package/src/i18n/locales/vi-VN.json

@@ -75,6 +75,14 @@
       "maxLength": "Phải có tối đa ${maxLength} ký tự",
       "numeric": "Phải là ID dạng số",
       "uuid": "Phải là UUID hợp lệ",
+      "uuidv1": "Phải là UUID v1 hợp lệ",
+      "uuidv2": "Phải là UUID v2 hợp lệ",
+      "uuidv3": "Phải là UUID v3 hợp lệ",
+      "uuidv4": "Phải là UUID v4 hợp lệ",
+      "uuidv5": "Phải là UUID v5 hợp lệ",
+      "uuidv6": "Phải là UUID v6 hợp lệ",
+      "uuidv7": "Phải là UUID v7 hợp lệ",
+      "uuidv8": "Phải là UUID v8 hợp lệ",
       "objectId": "Phải là MongoDB ObjectId hợp lệ",
       "nanoid": "Phải là Nano ID hợp lệ",
       "snowflake": "Phải là Snowflake ID hợp lệ",

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

@@ -75,6 +75,14 @@
       "maxLength": "长度最多 ${maxLength} 个字符",
       "numeric": "必须为数字 ID",
       "uuid": "必须为有效的 UUID",
+      "uuidv1": "必须为有效的 UUID v1",
+      "uuidv2": "必须为有效的 UUID v2",
+      "uuidv3": "必须为有效的 UUID v3",
+      "uuidv4": "必须为有效的 UUID v4",
+      "uuidv5": "必须为有效的 UUID v5",
+      "uuidv6": "必须为有效的 UUID v6",
+      "uuidv7": "必须为有效的 UUID v7",
+      "uuidv8": "必须为有效的 UUID v8",
       "objectId": "必须为有效的 MongoDB ObjectId",
       "nanoid": "必须为有效的 Nano ID",
       "snowflake": "必须为有效的 Snowflake ID",

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

@@ -75,6 +75,14 @@
       "maxLength": "長度最多 ${maxLength} 字元",
       "numeric": "必須為數字 ID",
       "uuid": "必須為有效的 UUID",
+      "uuidv1": "必須為有效的 UUID v1",
+      "uuidv2": "必須為有效的 UUID v2",
+      "uuidv3": "必須為有效的 UUID v3",
+      "uuidv4": "必須為有效的 UUID v4",
+      "uuidv5": "必須為有效的 UUID v5",
+      "uuidv6": "必須為有效的 UUID v6",
+      "uuidv7": "必須為有效的 UUID v7",
+      "uuidv8": "必須為有效的 UUID v8",
       "objectId": "必須為有效的 MongoDB ObjectId",
       "nanoid": "必須為有效的 Nano ID",
       "snowflake": "必須為有效的 Snowflake ID",

package/src/validators/common/id.ts

@@ -22,6 +22,14 @@ import { getLocale, type Locale } from "../../config"
  * @property {string} [maxLength] - Message when ID is too long
  * @property {string} [numeric] - Message when numeric ID format is invalid
  * @property {string} [uuid] - Message when UUID format is invalid
+ * @property {string} [uuidv1] - Message when UUID v1 format is invalid
+ * @property {string} [uuidv2] - Message when UUID v2 format is invalid
+ * @property {string} [uuidv3] - Message when UUID v3 format is invalid
+ * @property {string} [uuidv4] - Message when UUID v4 format is invalid
+ * @property {string} [uuidv5] - Message when UUID v5 format is invalid
+ * @property {string} [uuidv6] - Message when UUID v6 format is invalid
+ * @property {string} [uuidv7] - Message when UUID v7 format is invalid
+ * @property {string} [uuidv8] - Message when UUID v8 format is invalid
  * @property {string} [objectId] - Message when MongoDB ObjectId format is invalid
  * @property {string} [nanoid] - Message when Nano ID format is invalid
  * @property {string} [snowflake] - Message when Snowflake ID format is invalid
@@ -41,6 +49,14 @@ export type IdMessages = {
   maxLength?: string
   numeric?: string
   uuid?: string
+  uuidv1?: string
+  uuidv2?: string
+  uuidv3?: string
+  uuidv4?: string
+  uuidv5?: string
+  uuidv6?: string
+  uuidv7?: string
+  uuidv8?: string
   objectId?: string
   nanoid?: string
   snowflake?: string
@@ -61,7 +77,15 @@ export type IdMessages = {
  *
  * Available types:
  * - numeric: Pure numeric IDs (1, 123, 999999)
- * - uuid: UUID v4 format (xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx)
+ * - uuid: UUID any version (v1–v8)
+ * - uuidv1: UUID v1 (timestamp-based)
+ * - uuidv2: UUID v2 (DCE security)
+ * - uuidv3: UUID v3 (MD5 name-based)
+ * - uuidv4: UUID v4 (random)
+ * - uuidv5: UUID v5 (SHA-1 name-based)
+ * - uuidv6: UUID v6 (reordered timestamp, RFC 9562)
+ * - uuidv7: UUID v7 (Unix timestamp, sortable, RFC 9562)
+ * - uuidv8: UUID v8 (custom, RFC 9562)
  * - objectId: MongoDB ObjectId (24-character hexadecimal)
  * - nanoid: Nano ID format (21-character URL-safe)
  * - snowflake: Twitter Snowflake (19-digit number)
@@ -72,7 +96,15 @@ export type IdMessages = {
  */
 export type IdType =
   | "numeric" // Pure numeric IDs (1, 123, 999999)
-  | "uuid" // UUID v4 format
+  | "uuid" // UUID any version (v1–v8)
+  | "uuidv1" // UUID v1 (timestamp-based)
+  | "uuidv2" // UUID v2 (DCE security)
+  | "uuidv3" // UUID v3 (MD5 name-based)
+  | "uuidv4" // UUID v4 (random)
+  | "uuidv5" // UUID v5 (SHA-1 name-based)
+  | "uuidv6" // UUID v6 (reordered timestamp, RFC 9562)
+  | "uuidv7" // UUID v7 (Unix timestamp, sortable, RFC 9562)
+  | "uuidv8" // UUID v8 (custom, RFC 9562)
   | "objectId" // MongoDB ObjectId (24-character hexadecimal)
   | "nanoid" // Nano ID
   | "snowflake" // Twitter Snowflake (19-digit number)
@@ -143,9 +175,19 @@ export type IdSchema<IsRequired extends boolean, Type extends IdType | undefined
  * @constant {Record<string, RegExp>} ID_PATTERNS
  * @description Maps each ID type to its corresponding regex pattern
  */
+const UUID_BASE = (version: string) => new RegExp(`^[0-9a-f]{8}-[0-9a-f]{4}-${version}[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$`, "i")
+
 const ID_PATTERNS = {
   numeric: /^\d+$/,
-  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+  uuidv1: UUID_BASE("1"),
+  uuidv2: UUID_BASE("2"),
+  uuidv3: UUID_BASE("3"),
+  uuidv4: UUID_BASE("4"),
+  uuidv5: UUID_BASE("5"),
+  uuidv6: UUID_BASE("6"),
+  uuidv7: UUID_BASE("7"),
+  uuidv8: UUID_BASE("8"),
   objectId: /^[0-9a-f]{24}$/i,
   nanoid: /^[A-Za-z0-9_-]{21}$/,
   snowflake: /^\d{19}$/,

package/tests/common/id.test.ts

@@ -11,6 +11,9 @@ const locales = [
       maxLength: "Must be at most 10 characters",
       numeric: "Must be a numeric ID",
       uuid: "Must be a valid UUID",
+      uuidv1: "Must be a valid UUID v1",
+      uuidv4: "Must be a valid UUID v4",
+      uuidv7: "Must be a valid UUID v7",
       objectId: "Must be a valid MongoDB ObjectId",
       nanoid: "Must be a valid Nano ID",
       snowflake: "Must be a valid Snowflake ID",
@@ -33,6 +36,9 @@ const locales = [
       maxLength: "長度最多 10 字元",
       numeric: "必須為數字 ID",
       uuid: "必須為有效的 UUID",
+      uuidv1: "必須為有效的 UUID v1",
+      uuidv4: "必須為有效的 UUID v4",
+      uuidv7: "必須為有效的 UUID v7",
       objectId: "必須為有效的 MongoDB ObjectId",
       nanoid: "必須為有效的 Nano ID",
       snowflake: "必須為有效的 Snowflake ID",
@@ -51,7 +57,20 @@ const locales = [
 // Valid test IDs for different formats
 const validIds = {
   numeric: ["1", "123", "999999", "0"],
-  uuid: ["550e8400-e29b-41d4-a716-446655440000", "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "f47ac10b-58cc-4372-a567-0e02b2c3d479"],
+  uuid: [
+    "550e8400-e29b-41d4-a716-446655440000", // v4
+    "6ba7b810-9dad-11d1-80b4-00c04fd430c8", // v1
+    "f47ac10b-58cc-4372-a567-0e02b2c3d479", // v4
+    "01939fee-4b0b-7da3-a9e4-79fb4c267eb8", // v7
+    "320c3d4d-cc00-875b-8ec9-32d5f69181c0", // v8
+  ],
+  uuidv1: ["6ba7b810-9dad-11d1-80b4-00c04fd430c8", "f47ac10b-58cc-1372-a567-0e02b2c3d479"],
+  uuidv3: ["a3bb189e-8bf9-3888-9912-ace4e6543002"],
+  uuidv4: ["550e8400-e29b-41d4-a716-446655440000", "f47ac10b-58cc-4372-a567-0e02b2c3d479"],
+  uuidv5: ["886313e1-3b8a-5372-9b90-0c9aee199e5d"],
+  uuidv6: ["1ef21d2f-1207-6b90-8b50-a2e4100c5480"],
+  uuidv7: ["01939fee-4b0b-7da3-a9e4-79fb4c267eb8", "018fce07-42dc-7dc0-ba2c-9f7e777caee3"],
+  uuidv8: ["320c3d4d-cc00-875b-8ec9-32d5f69181c0"],
   objectId: ["507f1f77bcf86cd799439011", "507f191e810c19729de860ea", "5a9427648b0beebeb69579cc"],
   nanoid: ["V1StGXR8_Z5jdHi6B-myT", "3IBBoOd_b1YSlnKdvQ8fK", "9_xnJ2QZt8vKl3_Kj5f7N"],
   snowflake: ["1234567890123456789", "9876543210987654321", "5555555555555555555"],
@@ -65,11 +84,19 @@ const invalidIds = {
   numeric: ["abc", "12a", ""],
   uuid: [
     "550e8400-e29b-41d4-a716-44665544000", // too short
-    "550e8400-e29b-41d4-a716-44665544000g", // too long
-    "550e8400-e29b-61d4-a716-446655440000", // wrong version (6 instead of 1-5)
+    "550e8400-e29b-41d4-a716-44665544000g", // invalid character
+    "550e8400-e29b-91d4-a716-446655440000", // wrong version (9)
     "550e8400-e29b-41d4-c716-446655440000", // wrong variant (c instead of 8,9,a,b)
     "not-a-uuid-at-all",
   ],
+  uuidv4: [
+    "6ba7b810-9dad-11d1-80b4-00c04fd430c8", // v1, not v4
+    "01939fee-4b0b-7da3-a9e4-79fb4c267eb8", // v7, not v4
+  ],
+  uuidv7: [
+    "550e8400-e29b-41d4-a716-446655440000", // v4, not v7
+    "6ba7b810-9dad-11d1-80b4-00c04fd430c8", // v1, not v7
+  ],
   objectId: [
     "507f1f77bcf86cd79943901", // too short
     "507f1f77bcf86cd799439011g", // invalid character
@@ -192,6 +219,44 @@ describe.each(locales)("id(true) locale: $locale", ({ locale, messages }) => {
       })
     })
 
+    describe("UUID version-specific validation", () => {
+      it("should accept valid UUIDv4 and reject other versions", () => {
+        const schema = id(true, { type: "uuidv4" })
+        validIds.uuidv4.forEach((v) => expect(schema.parse(v)).toBe(v))
+        invalidIds.uuidv4.forEach((v) => expect(() => schema.parse(v)).toThrow(messages.uuidv4))
+      })
+
+      it("should accept valid UUIDv7 and reject other versions", () => {
+        const schema = id(true, { type: "uuidv7" })
+        validIds.uuidv7.forEach((v) => expect(schema.parse(v)).toBe(v))
+        invalidIds.uuidv7.forEach((v) => expect(() => schema.parse(v)).toThrow(messages.uuidv7))
+      })
+
+      it("should accept valid UUIDv1", () => {
+        const schema = id(true, { type: "uuidv1" })
+        validIds.uuidv1.forEach((v) => expect(schema.parse(v)).toBe(v))
+      })
+
+      it("should accept valid UUIDv6", () => {
+        const schema = id(true, { type: "uuidv6" })
+        validIds.uuidv6.forEach((v) => expect(schema.parse(v)).toBe(v))
+      })
+
+      it("should accept any version with generic uuid type", () => {
+        const schema = id(true, { type: "uuid" })
+        // All version-specific IDs should pass generic uuid validation
+        ;[...validIds.uuidv1, ...validIds.uuidv4, ...validIds.uuidv7, ...validIds.uuidv8].forEach((v) => expect(schema.parse(v)).toBe(v))
+      })
+
+      it("should work with allowedTypes for specific versions", () => {
+        const schema = id(true, { allowedTypes: ["uuidv4", "uuidv7"] })
+        validIds.uuidv4.forEach((v) => expect(schema.parse(v)).toBe(v))
+        validIds.uuidv7.forEach((v) => expect(schema.parse(v)).toBe(v))
+        // v1 should be rejected
+        expect(() => schema.parse("6ba7b810-9dad-11d1-80b4-00c04fd430c8")).toThrow()
+      })
+    })
+
     describe("ObjectId validation", () => {
       it("should accept valid ObjectIds", () => {
         const schema = id(true, { type: "objectId" })