@hy_ong/zod-kit 0.2.0 → 0.2.2

package/dist/common/id.cjs

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkB4EZYZOKcjs = require('../chunk-B4EZYZOK.cjs');
+require('../chunk-UCOXAZJF.cjs');
+
+
+
+
+
+exports.ID_PATTERNS = _chunkB4EZYZOKcjs.ID_PATTERNS; exports.detectIdType = _chunkB4EZYZOKcjs.detectIdType; exports.id = _chunkB4EZYZOKcjs.id; exports.validateIdType = _chunkB4EZYZOKcjs.validateIdType;

package/dist/common/id.d.cts

@@ -0,0 +1,288 @@
+import { ZodNumber, ZodNullable, ZodString } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.cjs';
+
+/**
+ * @fileoverview ID validator for Zod Kit
+ *
+ * Provides comprehensive ID validation with support for multiple ID formats,
+ * auto-detection, custom patterns, and flexible validation options.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.0.5
+ */
+
+/**
+ * Type definition for ID validation error messages
+ *
+ * @interface IdMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when ID format is invalid
+ * @property {string} [minLength] - Message when ID is too short
+ * @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
+ * @property {string} [cuid] - Message when CUID format is invalid
+ * @property {string} [ulid] - Message when ULID format is invalid
+ * @property {string} [shortid] - Message when ShortId format is invalid
+ * @property {string} [customFormat] - Message when custom regex format is invalid
+ * @property {string} [includes] - Message when ID doesn't contain required string
+ * @property {string} [excludes] - Message when ID contains forbidden string
+ * @property {string} [startsWith] - Message when ID doesn't start with required string
+ * @property {string} [endsWith] - Message when ID doesn't end with required string
+ */
+type IdMessages = {
+    required?: string;
+    invalid?: string;
+    minLength?: string;
+    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;
+    cuid?: string;
+    ulid?: string;
+    shortid?: string;
+    customFormat?: string;
+    includes?: string;
+    excludes?: string;
+    startsWith?: string;
+    endsWith?: string;
+};
+/**
+ * Supported ID types for validation
+ *
+ * @typedef {string} IdType
+ *
+ * Available types:
+ * - numeric: Pure numeric IDs (1, 123, 999999)
+ * - 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)
+ * - cuid: CUID format (25-character starting with 'c')
+ * - ulid: ULID format (26-character case-insensitive)
+ * - shortid: ShortId format (7-14 character URL-safe)
+ * - auto: Auto-detect format from the value
+ */
+type IdType = "numeric" | "uuid" | "uuidv1" | "uuidv2" | "uuidv3" | "uuidv4" | "uuidv5" | "uuidv6" | "uuidv7" | "uuidv8" | "objectId" | "nanoid" | "snowflake" | "cuid" | "ulid" | "shortid" | "auto";
+/**
+ * Configuration options for ID validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template Type - The ID type being validated
+ *
+ * @interface IdOptions
+ * @property {IsRequired} [required=true] - Whether the field is required
+ * @property {Type} [type="auto"] - Expected ID type or auto-detection
+ * @property {number} [minLength] - Minimum length of ID
+ * @property {number} [maxLength] - Maximum length of ID
+ * @property {IdType[]} [allowedTypes] - Multiple allowed ID types (overrides type)
+ * @property {RegExp} [customRegex] - Custom regex pattern (overrides type validation)
+ * @property {string} [includes] - String that must be included in ID
+ * @property {string | string[]} [excludes] - String(s) that must not be included
+ * @property {string} [startsWith] - String that ID must start with
+ * @property {string} [endsWith] - String that ID must end with
+ * @property {boolean} [caseSensitive=true] - Whether validation is case-sensitive
+ * @property {Function} [transform] - Custom transformation function for ID
+ * @property {any} [defaultValue] - Default value when input is empty (string for string types, number for numeric)
+ * @property {Record<Locale, IdMessages>} [i18n] - Custom error messages for different locales
+ */
+type IdOptions<Type extends IdType | undefined = undefined> = {
+    type?: Type;
+    minLength?: number;
+    maxLength?: number;
+    allowedTypes?: IdType[];
+    customRegex?: RegExp;
+    includes?: string;
+    excludes?: string | string[];
+    startsWith?: string;
+    endsWith?: string;
+    caseSensitive?: boolean;
+    transform?: (value: string) => string;
+    defaultValue?: any;
+    i18n?: Partial<Record<Locale, Partial<IdMessages>>>;
+};
+/**
+ * Type alias for ID validation schema based on required flag and ID type
+ *
+ * @template IsRequired - Whether the field is required
+ * @template IdType - The ID type being validated
+ * @typedef IdSchema
+ * @description Returns appropriate Zod type based on required flag and ID type:
+ * - numeric type: ZodNumber or ZodNullable<ZodNumber>
+ * - other types: ZodString or ZodNullable<ZodString>
+ */
+type IdSchema<IsRequired extends boolean, Type extends IdType | undefined = undefined> = Type extends "numeric" ? IsRequired extends true ? ZodNumber : ZodNullable<ZodNumber> : IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare const ID_PATTERNS: {
+    readonly numeric: RegExp;
+    readonly uuid: RegExp;
+    readonly uuidv1: RegExp;
+    readonly uuidv2: RegExp;
+    readonly uuidv3: RegExp;
+    readonly uuidv4: RegExp;
+    readonly uuidv5: RegExp;
+    readonly uuidv6: RegExp;
+    readonly uuidv7: RegExp;
+    readonly uuidv8: RegExp;
+    readonly objectId: RegExp;
+    readonly nanoid: RegExp;
+    readonly snowflake: RegExp;
+    readonly cuid: RegExp;
+    readonly ulid: RegExp;
+    readonly shortid: RegExp;
+};
+/**
+ * Detects the ID type of a given value using pattern matching
+ *
+ * @param {string} value - The ID value to analyze
+ * @returns {IdType | null} The detected ID type or null if no pattern matches
+ *
+ * @description
+ * Attempts to identify the ID type by testing against known patterns.
+ * Patterns are ordered by specificity to avoid false positives.
+ * More specific patterns (UUID, ObjectId) are tested before generic ones (numeric, shortid).
+ *
+ * @example
+ * ```typescript
+ * detectIdType("550e8400-e29b-41d4-a716-446655440000") // "uuid"
+ * detectIdType("507f1f77bcf86cd799439011") // "objectId"
+ * detectIdType("V1StGXR8_Z5jdHi6B-myT") // "nanoid"
+ * detectIdType("123456789") // "numeric"
+ * detectIdType("invalid-id") // null
+ * ```
+ */
+declare const detectIdType: (value: string) => IdType | null;
+/**
+ * Validates if a value matches the specified ID type
+ *
+ * @param {string} value - The ID value to validate
+ * @param {IdType} type - The expected ID type
+ * @returns {boolean} True if the value matches the specified type
+ *
+ * @description
+ * Validates a specific ID type using regex patterns or auto-detection.
+ * For "auto" type, uses detectIdType to check if any known pattern matches.
+ *
+ * @example
+ * ```typescript
+ * validateIdType("123456", "numeric") // true
+ * validateIdType("abc123", "numeric") // false
+ * validateIdType("550e8400-e29b-41d4-a716-446655440000", "uuid") // true
+ * validateIdType("invalid-uuid", "uuid") // false
+ * ```
+ */
+declare const validateIdType: (value: string, type: IdType) => boolean;
+/**
+ * Creates a Zod schema for ID validation with comprehensive format support
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template Type - The ID type being validated (affects return type for numeric)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @returns {IdSchema<IsRequired, Type>} Zod schema for ID validation
+ *
+ * @description
+ * Creates a comprehensive ID validator with support for multiple ID formats,
+ * auto-detection, custom patterns, and flexible validation options.
+ *
+ * Features:
+ * - Multiple ID format support (UUID, ObjectId, Snowflake, etc.)
+ * - Auto-detection of ID types
+ * - Custom regex pattern support
+ * - Length validation
+ * - Content validation (includes, excludes, startsWith, endsWith)
+ * - Case sensitivity control
+ * - Multiple allowed types
+ * - Custom transformation functions
+ * - Comprehensive internationalization
+ *
+ * @example
+ * ```typescript
+ * // Auto-detect ID format
+ * const autoSchema = id()
+ * autoSchema.parse("550e8400-e29b-41d4-a716-446655440000") // ✓ Valid (UUID)
+ * autoSchema.parse("507f1f77bcf86cd799439011") // ✓ Valid (ObjectId)
+ * autoSchema.parse("123456") // ✓ Valid (numeric)
+ *
+ * // Specific ID type
+ * const uuidSchema = id(false, { type: "uuid" })
+ * uuidSchema.parse("550e8400-e29b-41d4-a716-446655440000") // ✓ Valid
+ * uuidSchema.parse("invalid-uuid") // ✗ Invalid
+ *
+ * // Multiple allowed types
+ * const multiSchema = id(false, { allowedTypes: ["uuid", "objectId"] })
+ * multiSchema.parse("550e8400-e29b-41d4-a716-446655440000") // ✓ Valid (UUID)
+ * multiSchema.parse("507f1f77bcf86cd799439011") // ✓ Valid (ObjectId)
+ * multiSchema.parse("123456") // ✗ Invalid (numeric not allowed)
+ *
+ * // Custom regex pattern
+ * const customSchema = id(false, { customRegex: /^CUST_\d{6}$/ })
+ * customSchema.parse("CUST_123456") // ✓ Valid
+ * customSchema.parse("invalid") // ✗ Invalid
+ *
+ * // Content validation
+ * const prefixSchema = id(false, {
+ *   type: "auto",
+ *   startsWith: "user_",
+ *   minLength: 10
+ * })
+ * prefixSchema.parse("user_123456") // ✓ Valid
+ *
+ * // Case insensitive
+ * const caseInsensitiveSchema = id(false, {
+ *   type: "uuid",
+ *   caseSensitive: false
+ * })
+ * caseInsensitiveSchema.parse("550E8400-E29B-41D4-A716-446655440000") // ✓ Valid
+ *
+ * // Optional with default
+ * const optionalSchema = id(false, {
+ *   defaultValue: null
+ * })
+ * ```
+ *
+ * @throws {z.ZodError} When validation fails with specific error messages
+ * @see {@link IdOptions} for all available configuration options
+ * @see {@link IdType} for supported ID types
+ * @see {@link detectIdType} for auto-detection logic
+ * @see {@link validateIdType} for type-specific validation
+ */
+declare function id<IsRequired extends boolean = false>(required?: IsRequired): IdSchema<IsRequired, undefined>;
+declare function id<IsRequired extends boolean = false>(required: IsRequired, options: Omit<IdOptions<"numeric">, "required"> & {
+    type: "numeric";
+}): IdSchema<IsRequired, "numeric">;
+declare function id<IsRequired extends boolean = false, Type extends Exclude<IdType, "numeric"> = Exclude<IdType, "numeric">>(required: IsRequired, options: Omit<IdOptions<Type>, "required"> & {
+    type: Type;
+}): IdSchema<IsRequired, Type>;
+declare function id<IsRequired extends boolean = false>(required: IsRequired, options: Omit<IdOptions, "required"> & {
+    type?: never;
+}): IdSchema<IsRequired, undefined>;
+
+export { ID_PATTERNS, type IdMessages, type IdOptions, type IdSchema, type IdType, detectIdType, id, validateIdType };

