feat: adds buildApiForValibot()

Author: MH4GF

src/directive.ts

@@ -120,6 +120,39 @@ export function buildApi(config: FormattedDirectiveConfig, directives: ReadonlyA
     .join('')
 }
 
+// This function generates `[v.minLength(100), v.email()]`
+// NOTE: valibot's API is not a method chain, so it is prepared separately from buildApi.
+//
+// config
+// {
+//   'constraint': {
+//     'minLength': ['minLength', '$1'],
+//     'format': {
+//       'uri': ['url', '$2'],
+//       'email': ['email', '$2'],
+//     }
+//   }
+// }
+//
+// GraphQL schema
+// ```graphql
+// input ExampleInput {
+//   email: String! @required(msg: "message") @constraint(minLength: 100, format: "email")
+// }
+// ```
+//
+// FIXME: v.required() is not supported yet. v.required() is classified as `Methods` and must wrap the schema. ex) `v.required(v.object({...}))`
+export function buildApiForValibot(config: FormattedDirectiveConfig, directives: ReadonlyArray<ConstDirectiveNode>): string[] {
+  return directives
+    .filter(directive => config[directive.name.value] !== undefined)
+    .map((directive) => {
+      const directiveName = directive.name.value;
+      const argsConfig = config[directiveName];
+      const apis = buildApiFromDirectiveArguments(argsConfig, directive.arguments ?? []);
+      return apis.map((api) => `v${api}`);
+    }).flat()
+}
+
 function buildApiSchema(validationSchema: string[] | undefined, argValue: ConstValueNode): string {
   if (!validationSchema)
     return '';

tests/directive.spec.ts

@@ -9,6 +9,7 @@ import type {
 } from '../src/directive';
 import {
   buildApi,
+  buildApiForValibot,
   exportedForTesting,
   formatDirectiveConfig,
   formatDirectiveObjectArguments,
@@ -603,4 +604,64 @@ describe('format directive config', () => {
       });
     }
   });
+
+  describe('buildApiForValibot', () => {
+    const cases: {
+      name: string
+      args: {
+        config: FormattedDirectiveConfig
+        args: ReadonlyArray<ConstDirectiveNode>
+      }
+      want: string[]
+    }[] = [
+      {
+        name: 'valid',
+        args: {
+          config: {
+            constraint: {
+              minLength: ['minLength', '$1'],
+              format: {
+                uri: ['url'],
+                email: ['email'],
+              },
+            },
+          },
+          args: [
+            // @constraint(minLength: 100, format: "email")
+            buildConstDirectiveNodes('constraint', {
+              minLength: `100`,
+              format: `"email"`,
+            }),
+          ],
+        },
+        want: [`v.minLength(100)`, `v.email()`],
+      },
+      {
+        name: 'enum',
+        args: {
+          config: {
+            constraint: {
+              format: {
+                URI: ['uri'],
+              },
+            },
+          },
+          args: [
+            // @constraint(format: EMAIL)
+            buildConstDirectiveNodes('constraint', {
+              format: 'URI',
+            }),
+          ],
+        },
+        want: [`v.uri()`],
+      },
+    ];
+    for (const tc of cases) {
+      it(tc.name, () => {
+        const { config, args } = tc.args;
+        const got = buildApiForValibot(config, args);
+        expect(got).toStrictEqual(tc.want);
+      });
+    }
+  });
 });