fumadocs-openapi 9.0.0 → 9.0.1

package/dist/generate-file.js

@@ -86,7 +86,7 @@ async function generateFromDocument(pathOrUrl, options) {
         return [`${file}.mdx`];
     }
     if (options.per === 'file') {
-        const result = await generateAll(document, options);
+        const result = await generateAll(pathOrUrl, document, options);
         const filename = nameFn({
             pathOrUrl,
             content: result,
@@ -96,7 +96,7 @@ async function generateFromDocument(pathOrUrl, options) {
         console.log(`Generated: ${outPath}`);
     }
     else if (options.per === 'tag') {
-        const results = await generateTags(document, options);
+        const results = await generateTags(pathOrUrl, document, options);
         for (const result of results) {
             const filename = nameFn(result, document.document);
             const outPath = path.join(outputDir, `${filename}.mdx`);
@@ -105,7 +105,7 @@ async function generateFromDocument(pathOrUrl, options) {
         }
     }
     else {
-        const results = await generatePages(document, options);
+        const results = await generatePages(pathOrUrl, document, options);
         const mapping = new Map();
         for (const result of results) {
             for (const outputPath of getOutputPaths(options.groupBy, result)) {

package/dist/generate.d.ts

@@ -1,6 +1,6 @@
 import { type DocumentContext } from './utils/generate-document.js';
 import type { OperationItem, WebhookItem } from './render/api-page.js';
-import type { ProcessedDocument } from './utils/process-document.js';
+import type { DocumentInput, ProcessedDocument } from './utils/process-document.js';
 export interface GenerateOptions {
     /**
      * Additional imports of your MDX components.
@@ -33,6 +33,12 @@ export interface GenerateOptions {
      */
     addGeneratedComment?: boolean | string;
     cwd?: string;
+    /**
+     * Inline the entire OpenAPI document into the MDX file.
+     *
+     * @defaultValue false
+     */
+    inlineDocument?: boolean;
 }
 export interface GenerateTagOutput {
     tag: string;
@@ -47,7 +53,7 @@ export type GeneratePageOutput = {
     item: WebhookItem;
     content: string;
 };
-export declare function generateAll({ document, downloaded }: ProcessedDocument, options?: GenerateOptions): Promise<string>;
-export declare function generatePages({ document, downloaded }: ProcessedDocument, options?: GenerateOptions): Promise<GeneratePageOutput[]>;
-export declare function generateTags({ document, downloaded }: ProcessedDocument, options?: GenerateOptions): Promise<GenerateTagOutput[]>;
+export declare function generateAll(input: DocumentInput, processed: ProcessedDocument, options?: GenerateOptions): Promise<string>;
+export declare function generatePages(input: DocumentInput, processed: ProcessedDocument, options?: GenerateOptions): Promise<GeneratePageOutput[]>;
+export declare function generateTags(input: DocumentInput, processed: ProcessedDocument, options?: GenerateOptions): Promise<GenerateTagOutput[]>;
 //# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IAEJ;;;;OAIG;IACH,WAAW,CAAC,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,eAAe,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEvC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,WAAW,CAC/B,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAsB,aAAa,CACjC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA4D/B;AAED,wBAAsB,YAAY,CAChC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqC9B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IAEJ;;;;OAIG;IACH,WAAW,CAAC,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,eAAe,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAEvC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,WAAW,CAC/B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAiE/B;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwC9B"}

package/dist/generate.js

@@ -1,25 +1,23 @@
 import { getAPIPageItems } from './build-routes.js';
 import { generateDocument, } from './utils/generate-document.js';
 import { idToTitle } from './utils/id-to-title.js';
-export async function generateAll({ document, downloaded }, options = {}) {
+export async function generateAll(input, processed, options = {}) {
+    const { document } = processed;
     const items = getAPIPageItems(document);
-    return generateDocument({
+    return generateDocument(input, processed, {
+        operations: items.operations,
+        webhooks: items.webhooks,
+        hasHead: true,
+    }, {
         ...options,
-        dereferenced: document,
         title: document.info.title,
         description: document.info.description,
-        page: {
-            operations: items.operations,
-            webhooks: items.webhooks,
-            hasHead: true,
-            document: downloaded,
-        },
-        context: {
-            type: 'file',
-        },
+    }, {
+        type: 'file',
     });
 }
-export async function generatePages({ document, downloaded }, options = {}) {
+export async function generatePages(input, processed, options = {}) {
+    const { document } = processed;
     const items = getAPIPageItems(document);
     const result = [];
     for (const item of items.operations) {
@@ -32,21 +30,17 @@ export async function generatePages({ document, downloaded }, options = {}) {
         result.push({
             type: 'operation',
             item,
-            content: generateDocument({
+            content: generateDocument(input, processed, {
+                operations: [item],
+                hasHead: false,
+            }, {
                 ...options,
-                page: {
-                    operations: [item],
-                    hasHead: false,
-                    document: downloaded,
-                },
-                dereferenced: document,
                 title: operation.summary ??
                     pathItem.summary ??
                     idToTitle(operation.operationId ?? 'unknown'),
                 description: operation.description ?? pathItem.description,
-                context: {
-                    type: 'operation',
-                },
+            }, {
+                type: 'operation',
             }),
         });
     }
@@ -60,25 +54,22 @@ export async function generatePages({ document, downloaded }, options = {}) {
         result.push({
             type: 'webhook',
             item,
-            content: generateDocument({
+            content: generateDocument(input, processed, {
+                webhooks: [item],
+                hasHead: false,
+            }, {
                 ...options,
-                page: {
-                    webhooks: [item],
-                    hasHead: false,
-                    document: downloaded,
-                },
-                dereferenced: document,
                 title: operation.summary ?? pathItem.summary ?? idToTitle(item.name),
                 description: operation.description ?? pathItem.description,
-                context: {
-                    type: 'operation',
-                },
+            }, {
+                type: 'operation',
             }),
         });
     }
     return result;
 }
-export async function generateTags({ document, downloaded }, options = {}) {
+export async function generateTags(input, processed, options = {}) {
+    const { document } = processed;
     if (!document.tags)
         return [];
     const items = getAPIPageItems(document);
@@ -90,21 +81,17 @@ export async function generateTags({ document, downloaded }, options = {}) {
             : idToTitle(tag.name);
         return {
             tag: tag.name,
-            content: generateDocument({
+            content: generateDocument(input, processed, {
+                operations,
+                webhooks,
+                hasHead: true,
+            }, {
                 ...options,
-                page: {
-                    document: downloaded,
-                    operations,
-                    webhooks,
-                    hasHead: true,
-                },
-                dereferenced: document,
                 title: displayName,
                 description: tag?.description,
-                context: {
-                    type: 'tag',
-                    tag,
-                },
+            }, {
+                type: 'tag',
+                tag,
             }),
         };
     });

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export * from './generate.js';
 export * from './generate-file.js';
 export * from './types.js';
 export type { MediaAdapter } from './media/adapter.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,3 +1,2 @@
-export * from './generate.js';
 export * from './generate-file.js';
 export * from './types.js';

package/dist/render/api-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-page.d.ts","sourceRoot":"","sources":["../../src/render/api-page.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAIlC,KAAK,mBAAmB,GAAG,IAAI,CAC7B,OAAO,CAAC,aAAa,CAAC,EACpB,cAAc,GACd,0BAA0B,GAC1B,qBAAqB,GACrB,UAAU,GACV,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,CAClB,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,oDAsEhD;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,mBAAmB,GAAG;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzB,GACL,OAAO,CAAC,aAAa,CAAC,CA0CxB"}
+{"version":3,"file":"api-page.d.ts","sourceRoot":"","sources":["../../src/render/api-page.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAIlC,KAAK,mBAAmB,GAAG,IAAI,CAC7B,OAAO,CAAC,aAAa,CAAC,EACpB,cAAc,GACd,0BAA0B,GAC1B,qBAAqB,GACrB,UAAU,GACV,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,CAClB,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,mBAAmB;IACvD,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAE7B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC;CACjC;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,oDAqEhD;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,mBAAmB,GAAG;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACzB,GACL,OAAO,CAAC,aAAa,CAAC,CA0CxB"}

package/dist/render/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/render/markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAsB1C,wBAAsB,QAAQ,CAAC,EAC7B,IAAI,GACL,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAWxB"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/render/markdown.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAkC1C,wBAAsB,QAAQ,CAAC,EAC7B,IAAI,GACL,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAIxB"}

package/dist/render/markdown.js

@@ -3,7 +3,7 @@ import defaultMdxComponents from 'fumadocs-ui/mdx';
 import { remark } from 'remark';
 import remarkRehype from 'remark-rehype';
 import { toJsxRuntime } from 'hast-util-to-jsx-runtime';
-import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import * as JsxRuntime from 'react/jsx-runtime';
 const processor = remark()
     .use(remarkGfm)
     .use(remarkImage, { useImport: false })
@@ -11,15 +11,19 @@ const processor = remark()
     .use(rehypeCode, {
     langs: [],
     lazy: true,
-});
+})
+    .use(rehypeReact);
+function rehypeReact() {
+    this.compiler = (tree, file) => {
+        return toJsxRuntime(tree, {
+            development: false,
+            filePath: file.path,
+            ...JsxRuntime,
+            components: defaultMdxComponents,
+        });
+    };
+}
 export async function Markdown({ text, }) {
-    const nodes = processor.parse({ value: text });
-    const hast = await processor.run(nodes);
-    return toJsxRuntime(hast, {
-        development: false,
-        jsx: jsx,
-        jsxs: jsxs,
-        Fragment,
-        components: defaultMdxComponents,
-    });
+    const out = await processor.process(text);
+    return out.result;
 }

package/dist/render/operation/api-example.js

@@ -45,7 +45,8 @@ export function getAPIExamples(path, method, ctx) {
                 data: getRequestData(path, method, key, ctx),
             });
         }
-        return result;
+        if (result.length > 0)
+            return result;
     }
     return [
         {
@@ -68,7 +69,7 @@ export async function APIExample({ method, examples, ctx, }) {
                     title: sample.name,
                     description: sample.description ? (_jsx(Markdown, { text: sample.description })) : null,
                     value: sample.key,
-                })) })), generators.length > 0 && (_jsx(renderer.Requests, { items: generators.map((s) => s.label), children: generators.map((generator) => (_jsx(renderer.Request, { name: generator.label, children: _jsx(CodeExample, { ...generator }) }, generator.label))) })), _jsx(ResponseTabs, { operation: method, ctx: ctx })] }));
+                })) })), generators.length > 0 && (_jsx(renderer.Requests, { items: generators.map((s) => s.label ?? s.lang), children: generators.map((generator, i) => (_jsx(renderer.Request, { name: generator.label ?? generator.lang, children: _jsx(CodeExample, { ...generator }) }, i))) })), _jsx(ResponseTabs, { operation: method, ctx: ctx })] }));
 }
 /**
  * Remove duplicated labels
@@ -77,10 +78,13 @@ function dedupe(samples) {
     const set = new Set();
     const out = [];
     for (let i = samples.length - 1; i >= 0; i--) {
-        if (set.has(samples[i].label))
-            continue;
-        set.add(samples[i].label);
-        out.unshift(samples[i]);
+        const item = samples[i];
+        if (item.label) {
+            if (set.has(item.label))
+                continue;
+            set.add(item.label);
+        }
+        out.unshift(item);
     }
     return out;
 }

package/dist/render/operation/index.d.ts

@@ -3,7 +3,7 @@ import type { MethodInformation, RenderContext } from '../../types.js';
 import { type SampleGenerator } from '../../requests/_shared.js';
 export interface CodeSample {
     lang: string;
-    label: string;
+    label?: string;
     source?: string | SampleGenerator | false;
 }
 export declare function Operation({ type, path, method, ctx, hasHead, headingLevel, }: {

package/dist/render/operation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/operation/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAEV,iBAAiB,EAEjB,aAAa,EAEd,MAAM,SAAS,CAAC;AAmBjB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,KAAK,CAAC;CAC3C;AASD,wBAAgB,SAAS,CAAC,EACxB,IAAkB,EAClB,IAAI,EACJ,MAAM,EACN,GAAG,EACH,OAAO,EACP,YAAgB,GACjB,EAAE;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;IAEnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,YAAY,CA6Kf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/operation/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAEV,iBAAiB,EAEjB,aAAa,EAEd,MAAM,SAAS,CAAC;AAmBjB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,KAAK,CAAC;CAC3C;AASD,wBAAgB,SAAS,CAAC,EACxB,IAAkB,EAClB,IAAI,EACJ,MAAM,EACN,GAAG,EACH,OAAO,EACP,YAAgB,GACjB,EAAE;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,aAAa,CAAC;IAEnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,YAAY,CA6Kf"}

package/dist/server/proxy.d.ts

@@ -3,6 +3,16 @@ declare const keys: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD"];
 type Proxy = {
     [K in (typeof keys)[number]]: (req: NextRequest) => Promise<Response>;
 };
-export declare function createProxy(allowedUrls?: string[]): Proxy;
+interface CreateProxyOptions {
+    allowedUrls?: string[];
+    /**
+     * Override original request/response with yours
+     */
+    overrides?: {
+        request?: (request: Request) => Request;
+        response?: (response: Response) => Response;
+    };
+}
+export declare function createProxy(options?: CreateProxyOptions): Proxy;
 export {};
 //# sourceMappingURL=proxy.d.ts.map