package/dist/common/id.d.ts

@@ -0,0 +1,288 @@
+import { ZodNumber, ZodNullable, ZodString } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.js';
+
+/**
+ * @fileoverview ID validator for Zod Kit
+ *
+ * Provides comprehensive ID validation with support for multiple ID formats,
+ * auto-detection, custom patterns, and flexible validation options.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.0.5
+ */
+
+/**
+ * Type definition for ID validation error messages
+ *
+ * @interface IdMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when ID format is invalid
+ * @property {string} [minLength] - Message when ID is too short
+ * @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
+ * @property {string} [cuid] - Message when CUID format is invalid
+ * @property {string} [ulid] - Message when ULID format is invalid
+ * @property {string} [shortid] - Message when ShortId format is invalid
+ * @property {string} [customFormat] - Message when custom regex format is invalid
+ * @property {string} [includes] - Message when ID doesn't contain required string
+ * @property {string} [excludes] - Message when ID contains forbidden string
+ * @property {string} [startsWith] - Message when ID doesn't start with required string
+ * @property {string} [endsWith] - Message when ID doesn't end with required string
+ */
+type IdMessages = {
+    required?: string;
+    invalid?: string;
+    minLength?: string;
+    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;
+    cuid?: string;
+    ulid?: string;
+    shortid?: string;
+    customFormat?: string;
+    includes?: string;
+    excludes?: string;
+    startsWith?: string;
+    endsWith?: string;
+};
+/**
+ * Supported ID types for validation
+ *
+ * @typedef {string} IdType
+ *
+ * Available types:
+ * - numeric: Pure numeric IDs (1, 123, 999999)
+ * - 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)
+ * - cuid: CUID format (25-character starting with 'c')
+ * - ulid: ULID format (26-character case-insensitive)
+ * - shortid: ShortId format (7-14 character URL-safe)
+ * - auto: Auto-detect format from the value
+ */
+type IdType = "numeric" | "uuid" | "uuidv1" | "uuidv2" | "uuidv3" | "uuidv4" | "uuidv5" | "uuidv6" | "uuidv7" | "uuidv8" | "objectId" | "nanoid" | "snowflake" | "cuid" | "ulid" | "shortid" | "auto";
+/**
+ * Configuration options for ID validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template Type - The ID type being validated
+ *
+ * @interface IdOptions
+ * @property {IsRequired} [required=true] - Whether the field is required
+ * @property {Type} [type="auto"] - Expected ID type or auto-detection
+ * @property {number} [minLength] - Minimum length of ID
+ * @property {number} [maxLength] - Maximum length of ID
+ * @property {IdType[]} [allowedTypes] - Multiple allowed ID types (overrides type)
+ * @property {RegExp} [customRegex] - Custom regex pattern (overrides type validation)
+ * @property {string} [includes] - String that must be included in ID
+ * @property {string | string[]} [excludes] - String(s) that must not be included
+ * @property {string} [startsWith] - String that ID must start with
+ * @property {string} [endsWith] - String that ID must end with
+ * @property {boolean} [caseSensitive=true] - Whether validation is case-sensitive
+ * @property {Function} [transform] - Custom transformation function for ID
+ * @property {any} [defaultValue] - Default value when input is empty (string for string types, number for numeric)
+ * @property {Record<Locale, IdMessages>} [i18n] - Custom error messages for different locales
+ */
+type IdOptions<Type extends IdType | undefined = undefined> = {
+    type?: Type;
+    minLength?: number;
+    maxLength?: number;
+    allowedTypes?: IdType[];
+    customRegex?: RegExp;
+    includes?: string;
+    excludes?: string | string[];
+    startsWith?: string;
+    endsWith?: string;
+    caseSensitive?: boolean;
+    transform?: (value: string) => string;
+    defaultValue?: any;
+    i18n?: Partial<Record<Locale, Partial<IdMessages>>>;
+};
+/**
+ * Type alias for ID validation schema based on required flag and ID type
+ *
+ * @template IsRequired - Whether the field is required
+ * @template IdType - The ID type being validated
+ * @typedef IdSchema
+ * @description Returns appropriate Zod type based on required flag and ID type:
+ * - numeric type: ZodNumber or ZodNullable<ZodNumber>
+ * - other types: ZodString or ZodNullable<ZodString>
+ */
+type IdSchema<IsRequired extends boolean, Type extends IdType | undefined = undefined> = Type extends "numeric" ? IsRequired extends true ? ZodNumber : ZodNullable<ZodNumber> : IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare const ID_PATTERNS: {
+    readonly numeric: RegExp;
+    readonly uuid: RegExp;
+    readonly uuidv1: RegExp;
+    readonly uuidv2: RegExp;
+    readonly uuidv3: RegExp;
+    readonly uuidv4: RegExp;
+    readonly uuidv5: RegExp;
+    readonly uuidv6: RegExp;
+    readonly uuidv7: RegExp;
+    readonly uuidv8: RegExp;
+    readonly objectId: RegExp;
+    readonly nanoid: RegExp;
+    readonly snowflake: RegExp;
+    readonly cuid: RegExp;
+    readonly ulid: RegExp;
+    readonly shortid: RegExp;
+};
+/**
+ * Detects the ID type of a given value using pattern matching
+ *
+ * @param {string} value - The ID value to analyze
+ * @returns {IdType | null} The detected ID type or null if no pattern matches
+ *
+ * @description
+ * Attempts to identify the ID type by testing against known patterns.
+ * Patterns are ordered by specificity to avoid false positives.
+ * More specific patterns (UUID, ObjectId) are tested before generic ones (numeric, shortid).
+ *
+ * @example
+ * ```typescript
+ * detectIdType("550e8400-e29b-41d4-a716-446655440000") // "uuid"
+ * detectIdType("507f1f77bcf86cd799439011") // "objectId"
+ * detectIdType("V1StGXR8_Z5jdHi6B-myT") // "nanoid"
+ * detectIdType("123456789") // "numeric"
+ * detectIdType("invalid-id") // null
+ * ```
+ */
+declare const detectIdType: (value: string) => IdType | null;
+/**
+ * Validates if a value matches the specified ID type
+ *
+ * @param {string} value - The ID value to validate
+ * @param {IdType} type - The expected ID type
+ * @returns {boolean} True if the value matches the specified type
+ *
+ * @description
+ * Validates a specific ID type using regex patterns or auto-detection.
+ * For "auto" type, uses detectIdType to check if any known pattern matches.
+ *
+ * @example
+ * ```typescript
+ * validateIdType("123456", "numeric") // true
+ * validateIdType("abc123", "numeric") // false
+ * validateIdType("550e8400-e29b-41d4-a716-446655440000", "uuid") // true
+ * validateIdType("invalid-uuid", "uuid") // false
+ * ```
+ */
+declare const validateIdType: (value: string, type: IdType) => boolean;
+/**
+ * Creates a Zod schema for ID validation with comprehensive format support
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template Type - The ID type being validated (affects return type for numeric)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @returns {IdSchema<IsRequired, Type>} Zod schema for ID validation
+ *
+ * @description
+ * Creates a comprehensive ID validator with support for multiple ID formats,
+ * auto-detection, custom patterns, and flexible validation options.
+ *
+ * Features:
+ * - Multiple ID format support (UUID, ObjectId, Snowflake, etc.)
+ * - Auto-detection of ID types
+ * - Custom regex pattern support
+ * - Length validation
+ * - Content validation (includes, excludes, startsWith, endsWith)
+ * - Case sensitivity control
+ * - Multiple allowed types
+ * - Custom transformation functions
+ * - Comprehensive internationalization
+ *
+ * @example
+ * ```typescript
+ * // Auto-detect ID format
+ * const autoSchema = id()
+ * autoSchema.parse("550e8400-e29b-41d4-a716-446655440000") // ✓ Valid (UUID)
+ * autoSchema.parse("507f1f77bcf86cd799439011") // ✓ Valid (ObjectId)
+ * autoSchema.parse("123456") // ✓ Valid (numeric)
+ *
+ * // Specific ID type
+ * const uuidSchema = id(false, { type: "uuid" })
+ * uuidSchema.parse("550e8400-e29b-41d4-a716-446655440000") // ✓ Valid
+ * uuidSchema.parse("invalid-uuid") // ✗ Invalid
+ *
+ * // Multiple allowed types
+ * const multiSchema = id(false, { allowedTypes: ["uuid", "objectId"] })
+ * multiSchema.parse("550e8400-e29b-41d4-a716-446655440000") // ✓ Valid (UUID)
+ * multiSchema.parse("507f1f77bcf86cd799439011") // ✓ Valid (ObjectId)
+ * multiSchema.parse("123456") // ✗ Invalid (numeric not allowed)
+ *
+ * // Custom regex pattern
+ * const customSchema = id(false, { customRegex: /^CUST_\d{6}$/ })
+ * customSchema.parse("CUST_123456") // ✓ Valid
+ * customSchema.parse("invalid") // ✗ Invalid
+ *
+ * // Content validation
+ * const prefixSchema = id(false, {
+ *   type: "auto",
+ *   startsWith: "user_",
+ *   minLength: 10
+ * })
+ * prefixSchema.parse("user_123456") // ✓ Valid
+ *
+ * // Case insensitive
+ * const caseInsensitiveSchema = id(false, {
+ *   type: "uuid",
+ *   caseSensitive: false
+ * })
+ * caseInsensitiveSchema.parse("550E8400-E29B-41D4-A716-446655440000") // ✓ Valid
+ *
+ * // Optional with default
+ * const optionalSchema = id(false, {
+ *   defaultValue: null
+ * })
+ * ```
+ *
+ * @throws {z.ZodError} When validation fails with specific error messages
+ * @see {@link IdOptions} for all available configuration options
+ * @see {@link IdType} for supported ID types
+ * @see {@link detectIdType} for auto-detection logic
+ * @see {@link validateIdType} for type-specific validation
+ */
+declare function id<IsRequired extends boolean = false>(required?: IsRequired): IdSchema<IsRequired, undefined>;
+declare function id<IsRequired extends boolean = false>(required: IsRequired, options: Omit<IdOptions<"numeric">, "required"> & {
+    type: "numeric";
+}): IdSchema<IsRequired, "numeric">;
+declare function id<IsRequired extends boolean = false, Type extends Exclude<IdType, "numeric"> = Exclude<IdType, "numeric">>(required: IsRequired, options: Omit<IdOptions<Type>, "required"> & {
+    type: Type;
+}): IdSchema<IsRequired, Type>;
+declare function id<IsRequired extends boolean = false>(required: IsRequired, options: Omit<IdOptions, "required"> & {
+    type?: never;
+}): IdSchema<IsRequired, undefined>;
+
+export { ID_PATTERNS, type IdMessages, type IdOptions, type IdSchema, type IdType, detectIdType, id, validateIdType };

