feat(supported-version): validate custom_versions

Previously, @danslo reported that he tried to use `custom_versions` without
setting the kind. This isn't the correct behavior.
I've added a validator to alert him of this.

supported-version/src/kind/compute-kind.spec.ts

@@ -1,11 +0,0 @@
-import { isValidKind } from "./compute-kind";
-
-describe('isValidKind', () => {
-    it('returns `true` if its a valid kind', () => {
-        expect(isValidKind("latest")).toBe(true);
-    });
-
-    it('returns `false` if it is not a valid kind', () => {
-        expect(isValidKind("taco")).toBe(false);
-    })
-})

supported-version/src/kind/compute-kind.ts

@@ -1,23 +0,0 @@
-/**
- * Acceptable arguments for version `kind`
- */
-export const KNOWN_KINDS = {
-    'currently-supported': true,
-    'latest': true,
-    'custom': true,
-    'nightly': true,
-    'all': true,
-}
-
-export const isValidKind = (kind: string): boolean => {
-    return kind in KNOWN_KINDS;
-};
-
-export const validateOrError = (kind: string): true =>  {
-    if(isValidKind(kind)){
-        return true;   
-    }
-    else {
-        throw new Error(`Invalid kind provided, supported kinds are: ${Object.keys(KNOWN_KINDS).join(', ')}`);
-    }
-}

supported-version/src/kind/kinds.ts

@@ -0,0 +1,12 @@
+/**
+ * Acceptable arguments for version `kind`
+ */
+export const KNOWN_KINDS = {
+    'currently-supported': true,
+    'latest': true,
+    'custom': true,
+    'nightly': true,
+    'all': true,
+}
+
+export type Kind = keyof typeof KNOWN_KINDS;

supported-version/src/kind/validate-kinds.spec.ts

@@ -0,0 +1,15 @@
+import { validateKind } from "./validate-kinds";
+
+describe('validateKind', () => {
+    it('returns `true` if its a valid kind', () => {
+        expect(validateKind("latest")).toBe(true);
+    });
+
+    it('throws a helpful exception if its an invalid kind', () => {
+        expect(() => validateKind(<any>"taco")).toThrowError();
+    })
+
+    it('throws a helpful exception if custom versions are provided with the wrong kind', () => {
+        expect(() => validateKind(<any>"latest", [])).toThrowError();
+    })
+})

supported-version/src/kind/validate-kinds.ts

@@ -0,0 +1,12 @@
+import { customVersionsValidator } from "./validations/custom-versions-validator";
+import { isKnownKind } from "./validations/is-known-kind";
+import { KindValidator } from "./validator";
+
+export const validateKind: KindValidator = (kind, custom_versions = null): boolean => {
+    return validators.reduce((acc, el) => el(kind, custom_versions), true);
+}
+
+export const validators: KindValidator[] = [
+    isKnownKind,
+    customVersionsValidator,
+];

supported-version/src/kind/validations/custom-versions-validator.ts

@@ -0,0 +1,8 @@
+import { KindValidator } from "../validator";
+
+export const customVersionsValidator: KindValidator = (kind, customVersions) => {
+    if(customVersions && kind !== 'custom') {
+        throw new Error('`custom_versions` can only be used with kind `custom`'); 
+    }
+    return true;
+}

supported-version/src/kind/validations/is-known-kind.ts

@@ -0,0 +1,11 @@
+import { KNOWN_KINDS, Kind } from "../kinds";
+
+export const isKnownKind = (kind: Kind): boolean => {
+    if(!(kind in KNOWN_KINDS)) {
+        throw new Error(
+            `Invalid kind provided, supported kinds are: ${Object.keys(KNOWN_KINDS).join(', ')}`
+        );
+    }
+    
+    return true;
+};

supported-version/src/kind/validator.ts

@@ -0,0 +1,3 @@
+import { Kind } from "./kinds";
+
+export type KindValidator = (kind: Kind, custom_versions?: string[]) => boolean;