@hy_ong/zod-kit 0.2.0 → 0.2.2

package/dist/common/email.d.cts

@@ -0,0 +1,149 @@
+import { ZodString, ZodNullable } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.cjs';
+
+/**
+ * @fileoverview Email validator for Zod Kit
+ *
+ * Provides comprehensive email validation with domain filtering, business email
+ * validation, disposable email detection, and extensive customization options.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.0.5
+ */
+
+/**
+ * Type definition for email validation error messages
+ *
+ * @interface EmailMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when email format is invalid
+ * @property {string} [minLength] - Message when email is too short
+ * @property {string} [maxLength] - Message when email is too long
+ * @property {string} [includes] - Message when email doesn't contain required string
+ * @property {string} [domain] - Message when email domain is not allowed
+ * @property {string} [domainBlacklist] - Message when email domain is blacklisted
+ * @property {string} [businessOnly] - Message when free email providers are not allowed
+ * @property {string} [noDisposable] - Message when disposable email addresses are not allowed
+ */
+type EmailMessages = {
+    required?: string;
+    invalid?: string;
+    minLength?: string;
+    maxLength?: string;
+    includes?: string;
+    domain?: string;
+    domainBlacklist?: string;
+    businessOnly?: string;
+    noDisposable?: string;
+};
+/**
+ * Configuration options for email validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ *
+ * @interface EmailOptions
+ * @property {string | string[]} [domain] - Allowed domain(s) for email addresses
+ * @property {string[]} [domainBlacklist] - Domains that are not allowed
+ * @property {number} [minLength] - Minimum length of email address
+ * @property {number} [maxLength] - Maximum length of email address
+ * @property {string} [includes] - String that must be included in the email
+ * @property {string | string[]} [excludes] - String(s) that must not be included
+ * @property {boolean} [allowSubdomains=true] - Whether to allow subdomains in domain validation
+ * @property {boolean} [businessOnly=false] - If true, reject common free email providers
+ * @property {boolean} [noDisposable=false] - If true, reject disposable email addresses
+ * @property {boolean} [lowercase=true] - Whether to convert email to lowercase
+ * @property {Function} [transform] - Custom transformation function for email strings
+ * @property {string | null} [defaultValue] - Default value when input is empty
+ * @property {Record<Locale, EmailMessages>} [i18n] - Custom error messages for different locales
+ */
+type EmailOptions<IsRequired extends boolean = true> = {
+    domain?: string | string[];
+    domainBlacklist?: string[];
+    minLength?: number;
+    maxLength?: number;
+    includes?: string;
+    excludes?: string | string[];
+    allowSubdomains?: boolean;
+    businessOnly?: boolean;
+    noDisposable?: boolean;
+    lowercase?: boolean;
+    transform?: (value: string) => string;
+    defaultValue?: IsRequired extends true ? string : string | null;
+    i18n?: Partial<Record<Locale, Partial<EmailMessages>>>;
+};
+/**
+ * Type alias for email validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @typedef EmailSchema
+ * @description Returns ZodString if required, ZodNullable<ZodString> if optional
+ */
+type EmailSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+/**
+ * Creates a Zod schema for email validation with comprehensive filtering options
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {Omit<EmailOptions<IsRequired>, 'required'>} [options] - Configuration options for email validation
+ * @returns {EmailSchema<IsRequired>} Zod schema for email validation
+ *
+ * @description
+ * Creates a comprehensive email validator with domain filtering, business email
+ * validation, disposable email detection, and extensive customization options.
+ *
+ * Features:
+ * - RFC-compliant email format validation
+ * - Domain whitelist/blacklist support
+ * - Business email validation (excludes free providers)
+ * - Disposable email detection
+ * - Subdomain support configuration
+ * - Length validation
+ * - Content inclusion/exclusion
+ * - Automatic lowercase conversion
+ * - Custom transformation functions
+ * - Comprehensive internationalization
+ *
+ * @example
+ * ```typescript
+ * // Basic email validation (optional by default)
+ * const basicSchema = email()
+ * basicSchema.parse("user@example.com") // ✓ Valid
+ * basicSchema.parse(null) // ✓ Valid (optional)
+ *
+ * // Required email
+ * const requiredSchema = email(true)
+ * requiredSchema.parse("user@example.com") // ✓ Valid
+ * requiredSchema.parse(null) // ✗ Invalid (required)
+ *
+ * // Domain restriction
+ * const domainSchema = email(false, {
+ *   domain: ["company.com", "organization.org"]
+ * })
+ * domainSchema.parse("user@company.com") // ✓ Valid
+ * domainSchema.parse("user@gmail.com") // ✗ Invalid
+ *
+ * // Business emails only (no free providers)
+ * const businessSchema = email(true, { businessOnly: true })
+ * businessSchema.parse("user@company.com") // ✓ Valid
+ * businessSchema.parse("user@gmail.com") // ✗ Invalid
+ *
+ * // No disposable emails
+ * const noDisposableSchema = email(true, { noDisposable: true })
+ * noDisposableSchema.parse("user@company.com") // ✓ Valid
+ * noDisposableSchema.parse("user@10minutemail.com") // ✗ Invalid
+ *
+ * // Domain blacklist
+ * const blacklistSchema = email(false, {
+ *   domainBlacklist: ["spam.com", "blocked.org"]
+ * })
+ *
+ * // Optional with default
+ * const optionalSchema = email(false, { defaultValue: null })
+ * ```
+ *
+ * @throws {z.ZodError} When validation fails with specific error messages
+ * @see {@link EmailOptions} for all available configuration options
+ */
+declare function email<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<EmailOptions<IsRequired>, 'required'>): EmailSchema<IsRequired>;
+
+export { type EmailMessages, type EmailOptions, type EmailSchema, email };