package/dist/common/id.js

@@ -0,0 +1,13 @@
+import {
+  ID_PATTERNS,
+  detectIdType,
+  id,
+  validateIdType
+} from "../chunk-MHJFYYGV.js";
+import "../chunk-6AAP4LPF.js";
+export {
+  ID_PATTERNS,
+  detectIdType,
+  id,
+  validateIdType
+};

package/dist/common/ip.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunk32JI34CVcjs = require('../chunk-32JI34CV.cjs');
+require('../chunk-UCOXAZJF.cjs');
+
+
+
+
+exports.ip = _chunk32JI34CVcjs.ip; exports.validateIPv4 = _chunk32JI34CVcjs.validateIPv4; exports.validateIPv6 = _chunk32JI34CVcjs.validateIPv6;

package/dist/common/ip.d.cts

@@ -0,0 +1,25 @@
+import { ZodString, ZodNullable } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.cjs';
+
+type IpVersion = "v4" | "v6" | "any";
+type IpMessages = {
+    required?: string;
+    invalid?: string;
+    notIPv4?: string;
+    notIPv6?: string;
+    notInWhitelist?: string;
+};
+type IpOptions<IsRequired extends boolean = true> = {
+    version?: IpVersion;
+    allowCIDR?: boolean;
+    whitelist?: string[];
+    transform?: (value: string) => string;
+    defaultValue?: IsRequired extends true ? string : string | null;
+    i18n?: Partial<Record<Locale, Partial<IpMessages>>>;
+};
+type IpSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function validateIPv4(value: string): boolean;
+declare function validateIPv6(value: string): boolean;
+declare function ip<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<IpOptions<IsRequired>, "required">): IpSchema<IsRequired>;
+
+export { type IpMessages, type IpOptions, type IpSchema, type IpVersion, ip, validateIPv4, validateIPv6 };

