1.7.0 - uuid support

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wearekickback/shared",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Shared utils between client and server",
   "main": "dist/index.js",
   "module": "src/index.js",

src/index.js

@@ -7,3 +7,4 @@ export * from './strings'
 export * from './legal'
 export * from './participants'
 export * from './social'
+export * from './uuid'

src/uuid.js

@@ -0,0 +1,15 @@
+import { isUUID as checkIsUUID } from 'validator'
+
+export const isUUID = str => {
+  if (typeof str !== 'string') {
+    return false
+  }
+
+  return checkIsUUID(str)
+}
+
+export const assertUUID = str => {
+  if (!isUUID(str)) {
+    throw new Error(`Invalid UUID: ${str}`)
+  }
+}

src/uuid.test.js

@@ -0,0 +1,29 @@
+import {
+  isUUID,
+  assertUUID,
+} from './'
+
+
+
+describe('uuid', () => {
+  it('checks and assertions', () => {
+    const tests = [
+      [ 1024, false ],
+      [ '', false ],
+      [ 'str', false ],
+      [ 'a21c09cc-f1db-4086-9bd7-e568e23fe160', true ],
+    ]
+
+    expect.assertions(tests.length * 2)
+
+    tests.forEach(([ input, expected ]) => {
+      expect(isUUID(input)).toEqual(expected)
+
+      if (expected) {
+        expect(() => assertUUID(input)).not.toThrow()
+      } else {
+        expect(() => assertUUID(input)).toThrow()
+      }
+    })
+  })
+})