Merge pull request #3671 from hey-api/feat/zod-data-split

feat: extract zod and validator schemas

Author: mrlubos

.changeset/eighty-suns-fly.md

@@ -0,0 +1,29 @@
+---
+"@hey-api/openapi-ts": minor
+---
+
+**plugin(valibot)**: remove request data schema
+
+### Validator request schemas
+
+Valibot plugin no longer exports composite request `Data` schemas. Instead, each layer is exported as a separate schema. If you're using validators with SDKs, you can preserve the composite schema with `shouldExtract`:
+
+```js
+export default {
+  input: 'hey-api/backend', // sign up at app.heyapi.dev
+  output: 'src/client',
+  plugins: [
+    // ...other plugins
+    {
+      name: 'sdk',
+      validator: 'valibot',
+    },
+    {
+      name: 'valibot',
+      requests: {
+        shouldExtract: true,
+      },
+    },
+  ],
+};
+```

.changeset/every-vans-sleep.md

@@ -0,0 +1,10 @@
+---
+"@hey-api/openapi-ts": minor
+"@hey-api/shared": minor
+---
+
+**internal**: remove `plugin.getSymbol()` function
+
+### Removed `plugin.getSymbol()` function
+
+This function has been removed. You can use `plugin.querySymbol()` instead. It accepts the same arguments and returns the same result.

.changeset/fine-flies-sink.md

@@ -0,0 +1,29 @@
+---
+"@hey-api/openapi-ts": minor
+---
+
+**plugin(zod)**: remove request data schema
+
+### Validator request schemas
+
+Zod plugin no longer exports composite request `Data` schemas. Instead, each layer is exported as a separate schema. If you're using validators with SDKs, you can preserve the composite schema with `shouldExtract`:
+
+```js
+export default {
+  input: 'hey-api/backend', // sign up at app.heyapi.dev
+  output: 'src/client',
+  plugins: [
+    // ...other plugins
+    {
+      name: 'sdk',
+      validator: 'zod',
+    },
+    {
+      name: 'zod',
+      requests: {
+        shouldExtract: true,
+      },
+    },
+  ],
+};
+```

.changeset/happy-snails-strive.md

@@ -0,0 +1,5 @@
+---
+"@hey-api/openapi-ts": patch
+---
+
+**plugin(zod)**: export request body, path, query, and headers schemas

.changeset/short-things-leave.md

@@ -0,0 +1,5 @@
+---
+"@hey-api/shared": patch
+---
+
+**plugins**: add request validator helpers

.changeset/small-beds-travel.md

@@ -0,0 +1,5 @@
+---
+"@hey-api/openapi-ts": patch
+---
+
+**plugin(orpc)**: fix: adjust input shape

.changeset/thin-islands-happen.md

@@ -0,0 +1,5 @@
+---
+"@hey-api/openapi-ts": patch
+---
+
+**plugin(valibot)**: export request body, path, query, and headers schemas

docs/openapi-ts/migrating.md

@@ -7,6 +7,63 @@ description: Migrating to @hey-api/openapi-ts.
 
 While we try to avoid breaking changes, sometimes it's unavoidable in order to offer you the latest features. This page lists changes that require updates to your code. If you run into a problem with migration, please [open an issue](https://github.com/hey-api/openapi-ts/issues).
 
+## v0.95.0
+
+### Validator request schemas
+
+Valibot and Zod plugins no longer export composite request `Data` schemas. Instead, each layer is exported as a separate schema. If you're using validators with SDKs, you can preserve the composite schema with `shouldExtract`:
+
+::: code-group
+
+<!-- prettier-ignore-start -->
+```js [Zod]
+export default {
+  input: 'hey-api/backend', // sign up at app.heyapi.dev
+  output: 'src/client',
+  plugins: [
+    // ...other plugins
+    {
+      name: 'sdk',
+      validator: 'zod',
+    },
+    {
+      name: 'zod',
+      requests: { // [!code ++]
+        shouldExtract: true, // [!code ++]
+      }, // [!code ++]
+    },
+  ],
+};
+```
+<!-- prettier-ignore-end -->
+<!-- prettier-ignore-start -->
+```js [Valibot]
+export default {
+  input: 'hey-api/backend', // sign up at app.heyapi.dev
+  output: 'src/client',
+  plugins: [
+    // ...other plugins
+    {
+      name: 'sdk',
+      validator: 'valibot',
+    },
+    {
+      name: 'valibot',
+      requests: { // [!code ++]
+        shouldExtract: true, // [!code ++]
+      }, // [!code ++]
+    },
+  ],
+};
+```
+<!-- prettier-ignore-end -->
+
+:::
+
+### Removed `plugin.getSymbol()` function
+
+This function has been removed. You can use `plugin.querySymbol()` instead. It accepts the same arguments and returns the same result.
+
 ## v0.93.0
 
 ### Removed resolver node

docs/openapi-ts/plugins/orpc.md

@@ -99,7 +99,7 @@ For a more granular approach, manually add a validator plugin and set `validator
 ```js [example]
 import { oc } from '@orpc/contract';
 
-import { vAddPetData, vAddPetResponse } from './valibot.gen';
+import { vAddPetBody, vAddPetResponse } from './valibot.gen';
 
 const addPet = oc
   .route({
@@ -111,7 +111,7 @@ const addPet = oc
     summary: 'Add a new pet to the store.',
     tags: ['pet'],
   })
-  .input(vAddPetData) // [!code ++]
+  .input(v.object({ body: vAddPetBody })) // [!code ++]
   .output(vAddPetResponse); // [!code ++]
 ```
 

docs/openapi-ts/plugins/valibot.md

@@ -68,22 +68,21 @@ The Valibot plugin will generate the following artifacts, depending on the input
 
 ## Requests
 
-A single request schema is generated for each endpoint. It may contain a request body, parameters, and headers.
+A Valibot schema is generated for every request layer of each endpoint.
 
 ::: code-group
 
 ```ts [example]
-const vData = v.object({
-  body: v.optional(
-    v.object({
-      foo: v.optional(v.string()),
-      bar: v.optional(v.union([v.number(), v.null()])),
-    }),
-  ),
-  path: v.object({
-    baz: v.string(),
-  }),
-  query: v.optional(v.never()),
+const vDeletePetHeaders = v.object({
+  api_key: v.optional(v.string()),
+});
+
+const vDeletePetPath = v.object({
+  petId: v.number(),
+});
+
+const vDeletePetQuery = v.object({
+  additionalMetadata: v.string(),
 });
 ```
 
@@ -103,10 +102,6 @@ export default {
 
 :::
 
-::: tip
-If you need to access individual fields, you can do so using the [`.entries`](https://valibot.dev/api/object/) API. For example, we can get the request body schema with `vData.entries.body`.
-:::
-
 You can customize the naming and casing pattern for `requests` schemas using the `.name` and `.case` options.
 
 ## Responses