package/dist/common/email.d.ts

@@ -0,0 +1,149 @@
+import { ZodString, ZodNullable } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.js';
+
+/**
+ * @fileoverview Email validator for Zod Kit
+ *
+ * Provides comprehensive email validation with domain filtering, business email
+ * validation, disposable email detection, and extensive customization options.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.0.5
+ */
+
+/**
+ * Type definition for email validation error messages
+ *
+ * @interface EmailMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when email format is invalid
+ * @property {string} [minLength] - Message when email is too short
+ * @property {string} [maxLength] - Message when email is too long
+ * @property {string} [includes] - Message when email doesn't contain required string
+ * @property {string} [domain] - Message when email domain is not allowed
+ * @property {string} [domainBlacklist] - Message when email domain is blacklisted
+ * @property {string} [businessOnly] - Message when free email providers are not allowed
+ * @property {string} [noDisposable] - Message when disposable email addresses are not allowed
+ */
+type EmailMessages = {
+    required?: string;
+    invalid?: string;
+    minLength?: string;
+    maxLength?: string;
+    includes?: string;
+    domain?: string;
+    domainBlacklist?: string;
+    businessOnly?: string;
+    noDisposable?: string;
+};
+/**
+ * Configuration options for email validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ *
+ * @interface EmailOptions
+ * @property {string | string[]} [domain] - Allowed domain(s) for email addresses
+ * @property {string[]} [domainBlacklist] - Domains that are not allowed
+ * @property {number} [minLength] - Minimum length of email address
+ * @property {number} [maxLength] - Maximum length of email address
+ * @property {string} [includes] - String that must be included in the email
+ * @property {string | string[]} [excludes] - String(s) that must not be included
+ * @property {boolean} [allowSubdomains=true] - Whether to allow subdomains in domain validation
+ * @property {boolean} [businessOnly=false] - If true, reject common free email providers
+ * @property {boolean} [noDisposable=false] - If true, reject disposable email addresses
+ * @property {boolean} [lowercase=true] - Whether to convert email to lowercase
+ * @property {Function} [transform] - Custom transformation function for email strings
+ * @property {string | null} [defaultValue] - Default value when input is empty
+ * @property {Record<Locale, EmailMessages>} [i18n] - Custom error messages for different locales
+ */
+type EmailOptions<IsRequired extends boolean = true> = {
+    domain?: string | string[];
+    domainBlacklist?: string[];
+    minLength?: number;
+    maxLength?: number;
+    includes?: string;
+    excludes?: string | string[];
+    allowSubdomains?: boolean;
+    businessOnly?: boolean;
+    noDisposable?: boolean;
+    lowercase?: boolean;
+    transform?: (value: string) => string;
+    defaultValue?: IsRequired extends true ? string : string | null;
+    i18n?: Partial<Record<Locale, Partial<EmailMessages>>>;
+};
+/**
+ * Type alias for email validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @typedef EmailSchema
+ * @description Returns ZodString if required, ZodNullable<ZodString> if optional
+ */
+type EmailSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+/**
+ * Creates a Zod schema for email validation with comprehensive filtering options
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {Omit<EmailOptions<IsRequired>, 'required'>} [options] - Configuration options for email validation
+ * @returns {EmailSchema<IsRequired>} Zod schema for email validation
+ *
+ * @description
+ * Creates a comprehensive email validator with domain filtering, business email
+ * validation, disposable email detection, and extensive customization options.
+ *
+ * Features:
+ * - RFC-compliant email format validation
+ * - Domain whitelist/blacklist support
+ * - Business email validation (excludes free providers)
+ * - Disposable email detection
+ * - Subdomain support configuration
+ * - Length validation
+ * - Content inclusion/exclusion
+ * - Automatic lowercase conversion
+ * - Custom transformation functions
+ * - Comprehensive internationalization
+ *
+ * @example
+ * ```typescript
+ * // Basic email validation (optional by default)
+ * const basicSchema = email()
+ * basicSchema.parse("user@example.com") // ✓ Valid
+ * basicSchema.parse(null) // ✓ Valid (optional)
+ *
+ * // Required email
+ * const requiredSchema = email(true)
+ * requiredSchema.parse("user@example.com") // ✓ Valid
+ * requiredSchema.parse(null) // ✗ Invalid (required)
+ *
+ * // Domain restriction
+ * const domainSchema = email(false, {
+ *   domain: ["company.com", "organization.org"]
+ * })
+ * domainSchema.parse("user@company.com") // ✓ Valid
+ * domainSchema.parse("user@gmail.com") // ✗ Invalid
+ *
+ * // Business emails only (no free providers)
+ * const businessSchema = email(true, { businessOnly: true })
+ * businessSchema.parse("user@company.com") // ✓ Valid
+ * businessSchema.parse("user@gmail.com") // ✗ Invalid
+ *
+ * // No disposable emails
+ * const noDisposableSchema = email(true, { noDisposable: true })
+ * noDisposableSchema.parse("user@company.com") // ✓ Valid
+ * noDisposableSchema.parse("user@10minutemail.com") // ✗ Invalid
+ *
+ * // Domain blacklist
+ * const blacklistSchema = email(false, {
+ *   domainBlacklist: ["spam.com", "blocked.org"]
+ * })
+ *
+ * // Optional with default
+ * const optionalSchema = email(false, { defaultValue: null })
+ * ```
+ *
+ * @throws {z.ZodError} When validation fails with specific error messages
+ * @see {@link EmailOptions} for all available configuration options
+ */
+declare function email<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<EmailOptions<IsRequired>, 'required'>): EmailSchema<IsRequired>;
+
+export { type EmailMessages, type EmailOptions, type EmailSchema, email };