package/dist/server/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/server/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAA,MAAM,IAAI,4DAA6D,CAAC;AAExE,KAAK,KAAK,GAAG;KACV,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC;CACtE,CAAC;AAEF,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAoEzD"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/server/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,QAAA,MAAM,IAAI,4DAA6D,CAAC;AAExE,KAAK,KAAK,GAAG;KACV,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC;CACtE,CAAC;AAEF,UAAU,kBAAkB;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;QACxC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC;KAC7C,CAAC;CACH;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,KAAK,CA8EnE"}

package/dist/server/proxy.js

@@ -1,5 +1,6 @@
 const keys = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD'];
-export function createProxy(allowedUrls) {
+export function createProxy(options = {}) {
+    const { allowedUrls, overrides } = options;
     const handlers = {};
     async function handler(req) {
         const url = req.nextUrl.searchParams.get('url');
@@ -14,11 +15,14 @@ export function createProxy(allowedUrls) {
                 status: 400,
             });
         }
-        const clonedReq = new Request(url, {
+        let clonedReq = new Request(url, {
             ...req,
             cache: 'no-cache',
             mode: 'cors',
         });
+        if (overrides?.request) {
+            clonedReq = overrides.request(clonedReq);
+        }
         clonedReq.headers.forEach((_value, originalKey) => {
             const key = originalKey.toLowerCase();
             const notAllowed = key === 'origin';
@@ -26,12 +30,15 @@ export function createProxy(allowedUrls) {
                 clonedReq.headers.delete(originalKey);
             }
         });
-        const res = await fetch(clonedReq).catch((e) => new Error(e.toString()));
+        let res = await fetch(clonedReq).catch((e) => new Error(e.toString()));
         if (res instanceof Error) {
             return Response.json(`Failed to proxy request: ${res.message}`, {
                 status: 400,
             });
         }
+        if (overrides?.response) {
+            res = overrides.response(res);
+        }
         const headers = new Headers(res.headers);
         headers.forEach((_value, originalKey) => {
             const key = originalKey.toLowerCase();

package/dist/utils/generate-document.d.ts

@@ -1,7 +1,7 @@
 import type { ApiPageProps } from '../render/api-page.js';
 import type { GenerateOptions } from '../generate.js';
-import type { Document, TagObject } from '../types.js';
-import type { NoReference } from '../utils/schema.js';
+import type { TagObject } from '../types.js';
+import type { DocumentInput, ProcessedDocument } from '../utils/process-document.js';
 export type DocumentContext = {
     type: 'tag';
     tag: TagObject | undefined;
@@ -10,11 +10,8 @@ export type DocumentContext = {
 } | {
     type: 'file';
 };
-export declare function generateDocument(options: GenerateOptions & {
-    dereferenced: NoReference<Document>;
-    page: ApiPageProps;
+export declare function generateDocument(input: DocumentInput, processed: ProcessedDocument, pageProps: Omit<ApiPageProps, 'document'>, options: GenerateOptions & {
     title: string;
     description?: string;
-    context: DocumentContext;
-}): string;
+}, context: DocumentContext): string;
 //# sourceMappingURL=generate-document.d.ts.map

package/dist/utils/generate-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-document.d.ts","sourceRoot":"","sources":["../../src/utils/generate-document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAOlD,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;CACnB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,GAAG;IACzB,YAAY,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC1B,GACA,MAAM,CAkER"}
+{"version":3,"file":"generate-document.d.ts","sourceRoot":"","sources":["../../src/utils/generate-document.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAOlC,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;CACnB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EACzC,OAAO,EAAE,eAAe,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,OAAO,EAAE,eAAe,GACvB,MAAM,CAkER"}

package/dist/utils/generate-document.js

@@ -1,19 +1,23 @@
 import { dump } from 'js-yaml';
 import Slugger from 'github-slugger';
 import { idToTitle } from '../utils/id-to-title.js';
-export function generateDocument(options) {
+export function generateDocument(input, processed, pageProps, options, context) {
     const { frontmatter, includeDescription = false, addGeneratedComment = true, } = options;
     const out = [];
-    const extend = frontmatter?.(options.title, options.description, options.context);
+    const extend = frontmatter?.(options.title, options.description, context);
+    const page = {
+        ...pageProps,
+        document: options.inlineDocument ? processed.downloaded : input,
+    };
     let meta;
-    if (options.page.operations?.length === 1) {
-        const operation = options.page.operations[0];
+    if (page.operations?.length === 1) {
+        const operation = page.operations[0];
         meta = {
             method: operation.method.toUpperCase(),
             route: operation.path,
         };
     }
-    const data = generateStaticData(options.dereferenced, options.page);
+    const data = generateStaticData(processed.document, page);
     const banner = dump({
         title: options.title,
         description: !includeDescription ? options.description : undefined,
@@ -43,7 +47,7 @@ export function generateDocument(options) {
     }
     if (options.description && includeDescription)
         out.push(options.description);
-    out.push(pageContent(options.page));
+    out.push(pageContent(page));
     return out.join('\n\n');
 }
 function generateStaticData(dereferenced, props) {

package/dist/utils/process-document.d.ts

@@ -10,5 +10,5 @@ export type ProcessedDocument = {
 /**
  * process & reference input document to a Fumadocs OpenAPI compatible format
  */
-export declare function processDocument(document: DocumentInput, disableCache?: boolean): Promise<ProcessedDocument>;
+export declare function processDocument(input: DocumentInput, disableCache?: boolean): Promise<ProcessedDocument>;
 //# sourceMappingURL=process-document.d.ts.map

package/dist/utils/process-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAIF;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,YAAY,UAAQ,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAoC5B"}
+{"version":3,"file":"process-document.d.ts","sourceRoot":"","sources":["../../src/utils/process-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAIF;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,YAAY,UAAQ,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAoC5B"}

package/dist/utils/process-document.js

@@ -5,12 +5,12 @@ const cache = new Map();
 /**
  * process & reference input document to a Fumadocs OpenAPI compatible format
  */
-export async function processDocument(document, disableCache = false) {
-    const cached = !disableCache && typeof document === 'string' ? cache.get(document) : null;
+export async function processDocument(input, disableCache = false) {
+    const cached = !disableCache && typeof input === 'string' ? cache.get(input) : null;
     if (cached)
         return cached;
     const dereferenceMap = new Map();
-    const loaded = await load(document, {
+    const loaded = await load(input, {
         plugins: [readFiles(), fetchUrls()],
     });
     if (loaded.errors && loaded.errors.length > 0) {
@@ -28,8 +28,8 @@ export async function processDocument(document, disableCache = false) {
         dereferenceMap,
         downloaded: loaded.specification,
     };
-    if (!disableCache && typeof document === 'string') {
-        cache.set(document, processed);
+    if (!disableCache && typeof input === 'string') {
+        cache.set(input, processed);
     }
     return processed;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fumadocs-openapi",
-  "version": "9.0.0",
+  "version": "9.0.1",
   "description": "Generate MDX docs for your OpenAPI spec",
   "keywords": [
     "NextJs",
@@ -77,8 +77,8 @@
     "openapi-types": "^12.1.3",
     "tailwindcss": "^4.1.7",
     "tsc-alias": "^1.8.16",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "tsconfig": "0.0.0",
+    "eslint-config-custom": "0.0.0"
   },
   "peerDependencies": {
     "@scalar/api-client-react": "*",