feat(versioning): Add schema transform

lib/modules/versioning/index.ts

@@ -1,13 +1,9 @@
-import { logger } from '../../logger';
 import versionings from './api';
-import { isVersioningApiConstructor } from './common';
-import * as semverCoerced from './semver-coerced';
+import { Versioning } from './schema';
 import type { VersioningApi, VersioningApiConstructor } from './types';
 
 export * from './types';
 
-const defaultVersioning = semverCoerced;
-
 export const getVersioningList = (): string[] => Array.from(versionings.keys());
 /**
  * Get versioning map. Can be used to dynamically add new versioning type
@@ -18,27 +14,5 @@ export const getVersionings = (): Map<
 > => versionings;
 
 export function get(versioning: string | undefined): VersioningApi {
-  if (!versioning) {
-    logger.trace(
-      `Missing versioning, using ${defaultVersioning.id} as fallback.`
-    );
-    return defaultVersioning.api;
-  }
-  const [versioningName, ...versioningRest] = versioning.split(':');
-  const versioningConfig = versioningRest.length
-    ? versioningRest.join(':')
-    : undefined;
-
-  const theVersioning = versionings.get(versioningName);
-  if (!theVersioning) {
-    logger.info(
-      { versioning },
-      `Unknown versioning - defaulting to ${defaultVersioning.id}`
-    );
-    return defaultVersioning.api;
-  }
-  if (isVersioningApiConstructor(theVersioning)) {
-    return new theVersioning(versioningConfig);
-  }
-  return theVersioning;
+  return Versioning.parse(versioning);
 }

lib/modules/versioning/schema.spec.ts

@@ -0,0 +1,14 @@
+import api from './api';
+import { Versioning } from './schema';
+
+describe('modules/versioning/schema', () => {
+  it('parses valid version strings', () => {
+    const versioning = Versioning.parse('semver');
+    expect(versioning).toBeDefined();
+    expect(versioning).toEqual(api.get('semver'));
+  });
+
+  it('throws an error for invalid version strings', () => {
+    expect(() => Versioning.parse('foobar')).toThrow();
+  });
+});

lib/modules/versioning/schema.ts

@@ -0,0 +1,38 @@
+import is from '@sindresorhus/is';
+import { z } from 'zod';
+import { logger } from '../../logger';
+import versionings from './api';
+import * as defaultVersioning from './semver-coerced';
+import type { VersioningApi } from './types';
+
+export const Versioning = z
+  .unknown()
+  .transform((versioningSpec): VersioningApi => {
+    if (!is.string(versioningSpec)) {
+      logger.debug(
+        { versioning: versioningSpec },
+        `Versioning: invalid name, falling back to ${defaultVersioning.id}`
+      );
+      return defaultVersioning.api;
+    }
+
+    const [versioningName, ...versioningRest] = versioningSpec.split(':');
+
+    let versioning = versionings.get(versioningName);
+    if (!versioning) {
+      logger.info(
+        { versioning: versioningSpec },
+        `Versioning: '${versioningSpec}' not found, falling back to ${defaultVersioning.id}`
+      );
+      return defaultVersioning.api;
+    }
+
+    if (is.function_(versioning)) {
+      const versioningConfig = versioningRest.length
+        ? versioningRest.join(':')
+        : undefined;
+      versioning = new versioning(versioningConfig);
+    }
+
+    return versioning;
+  });