/**
* @fileoverview Common validation schemas and utilities for input validation
* @module utils/validation
*/
import { z } from 'zod';
/**
* Common validation schemas for reuse across tools
*/
/**
* Schema for validating URL strings
* @description Ensures the input is a valid URL format
* @example
* ```typescript
* const validUrl = urlSchema.parse("https://example.com");
* // Returns: "https://example.com"
* ```
*/
export const urlSchema = z.string().url('Invalid URL format');
/**
* Schema for validating date strings in YYYY-MM-DD format
* @description Validates that the input matches the YYYY-MM-DD date format
* @example
* ```typescript
* const validDate = dateSchema.parse("2024-01-15");
* // Returns: "2024-01-15"
* ```
*/
export const dateSchema = z
.string()
.regex(/^\d{4}-\d{2}-\d{2}$/, 'Date must be in YYYY-MM-DD format');
/**
* Schema for validating timestamp strings in YYYYMMDDHHmmss format
* @description Validates 14-digit timestamp strings commonly used by web archives
* @example
* ```typescript
* const validTimestamp = timestampSchema.parse("20240115143022");
* // Returns: "20240115143022" (2024-01-15 14:30:22)
* ```
*/
export const timestampSchema = z
.string()
.regex(/^\d{14}$/, 'Timestamp must be in YYYYMMDDHHmmss format');
/**
* Validate and parse input with helpful error messages
* @param schema - Zod schema to validate against
* @param input - Unknown input to validate
* @returns Validated and typed input
* @throws {Error} If validation fails, with formatted error messages
*
* @example
* ```typescript
* const schema = z.object({ name: z.string() });
* const validated = validateInput(schema, { name: "test" });
* // Returns: { name: "test" } with TypeScript type inference
* ```
*/
export function validateInput<T>(schema: z.ZodSchema<T>, input: unknown): T {
try {
return schema.parse(input);
} catch (error) {
if (error instanceof z.ZodError) {
const issues = error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
throw new Error(`Validation failed:\n${issues.join('\n')}`);
}
throw error;
}
}
/**
* Validate URL format and return sanitized URL
* @param url - URL string to validate
* @returns Validated URL string
* @throws {Error} If URL is invalid
*/
export function validateUrl(url: string): string {
return urlSchema.parse(url);
}
/**
* Format timestamp to human-readable string
* @param timestamp - 14-digit timestamp (YYYYMMDDHHmmss)
* @returns Formatted date string
*/
export function formatTimestamp(timestamp: string): string {
const validated = timestampSchema.parse(timestamp);
const year = validated.slice(0, 4);
const month = validated.slice(4, 6);
const day = validated.slice(6, 8);
const hour = validated.slice(8, 10);
const minute = validated.slice(10, 12);
const second = validated.slice(12, 14);
return `${year}-${month}-${day} ${hour}:${minute}:${second}`;
}
