feat: timestamp validation

Author: glennmichael123

CHANGELOG.md

@@ -1,4 +1,8 @@
 
+## v0.2.2...v0.2.2
+
+[compare changes](https://github.com/stacksjs/ts-validation/compare/v0.2.2...v0.2.2)
+
 ## v0.2.1...main
 
 [compare changes](https://github.com/stacksjs/ts-validation/compare/v0.2.1...main)

src/types.ts

@@ -7,6 +7,7 @@ import type { EnumValidator } from './validators/enums'
 import type { NumberValidator } from './validators/numbers'
 import type { ObjectValidator } from './validators/objects'
 import type { StringValidator } from './validators/strings'
+import type { TimestampValidator } from './validators/timestamp'
 
 export interface ValidationError {
   message: string
@@ -253,4 +254,5 @@ export interface ValidationInstance {
   date: () => DateValidator
   object: <T extends Record<string, any>>() => ObjectValidator<T>
   custom: <T>(validationFn: (value: T) => boolean, message: string) => CustomValidator<T>
+  timestamp: () => TimestampValidator
 }

src/validation.ts

@@ -7,6 +7,7 @@ import { enum_ } from './validators/enums'
 import { number } from './validators/numbers'
 import { object } from './validators/objects'
 import { string } from './validators/strings'
+import { timestamp } from './validators/timestamp'
 
 export const v: ValidationInstance = {
   string,
@@ -17,4 +18,5 @@ export const v: ValidationInstance = {
   date,
   object,
   custom,
+  timestamp,
 }

src/validators/timestamp.ts

@@ -0,0 +1,33 @@
+import { BaseValidator } from './base'
+
+export class TimestampValidator extends BaseValidator<number | string> {
+  constructor() {
+    super()
+    this.addRule({
+      name: 'isTimestamp',
+      test: (value: number | string) => {
+        const timestampStr = value.toString()
+        const length = timestampStr.length
+
+        // Check if length is between 10 and 13
+        if (length < 10 || length > 13) {
+          return false
+        }
+
+        // Check if it's a valid number
+        const num = Number(value)
+        if (Number.isNaN(num)) {
+          return false
+        }
+
+        // Additional validation: should be a positive number
+        return num > 0
+      },
+      message: 'Must be a valid timestamp (10-13 digits)',
+    })
+  }
+}
+
+export function timestamp(): TimestampValidator {
+  return new TimestampValidator()
+}

test/validation.test.ts

@@ -484,4 +484,31 @@ describe('Validation Library', () => {
       expect(result.errors).toHaveLength(0)
     })
   })
+
+  describe('Timestamp Validator', () => {
+    test('basic timestamp validation', () => {
+      const validator = v.timestamp()
+      expect(validator.test(1683912345)).toBe(true) // 10 digits
+      expect(validator.test('1683912345')).toBe(true) // 10 digits string
+      expect(validator.test(1683912345678)).toBe(true) // 13 digits
+      expect(validator.test('1683912345678')).toBe(true) // 13 digits string
+    })
+
+    test('invalid timestamp validation', () => {
+      const validator = v.timestamp()
+      expect(validator.test(123456789)).toBe(false) // 9 digits (too short)
+      expect(validator.test('123456789')).toBe(false) // 9 digits string
+      expect(validator.test(12345678901234)).toBe(false) // 14 digits (too long)
+      expect(validator.test('abc')).toBe(false) // invalid string
+      expect(validator.test(-1683912345)).toBe(false) // negative number
+    })
+
+    test('timestamp validation error messages', () => {
+      const validator = v.timestamp()
+      const result = validator.validate('invalid')
+      expect(result.valid).toBe(false)
+      expect(result.errors).toHaveLength(1)
+      expect(result.errors[0].message).toBe('Must be a valid timestamp (10-13 digits)')
+    })
+  })
 })