package/dist/common/email.js

@@ -0,0 +1,7 @@
+import {
+  email
+} from "../chunk-MM7IL2RG.js";
+import "../chunk-6AAP4LPF.js";
+export {
+  email
+};

package/dist/common/file.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkHTEHINI7cjs = require('../chunk-HTEHINI7.cjs');
+require('../chunk-UCOXAZJF.cjs');
+
+
+exports.file = _chunkHTEHINI7cjs.file;

package/dist/common/file.d.cts

@@ -0,0 +1,178 @@
+import { ZodType } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.cjs';
+
+/**
+ * @fileoverview File validator for Zod Kit
+ *
+ * Provides comprehensive file validation with MIME type filtering, size validation,
+ * extension validation, and extensive customization options.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.0.5
+ */
+
+/**
+ * Type definition for file validation error messages
+ *
+ * @interface FileMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when file format is invalid
+ * @property {string} [size] - Message when file size exceeds limit
+ * @property {string} [minSize] - Message when file size is too small
+ * @property {string} [maxSize] - Message when file size exceeds maximum
+ * @property {string} [type] - Message when file type is not allowed
+ * @property {string} [extension] - Message when file extension is not allowed
+ * @property {string} [extensionBlacklist] - Message when file extension is blacklisted
+ * @property {string} [name] - Message when file name doesn't match pattern
+ * @property {string} [nameBlacklist] - Message when file name matches blacklisted pattern
+ * @property {string} [imageOnly] - Message when only image files are allowed
+ * @property {string} [documentOnly] - Message when only document files are allowed
+ * @property {string} [videoOnly] - Message when only video files are allowed
+ * @property {string} [audioOnly] - Message when only audio files are allowed
+ * @property {string} [archiveOnly] - Message when only archive files are allowed
+ */
+type FileMessages = {
+    required?: string;
+    invalid?: string;
+    size?: string;
+    minSize?: string;
+    maxSize?: string;
+    type?: string;
+    extension?: string;
+    extensionBlacklist?: string;
+    name?: string;
+    nameBlacklist?: string;
+    imageOnly?: string;
+    documentOnly?: string;
+    videoOnly?: string;
+    audioOnly?: string;
+    archiveOnly?: string;
+};
+/**
+ * Configuration options for file validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ *
+ * @interface FileOptions
+ * @property {IsRequired} [required=true] - Whether the field is required
+ * @property {number} [maxSize] - Maximum file size in bytes
+ * @property {number} [minSize] - Minimum file size in bytes
+ * @property {string | string[]} [type] - Allowed MIME type(s)
+ * @property {string[]} [typeBlacklist] - MIME types that are not allowed
+ * @property {string | string[]} [extension] - Allowed file extension(s)
+ * @property {string[]} [extensionBlacklist] - File extensions that are not allowed
+ * @property {RegExp | string} [namePattern] - Pattern that file name must match
+ * @property {RegExp | string | Array<RegExp | string>} [nameBlacklist] - Pattern(s) that file name must not match
+ * @property {boolean} [imageOnly=false] - If true, only allow image files
+ * @property {boolean} [documentOnly=false] - If true, only allow document files
+ * @property {boolean} [videoOnly=false] - If true, only allow video files
+ * @property {boolean} [audioOnly=false] - If true, only allow audio files
+ * @property {boolean} [archiveOnly=false] - If true, only allow archive files
+ * @property {boolean} [caseSensitive=false] - Whether extension matching is case-sensitive
+ * @property {Function} [transform] - Custom transformation function for File objects
+ * @property {File | null} [defaultValue] - Default value when input is empty
+ * @property {Record<Locale, FileMessages>} [i18n] - Custom error messages for different locales
+ */
+type FileOptions<IsRequired extends boolean = true> = {
+    maxSize?: number;
+    minSize?: number;
+    type?: string | string[];
+    typeBlacklist?: string[];
+    extension?: string | string[];
+    extensionBlacklist?: string[];
+    namePattern?: RegExp | string;
+    nameBlacklist?: RegExp | string | Array<RegExp | string>;
+    imageOnly?: boolean;
+    documentOnly?: boolean;
+    videoOnly?: boolean;
+    audioOnly?: boolean;
+    archiveOnly?: boolean;
+    caseSensitive?: boolean;
+    transform?: (value: File) => File;
+    defaultValue?: IsRequired extends true ? File : File | null;
+    i18n?: Partial<Record<Locale, Partial<FileMessages>>>;
+};
+/**
+ * Type alias for file validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @description Returns ZodType with proper input/output types based on required flag
+ */
+type FileSchema<IsRequired extends boolean> = IsRequired extends true ? ZodType<File, File | null> : ZodType<File | null, File | null>;
+/**
+ * Creates a Zod schema for file validation with comprehensive filtering options
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {Omit<FileOptions<IsRequired>, 'required'>} [options] - Configuration options for validation
+ * @returns {FileSchema<IsRequired>} Zod schema for file validation
+ *
+ * @description
+ * Creates a comprehensive file validator with MIME type filtering, size validation,
+ * extension validation, and extensive customization options.
+ *
+ * Features:
+ * - File size validation (min/max)
+ * - MIME type whitelist/blacklist support
+ * - File extension whitelist/blacklist support
+ * - File name pattern validation
+ * - Predefined file category filters (image, document, video, audio, archive)
+ * - Case-sensitive/insensitive extension matching
+ * - Custom transformation functions
+ * - Comprehensive internationalization
+ *
+ * @example
+ * ```typescript
+ * // Basic file validation
+ * const basicSchema = file() // optional by default
+ * basicSchema.parse(new File(["content"], "test.txt"))
+ * basicSchema.parse(null) // ✓ Valid (optional)
+ *
+ * // Required validation
+ * const requiredSchema = parse(new File(["content"], "test.txt"))
+(true)
+ * requiredSchema.parse(null) // ✗ Invalid (required)
+ *
+ *
+ * // Size restrictions
+ * const sizeSchema = file(false, {
+ *   maxSize: 1024 * 1024, // 1MB
+ *   minSize: 1024 // 1KB
+ * })
+ *
+ * // Extension restrictions
+ * const imageSchema = file(false, {
+ *   extension: [".jpg", ".png", ".gif"],
+ *   maxSize: 5 * 1024 * 1024 // 5MB
+ * })
+ *
+ * // MIME type restrictions
+ * const documentSchema = file(false, {
+ *   type: ["application/pdf", "application/msword"],
+ *   maxSize: 10 * 1024 * 1024 // 10MB
+ * })
+ *
+ * // Image files only
+ * const imageOnlySchema = file(false, { imageOnly: true })
+ *
+ * // Document files only
+ * const docOnlySchema = file(false, { documentOnly: true })
+ *
+ * // Name pattern validation
+ * const patternSchema = file(false, {
+ *   namePattern: /^[a-zA-Z0-9_-]+\.(pdf|doc|docx)$/,
+ *   maxSize: 5 * 1024 * 1024
+ * })
+ *
+ * // Optional with default
+ * const optionalSchema = file(false, {
+ *   defaultValue: null
+ * })
+ * ```
+ *
+ * @throws {z.ZodError} When validation fails with specific error messages
+ * @see {@link FileOptions} for all available configuration options
+ */
+declare function file<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<FileOptions<IsRequired>, "required">): FileSchema<IsRequired>;
+
+export { type FileMessages, type FileOptions, type FileSchema, file };

