fumadocs-openapi 5.10.6 → 5.11.1

package/dist/index.d.ts

@@ -49,14 +49,15 @@ type RequestSchema = PrimitiveSchema | ArraySchema | ObjectSchema | SwitcherSche
 interface APIPlaygroundProps {
     route: string;
     method: string;
-    bodyType: 'json' | 'form-data';
     authorization?: PrimitiveRequestField & {
         authType: string;
     };
     path?: PrimitiveRequestField[];
     query?: PrimitiveRequestField[];
     header?: PrimitiveRequestField[];
-    body?: RequestSchema;
+    body?: RequestSchema & {
+        mediaType: string;
+    };
     schemas: Record<string, RequestSchema>;
     proxyUrl?: string;
 }

package/dist/server/index.d.ts

@@ -51,14 +51,15 @@ type RequestSchema = PrimitiveSchema | ArraySchema | ObjectSchema | SwitcherSche
 interface APIPlaygroundProps {
     route: string;
     method: string;
-    bodyType: 'json' | 'form-data';
     authorization?: PrimitiveRequestField & {
         authType: string;
     };
     path?: PrimitiveRequestField[];
     query?: PrimitiveRequestField[];
     header?: PrimitiveRequestField[];
-    body?: RequestSchema;
+    body?: RequestSchema & {
+        mediaType: string;
+    };
     schemas: Record<string, RequestSchema>;
     proxyUrl?: string;
 }

package/dist/server/index.js

@@ -2,6 +2,7 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import Slugger from 'github-slugger';
 import { Fragment as Fragment$1 } from 'react';
 import { sample } from 'openapi-sampler';
+import { js2xml } from 'xml-js';
 import { compile } from '@fumari/json-schema-to-typescript';
 import { remarkGfm, remarkImage, rehypeCode } from 'fumadocs-core/mdx-plugins';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
