🎉 feat: support standalone schema

Author: SaltyAom

CHANGELOG.md

@@ -1,4 +1,5 @@
 # 1.4.12 - 18 Dec 2025
+- support standard json schema conversion
 - [#300](https://github.com/elysiajs/elysia-openapi/pull/300) support standalone schema by @MarcelOlsen
 
 # 1.4.11 - 25 Sep 2025

bun.lock

@@ -2,35 +2,13 @@ import { Elysia, t } from 'elysia'
 import z from 'zod'
 import { JSONSchema, Schema } from 'effect'
 
-import { openapi, withHeaders } from '../src/index'
+import { openapi } from '../src/index'
 
 const app = new Elysia()
-	.use(
-		openapi({
-			mapJsonSchema: {
-				zod: z.toJSONSchema
-			}
-		})
-	)
-	.guard({
-		schema: 'standalone',
-		response: {
-			403: t.Object({
-				age: t.Number()
-			})
-		}
-	})
-	// .guard({
-	// 	schema: 'standalone',
-	// 	response: {
-	// 		403: z.object({
-	// 			code: z.string()
-	// 		})
-	// 	}
-	// })
+	.use(openapi())
 	.post('/', ({ body }) => body, {
-		body: t.Object({
-			name: t.String()
+		body: z.object({
+			name: z.string()
 		})
 	})
 	.get('/test', ({ status }) => {}, {

example/index.ts

@@ -1,6 +1,6 @@
 {
     "name": "@elysiajs/openapi",
-    "version": "1.4.11",
+    "version": "1.4.12",
     "description": "Plugin for Elysia to auto-generate API documentation",
     "author": {
         "name": "saltyAom",
@@ -85,7 +85,7 @@
         "openapi-types": "^12.1.3",
         "tsup": "^8.5.0",
         "typescript": "^5.9.2",
-        "zod": "^4.1.5"
+        "zod": "^4.2.1"
     },
     "peerDependencies": {
         "elysia": ">= 1.4.0"

package.json

@@ -298,15 +298,15 @@ const unwrapResponseSchema = (
 				? schema
 				: // @ts-ignore
 					schema['~standard']
-					? unwrapSchema(schema as any, vendors)
+					? unwrapSchema(schema as any, vendors, 'output')
 					: Object.fromEntries(
 							Object.entries(schema).map(([status, schema]) => [
 								status,
 								typeof schema === 'string'
 									? normalizeSchemaReference(schema)
 									: isTSchema(schema)
 										? schema
-										: unwrapSchema(schema as any, vendors)
+										: unwrapSchema(schema as any, vendors, 'output')
 							])
 						)
 
@@ -498,7 +498,8 @@ const unwrapReference = <T extends OpenAPIV3.SchemaObject | undefined>(
 
 export const unwrapSchema = (
 	schema: InputSchema['body'],
-	mapJsonSchema?: MapJsonSchema
+	mapJsonSchema?: MapJsonSchema,
+	io: 'input' | 'output' = 'input'
 ): OpenAPIV3.SchemaObject | undefined => {
 	if (!schema) return
 
@@ -511,6 +512,11 @@ export const unwrapSchema = (
 	const vendor = schema['~standard'].vendor
 
 	try {
+		// @ts-ignore
+		if (schema['~standard']?.jsonSchema?.[io])
+		// @ts-ignore
+			return schema['~standard']?.jsonSchema?.[io]?.()
+
 		if (
 			mapJsonSchema?.[vendor] &&
 			typeof mapJsonSchema[vendor] === 'function'
@@ -954,7 +960,7 @@ export function toOpenAPISchema(
 				!(hooks.response as any)['~standard']
 			) {
 				for (let [status, schema] of Object.entries(hooks.response)) {
-					const response = unwrapSchema(schema, vendors)
+					const response = unwrapSchema(schema, vendors, 'output')
 
 					if (!response) continue
 
@@ -987,7 +993,7 @@ export function toOpenAPISchema(
 					}
 				}
 			} else {
-				const response = unwrapSchema(hooks.response as any, vendors)
+				const response = unwrapSchema(hooks.response as any, vendors, 'output')
 
 				if (response) {
 					// @ts-ignore