package/dist/common/file.d.ts

@@ -0,0 +1,178 @@
+import { ZodType } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.js';
+
+/**
+ * @fileoverview File validator for Zod Kit
+ *
+ * Provides comprehensive file validation with MIME type filtering, size validation,
+ * extension validation, and extensive customization options.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.0.5
+ */
+
+/**
+ * Type definition for file validation error messages
+ *
+ * @interface FileMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when file format is invalid
+ * @property {string} [size] - Message when file size exceeds limit
+ * @property {string} [minSize] - Message when file size is too small
+ * @property {string} [maxSize] - Message when file size exceeds maximum
+ * @property {string} [type] - Message when file type is not allowed
+ * @property {string} [extension] - Message when file extension is not allowed
+ * @property {string} [extensionBlacklist] - Message when file extension is blacklisted
+ * @property {string} [name] - Message when file name doesn't match pattern
+ * @property {string} [nameBlacklist] - Message when file name matches blacklisted pattern
+ * @property {string} [imageOnly] - Message when only image files are allowed
+ * @property {string} [documentOnly] - Message when only document files are allowed
+ * @property {string} [videoOnly] - Message when only video files are allowed
+ * @property {string} [audioOnly] - Message when only audio files are allowed
+ * @property {string} [archiveOnly] - Message when only archive files are allowed
+ */
+type FileMessages = {
+    required?: string;
+    invalid?: string;
+    size?: string;
+    minSize?: string;
+    maxSize?: string;
+    type?: string;
+    extension?: string;
+    extensionBlacklist?: string;
+    name?: string;
+    nameBlacklist?: string;
+    imageOnly?: string;
+    documentOnly?: string;
+    videoOnly?: string;
+    audioOnly?: string;
+    archiveOnly?: string;
+};
+/**
+ * Configuration options for file validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ *
+ * @interface FileOptions
+ * @property {IsRequired} [required=true] - Whether the field is required
+ * @property {number} [maxSize] - Maximum file size in bytes
+ * @property {number} [minSize] - Minimum file size in bytes
+ * @property {string | string[]} [type] - Allowed MIME type(s)
+ * @property {string[]} [typeBlacklist] - MIME types that are not allowed
+ * @property {string | string[]} [extension] - Allowed file extension(s)
+ * @property {string[]} [extensionBlacklist] - File extensions that are not allowed
+ * @property {RegExp | string} [namePattern] - Pattern that file name must match
+ * @property {RegExp | string | Array<RegExp | string>} [nameBlacklist] - Pattern(s) that file name must not match
+ * @property {boolean} [imageOnly=false] - If true, only allow image files
+ * @property {boolean} [documentOnly=false] - If true, only allow document files
+ * @property {boolean} [videoOnly=false] - If true, only allow video files
+ * @property {boolean} [audioOnly=false] - If true, only allow audio files
+ * @property {boolean} [archiveOnly=false] - If true, only allow archive files
+ * @property {boolean} [caseSensitive=false] - Whether extension matching is case-sensitive
+ * @property {Function} [transform] - Custom transformation function for File objects
+ * @property {File | null} [defaultValue] - Default value when input is empty
+ * @property {Record<Locale, FileMessages>} [i18n] - Custom error messages for different locales
+ */
+type FileOptions<IsRequired extends boolean = true> = {
+    maxSize?: number;
+    minSize?: number;
+    type?: string | string[];
+    typeBlacklist?: string[];
+    extension?: string | string[];
+    extensionBlacklist?: string[];
+    namePattern?: RegExp | string;
+    nameBlacklist?: RegExp | string | Array<RegExp | string>;
+    imageOnly?: boolean;
+    documentOnly?: boolean;
+    videoOnly?: boolean;
+    audioOnly?: boolean;
+    archiveOnly?: boolean;
+    caseSensitive?: boolean;
+    transform?: (value: File) => File;
+    defaultValue?: IsRequired extends true ? File : File | null;
+    i18n?: Partial<Record<Locale, Partial<FileMessages>>>;
+};
+/**
+ * Type alias for file validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @description Returns ZodType with proper input/output types based on required flag
+ */
+type FileSchema<IsRequired extends boolean> = IsRequired extends true ? ZodType<File, File | null> : ZodType<File | null, File | null>;
+/**
+ * Creates a Zod schema for file validation with comprehensive filtering options
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {Omit<FileOptions<IsRequired>, 'required'>} [options] - Configuration options for validation
+ * @returns {FileSchema<IsRequired>} Zod schema for file validation
+ *
+ * @description
+ * Creates a comprehensive file validator with MIME type filtering, size validation,
+ * extension validation, and extensive customization options.
+ *
+ * Features:
+ * - File size validation (min/max)
+ * - MIME type whitelist/blacklist support
+ * - File extension whitelist/blacklist support
+ * - File name pattern validation
+ * - Predefined file category filters (image, document, video, audio, archive)
+ * - Case-sensitive/insensitive extension matching
+ * - Custom transformation functions
+ * - Comprehensive internationalization
+ *
+ * @example
+ * ```typescript
+ * // Basic file validation
+ * const basicSchema = file() // optional by default
+ * basicSchema.parse(new File(["content"], "test.txt"))
+ * basicSchema.parse(null) // ✓ Valid (optional)
+ *
+ * // Required validation
+ * const requiredSchema = parse(new File(["content"], "test.txt"))
+(true)
+ * requiredSchema.parse(null) // ✗ Invalid (required)
+ *
+ *
+ * // Size restrictions
+ * const sizeSchema = file(false, {
+ *   maxSize: 1024 * 1024, // 1MB
+ *   minSize: 1024 // 1KB
+ * })
+ *
+ * // Extension restrictions
+ * const imageSchema = file(false, {
+ *   extension: [".jpg", ".png", ".gif"],
+ *   maxSize: 5 * 1024 * 1024 // 5MB
+ * })
+ *
+ * // MIME type restrictions
+ * const documentSchema = file(false, {
+ *   type: ["application/pdf", "application/msword"],
+ *   maxSize: 10 * 1024 * 1024 // 10MB
+ * })
+ *
+ * // Image files only
+ * const imageOnlySchema = file(false, { imageOnly: true })
+ *
+ * // Document files only
+ * const docOnlySchema = file(false, { documentOnly: true })
+ *
+ * // Name pattern validation
+ * const patternSchema = file(false, {
+ *   namePattern: /^[a-zA-Z0-9_-]+\.(pdf|doc|docx)$/,
+ *   maxSize: 5 * 1024 * 1024
+ * })
+ *
+ * // Optional with default
+ * const optionalSchema = file(false, {
+ *   defaultValue: null
+ * })
+ * ```
+ *
+ * @throws {z.ZodError} When validation fails with specific error messages
+ * @see {@link FileOptions} for all available configuration options
+ */
+declare function file<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<FileOptions<IsRequired>, "required">): FileSchema<IsRequired>;
+
+export { type FileMessages, type FileOptions, type FileSchema, file };

package/dist/common/file.js

@@ -0,0 +1,7 @@
+import {
+  file
+} from "../chunk-WDI4QJMQ.js";
+import "../chunk-6AAP4LPF.js";
+export {
+  file
+};