feat(guards): isUnixTimestamp

.eslintrc.cjs

@@ -20,7 +20,8 @@ module.exports = {
           'duid',
           'enum',
           'enums',
-          'uid'
+          'uid',
+          'unix'
         ]
       }
     ]

src/guards/__tests__/is-unix-timestamp.guard.spec.ts

@@ -0,0 +1,24 @@
+import type { Testcase } from '@tests/utils/types'
+import testSubject from '../is-number-string.guard'
+
+/**
+ * @file Unit Tests - isUnixTimestamp
+ * @module tutils/guards/tests/unit/isUnixTimestamp
+ */
+
+describe('unit:guards/isUnixTimestamp', () => {
+  type Case = Testcase<boolean> & { state: string; value: any }
+
+  const cases: Case[] = [
+    { expected: false, state: 'non-number value', value: null },
+    { expected: true, state: 'unix timestamp', value: Date.now() }
+  ]
+
+  it.each<Case>(cases)('should return $expected given $state', testcase => {
+    // Arrange
+    const { expected, value } = testcase
+
+    // Act + Expect
+    expect(testSubject(value)).toBe(expected)
+  })
+})

src/guards/index.ts

@@ -10,3 +10,4 @@ export { default as isEmptyValue } from './is-empty-value.guard'
 export { default as isNIL } from './is-nil.guard'
 export { default as isNodeEnv } from './is-node-env.guard'
 export { default as isNumberString } from './is-number-string.guard'
+export { default as isUnixTimestamp } from './is-unix-timestamp.guard'

src/guards/is-unix-timestamp.guard.ts

@@ -0,0 +1,18 @@
+/**
+ * @file Type Guards - isUnixTimestamp
+ * @module tutils/guards/isUnixTimestamp
+ */
+
+/**
+ * Checks if `timestamp` is a valid [unix timestamp][1].
+ *
+ * [1]: https://unixtimestamp.com
+ *
+ * @param {any} timestamp - Value to check
+ * @return {boolean} `true` if unix timestamp, `false` otherwise
+ */
+const isUnixTimestamp = (timestamp: any): boolean => {
+  return typeof timestamp === 'number' && new Date(timestamp).getTime() > 0
+}
+
+export default isUnixTimestamp