@@ -24,9 +25,24 @@ function getPreferredType(body) {
     return Object.keys(body)[0];
 }
 /**
- * Convert to JSON string if necessary
- */ function toSampleInput(value) {
-    return typeof value === 'string' ? value : JSON.stringify(value, null, 2);
+ * Convert input to string (with quotes)
+ */ function inputToString(value, mediaType = 'application/json', multiLine = 'none') {
+    const getStr = (v)=>{
+        if (multiLine === 'none') return JSON.stringify(v);
+        const delimit = multiLine === 'backtick' ? `\`` : `'`;
+        return `${delimit}${v.replaceAll(delimit, `\\${delimit}`)}${delimit}`;
+    };
+    if (typeof value === 'string') return getStr(value);
+    if (mediaType === 'application/json' || mediaType === 'multipart/form-data') {
+        return getStr(JSON.stringify(value, null, 2));
+    }
+    if (mediaType === 'application/xml') {
+        return getStr(js2xml(value, {
+            compact: true,
+            spaces: 2
+        }));
+    }
+    throw new Error(`Unsupported media type: ${mediaType}`);
 }
 function isNullable(schema, includeOneOf = true) {
     if (Array.isArray(schema.type) && schema.type.includes('null')) return true;
@@ -124,8 +140,8 @@ function generateSample(path, method, { baseUrl, document }) {
     const queryParams = new URLSearchParams();
     for (const param of params){
         const value = generateBody(method.method, param.schema);
-        if (param.in === 'query') queryParams.append(param.name, toSampleInput(value));
-        if (param.in === 'path') pathWithParameters = pathWithParameters.replace(`{${param.name}}`, toSampleInput(value));
+        if (param.in === 'query') queryParams.append(param.name, String(value));
+        if (param.in === 'path') pathWithParameters = pathWithParameters.replace(`{${param.name}}`, String(value));
     }
     if (queryParams.size > 0) pathWithParameters = `${pathWithParameters}?${queryParams.toString()}`;
     return {
@@ -148,11 +164,11 @@ function getSampleRequest$3(endpoint) {
     s.push(`curl -X ${endpoint.method} "${endpoint.url}"`);
     for (const param of endpoint.parameters){
         if (param.in === 'header') {
-            const header = `${param.name}: ${toSampleInput(param.sample)}`;
+            const header = `${param.name}: ${param.sample}`;
             s.push(`-H "${header}"`);
         }
         if (param.in === 'cookie') {
-            const cookie = JSON.stringify(`${param.name}=${toSampleInput(param.sample)}`);
+            const cookie = JSON.stringify(`${param.name}=${param.sample}`);
             s.push(`--cookie ${cookie}`);
         }
     }
@@ -160,12 +176,12 @@ function getSampleRequest$3(endpoint) {
         const sample = endpoint.body.sample;
         if (sample && typeof sample === 'object') {
             for (const [key, value] of Object.entries(sample)){
-                s.push(`-F ${key}=${JSON.stringify(value, null, 2)}`);
+                s.push(`-F ${key}=${inputToString(value)}`);
             }
         }
     } else if (endpoint.body) {
-        s.push(`-H "Content-Type: application/json"`);
-        s.push(`-d '${toSampleInput(endpoint.body.sample)}'`);
+        s.push(`-H "Content-Type: ${endpoint.body.mediaType}"`);
+        s.push(`-d ${inputToString(endpoint.body.sample, endpoint.body.mediaType, 'single-quote')}`);
     }
     return s.flatMap((v, i)=>v.split('\n').map((line)=>i > 0 ? `  ${line}` : line).join('\n')).join(' \\\n');
 }
@@ -184,17 +200,23 @@ function getSampleRequest$2(endpoint) {
         }
     }
     if (cookies.size > 0) {
-        headers.set('cookie', Array.from(cookies.entries()).map(([key, value])=>`${key}=${toSampleInput(value)}`).join('; '));
+        headers.set('cookie', Array.from(cookies.entries()).map(([key, value])=>`${key}=${value}`).join('; '));
     }
     if (headers.size > 0) {
-        options.set('headers', JSON.stringify(Object.fromEntries(headers.entries()), undefined, 2).replaceAll('\n', '\n  '));
+        options.set('headers', JSON.stringify(Object.fromEntries(headers.entries()), null, 2).replaceAll('\n', '\n  '));
     }
     if (endpoint.body?.mediaType === 'multipart/form-data' && typeof endpoint.body.sample === 'object' && endpoint.body.sample) {
         s.push(`const formData = new FormData();`);
-        for (const [key, value] of Object.entries(endpoint.body.sample))s.push(`formData.set(${key}, ${JSON.stringify(value)})`);
+        for (const [key, value] of Object.entries(endpoint.body.sample))s.push(`formData.set(${key}, ${inputToString(value)})`);
         options.set('body', 'formData');
     } else if (endpoint.body) {
-        options.set('body', `JSON.stringify(${JSON.stringify(endpoint.body.sample, null, 2).replaceAll('\n', '\n  ')})`);
+        let code;
+        if (endpoint.body.mediaType === 'application/json') {
+            code = typeof endpoint.body.sample === 'string' ? inputToString(endpoint.body.sample, endpoint.body.mediaType, 'backtick') : `JSON.stringify(${JSON.stringify(endpoint.body.sample, null, 2)})`;
+        } else {
+            code = inputToString(endpoint.body.sample, endpoint.body.mediaType, 'backtick');
+        }
+        options.set('body', code.replaceAll('\n', '\n  '));
     }
     const optionsStr = Array.from(options.entries()).map(([k, v])=>`  ${k}: ${v}`).join(',\n');
     s.push(`fetch(${JSON.stringify(endpoint.url)}, {\n${optionsStr}\n});`);
@@ -208,29 +230,27 @@ function getSampleRequest$1(endpoint) {
         'io/ioutil'
     ];
     const headers = new Map();
-    const cookies = new Map();
     const variables = new Map();
     // additional lines before initializing request
     const additional = [];
     for (const p of endpoint.parameters){
         if (p.in === 'header') headers.set(p.name, JSON.stringify(p.sample));
-        if (p.in === 'cookie') cookies.set(p.name, toSampleInput(p.sample));
     }
+    const cookies = endpoint.parameters.filter((p)=>p.in === 'cookie');
     variables.set('url', JSON.stringify(endpoint.url));
-    if (cookies.size > 0) headers.set('Cookie', JSON.stringify(Array.from(cookies.entries()).map(([key, value])=>`${key}=${value}`).join('; ')));
+    if (cookies.length > 0) headers.set('Cookie', JSON.stringify(cookies.map((p)=>`${p.name}=${p.sample}`).join('; ')));
     if (endpoint.body) {
         headers.set('Content-Type', `"${endpoint.body.mediaType}"`);
-        if (endpoint.body.mediaType === 'application/json') {
-            imports.push('strings');
-            variables.set('payload', `strings.NewReader(\`${JSON.stringify(endpoint.body.sample, null, 2).replaceAll('\n', '\n  ')}\`)`);
-        }
         if (endpoint.body.mediaType === 'multipart/form-data' && typeof endpoint.body.sample === 'object') {
             imports.push('mime/multipart', 'bytes');
             variables.set('payload', `new(bytes.Buffer)`);
             variables.set('mp', 'multipart.NewWriter(payload)');
             for (const [key, value] of Object.entries(endpoint.body.sample ?? {})){
-                additional.push(`mp.WriteField("${key}", ${JSON.stringify(toSampleInput(value))})`);
+                additional.push(`mp.WriteField("${key}", ${inputToString(value, undefined, 'backtick')})`);
             }
+        } else {
+            imports.push('strings');
+            variables.set('payload', `strings.NewReader(${inputToString(endpoint.body.sample, endpoint.body.mediaType, 'backtick').replaceAll('\n', '\n  ')})`);
         }
     }
     return `package main
@@ -261,15 +281,26 @@ function getSampleRequest(endpoint) {
         if (param.in === 'header') headers.set(param.name, param.sample);
         if (param.in === 'cookie') cookies.set(param.name, param.sample);
     }
+    if (endpoint.body) {
+        switch(endpoint.body.mediaType){
+            case 'application/json':
+                variables.set('json', JSON.stringify(endpoint.body.sample, null, 2));
+                break;
+            case 'multipart/form-data':
+                headers.set('Content-Type', endpoint.body.mediaType);
+                variables.set('data', JSON.stringify(endpoint.body.sample, null, 2));
+                break;
+            default:
+                headers.set('Content-Type', endpoint.body.mediaType);
+                variables.set('data', inputToString(endpoint.body.sample, endpoint.body.mediaType, 'backtick'));
+        }
+    }
     if (headers.size > 0) {
         variables.set('headers', JSON.stringify(Object.fromEntries(headers.entries()), null, 2));
     }
     if (cookies.size > 0) {
         variables.set('cookies', JSON.stringify(Object.fromEntries(cookies.entries()), null, 2));
     }
-    if (endpoint.body) {
-        variables.set(endpoint.body.mediaType === 'multipart/form-data' ? 'data' : 'json', JSON.stringify(endpoint.body.sample, null, 2));
-    }
     return `import requests
 
 url = ${JSON.stringify(endpoint.url)}
@@ -314,11 +345,13 @@ function Playground({ path, method, ctx }) {
         authorization: getAuthorizationField(method, ctx),
         method: method.method,
         route: path,
-        bodyType: mediaType === 'multipart/form-data' ? 'form-data' : 'json',
         path: method.parameters?.filter((v)=>v.in === 'path').map((v)=>parameterToField(v, context)),
         query: method.parameters?.filter((v)=>v.in === 'query').map((v)=>parameterToField(v, context)),
         header: method.parameters?.filter((v)=>v.in === 'header').map((v)=>parameterToField(v, context)),
-        body: bodySchema,
+        body: bodySchema && mediaType ? {
+            ...bodySchema,
+            mediaType: mediaType
+        } : undefined,
         schemas: context.references,
         proxyUrl: ctx.proxyUrl
     };

package/dist/ui/{client-client-B9w--AKD.js → client-client-NS2E5Jdn.js}

@@ -253,7 +253,7 @@ function useSchemaContext() {
     return ctx;
 }
 
-const APIPlayground = dynamic(()=>import('./index-client-69lE5jtH.js').then(function (n) { return n.i; }).then((mod)=>mod.APIPlayground));
+const APIPlayground = dynamic(()=>import('./index-client-B6op0H4J.js').then(function (n) { return n.i; }).then((mod)=>mod.APIPlayground));
 function Root({ children, baseUrl, className, shikiOptions, ...props }) {
     return /*#__PURE__*/ jsx("div", {
         className: cn('flex flex-col gap-24 text-sm text-fd-muted-foreground', className),

package/dist/ui/{fetcher-DBWYlEEA.js → fetcher-B7R5rjLv.js}

@@ -1,22 +1,22 @@
-import { r as resolve } from './index-client-69lE5jtH.js';
+import { r as resolve } from './index-client-B6op0H4J.js';
 
 /**
  * @param bodySchema - schema of body
  * @param references - defined references of schemas, needed for resolve cyclic references
  */ function createBrowserFetcher(bodySchema, references) {
     return {
-        async fetch (input) {
+        async fetch (options) {
             const headers = new Headers();
-            if (input.type !== 'form-data') headers.append('Content-Type', 'application/json');
-            for (const key of Object.keys(input.header)){
-                const paramValue = input.header[key];
+            if (options.body && options.body.mediaType !== 'multipart/form-data') headers.append('Content-Type', options.body.mediaType);
+            for (const key of Object.keys(options.header)){
+                const paramValue = options.header[key];
                 if (typeof paramValue === 'string' && paramValue.length > 0) headers.append(key, paramValue.toString());
             }
-            return fetch(input.url, {
-                method: input.method,
+            return fetch(options.url, {
+                method: options.method,
                 cache: 'no-cache',
                 headers,
-                body: bodySchema ? createBodyFromValue(input.type, input.body, bodySchema, references, input.dynamicFields ?? new Map()) : undefined,
+                body: bodySchema && options.body ? await createBodyFromValue(options.body.mediaType, options.body.value, bodySchema, references, options.dynamicFields ?? new Map()) : undefined,
                 signal: AbortSignal.timeout(10 * 1000)
             }).then(async (res)=>{
                 const contentType = res.headers.get('Content-Type') ?? '';
@@ -47,11 +47,18 @@ import { r as resolve } from './index-client-69lE5jtH.js';
 }
 /**
  * Create request body from value
- */ function createBodyFromValue(type, value, schema, references, dynamicFields) {
+ */ async function createBodyFromValue(mediaType, value, schema, references, dynamicFields) {
     const result = convertValue('body', value, schema, references, dynamicFields);
-    if (type === 'json') {
+    if (mediaType === 'application/json') {
         return JSON.stringify(result);
     }
+    if (mediaType === 'application/xml') {
+        const { js2xml } = await import('xml-js');
+        return js2xml(result, {
+            compact: true,
+            spaces: 2
+        });
+    }
     const formData = new FormData();
     if (typeof result !== 'object' || !result) {
         throw new Error(`Unsupported body type: ${typeof result}, expected: object`);
@@ -88,8 +95,7 @@ import { r as resolve } from './index-client-69lE5jtH.js';
         return value.map((item, index)=>convertValue(`${fieldName}.${String(index)}`, item, resolve(schema.items, references), references, dynamicFields));
     }
     if (schema.type === 'switcher') {
-        const schema = resolve(getDynamicFieldSchema(fieldName, dynamicFields), references);
-        return convertValue(fieldName, value, schema, references, dynamicFields);
+        return convertValue(fieldName, value, resolve(getDynamicFieldSchema(fieldName, dynamicFields, Object.values(schema.items).at(0)), references), references, dynamicFields);
     }
     if (typeof value === 'object' && schema.type === 'object') {
         const entries = Object.keys(value).map((key)=>{
@@ -127,9 +133,11 @@ import { r as resolve } from './index-client-69lE5jtH.js';
             return String(value);
     }
 }
-function getDynamicFieldSchema(name, dynamicFields) {
+function getDynamicFieldSchema(name, dynamicFields, defaultValue) {
     const field = dynamicFields.get(name);
-    return field?.type === 'field' ? field.schema : {
+    if (field?.type === 'field') return field.schema;
+    if (defaultValue) return defaultValue;
+    return {
         type: 'null',
         isRequired: false
     };

package/dist/ui/{index-client-69lE5jtH.js → index-client-B6op0H4J.js}

@@ -5,7 +5,7 @@ import { forwardRef, useId, createContext, useContext, useState, useCallback, us
 import { FormProvider, Controller, useFormContext, useFieldArray, useForm, useWatch } from 'react-hook-form';
 import { Accordions, Accordion } from 'fumadocs-ui/components/accordion';
 import { cn, buttonVariants } from 'fumadocs-ui/components/api';
-import { C as ChevronDown, a as ChevronUp, b as Check, u as useSchemaContext, T as Trash2, P as Plus, c as useApiContext, d as CircleCheck, e as CircleX, S as SchemaContext } from './client-client-B9w--AKD.js';
+import { C as ChevronDown, a as ChevronUp, b as Check, u as useSchemaContext, T as Trash2, P as Plus, c as useApiContext, d as CircleCheck, e as CircleX, S as SchemaContext } from './client-client-NS2E5Jdn.js';
 import { Slot } from '@radix-ui/react-slot';
 import { cva } from 'class-variance-authority';
 import { useOnChange } from 'fumadocs-core/utils/use-on-change';
@@ -735,7 +735,7 @@ function getStatusInfo(status) {
     };
 }
 
-function APIPlayground({ route, method = 'GET', bodyType, authorization, path = [], header = [], query = [], body, fields = {}, schemas, proxyUrl }) {
+function APIPlayground({ route, method = 'GET', authorization, path = [], header = [], query = [], body, fields = {}, schemas, proxyUrl }) {
     const { baseUrl } = useApiContext();
     const dynamicRef = useRef(new Map());
     const form = useForm({
@@ -748,7 +748,7 @@ function APIPlayground({ route, method = 'GET', bodyType, authorization, path =
         }
     });
     const testQuery = useQuery(async (input)=>{
-        const fetcher = await import('./fetcher-DBWYlEEA.js').then((mod)=>mod.createBrowserFetcher(body, schemas));
+        const fetcher = await import('./fetcher-B7R5rjLv.js').then((mod)=>mod.createBrowserFetcher(body, schemas));
         const targetUrl = `${baseUrl ?? window.location.origin}${createPathnameFromInput(route, input.path, input.query)}`;
         let url;
         if (proxyUrl) {
@@ -764,10 +764,12 @@ function APIPlayground({ route, method = 'GET', bodyType, authorization, path =
             header[authorization.name] = input.authorization;
         }
         return fetcher.fetch({
-            type: bodyType,
             url: url.toString(),
             header,
-            body: input.body,
+            body: body ? {
+                mediaType: body.mediaType,
+                value: input.body
+            } : undefined,
             dynamicFields: dynamicRef.current,
             method
         });

package/dist/ui/index.d.ts

@@ -129,14 +129,15 @@ type RequestSchema = PrimitiveSchema | ArraySchema | ObjectSchema | SwitcherSche
 interface APIPlaygroundProps {
     route: string;
     method: string;
-    bodyType: 'json' | 'form-data';
     authorization?: PrimitiveRequestField & {
         authType: string;
     };
     path?: PrimitiveRequestField[];
     query?: PrimitiveRequestField[];
     header?: PrimitiveRequestField[];
-    body?: RequestSchema;
+    body?: RequestSchema & {
+        mediaType: string;
+    };
     schemas: Record<string, RequestSchema>;
     proxyUrl?: string;
 }

package/dist/ui/index.js

@@ -3,8 +3,8 @@ import { cn } from 'fumadocs-ui/components/api';
 import { Fragment } from 'react';
 import { Accordions, Accordion } from 'fumadocs-ui/components/accordion';
 import { cva } from 'class-variance-authority';
-import { f as CopyRouteButton, B as BaseUrlSelect } from './client-client-B9w--AKD.js';
-export { A as APIPlayground, R as Root, u as useSchemaContext } from './client-client-B9w--AKD.js';
+import { f as CopyRouteButton, B as BaseUrlSelect } from './client-client-NS2E5Jdn.js';
+export { A as APIPlayground, R as Root, u as useSchemaContext } from './client-client-NS2E5Jdn.js';
 
 const badgeVariants = cva('rounded-xl border px-1.5 py-1 text-xs font-medium leading-[12px]', {
     variants: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "5.10.6",
+  "version": "5.11.1",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -45,18 +45,19 @@
     "react-hook-form": "^7.54.2",
     "remark": "^15.0.1",
     "remark-rehype": "^11.1.1",
-    "shiki": "^1.24.3",
-    "fumadocs-core": "14.6.8",
-    "fumadocs-ui": "14.6.8"
+    "shiki": "^1.26.1",
+    "xml-js": "^1.6.11",
+    "fumadocs-core": "14.7.1",
+    "fumadocs-ui": "14.7.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "22.10.2",
+    "@types/node": "22.10.5",
     "@types/openapi-sampler": "^1.0.3",
     "@types/react": "^19.0.2",
-    "bunchee": "^6.0.3",
+    "bunchee": "^6.2.0",
     "lucide-react": "^0.469.0",
-    "next": "15.1.2",
+    "next": "15.1.3",
     "openapi-types": "^12.1.3",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"