package/dist/common/ip.d.ts

@@ -0,0 +1,25 @@
+import { ZodString, ZodNullable } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.js';
+
+type IpVersion = "v4" | "v6" | "any";
+type IpMessages = {
+    required?: string;
+    invalid?: string;
+    notIPv4?: string;
+    notIPv6?: string;
+    notInWhitelist?: string;
+};
+type IpOptions<IsRequired extends boolean = true> = {
+    version?: IpVersion;
+    allowCIDR?: boolean;
+    whitelist?: string[];
+    transform?: (value: string) => string;
+    defaultValue?: IsRequired extends true ? string : string | null;
+    i18n?: Partial<Record<Locale, Partial<IpMessages>>>;
+};
+type IpSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function validateIPv4(value: string): boolean;
+declare function validateIPv6(value: string): boolean;
+declare function ip<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<IpOptions<IsRequired>, "required">): IpSchema<IsRequired>;
+
+export { type IpMessages, type IpOptions, type IpSchema, type IpVersion, ip, validateIPv4, validateIPv6 };

package/dist/common/ip.js

@@ -0,0 +1,11 @@
+import {
+  ip,
+  validateIPv4,
+  validateIPv6
+} from "../chunk-RO47DKQG.js";
+import "../chunk-6AAP4LPF.js";
+export {
+  ip,
+  validateIPv4,
+  validateIPv6
+};