fumadocs-openapi 10.5.0 → 10.6.1

package/dist/playground/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","names":[],"sources":["../../src/playground/fetcher.ts"],"mappings":";UAQiB,WAAA;EACf,MAAA;EACA,IAAA;EACA,IAAA;AAAA"}
+{"version":3,"file":"fetcher.d.ts","names":[],"sources":["../../src/playground/fetcher.ts"],"mappings":";;;UAKiB,WAAA;EACf,MAAA;EACA,IAAA;EACA,IAAA;AAAA;AAAA,UAYe,qBAAA;EAiByC;;;EAbxD,cAAA;EAEA,QAAA;EAAA;;;;;EAMA,kBAAA;EAKwD;;;EAAxD,aAAA,IAAiB,WAAA,EAAa,WAAA,KAAgB,SAAA,CAAU,WAAA;AAAA"}

package/dist/playground/fetcher.js

@@ -1,42 +1,46 @@
 import { resolveMediaAdapter } from "../requests/media/resolve-adapter.js";
 import "../requests/media/adapter.js";
 //#region src/playground/fetcher.ts
-function createBrowserFetcher(adapters, requestTimeout) {
-	return { async fetch(url, options) {
-		const headers = new Headers();
-		if (options.bodyMediaType && options.bodyMediaType !== "multipart/form-data") headers.append("Content-Type", options.bodyMediaType);
-		for (const key in options.header) {
-			const param = options.header[key];
+function createBrowserFetcher(adapters, { proxyUrl, proxyForwardCookie = true, requestTimeout = 10, onRequestInit } = {}) {
+	return { async fetch(url, data) {
+		let requestUrl = new URL(url, document.baseURI);
+		let requestInit = {
+			method: data.method,
+			cache: "no-cache",
+			signal: typeof requestTimeout === "number" ? AbortSignal.timeout(requestTimeout * 1e3) : void 0
+		};
+		const headers = requestInit.headers = new Headers();
+		for (const key in data.header) {
+			const param = data.header[key];
 			headers.append(key, param.value);
 		}
-		const proxyUrl = options.proxyUrl ? new URL(options.proxyUrl, document.baseURI) : null;
 		if (proxyUrl) {
-			proxyUrl.searchParams.append("url", url);
-			url = proxyUrl.toString();
+			requestUrl = new URL(proxyUrl, document.baseURI);
+			requestUrl.searchParams.append("url", url);
 		}
-		let body = void 0;
-		if (options.bodyMediaType && options.body) {
-			const adapter = resolveMediaAdapter(options.bodyMediaType, adapters);
+		if (data.bodyMediaType && data.body) {
+			const adapter = resolveMediaAdapter(data.bodyMediaType, adapters);
 			if (!adapter) return {
 				status: 400,
 				type: "text",
-				data: `[Fumadocs] No adapter for ${options.bodyMediaType}, you need to specify one from 'createOpenAPI()'.`
+				data: `[Fumadocs] No adapter for ${data.bodyMediaType}, you need to specify one from 'createOpenAPI()'.`
 			};
-			body = adapter.encode(options);
+			if (data.bodyMediaType !== "multipart/form-data") headers.append("Content-Type", data.bodyMediaType);
+			requestInit.body = adapter.encode(data);
 		}
-		for (const key in options.cookie) {
-			const segs = [`${key}=${options.cookie[key].value}`];
-			if (proxyUrl && proxyUrl.origin !== window.location.origin) segs.push(`domain=${proxyUrl.host}`);
+		if (proxyUrl && proxyForwardCookie) {
+			const encoded = Object.entries(data.cookie).map(([k, v]) => `${k}=${encodeURIComponent(v.value)}`).join("; ");
+			requestUrl.searchParams.set("cookie", encoded);
+			requestInit.credentials = "omit";
+		} else for (const key in data.cookie) {
+			const param = data.cookie[key];
+			const segs = [`${key}=${encodeURIComponent(param.value)}`];
+			if (proxyUrl && requestUrl.origin !== window.location.origin) segs.push(`domain=${requestUrl.host}`);
 			segs.push("path=/", "max-age=30");
 			document.cookie = segs.join("; ");
 		}
-		return fetch(url, {
-			method: options.method,
-			cache: "no-cache",
-			headers,
-			body,
-			signal: AbortSignal.timeout(requestTimeout * 1e3)
-		}).then(async (res) => {
+		if (onRequestInit) requestInit = await onRequestInit(requestInit);
+		return fetch(requestUrl, requestInit).then(async (res) => {
 			const contentType = res.headers.get("Content-Type") ?? "";
 			let type;
 			let data;

package/dist/playground/fetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.js","names":[],"sources":["../../src/playground/fetcher.ts"],"sourcesContent":["import type { RequestData } from '@/requests/types';\nimport type { MediaAdapter } from '@/requests/media/adapter';\nimport { resolveMediaAdapter } from '@/requests/media/adapter';\n\nexport interface FetchOptions extends RequestData {\n  proxyUrl?: string;\n}\n\nexport interface FetchResult {\n  status: number;\n  type: 'json' | 'html' | 'text';\n  data: unknown;\n}\n\nexport interface Fetcher {\n  /**\n   * This method will not apply the path & search parameters from `options` to given `url`.\n   *\n   * @param url - The full URL of request.\n   */\n  fetch: (url: string, options: FetchOptions) => Promise<FetchResult>;\n}\n\nexport function createBrowserFetcher(\n  adapters: Record<string, MediaAdapter>,\n  requestTimeout: number,\n): Fetcher {\n  return {\n    async fetch(url, options) {\n      const headers = new Headers();\n      if (options.bodyMediaType && options.bodyMediaType !== 'multipart/form-data')\n        headers.append('Content-Type', options.bodyMediaType);\n\n      for (const key in options.header) {\n        const param = options.header[key];\n        headers.append(key, param.value);\n      }\n\n      const proxyUrl = options.proxyUrl ? new URL(options.proxyUrl, document.baseURI) : null;\n\n      if (proxyUrl) {\n        proxyUrl.searchParams.append('url', url);\n        url = proxyUrl.toString();\n      }\n\n      let body: BodyInit | undefined = undefined;\n      if (options.bodyMediaType && options.body) {\n        const adapter = resolveMediaAdapter(options.bodyMediaType, adapters);\n        if (!adapter)\n          return {\n            status: 400,\n            type: 'text',\n            data: `[Fumadocs] No adapter for ${options.bodyMediaType}, you need to specify one from 'createOpenAPI()'.`,\n          };\n\n        body = adapter.encode(options as { body: unknown });\n      }\n\n      // cookies\n      for (const key in options.cookie) {\n        const param = options.cookie[key];\n        const segs: string[] = [`${key}=${param.value}`];\n\n        if (proxyUrl && proxyUrl.origin !== window.location.origin)\n          segs.push(`domain=${proxyUrl.host}`);\n        segs.push('path=/', 'max-age=30');\n\n        document.cookie = segs.join('; ');\n      }\n\n      return fetch(url, {\n        method: options.method,\n        cache: 'no-cache',\n        headers,\n        body,\n        signal: AbortSignal.timeout(requestTimeout * 1000),\n      })\n        .then(async (res) => {\n          const contentType = res.headers.get('Content-Type') ?? '';\n          let type: FetchResult['type'];\n          let data: unknown;\n\n          if (contentType.startsWith('application/json')) {\n            type = 'json';\n            data = await res.json();\n          } else {\n            type = contentType.startsWith('text/html') ? 'html' : 'text';\n            data = await res.text();\n          }\n\n          return { status: res.status, type, data };\n        })\n        .catch((e) => {\n          const message = e instanceof Error ? `[${e.name}] ${e.message}` : e.toString();\n\n          return {\n            status: 400,\n            type: 'text',\n            data: `Client side error: ${message}`,\n          };\n        });\n    },\n  };\n}\n"],"mappings":";;;AAuBA,SAAgB,qBACd,UACA,gBACS;AACT,QAAO,EACL,MAAM,MAAM,KAAK,SAAS;EACxB,MAAM,UAAU,IAAI,SAAS;AAC7B,MAAI,QAAQ,iBAAiB,QAAQ,kBAAkB,sBACrD,SAAQ,OAAO,gBAAgB,QAAQ,cAAc;AAEvD,OAAK,MAAM,OAAO,QAAQ,QAAQ;GAChC,MAAM,QAAQ,QAAQ,OAAO;AAC7B,WAAQ,OAAO,KAAK,MAAM,MAAM;;EAGlC,MAAM,WAAW,QAAQ,WAAW,IAAI,IAAI,QAAQ,UAAU,SAAS,QAAQ,GAAG;AAElF,MAAI,UAAU;AACZ,YAAS,aAAa,OAAO,OAAO,IAAI;AACxC,SAAM,SAAS,UAAU;;EAG3B,IAAI,OAA6B,KAAA;AACjC,MAAI,QAAQ,iBAAiB,QAAQ,MAAM;GACzC,MAAM,UAAU,oBAAoB,QAAQ,eAAe,SAAS;AACpE,OAAI,CAAC,QACH,QAAO;IACL,QAAQ;IACR,MAAM;IACN,MAAM,6BAA6B,QAAQ,cAAc;IAC1D;AAEH,UAAO,QAAQ,OAAO,QAA6B;;AAIrD,OAAK,MAAM,OAAO,QAAQ,QAAQ;GAEhC,MAAM,OAAiB,CAAC,GAAG,IAAI,GADjB,QAAQ,OAAO,KACW,QAAQ;AAEhD,OAAI,YAAY,SAAS,WAAW,OAAO,SAAS,OAClD,MAAK,KAAK,UAAU,SAAS,OAAO;AACtC,QAAK,KAAK,UAAU,aAAa;AAEjC,YAAS,SAAS,KAAK,KAAK,KAAK;;AAGnC,SAAO,MAAM,KAAK;GAChB,QAAQ,QAAQ;GAChB,OAAO;GACP;GACA;GACA,QAAQ,YAAY,QAAQ,iBAAiB,IAAK;GACnD,CAAC,CACC,KAAK,OAAO,QAAQ;GACnB,MAAM,cAAc,IAAI,QAAQ,IAAI,eAAe,IAAI;GACvD,IAAI;GACJ,IAAI;AAEJ,OAAI,YAAY,WAAW,mBAAmB,EAAE;AAC9C,WAAO;AACP,WAAO,MAAM,IAAI,MAAM;UAClB;AACL,WAAO,YAAY,WAAW,YAAY,GAAG,SAAS;AACtD,WAAO,MAAM,IAAI,MAAM;;AAGzB,UAAO;IAAE,QAAQ,IAAI;IAAQ;IAAM;IAAM;IACzC,CACD,OAAO,MAAM;AAGZ,UAAO;IACL,QAAQ;IACR,MAAM;IACN,MAAM,sBALQ,aAAa,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,YAAY,EAAE,UAAU;IAM7E;IACD;IAEP"}
+{"version":3,"file":"fetcher.js","names":[],"sources":["../../src/playground/fetcher.ts"],"sourcesContent":["import type { RequestData } from '@/requests/types';\nimport type { MediaAdapter } from '@/requests/media/adapter';\nimport { resolveMediaAdapter } from '@/requests/media/adapter';\nimport type { Awaitable } from '@/types';\n\nexport interface FetchResult {\n  status: number;\n  type: 'json' | 'html' | 'text';\n  data: unknown;\n}\n\nexport interface Fetcher {\n  /**\n   * This method will not apply the path & search parameters from `options` to given `url`.\n   *\n   * @param url - The full URL of request.\n   */\n  fetch: (url: string, data: RequestData) => Promise<FetchResult>;\n}\n\nexport interface BrowserFetcherOptions {\n  /**\n   * Request timeout in seconds (default: 10s)\n   */\n  requestTimeout?: number | false;\n\n  proxyUrl?: string;\n  /**\n   * Forward cookies via search parameters when API proxy is configured.\n   *\n   * @default true\n   */\n  proxyForwardCookie?: boolean;\n\n  /**\n   * transform the request options before sending.\n   */\n  onRequestInit?: (requestInit: RequestInit) => Awaitable<RequestInit>;\n}\n\nexport function createBrowserFetcher(\n  adapters: Record<string, MediaAdapter>,\n  {\n    proxyUrl,\n    proxyForwardCookie = true,\n    requestTimeout = 10,\n    onRequestInit,\n  }: BrowserFetcherOptions = {},\n): Fetcher {\n  return {\n    async fetch(url, data) {\n      let requestUrl = new URL(url, document.baseURI);\n      let requestInit: RequestInit = {\n        method: data.method,\n        cache: 'no-cache',\n        signal:\n          typeof requestTimeout === 'number'\n            ? AbortSignal.timeout(requestTimeout * 1000)\n            : undefined,\n      };\n\n      const headers = (requestInit.headers = new Headers());\n\n      for (const key in data.header) {\n        const param = data.header[key];\n        headers.append(key, param.value);\n      }\n\n      if (proxyUrl) {\n        requestUrl = new URL(proxyUrl, document.baseURI);\n        requestUrl.searchParams.append('url', url);\n      }\n\n      if (data.bodyMediaType && data.body) {\n        const adapter = resolveMediaAdapter(data.bodyMediaType, adapters);\n        if (!adapter)\n          return {\n            status: 400,\n            type: 'text',\n            data: `[Fumadocs] No adapter for ${data.bodyMediaType}, you need to specify one from 'createOpenAPI()'.`,\n          };\n\n        if (data.bodyMediaType !== 'multipart/form-data') {\n          headers.append('Content-Type', data.bodyMediaType);\n        }\n\n        requestInit.body = adapter.encode(data as { body: unknown });\n      }\n\n      // cookies\n      if (proxyUrl && proxyForwardCookie) {\n        const encoded = Object.entries(data.cookie)\n          .map(([k, v]) => `${k}=${encodeURIComponent(v.value)}`)\n          .join('; ');\n        requestUrl.searchParams.set('cookie', encoded);\n        requestInit.credentials = 'omit';\n      } else {\n        for (const key in data.cookie) {\n          const param = data.cookie[key];\n          const segs: string[] = [`${key}=${encodeURIComponent(param.value)}`];\n\n          if (proxyUrl && requestUrl.origin !== window.location.origin)\n            segs.push(`domain=${requestUrl.host}`);\n          segs.push('path=/', 'max-age=30');\n\n          document.cookie = segs.join('; ');\n        }\n      }\n\n      if (onRequestInit) requestInit = await onRequestInit(requestInit);\n\n      return fetch(requestUrl, requestInit)\n        .then(async (res) => {\n          const contentType = res.headers.get('Content-Type') ?? '';\n          let type: FetchResult['type'];\n          let data: unknown;\n\n          if (contentType.startsWith('application/json')) {\n            type = 'json';\n            data = await res.json();\n          } else {\n            type = contentType.startsWith('text/html') ? 'html' : 'text';\n            data = await res.text();\n          }\n\n          return { status: res.status, type, data };\n        })\n        .catch((e) => {\n          const message = e instanceof Error ? `[${e.name}] ${e.message}` : e.toString();\n\n          return {\n            status: 400,\n            type: 'text',\n            data: `Client side error: ${message}`,\n          };\n        });\n    },\n  };\n}\n"],"mappings":";;;AAwCA,SAAgB,qBACd,UACA,EACE,UACA,qBAAqB,MACrB,iBAAiB,IACjB,kBACyB,EAAE,EACpB;AACT,QAAO,EACL,MAAM,MAAM,KAAK,MAAM;EACrB,IAAI,aAAa,IAAI,IAAI,KAAK,SAAS,QAAQ;EAC/C,IAAI,cAA2B;GAC7B,QAAQ,KAAK;GACb,OAAO;GACP,QACE,OAAO,mBAAmB,WACtB,YAAY,QAAQ,iBAAiB,IAAK,GAC1C,KAAA;GACP;EAED,MAAM,UAAW,YAAY,UAAU,IAAI,SAAS;AAEpD,OAAK,MAAM,OAAO,KAAK,QAAQ;GAC7B,MAAM,QAAQ,KAAK,OAAO;AAC1B,WAAQ,OAAO,KAAK,MAAM,MAAM;;AAGlC,MAAI,UAAU;AACZ,gBAAa,IAAI,IAAI,UAAU,SAAS,QAAQ;AAChD,cAAW,aAAa,OAAO,OAAO,IAAI;;AAG5C,MAAI,KAAK,iBAAiB,KAAK,MAAM;GACnC,MAAM,UAAU,oBAAoB,KAAK,eAAe,SAAS;AACjE,OAAI,CAAC,QACH,QAAO;IACL,QAAQ;IACR,MAAM;IACN,MAAM,6BAA6B,KAAK,cAAc;IACvD;AAEH,OAAI,KAAK,kBAAkB,sBACzB,SAAQ,OAAO,gBAAgB,KAAK,cAAc;AAGpD,eAAY,OAAO,QAAQ,OAAO,KAA0B;;AAI9D,MAAI,YAAY,oBAAoB;GAClC,MAAM,UAAU,OAAO,QAAQ,KAAK,OAAO,CACxC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,mBAAmB,EAAE,MAAM,GAAG,CACtD,KAAK,KAAK;AACb,cAAW,aAAa,IAAI,UAAU,QAAQ;AAC9C,eAAY,cAAc;QAE1B,MAAK,MAAM,OAAO,KAAK,QAAQ;GAC7B,MAAM,QAAQ,KAAK,OAAO;GAC1B,MAAM,OAAiB,CAAC,GAAG,IAAI,GAAG,mBAAmB,MAAM,MAAM,GAAG;AAEpE,OAAI,YAAY,WAAW,WAAW,OAAO,SAAS,OACpD,MAAK,KAAK,UAAU,WAAW,OAAO;AACxC,QAAK,KAAK,UAAU,aAAa;AAEjC,YAAS,SAAS,KAAK,KAAK,KAAK;;AAIrC,MAAI,cAAe,eAAc,MAAM,cAAc,YAAY;AAEjE,SAAO,MAAM,YAAY,YAAY,CAClC,KAAK,OAAO,QAAQ;GACnB,MAAM,cAAc,IAAI,QAAQ,IAAI,eAAe,IAAI;GACvD,IAAI;GACJ,IAAI;AAEJ,OAAI,YAAY,WAAW,mBAAmB,EAAE;AAC9C,WAAO;AACP,WAAO,MAAM,IAAI,MAAM;UAClB;AACL,WAAO,YAAY,WAAW,YAAY,GAAG,SAAS;AACtD,WAAO,MAAM,IAAI,MAAM;;AAGzB,UAAO;IAAE,QAAQ,IAAI;IAAQ;IAAM;IAAM;IACzC,CACD,OAAO,MAAM;AAGZ,UAAO;IACL,QAAQ;IACR,MAAM;IACN,MAAM,sBALQ,aAAa,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,YAAY,EAAE,UAAU;IAM7E;IACD;IAEP"}

package/dist/playground/index.d.ts

@@ -1,6 +1,6 @@
 import { MethodInformation, RenderContext, SecuritySchemeObject } from "../types.js";
-import * as react from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as _$react from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/playground/index.d.ts
 interface APIPlaygroundProps {
@@ -16,7 +16,7 @@ declare function APIPlayground({
   path,
   method,
   ctx
-}: APIPlaygroundProps): Promise<string | number | bigint | boolean | react_jsx_runtime0.JSX.Element | Iterable<react.ReactNode> | null | undefined>;
+}: APIPlaygroundProps): string | number | bigint | boolean | _$react_jsx_runtime0.JSX.Element | Iterable<_$react.ReactNode> | Promise<_$react.ReactNode> | null | undefined;
 //#endregion
 export { APIPlayground, APIPlaygroundProps, SecurityEntry };
 //# sourceMappingURL=index.d.ts.map

package/dist/playground/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/playground/index.tsx"],"mappings":";;;;;UAiBiB,kBAAA;EACf,IAAA;EACA,MAAA,EAAQ,iBAAA;EACR,GAAA,EAAK,aAAA;AAAA;AAAA,KAGK,aAAA,GAAgB,oBAAA;EAC1B,MAAA;EACA,EAAA;AAAA;AAAA,iBAGoB,aAAA,CAAA;EAAgB,IAAA;EAAM,MAAA;EAAQ;AAAA,GAAO,kBAAA,GAAkB,OAAA,sCAAA,kBAAA,CAAA,GAAA,CAAA,OAAA,GAAA,QAAA,CAAA,KAAA,CAAA,SAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/playground/index.tsx"],"mappings":";;;;;UAiBiB,kBAAA;EACf,IAAA;EACA,MAAA,EAAQ,iBAAA;EACR,GAAA,EAAK,aAAA;AAAA;AAAA,KAGK,aAAA,GAAgB,oBAAA;EAC1B,MAAA;EACA,EAAA;AAAA;AAAA,iBAGc,aAAA,CAAA;EAAgB,IAAA;EAAM,MAAA;EAAQ;AAAA,GAAO,kBAAA,wCAAkB,oBAAA,CAAA,GAAA,CAAA,OAAA,GAAA,QAAA,CAAA,OAAA,CAAA,SAAA,IAAA,OAAA,CAAA,OAAA,CAAA,SAAA"}

package/dist/playground/index.js

@@ -1,8 +1,8 @@
-import { getPreferredType } from "../utils/schema.js";
+import { getPreferredType } from "../utils/schema/index.js";
 import { ClientLazy } from "./lazy.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/playground/index.tsx
-async function APIPlayground({ path, method, ctx }) {
+function APIPlayground({ path, method, ctx }) {
 	if (ctx.playground?.render) return ctx.playground.render({
 		path,
 		method,

package/dist/playground/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/playground/index.tsx"],"sourcesContent":["import type {\n  MediaTypeObject,\n  MethodInformation,\n  ParameterObject,\n  RenderContext,\n  SecuritySchemeObject,\n} from '@/types';\nimport { getPreferredType, NoReference, type ParsedSchema } from '@/utils/schema';\nimport { type PlaygroundClientProps } from './client';\nimport { ClientLazy } from './lazy';\n\ninterface Context {\n  references: Record<string, ParsedSchema>;\n  registered: WeakMap<Exclude<ParsedSchema, boolean>, string>;\n  id: (schema?: object) => string;\n}\n\nexport interface APIPlaygroundProps {\n  path: string;\n  method: MethodInformation;\n  ctx: RenderContext;\n}\n\nexport type SecurityEntry = SecuritySchemeObject & {\n  scopes: string[];\n  id: string;\n};\n\nexport async function APIPlayground({ path, method, ctx }: APIPlaygroundProps) {\n  if (ctx.playground?.render) {\n    return ctx.playground.render({ path, method, ctx });\n  }\n\n  const bodyContent = method.requestBody?.content;\n  const mediaType = bodyContent ? getPreferredType(bodyContent) : undefined;\n  const takenIds = new Map<string, number>();\n\n  const context: Context = {\n    references: {},\n    id(schema) {\n      let name = 'r';\n      if (schema) {\n        const ref = ctx.schema.getRawRef(schema)?.split('/');\n        if (ref && ref.length > 0) name = ref[ref.length - 1];\n      }\n\n      const count = takenIds.get(name) ?? 0;\n      takenIds.set(name, count + 1);\n      return count === 0 ? name : `${name}${count}`;\n    },\n    registered: new WeakMap(),\n  };\n\n  const props: PlaygroundClientProps = {\n    securities: parseSecurities(method, ctx),\n    method: method.method,\n    route: path,\n    parameters: method.parameters?.map((param: NoReference<ParameterObject>): ParameterObject => {\n      if (param.schema !== undefined) {\n        return {\n          ...param,\n          schema: writeReferences(param.schema, context),\n        } as ParameterObject;\n      }\n\n      if (param.content !== undefined) {\n        const content: Record<string, MediaTypeObject> = {};\n\n        for (const k in param.content) {\n          const original = param.content[k] as NoReference<MediaTypeObject>;\n          if (!original || original.schema === undefined) continue;\n\n          content[k] = {\n            ...original,\n            schema: writeReferences(original.schema, context),\n          } as MediaTypeObject;\n        }\n\n        return {\n          ...param,\n          content,\n        } as ParameterObject;\n      }\n\n      return param;\n    }),\n    body:\n      bodyContent && mediaType\n        ? ({\n            schema: writeReferences(bodyContent[mediaType].schema as ParsedSchema, context),\n            mediaType,\n          } as PlaygroundClientProps['body'])\n        : undefined,\n    references: context.references,\n    proxyUrl: ctx.proxyUrl,\n    writeOnly: true,\n    readOnly: false,\n  };\n\n  return <ClientLazy {...props} />;\n}\n\nfunction writeReferences(\n  schema: ParsedSchema,\n  ctx: Context,\n  stack: WeakMap<object, object> = new WeakMap(),\n): ParsedSchema {\n  if (typeof schema !== 'object' || !schema) return schema;\n  if (stack.has(schema)) {\n    const out = stack.get(schema)!;\n    const id = ctx.id(schema);\n    ctx.references[id] = out;\n\n    return {\n      $ref: `#/${id}`,\n    };\n  }\n\n  const output = { ...schema };\n  stack.set(schema, output);\n  for (const _n in output) {\n    const name = _n as keyof typeof output;\n    if (!output[name]) continue;\n\n    switch (name) {\n      case 'oneOf':\n      case 'allOf':\n      case 'anyOf':\n        output[name] = output[name].map((item) => writeReferences(item, ctx, stack));\n        continue;\n      case 'items':\n      case 'additionalProperties':\n      case 'not':\n        output[name] = writeReferences(output[name], ctx, stack);\n        continue;\n      case 'properties':\n      case 'patternProperties':\n        output[name] = { ...output[name] };\n\n        for (const key in output[name]) {\n          output[name][key] = writeReferences(output[name][key], ctx, stack);\n        }\n    }\n  }\n\n  return output;\n}\n\nfunction parseSecurities(\n  method: MethodInformation,\n  { schema: { dereferenced } }: RenderContext,\n): PlaygroundClientProps['securities'] {\n  const result: PlaygroundClientProps['securities'] = [];\n  const security = method.security ?? dereferenced.security ?? [];\n  if (security.length === 0) return result;\n\n  for (const map of security) {\n    const list: PlaygroundClientProps['securities'][number] = [];\n\n    for (const [key, scopes] of Object.entries(map)) {\n      const scheme = dereferenced.components?.securitySchemes?.[key];\n      if (!scheme) continue;\n\n      list.push({\n        ...scheme,\n        scopes,\n        id: key,\n      });\n    }\n\n    if (list.length > 0) result.push(list);\n  }\n\n  return result;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/playground/index.tsx"],"sourcesContent":["import type {\n  MediaTypeObject,\n  MethodInformation,\n  ParameterObject,\n  RenderContext,\n  SecuritySchemeObject,\n} from '@/types';\nimport { getPreferredType, NoReference, type ParsedSchema } from '@/utils/schema';\nimport { type PlaygroundClientProps } from './client';\nimport { ClientLazy } from './lazy';\n\ninterface Context {\n  references: Record<string, ParsedSchema>;\n  registered: WeakMap<Exclude<ParsedSchema, boolean>, string>;\n  id: (schema?: object) => string;\n}\n\nexport interface APIPlaygroundProps {\n  path: string;\n  method: MethodInformation;\n  ctx: RenderContext;\n}\n\nexport type SecurityEntry = SecuritySchemeObject & {\n  scopes: string[];\n  id: string;\n};\n\nexport function APIPlayground({ path, method, ctx }: APIPlaygroundProps) {\n  if (ctx.playground?.render) {\n    return ctx.playground.render({ path, method, ctx });\n  }\n\n  const bodyContent = method.requestBody?.content;\n  const mediaType = bodyContent ? getPreferredType(bodyContent) : undefined;\n  const takenIds = new Map<string, number>();\n\n  const context: Context = {\n    references: {},\n    id(schema) {\n      let name = 'r';\n      if (schema) {\n        const ref = ctx.schema.getRawRef(schema)?.split('/');\n        if (ref && ref.length > 0) name = ref[ref.length - 1];\n      }\n\n      const count = takenIds.get(name) ?? 0;\n      takenIds.set(name, count + 1);\n      return count === 0 ? name : `${name}${count}`;\n    },\n    registered: new WeakMap(),\n  };\n\n  const props: PlaygroundClientProps = {\n    securities: parseSecurities(method, ctx),\n    method: method.method,\n    route: path,\n    parameters: method.parameters?.map((param: NoReference<ParameterObject>): ParameterObject => {\n      if (param.schema !== undefined) {\n        return {\n          ...param,\n          schema: writeReferences(param.schema, context),\n        } as ParameterObject;\n      }\n\n      if (param.content !== undefined) {\n        const content: Record<string, MediaTypeObject> = {};\n\n        for (const k in param.content) {\n          const original = param.content[k] as NoReference<MediaTypeObject>;\n          if (!original || original.schema === undefined) continue;\n\n          content[k] = {\n            ...original,\n            schema: writeReferences(original.schema, context),\n          } as MediaTypeObject;\n        }\n\n        return {\n          ...param,\n          content,\n        } as ParameterObject;\n      }\n\n      return param;\n    }),\n    body:\n      bodyContent && mediaType\n        ? ({\n            schema: writeReferences(bodyContent[mediaType].schema as ParsedSchema, context),\n            mediaType,\n          } as PlaygroundClientProps['body'])\n        : undefined,\n    references: context.references,\n    proxyUrl: ctx.proxyUrl,\n    writeOnly: true,\n    readOnly: false,\n  };\n\n  return <ClientLazy {...props} />;\n}\n\nfunction writeReferences(\n  schema: ParsedSchema,\n  ctx: Context,\n  stack: WeakMap<object, object> = new WeakMap(),\n): ParsedSchema {\n  if (typeof schema !== 'object' || !schema) return schema;\n  if (stack.has(schema)) {\n    const out = stack.get(schema)!;\n    const id = ctx.id(schema);\n    ctx.references[id] = out;\n\n    return {\n      $ref: `#/${id}`,\n    };\n  }\n\n  const output = { ...schema };\n  stack.set(schema, output);\n  for (const _n in output) {\n    const name = _n as keyof typeof output;\n    if (!output[name]) continue;\n\n    switch (name) {\n      case 'oneOf':\n      case 'allOf':\n      case 'anyOf':\n        output[name] = output[name].map((item) => writeReferences(item, ctx, stack));\n        continue;\n      case 'items':\n      case 'additionalProperties':\n      case 'not':\n        output[name] = writeReferences(output[name], ctx, stack);\n        continue;\n      case 'properties':\n      case 'patternProperties':\n        output[name] = { ...output[name] };\n\n        for (const key in output[name]) {\n          output[name][key] = writeReferences(output[name][key], ctx, stack);\n        }\n    }\n  }\n\n  return output;\n}\n\nfunction parseSecurities(\n  method: MethodInformation,\n  { schema: { dereferenced } }: RenderContext,\n): PlaygroundClientProps['securities'] {\n  const result: PlaygroundClientProps['securities'] = [];\n  const security = method.security ?? dereferenced.security ?? [];\n  if (security.length === 0) return result;\n\n  for (const map of security) {\n    const list: PlaygroundClientProps['securities'][number] = [];\n\n    for (const [key, scopes] of Object.entries(map)) {\n      const scheme = dereferenced.components?.securitySchemes?.[key];\n      if (!scheme) continue;\n\n      list.push({\n        ...scheme,\n        scopes,\n        id: key,\n      });\n    }\n\n    if (list.length > 0) result.push(list);\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/playground/schema.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from "react";
+import { Ajv2020 } from "ajv/dist/2020.js";
 import { FieldKey } from "@fumari/stf";
 
 //#region src/playground/schema.d.ts

package/dist/playground/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/playground/schema.tsx"],"mappings":";;;;UAciB,WAAA;EASP;;;EALR,SAAA;;;;EAKA,QAAA;AAAA"}
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/playground/schema.tsx"],"mappings":";;;;;UAeiB,WAAA;;;;EAIf,SAAA;;;;EAKA,QAAA;AAAA"}

package/dist/playground/schema.js

@@ -1,5 +1,6 @@
 import { mergeAllOf } from "../utils/merge-schema.js";
-import { schemaToString } from "../utils/schema-to-string.js";
+import { schemaToString } from "../utils/schema/to-string.js";
+import { resolveRefSync } from "../utils/schema/resolve-ref.js";
 import { createContext, use, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 import { Ajv2020 } from "ajv/dist/2020.js";
@@ -129,24 +130,21 @@ function useResolvedSchema(raw) {
 	return useMemo(() => {
 		const schema = dereference(raw, references);
 		if (typeof schema === "boolean") return anyFields;
-		if (schema.allOf) return fallbackAny(mergeAllOf(schema, { dereference(schema) {
-			return dereference(schema, references);
-		} }));
+		if (schema.allOf) {
+			const merged = mergeAllOf(schema, { dereference(schema) {
+				return dereference(schema, references);
+			} });
+			if (typeof merged === "boolean") return anyFields;
+			return merged;
+		}
 		return schema;
 	}, [raw, references]);
 }
 function dereference(schema, references) {
 	if (typeof schema === "boolean") return schema;
-	let ref = schema.$ref;
-	if (ref) {
-		if (ref.startsWith("#/")) ref = ref.slice(2);
-		if (ref in references) return references[ref];
-	}
+	if (schema.$ref) return resolveRefSync(schema.$ref, references);
 	return schema;
 }
-function fallbackAny(schema) {
-	return typeof schema === "boolean" ? anyFields : schema;
-}
 function getUnion(schema) {
 	if (schema.anyOf) return [schema.anyOf, "anyOf"];
 	if (schema.oneOf) return [schema.oneOf, "oneOf"];

package/dist/playground/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../../src/playground/schema.tsx"],"sourcesContent":["import { Ajv2020 } from 'ajv/dist/2020';\nimport { createContext, ReactNode, use, useMemo } from 'react';\nimport type { ParsedSchema, ResolvedSchema } from '@/utils/schema';\nimport { mergeAllOf } from '@/utils/merge-schema';\nimport { FieldKey, useDataEngine, useFieldValue, useNamespace } from '@fumari/stf';\nimport { stringifyFieldKey } from '@fumari/stf/lib/utils';\nimport { sample } from 'openapi-sampler';\nimport { FormatFlags, schemaToString } from '@/utils/schema-to-string';\n\ninterface SchemaContextType extends SchemaScope {\n  references: Record<string, ParsedSchema>;\n  ajv: Ajv2020;\n}\n\nexport interface SchemaScope {\n  /**\n   * show write only fields\n   */\n  writeOnly: boolean;\n\n  /**\n   * show read only fields\n   */\n  readOnly: boolean;\n}\n\ntype UnionField = 'anyOf' | 'oneOf';\n\nexport interface FieldInfo {\n  selectedType?: string;\n  oneOf: number;\n\n  /**\n   * The actual field that represents union members.\n   */\n  unionField?: UnionField;\n}\n\nconst SchemaContext = createContext<SchemaContextType | undefined>(undefined);\nexport const anyFields = {\n  type: ['string', 'number', 'boolean', 'array', 'object'],\n  items: true,\n  additionalProperties: true,\n} satisfies ParsedSchema;\n\nexport function SchemaProvider({\n  references,\n  readOnly,\n  writeOnly,\n  children,\n}: Omit<SchemaContextType, 'ajv'> & { children: ReactNode }) {\n  const ajv = useMemo(\n    () =>\n      new Ajv2020({\n        strict: false,\n        validateSchema: false,\n        validateFormats: false,\n      }),\n    [],\n  );\n\n  return (\n    <SchemaContext.Provider\n      value={useMemo(\n        () => ({ references, ajv, readOnly, writeOnly }),\n        [references, ajv, readOnly, writeOnly],\n      )}\n    >\n      {children}\n    </SchemaContext.Provider>\n  );\n}\n\nexport function useSchemaScope(): SchemaScope {\n  return use(SchemaContext)!;\n}\n\n/**\n * A hook to store dynamic info of a field, such as selected schema of `oneOf`.\n *\n * @param fieldName - field name of form.\n * @param schema - The **resolved** JSON Schema to generate initial values.\n * @param depth - The depth to avoid duplicated field name with same schema (e.g. nested `oneOf`).\n */\nexport function useFieldInfo(\n  fieldName: FieldKey,\n  schema: Exclude<ParsedSchema, boolean>,\n  depth = 0,\n): {\n  info: FieldInfo;\n  schema: Exclude<ParsedSchema, boolean>;\n  updateInfo: (value: Partial<FieldInfo>) => void;\n} {\n  const { ajv, references } = use(SchemaContext)!;\n  const engine = useDataEngine();\n  const { generateDefault } = useSchemaUtils();\n  const fieldData = useNamespace({\n    namespace: `field-info:${depth}:${stringifyFieldKey(fieldName)}`,\n    initial(): FieldInfo {\n      const value = engine.get(fieldName);\n      const out: FieldInfo = {\n        oneOf: -1,\n      };\n      const union = getUnion(schema);\n      if (union) {\n        const [members, field] = union;\n\n        out.oneOf = members.findIndex((item) =>\n          ajv.validate(typeof item === 'object' ? { ...item, ...references } : item, value),\n        );\n        if (out.oneOf === -1) out.oneOf = 0;\n        out.unionField = field;\n      }\n\n      if (Array.isArray(schema.type)) {\n        const types = schema.type;\n\n        out.selectedType =\n          types.find((type) => {\n            return ajv.validate({ ...schema, ...references, type }, value);\n          }) ?? types[0];\n      }\n\n      return out;\n    },\n  });\n  const [info, setInfo] = useFieldValue<FieldInfo>([], {\n    stf: fieldData,\n  });\n\n  return {\n    info,\n    schema,\n    updateInfo(value) {\n      const updated = {\n        ...info,\n        ...value,\n      };\n\n      if (updated.oneOf === info.oneOf && updated.selectedType === info.selectedType) return;\n\n      setInfo(updated);\n\n      let valueSchema: ParsedSchema = schema;\n      if (updated.unionField) {\n        valueSchema = schema[updated.unionField]![updated.oneOf];\n      } else if (updated.selectedType) {\n        // must remove to `examples` to avoid invalid default values\n        valueSchema = { ...schema, type: updated.selectedType, examples: undefined };\n      }\n\n      engine.update(fieldName, generateDefault(valueSchema));\n    },\n  };\n}\n\nexport function useSchemaUtils() {\n  const { references } = use(SchemaContext)!;\n\n  return {\n    generateDefault(schema: ParsedSchema): unknown {\n      return sample(\n        schema as never,\n        { skipNonRequired: true, skipReadOnly: true, quiet: true },\n        references,\n      );\n    },\n    schemaToString(value: ResolvedSchema, flags?: FormatFlags) {\n      return schemaToString(\n        value,\n        (s) => ({ dereferenced: dereference(s, references), raw: s }),\n        flags,\n      );\n    },\n  };\n}\n\n/**\n * resolve $ref & merge `allOf`.\n */\nexport function useResolvedSchema(raw: ParsedSchema): Exclude<ParsedSchema, boolean> {\n  const { references } = use(SchemaContext)!;\n\n  return useMemo(() => {\n    const schema = dereference(raw, references);\n    if (typeof schema === 'boolean') return anyFields;\n\n    if (schema.allOf) {\n      return fallbackAny(\n        mergeAllOf(schema, {\n          dereference(schema) {\n            return dereference(schema, references);\n          },\n        }),\n      );\n    }\n\n    return schema;\n  }, [raw, references]);\n}\n\nfunction dereference(schema: ParsedSchema, references: Record<string, ParsedSchema>): ParsedSchema {\n  if (typeof schema === 'boolean') return schema;\n\n  let ref = schema.$ref;\n  if (ref) {\n    // use swallow resolution as it is already preprocessed in `playground/index.tsx`\n    const prefix = '#/';\n    if (ref.startsWith(prefix)) ref = ref.slice(prefix.length);\n    if (ref in references) return references[ref];\n  }\n\n  return schema;\n}\n\nfunction fallbackAny(schema: ParsedSchema): Exclude<ParsedSchema, boolean> {\n  return typeof schema === 'boolean' ? anyFields : schema;\n}\n\nfunction getUnion(\n  schema: Exclude<ParsedSchema, boolean>,\n): [readonly ParsedSchema[], UnionField] | undefined {\n  if (schema.anyOf) {\n    return [schema.anyOf, 'anyOf'];\n  }\n\n  if (schema.oneOf) return [schema.oneOf, 'oneOf'];\n}\n"],"mappings":";;;;;;;;;AAsCA,MAAM,gBAAgB,cAA6C,KAAA,EAAU;AAC7E,MAAa,YAAY;CACvB,MAAM;EAAC;EAAU;EAAU;EAAW;EAAS;EAAS;CACxD,OAAO;CACP,sBAAsB;CACvB;AAED,SAAgB,eAAe,EAC7B,YACA,UACA,WACA,YAC2D;CAC3D,MAAM,MAAM,cAER,IAAI,QAAQ;EACV,QAAQ;EACR,gBAAgB;EAChB,iBAAiB;EAClB,CAAC,EACJ,EAAE,CACH;AAED,QACE,oBAAC,cAAc,UAAf;EACE,OAAO,eACE;GAAE;GAAY;GAAK;GAAU;GAAW,GAC/C;GAAC;GAAY;GAAK;GAAU;GAAU,CACvC;EAEA;EACsB,CAAA;;AAI7B,SAAgB,iBAA8B;AAC5C,QAAO,IAAI,cAAc;;;;;;;;;AAU3B,SAAgB,aACd,WACA,QACA,QAAQ,GAKR;CACA,MAAM,EAAE,KAAK,eAAe,IAAI,cAAc;CAC9C,MAAM,SAAS,eAAe;CAC9B,MAAM,EAAE,oBAAoB,gBAAgB;CA+B5C,MAAM,CAAC,MAAM,WAAW,cAAyB,EAAE,EAAE,EACnD,KA/BgB,aAAa;EAC7B,WAAW,cAAc,MAAM,GAAG,kBAAkB,UAAU;EAC9D,UAAqB;GACnB,MAAM,QAAQ,OAAO,IAAI,UAAU;GACnC,MAAM,MAAiB,EACrB,OAAO,IACR;GACD,MAAM,QAAQ,SAAS,OAAO;AAC9B,OAAI,OAAO;IACT,MAAM,CAAC,SAAS,SAAS;AAEzB,QAAI,QAAQ,QAAQ,WAAW,SAC7B,IAAI,SAAS,OAAO,SAAS,WAAW;KAAE,GAAG;KAAM,GAAG;KAAY,GAAG,MAAM,MAAM,CAClF;AACD,QAAI,IAAI,UAAU,GAAI,KAAI,QAAQ;AAClC,QAAI,aAAa;;AAGnB,OAAI,MAAM,QAAQ,OAAO,KAAK,EAAE;IAC9B,MAAM,QAAQ,OAAO;AAErB,QAAI,eACF,MAAM,MAAM,SAAS;AACnB,YAAO,IAAI,SAAS;MAAE,GAAG;MAAQ,GAAG;MAAY;MAAM,EAAE,MAAM;MAC9D,IAAI,MAAM;;AAGhB,UAAO;;EAEV,CAAC,EAGD,CAAC;AAEF,QAAO;EACL;EACA;EACA,WAAW,OAAO;GAChB,MAAM,UAAU;IACd,GAAG;IACH,GAAG;IACJ;AAED,OAAI,QAAQ,UAAU,KAAK,SAAS,QAAQ,iBAAiB,KAAK,aAAc;AAEhF,WAAQ,QAAQ;GAEhB,IAAI,cAA4B;AAChC,OAAI,QAAQ,WACV,eAAc,OAAO,QAAQ,YAAa,QAAQ;YACzC,QAAQ,aAEjB,eAAc;IAAE,GAAG;IAAQ,MAAM,QAAQ;IAAc,UAAU,KAAA;IAAW;AAG9E,UAAO,OAAO,WAAW,gBAAgB,YAAY,CAAC;;EAEzD;;AAGH,SAAgB,iBAAiB;CAC/B,MAAM,EAAE,eAAe,IAAI,cAAc;AAEzC,QAAO;EACL,gBAAgB,QAA+B;AAC7C,UAAO,OACL,QACA;IAAE,iBAAiB;IAAM,cAAc;IAAM,OAAO;IAAM,EAC1D,WACD;;EAEH,eAAe,OAAuB,OAAqB;AACzD,UAAO,eACL,QACC,OAAO;IAAE,cAAc,YAAY,GAAG,WAAW;IAAE,KAAK;IAAG,GAC5D,MACD;;EAEJ;;;;;AAMH,SAAgB,kBAAkB,KAAmD;CACnF,MAAM,EAAE,eAAe,IAAI,cAAc;AAEzC,QAAO,cAAc;EACnB,MAAM,SAAS,YAAY,KAAK,WAAW;AAC3C,MAAI,OAAO,WAAW,UAAW,QAAO;AAExC,MAAI,OAAO,MACT,QAAO,YACL,WAAW,QAAQ,EACjB,YAAY,QAAQ;AAClB,UAAO,YAAY,QAAQ,WAAW;KAEzC,CAAC,CACH;AAGH,SAAO;IACN,CAAC,KAAK,WAAW,CAAC;;AAGvB,SAAS,YAAY,QAAsB,YAAwD;AACjG,KAAI,OAAO,WAAW,UAAW,QAAO;CAExC,IAAI,MAAM,OAAO;AACjB,KAAI,KAAK;AAGP,MAAI,IAAI,WADO,KACW,CAAE,OAAM,IAAI,MAAM,EAAc;AAC1D,MAAI,OAAO,WAAY,QAAO,WAAW;;AAG3C,QAAO;;AAGT,SAAS,YAAY,QAAsD;AACzE,QAAO,OAAO,WAAW,YAAY,YAAY;;AAGnD,SAAS,SACP,QACmD;AACnD,KAAI,OAAO,MACT,QAAO,CAAC,OAAO,OAAO,QAAQ;AAGhC,KAAI,OAAO,MAAO,QAAO,CAAC,OAAO,OAAO,QAAQ"}
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/playground/schema.tsx"],"sourcesContent":["import { Ajv2020 } from 'ajv/dist/2020';\nimport { createContext, ReactNode, use, useMemo } from 'react';\nimport type { ParsedSchema, ResolvedSchema } from '@/utils/schema';\nimport { mergeAllOf } from '@/utils/merge-schema';\nimport { FieldKey, useDataEngine, useFieldValue, useNamespace } from '@fumari/stf';\nimport { stringifyFieldKey } from '@fumari/stf/lib/utils';\nimport { sample } from 'openapi-sampler';\nimport { FormatFlags, schemaToString } from '@/utils/schema/to-string';\nimport { resolveRefSync } from '@/utils/schema/resolve-ref';\n\ninterface SchemaContextType extends SchemaScope {\n  references: Record<string, ParsedSchema>;\n  ajv: Ajv2020;\n}\n\nexport interface SchemaScope {\n  /**\n   * show write only fields\n   */\n  writeOnly: boolean;\n\n  /**\n   * show read only fields\n   */\n  readOnly: boolean;\n}\n\ntype UnionField = 'anyOf' | 'oneOf';\n\nexport interface FieldInfo {\n  selectedType?: string;\n  oneOf: number;\n\n  /**\n   * The actual field that represents union members.\n   */\n  unionField?: UnionField;\n}\n\nconst SchemaContext = createContext<SchemaContextType | undefined>(undefined);\nexport const anyFields = {\n  type: ['string', 'number', 'boolean', 'array', 'object'],\n  items: true,\n  additionalProperties: true,\n} satisfies ParsedSchema;\n\nexport function SchemaProvider({\n  references,\n  readOnly,\n  writeOnly,\n  children,\n}: Omit<SchemaContextType, 'ajv'> & { children: ReactNode }) {\n  const ajv = useMemo(\n    () =>\n      new Ajv2020({\n        strict: false,\n        validateSchema: false,\n        validateFormats: false,\n      }),\n    [],\n  );\n\n  return (\n    <SchemaContext.Provider\n      value={useMemo(\n        () => ({ references, ajv, readOnly, writeOnly }),\n        [references, ajv, readOnly, writeOnly],\n      )}\n    >\n      {children}\n    </SchemaContext.Provider>\n  );\n}\n\nexport function useSchemaScope(): SchemaScope {\n  return use(SchemaContext)!;\n}\n\n/**\n * A hook to store dynamic info of a field, such as selected schema of `oneOf`.\n *\n * @param fieldName - field name of form.\n * @param schema - The **resolved** JSON Schema to generate initial values.\n * @param depth - The depth to avoid duplicated field name with same schema (e.g. nested `oneOf`).\n */\nexport function useFieldInfo(\n  fieldName: FieldKey,\n  schema: Exclude<ParsedSchema, boolean>,\n  depth = 0,\n): {\n  info: FieldInfo;\n  schema: Exclude<ParsedSchema, boolean>;\n  updateInfo: (value: Partial<FieldInfo>) => void;\n} {\n  const { ajv, references } = use(SchemaContext)!;\n  const engine = useDataEngine();\n  const { generateDefault } = useSchemaUtils();\n  const fieldData = useNamespace({\n    namespace: `field-info:${depth}:${stringifyFieldKey(fieldName)}`,\n    initial(): FieldInfo {\n      const value = engine.get(fieldName);\n      const out: FieldInfo = {\n        oneOf: -1,\n      };\n      const union = getUnion(schema);\n      if (union) {\n        const [members, field] = union;\n\n        out.oneOf = members.findIndex((item) =>\n          ajv.validate(typeof item === 'object' ? { ...item, ...references } : item, value),\n        );\n        if (out.oneOf === -1) out.oneOf = 0;\n        out.unionField = field;\n      }\n\n      if (Array.isArray(schema.type)) {\n        const types = schema.type;\n\n        out.selectedType =\n          types.find((type) => {\n            return ajv.validate({ ...schema, ...references, type }, value);\n          }) ?? types[0];\n      }\n\n      return out;\n    },\n  });\n  const [info, setInfo] = useFieldValue<FieldInfo>([], {\n    stf: fieldData,\n  });\n\n  return {\n    info,\n    schema,\n    updateInfo(value) {\n      const updated = {\n        ...info,\n        ...value,\n      };\n\n      if (updated.oneOf === info.oneOf && updated.selectedType === info.selectedType) return;\n\n      setInfo(updated);\n\n      let valueSchema: ParsedSchema = schema;\n      if (updated.unionField) {\n        valueSchema = schema[updated.unionField]![updated.oneOf];\n      } else if (updated.selectedType) {\n        // must remove to `examples` to avoid invalid default values\n        valueSchema = { ...schema, type: updated.selectedType, examples: undefined };\n      }\n\n      engine.update(fieldName, generateDefault(valueSchema));\n    },\n  };\n}\n\nexport function useSchemaUtils() {\n  const { references } = use(SchemaContext)!;\n\n  return {\n    generateDefault(schema: ParsedSchema): unknown {\n      return sample(\n        schema as never,\n        { skipNonRequired: true, skipReadOnly: true, quiet: true },\n        references,\n      );\n    },\n    schemaToString(value: ResolvedSchema, flags?: FormatFlags) {\n      return schemaToString(\n        value,\n        (s) => ({ dereferenced: dereference(s, references), raw: s }),\n        flags,\n      );\n    },\n  };\n}\n\n/**\n * resolve $ref & merge `allOf`.\n */\nexport function useResolvedSchema(raw: ParsedSchema): Exclude<ParsedSchema, boolean> {\n  const { references } = use(SchemaContext)!;\n\n  return useMemo(() => {\n    const schema = dereference(raw, references);\n    if (typeof schema === 'boolean') return anyFields;\n\n    if (schema.allOf) {\n      const merged = mergeAllOf(schema, {\n        dereference(schema) {\n          return dereference(schema, references);\n        },\n      });\n      if (typeof merged === 'boolean') return anyFields;\n      return merged;\n    }\n\n    return schema;\n  }, [raw, references]);\n}\n\nfunction dereference(schema: ParsedSchema, references: Record<string, ParsedSchema>): ParsedSchema {\n  if (typeof schema === 'boolean') return schema;\n  if (schema.$ref) {\n    return resolveRefSync(schema.$ref, references) as ParsedSchema;\n  }\n\n  return schema;\n}\n\nfunction getUnion(\n  schema: Exclude<ParsedSchema, boolean>,\n): [readonly ParsedSchema[], UnionField] | undefined {\n  if (schema.anyOf) {\n    return [schema.anyOf, 'anyOf'];\n  }\n\n  if (schema.oneOf) return [schema.oneOf, 'oneOf'];\n}\n"],"mappings":"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"}

package/dist/requests/generators/python.d.ts

@@ -2,6 +2,7 @@ import { CodeUsageGenerator } from "./index.js";
 
 //#region src/requests/generators/python.d.ts
 declare const python: CodeUsageGenerator;
+declare function generatePythonObject(v: unknown, imports: Set<string>): string;
 //#endregion
-export { python };
+export { generatePythonObject, python };
 //# sourceMappingURL=python.d.ts.map

package/dist/requests/generators/python.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python.d.ts","names":[],"sources":["../../../src/requests/generators/python.ts"],"mappings":";;;cAIa,MAAA,EAAQ,kBAAA"}
+{"version":3,"file":"python.d.ts","names":[],"sources":["../../../src/requests/generators/python.ts"],"mappings":";;;cAGa,MAAA,EAAQ,kBAAA;AAAA,iBAuDL,oBAAA,CAAqB,CAAA,WAAY,OAAA,EAAS,GAAA"}

package/dist/requests/generators/python.js

@@ -1,6 +1,5 @@
 import { resolveMediaAdapter } from "../media/resolve-adapter.js";
 import "../media/adapter.js";
-import { generatePythonObject } from "../to-python-object.js";
 //#region src/requests/generators/python.ts
 const python = {
 	label: "Python",
@@ -34,7 +33,19 @@ response = requests.request(${params.join(", ")})
 print(response.text)`;
 	}
 };
+function generatePythonObject(v, imports) {
+	if (v === null) return "None";
+	else if (typeof v === "boolean") return v ? "True" : "False";
+	else if (typeof v === "string") return JSON.stringify(v);
+	else if (typeof v === "number") return v.toString();
+	else if (Array.isArray(v)) return `[${v.map((item) => generatePythonObject(item, imports)).join(", ")}]`;
+	else if (v instanceof Date) {
+		imports.add("datetime");
+		return `datetime.datetime(${v.getFullYear()}, ${v.getMonth() + 1}, ${v.getDate()}, ${v.getHours()}, ${v.getMinutes()}, ${v.getSeconds()}, ${v.getMilliseconds()})`;
+	} else if (typeof v === "object") return `{\n${Object.entries(v).map(([key, value]) => `  ${JSON.stringify(key)}: ${generatePythonObject(value, imports)}`).join(", \n")}\n}`;
+	else throw new Error(`Unsupported type: ${typeof v}`);
+}
 //#endregion
-export { python };
+export { generatePythonObject, python };
 
 //# sourceMappingURL=python.js.map

package/dist/requests/generators/python.js.map

@@ -1 +1 @@
-{"version":3,"file":"python.js","names":[],"sources":["../../../src/requests/generators/python.ts"],"sourcesContent":["import type { CodeUsageGenerator } from '@/requests/generators';\nimport { generatePythonObject } from '@/requests/to-python-object';\nimport { resolveMediaAdapter } from '@/requests/media/adapter';\n\nexport const python: CodeUsageGenerator = {\n  label: 'Python',\n  lang: 'python',\n  generate(url, data, { mediaAdapters }) {\n    const headers: Record<string, string> = {};\n    const imports = new Set<string>();\n    const params = [`\"${data.method}\"`, 'url'];\n    let body: string | undefined;\n\n    imports.add('requests');\n\n    if (data.body && data.bodyMediaType) {\n      const adapter = resolveMediaAdapter(data.bodyMediaType, mediaAdapters);\n      headers['Content-Type'] = data.bodyMediaType;\n\n      body = adapter?.generateExample(data as { body: unknown }, {\n        lang: 'python',\n      });\n\n      if (body) {\n        params.push('data = body');\n      }\n    }\n\n    for (const [k, v] of Object.entries(data.header)) {\n      headers[k] = v.value;\n    }\n\n    if (Object.keys(headers).length > 0) {\n      params.push(`headers = ${generatePythonObject(headers, imports)}`);\n    }\n\n    const inputCookies = Object.entries(data.cookie);\n    if (inputCookies.length > 0) {\n      const cookies: Record<string, string> = {};\n\n      for (const [k, v] of inputCookies) {\n        cookies[k] = v.value;\n      }\n\n      params.push(`cookies = ${generatePythonObject(cookies, imports)}`);\n    }\n\n    return `${Array.from(imports)\n      .map((name) => 'import ' + name)\n      .join('\\n')}\n\nurl = ${JSON.stringify(url)}\n${body ?? ''}\nresponse = requests.request(${params.join(', ')})\n\nprint(response.text)`;\n  },\n};\n"],"mappings":";;;;AAIA,MAAa,SAA6B;CACxC,OAAO;CACP,MAAM;CACN,SAAS,KAAK,MAAM,EAAE,iBAAiB;EACrC,MAAM,UAAkC,EAAE;EAC1C,MAAM,0BAAU,IAAI,KAAa;EACjC,MAAM,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM;EAC1C,IAAI;AAEJ,UAAQ,IAAI,WAAW;AAEvB,MAAI,KAAK,QAAQ,KAAK,eAAe;GACnC,MAAM,UAAU,oBAAoB,KAAK,eAAe,cAAc;AACtE,WAAQ,kBAAkB,KAAK;AAE/B,UAAO,SAAS,gBAAgB,MAA2B,EACzD,MAAM,UACP,CAAC;AAEF,OAAI,KACF,QAAO,KAAK,cAAc;;AAI9B,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,OAAO,CAC9C,SAAQ,KAAK,EAAE;AAGjB,MAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAChC,QAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;EAGpE,MAAM,eAAe,OAAO,QAAQ,KAAK,OAAO;AAChD,MAAI,aAAa,SAAS,GAAG;GAC3B,MAAM,UAAkC,EAAE;AAE1C,QAAK,MAAM,CAAC,GAAG,MAAM,aACnB,SAAQ,KAAK,EAAE;AAGjB,UAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;;AAGpE,SAAO,GAAG,MAAM,KAAK,QAAQ,CAC1B,KAAK,SAAS,YAAY,KAAK,CAC/B,KAAK,KAAK,CAAC;;QAEV,KAAK,UAAU,IAAI,CAAC;EAC1B,QAAQ,GAAG;8BACiB,OAAO,KAAK,KAAK,CAAC;;;;CAI/C"}
+{"version":3,"file":"python.js","names":[],"sources":["../../../src/requests/generators/python.ts"],"sourcesContent":["import type { CodeUsageGenerator } from '@/requests/generators';\nimport { resolveMediaAdapter } from '@/requests/media/adapter';\n\nexport const python: CodeUsageGenerator = {\n  label: 'Python',\n  lang: 'python',\n  generate(url, data, { mediaAdapters }) {\n    const headers: Record<string, string> = {};\n    const imports = new Set<string>();\n    const params = [`\"${data.method}\"`, 'url'];\n    let body: string | undefined;\n\n    imports.add('requests');\n\n    if (data.body && data.bodyMediaType) {\n      const adapter = resolveMediaAdapter(data.bodyMediaType, mediaAdapters);\n      headers['Content-Type'] = data.bodyMediaType;\n\n      body = adapter?.generateExample(data as { body: unknown }, {\n        lang: 'python',\n      });\n\n      if (body) {\n        params.push('data = body');\n      }\n    }\n\n    for (const [k, v] of Object.entries(data.header)) {\n      headers[k] = v.value;\n    }\n\n    if (Object.keys(headers).length > 0) {\n      params.push(`headers = ${generatePythonObject(headers, imports)}`);\n    }\n\n    const inputCookies = Object.entries(data.cookie);\n    if (inputCookies.length > 0) {\n      const cookies: Record<string, string> = {};\n\n      for (const [k, v] of inputCookies) {\n        cookies[k] = v.value;\n      }\n\n      params.push(`cookies = ${generatePythonObject(cookies, imports)}`);\n    }\n\n    return `${Array.from(imports)\n      .map((name) => 'import ' + name)\n      .join('\\n')}\n\nurl = ${JSON.stringify(url)}\n${body ?? ''}\nresponse = requests.request(${params.join(', ')})\n\nprint(response.text)`;\n  },\n};\n\nexport function generatePythonObject(v: unknown, imports: Set<string>): string {\n  if (v === null) {\n    return 'None';\n  } else if (typeof v === 'boolean') {\n    return v ? 'True' : 'False';\n  } else if (typeof v === 'string') {\n    return JSON.stringify(v);\n  } else if (typeof v === 'number') {\n    return v.toString();\n  } else if (Array.isArray(v)) {\n    const items = v.map((item) => generatePythonObject(item, imports));\n    return `[${items.join(', ')}]`;\n  } else if (v instanceof Date) {\n    imports.add('datetime');\n    return `datetime.datetime(${v.getFullYear()}, ${v.getMonth() + 1}, ${v.getDate()}, ${v.getHours()}, ${v.getMinutes()}, ${v.getSeconds()}, ${v.getMilliseconds()})`;\n  } else if (typeof v === 'object') {\n    const entries = Object.entries(v).map(\n      ([key, value]) => `  ${JSON.stringify(key)}: ${generatePythonObject(value, imports)}`,\n    );\n    return `{\\n${entries.join(', \\n')}\\n}`;\n  } else {\n    throw new Error(`Unsupported type: ${typeof v}`);\n  }\n}\n"],"mappings":";;;AAGA,MAAa,SAA6B;CACxC,OAAO;CACP,MAAM;CACN,SAAS,KAAK,MAAM,EAAE,iBAAiB;EACrC,MAAM,UAAkC,EAAE;EAC1C,MAAM,0BAAU,IAAI,KAAa;EACjC,MAAM,SAAS,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM;EAC1C,IAAI;AAEJ,UAAQ,IAAI,WAAW;AAEvB,MAAI,KAAK,QAAQ,KAAK,eAAe;GACnC,MAAM,UAAU,oBAAoB,KAAK,eAAe,cAAc;AACtE,WAAQ,kBAAkB,KAAK;AAE/B,UAAO,SAAS,gBAAgB,MAA2B,EACzD,MAAM,UACP,CAAC;AAEF,OAAI,KACF,QAAO,KAAK,cAAc;;AAI9B,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,OAAO,CAC9C,SAAQ,KAAK,EAAE;AAGjB,MAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAChC,QAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;EAGpE,MAAM,eAAe,OAAO,QAAQ,KAAK,OAAO;AAChD,MAAI,aAAa,SAAS,GAAG;GAC3B,MAAM,UAAkC,EAAE;AAE1C,QAAK,MAAM,CAAC,GAAG,MAAM,aACnB,SAAQ,KAAK,EAAE;AAGjB,UAAO,KAAK,aAAa,qBAAqB,SAAS,QAAQ,GAAG;;AAGpE,SAAO,GAAG,MAAM,KAAK,QAAQ,CAC1B,KAAK,SAAS,YAAY,KAAK,CAC/B,KAAK,KAAK,CAAC;;QAEV,KAAK,UAAU,IAAI,CAAC;EAC1B,QAAQ,GAAG;8BACiB,OAAO,KAAK,KAAK,CAAC;;;;CAI/C;AAED,SAAgB,qBAAqB,GAAY,SAA8B;AAC7E,KAAI,MAAM,KACR,QAAO;UACE,OAAO,MAAM,UACtB,QAAO,IAAI,SAAS;UACX,OAAO,MAAM,SACtB,QAAO,KAAK,UAAU,EAAE;UACf,OAAO,MAAM,SACtB,QAAO,EAAE,UAAU;UACV,MAAM,QAAQ,EAAE,CAEzB,QAAO,IADO,EAAE,KAAK,SAAS,qBAAqB,MAAM,QAAQ,CAAC,CACjD,KAAK,KAAK,CAAC;UACnB,aAAa,MAAM;AAC5B,UAAQ,IAAI,WAAW;AACvB,SAAO,qBAAqB,EAAE,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC;YACvJ,OAAO,MAAM,SAItB,QAAO,MAHS,OAAO,QAAQ,EAAE,CAAC,KAC/B,CAAC,KAAK,WAAW,KAAK,KAAK,UAAU,IAAI,CAAC,IAAI,qBAAqB,OAAO,QAAQ,GACpF,CACoB,KAAK,OAAO,CAAC;KAElC,OAAM,IAAI,MAAM,qBAAqB,OAAO,IAAI"}

package/dist/scalar/index.d.ts

@@ -1,4 +1,5 @@
-import { CreateAPIPageOptions } from "../ui/full.js";
+import { CreateAPIPageOptions } from "../ui/index.js";
+
 //#region src/scalar/index.d.ts
 /**
  * Enable Scalar for API playgrounds by wrapping your options inside.

package/dist/scalar/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/scalar/index.tsx"],"mappings":";;;;;AAuBA;;iBAAgB,UAAA,CAAW,OAAA,GAAS,oBAAA,GAA4B,oBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/scalar/index.tsx"],"mappings":";;;;;AAuBA;;;iBAAgB,UAAA,CAAW,OAAA,GAAS,oBAAA,GAA4B,oBAAA"}

package/dist/server/create.d.ts

@@ -27,6 +27,8 @@ interface OpenAPIServer {
   createProxy: typeof createProxy;
   getSchemas: () => Promise<ProcessedSchemaMap>;
   getSchema: (document: string) => Promise<ProcessedDocument>;
+  /** @private internal API */
+  _getWatchPaths: () => string[];
   readonly options: OpenAPIOptions;
 }
 declare function createOpenAPI(options?: OpenAPIOptions): OpenAPIServer;

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

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/server/create.ts"],"mappings":";;;;;;;;AAGsE;KAKjE,SAAA,GAAY,MAAA,kBAAwB,QAAA;AAAA,KACpC,kBAAA,GAAqB,MAAA,SAAe,iBAAA;AAAA,UAExB,cAAA;EAHgC;AAAA;;;;;EAU/C,KAAA,qBAA0B,SAAA,GAAY,OAAA,CAAQ,SAAA;EAE9C,YAAA;;;;EAKA,QAAA;AAAA;AAAA,UAGe,aAAA;EACf,WAAA,SAAoB,WAAA;EACpB,UAAA,QAAkB,OAAA,CAAQ,kBAAA;EAC1B,SAAA,GAAY,QAAA,aAAqB,OAAA,CAAQ,iBAAA;EAAA,SAChC,OAAA,EAAS,cAAA;AAAA;AAAA,iBAGJ,aAAA,CAAc,OAAA,GAAS,cAAA,GAAsB,aAAA;;;AAP7D;iBAuDgB,gBAAA,GAAA,CACd,OAAA,EAAS,wBAAA,CAAyB,CAAA,IACjC,wBAAA,CAAyB,CAAA"}
+{"version":3,"file":"create.d.ts","names":[],"sources":["../../src/server/create.ts"],"mappings":";;;;;;;;AAGsE;KAMjE,SAAA,GAAY,MAAA,kBAAwB,QAAA;AAAA,KACpC,kBAAA,GAAqB,MAAA,SAAe,iBAAA;AAAA,UAExB,cAAA;EAHgC;AAAA;;;;;EAU/C,KAAA,qBAA0B,SAAA,GAAY,OAAA,CAAQ,SAAA;EAE9C,YAAA;;;;EAKA,QAAA;AAAA;AAAA,UAGe,aAAA;EACf,WAAA,SAAoB,WAAA;EACpB,UAAA,QAAkB,OAAA,CAAQ,kBAAA;EAC1B,SAAA,GAAY,QAAA,aAAqB,OAAA,CAAQ,iBAAA;EAbK;EAe9C,cAAA;EAAA,SACS,OAAA,EAAS,cAAA;AAAA;AAAA,iBAGJ,aAAA,CAAc,OAAA,GAAS,cAAA,GAAsB,aAAA;AAT7D;;;AAAA,iBAuDgB,gBAAA,GAAA,CACd,OAAA,EAAS,wBAAA,CAAyB,CAAA,IACjC,wBAAA,CAAyB,CAAA"}

package/dist/server/create.js

@@ -1,22 +1,25 @@
 import { createProxy } from "./proxy.js";
 import { processDocument } from "../utils/process-document.js";
+import fs from "node:fs";
 //#region src/server/create.ts
 function createOpenAPI(options = {}) {
 	const { input = [], disableCache = false } = options;
 	let schemas;
 	async function getSchemas() {
-		const out = {};
-		if (Array.isArray(input)) await Promise.all(input.map(async (item) => {
-			out[item] = await processDocument(item);
-		}));
-		else await Promise.all(Object.entries(await input()).map(async ([k, v]) => {
-			out[k] = await processDocument(v);
-		}));
-		return out;
+		if (Array.isArray(input)) {
+			const entries = await Promise.all(input.map(async (item) => [item, await processDocument(item)]));
+			return Object.fromEntries(entries);
+		} else {
+			const entries = await Promise.all(Object.entries(await input()).map(async ([k, v]) => [k, await processDocument(v)]));
+			return Object.fromEntries(entries);
+		}
 	}
 	return {
 		options,
 		createProxy,
+		_getWatchPaths() {
+			return (Array.isArray(input) ? input : Object.keys(input)).filter((key) => !URL.canParse(key) && fs.existsSync(key));
+		},
 		async getSchema(document) {
 			const schemas = await this.getSchemas();
 			if (document in schemas) return schemas[document];

package/dist/server/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","names":[],"sources":["../../src/server/create.ts"],"sourcesContent":["import { createProxy } from '@/server/proxy';\nimport { processDocument, type ProcessedDocument } from '@/utils/process-document';\nimport type { Document } from '@/types';\nimport type { InlineCodeUsageGenerator } from '@/requests/generators';\n\n/**\n * schema id -> file path, URL, or downloaded schema object\n */\ntype SchemaMap = Record<string, string | Document>;\ntype ProcessedSchemaMap = Record<string, ProcessedDocument>;\n\nexport interface OpenAPIOptions {\n  /**\n   * Schema files, can be:\n   * - URL\n   * - file path\n   * - a function returning records of downloaded schemas.\n   */\n  input?: string[] | (() => SchemaMap | Promise<SchemaMap>);\n\n  disableCache?: boolean;\n\n  /**\n   * The url of proxy to avoid CORS issues\n   */\n  proxyUrl?: string;\n}\n\nexport interface OpenAPIServer {\n  createProxy: typeof createProxy;\n  getSchemas: () => Promise<ProcessedSchemaMap>;\n  getSchema: (document: string) => Promise<ProcessedDocument>;\n  readonly options: OpenAPIOptions;\n}\n\nexport function createOpenAPI(options: OpenAPIOptions = {}): OpenAPIServer {\n  const { input = [], disableCache = false } = options;\n  let schemas: Promise<ProcessedSchemaMap> | undefined;\n\n  async function getSchemas() {\n    const out: ProcessedSchemaMap = {};\n\n    if (Array.isArray(input)) {\n      await Promise.all(\n        input.map(async (item) => {\n          out[item] = await processDocument(item);\n        }),\n      );\n    } else {\n      await Promise.all(\n        Object.entries(await input()).map(async ([k, v]) => {\n          out[k] = await processDocument(v);\n        }),\n      );\n    }\n\n    return out;\n  }\n\n  return {\n    options,\n    createProxy,\n    async getSchema(document) {\n      const schemas = await this.getSchemas();\n      if (document in schemas) return schemas[document];\n\n      console.warn(\n        `[Fumadocs OpenAPI] the document \"${document}\" is not listed in the input array, this may not be expected.`,\n      );\n      // do not cache unlisted documents\n      return processDocument(document);\n    },\n    async getSchemas() {\n      if (disableCache) return getSchemas();\n\n      return (schemas ??= getSchemas());\n    },\n  };\n}\n\n/**\n * @deprecated\n */\nexport function createCodeSample<T>(\n  options: InlineCodeUsageGenerator<T>,\n): InlineCodeUsageGenerator<T> {\n  return options;\n}\n"],"mappings":";;;AAmCA,SAAgB,cAAc,UAA0B,EAAE,EAAiB;CACzE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,UAAU;CAC7C,IAAI;CAEJ,eAAe,aAAa;EAC1B,MAAM,MAA0B,EAAE;AAElC,MAAI,MAAM,QAAQ,MAAM,CACtB,OAAM,QAAQ,IACZ,MAAM,IAAI,OAAO,SAAS;AACxB,OAAI,QAAQ,MAAM,gBAAgB,KAAK;IACvC,CACH;MAED,OAAM,QAAQ,IACZ,OAAO,QAAQ,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,OAAO;AAClD,OAAI,KAAK,MAAM,gBAAgB,EAAE;IACjC,CACH;AAGH,SAAO;;AAGT,QAAO;EACL;EACA;EACA,MAAM,UAAU,UAAU;GACxB,MAAM,UAAU,MAAM,KAAK,YAAY;AACvC,OAAI,YAAY,QAAS,QAAO,QAAQ;AAExC,WAAQ,KACN,oCAAoC,SAAS,+DAC9C;AAED,UAAO,gBAAgB,SAAS;;EAElC,MAAM,aAAa;AACjB,OAAI,aAAc,QAAO,YAAY;AAErC,UAAQ,YAAY,YAAY;;EAEnC;;;;;AAMH,SAAgB,iBACd,SAC6B;AAC7B,QAAO"}
+{"version":3,"file":"create.js","names":[],"sources":["../../src/server/create.ts"],"sourcesContent":["import { createProxy } from '@/server/proxy';\nimport { processDocument, type ProcessedDocument } from '@/utils/process-document';\nimport type { Document } from '@/types';\nimport type { InlineCodeUsageGenerator } from '@/requests/generators';\nimport fs from 'node:fs';\n\n/**\n * schema id -> file path, URL, or downloaded schema object\n */\ntype SchemaMap = Record<string, string | Document>;\ntype ProcessedSchemaMap = Record<string, ProcessedDocument>;\n\nexport interface OpenAPIOptions {\n  /**\n   * Schema files, can be:\n   * - URL\n   * - file path\n   * - a function returning records of downloaded schemas.\n   */\n  input?: string[] | (() => SchemaMap | Promise<SchemaMap>);\n\n  disableCache?: boolean;\n\n  /**\n   * The url of proxy to avoid CORS issues\n   */\n  proxyUrl?: string;\n}\n\nexport interface OpenAPIServer {\n  createProxy: typeof createProxy;\n  getSchemas: () => Promise<ProcessedSchemaMap>;\n  getSchema: (document: string) => Promise<ProcessedDocument>;\n  /** @private internal API */\n  _getWatchPaths: () => string[];\n  readonly options: OpenAPIOptions;\n}\n\nexport function createOpenAPI(options: OpenAPIOptions = {}): OpenAPIServer {\n  const { input = [], disableCache = false } = options;\n  let schemas: Promise<ProcessedSchemaMap> | undefined;\n\n  async function getSchemas(): Promise<ProcessedSchemaMap> {\n    if (Array.isArray(input)) {\n      const entries = await Promise.all(\n        input.map(async (item) => [item, await processDocument(item)]),\n      );\n      return Object.fromEntries(entries);\n    } else {\n      const entries = await Promise.all(\n        Object.entries(await input()).map(async ([k, v]) => [k, await processDocument(v)]),\n      );\n      return Object.fromEntries(entries);\n    }\n  }\n\n  return {\n    options,\n    createProxy,\n    _getWatchPaths() {\n      const keys = Array.isArray(input) ? input : Object.keys(input);\n      return keys.filter((key) => !URL.canParse(key) && fs.existsSync(key));\n    },\n    async getSchema(document) {\n      const schemas = await this.getSchemas();\n      if (document in schemas) return schemas[document];\n\n      console.warn(\n        `[Fumadocs OpenAPI] the document \"${document}\" is not listed in the input array, this may not be expected.`,\n      );\n      // do not cache unlisted documents\n      return processDocument(document);\n    },\n    async getSchemas() {\n      if (disableCache) return getSchemas();\n\n      return (schemas ??= getSchemas());\n    },\n  };\n}\n\n/**\n * @deprecated\n */\nexport function createCodeSample<T>(\n  options: InlineCodeUsageGenerator<T>,\n): InlineCodeUsageGenerator<T> {\n  return options;\n}\n"],"mappings":";;;;AAsCA,SAAgB,cAAc,UAA0B,EAAE,EAAiB;CACzE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,UAAU;CAC7C,IAAI;CAEJ,eAAe,aAA0C;AACvD,MAAI,MAAM,QAAQ,MAAM,EAAE;GACxB,MAAM,UAAU,MAAM,QAAQ,IAC5B,MAAM,IAAI,OAAO,SAAS,CAAC,MAAM,MAAM,gBAAgB,KAAK,CAAC,CAAC,CAC/D;AACD,UAAO,OAAO,YAAY,QAAQ;SAC7B;GACL,MAAM,UAAU,MAAM,QAAQ,IAC5B,OAAO,QAAQ,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,MAAM,gBAAgB,EAAE,CAAC,CAAC,CACnF;AACD,UAAO,OAAO,YAAY,QAAQ;;;AAItC,QAAO;EACL;EACA;EACA,iBAAiB;AAEf,WADa,MAAM,QAAQ,MAAM,GAAG,QAAQ,OAAO,KAAK,MAAM,EAClD,QAAQ,QAAQ,CAAC,IAAI,SAAS,IAAI,IAAI,GAAG,WAAW,IAAI,CAAC;;EAEvE,MAAM,UAAU,UAAU;GACxB,MAAM,UAAU,MAAM,KAAK,YAAY;AACvC,OAAI,YAAY,QAAS,QAAO,QAAQ;AAExC,WAAQ,KACN,oCAAoC,SAAS,+DAC9C;AAED,UAAO,gBAAgB,SAAS;;EAElC,MAAM,aAAa;AACjB,OAAI,aAAc,QAAO,YAAY;AAErC,UAAQ,YAAY,YAAY;;EAEnC;;;;;AAMH,SAAgB,iBACd,SAC6B;AAC7B,QAAO"}

package/dist/server/proxy.d.ts

@@ -1,6 +1,9 @@
 //#region src/server/proxy.d.ts
-declare const keys: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD"];
-type Proxy = { [K in (typeof keys)[number]]: (req: Request) => Promise<Response> };
+declare const methods: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD"];
+type Handler = (req: Request) => Promise<Response>;
+interface Proxy extends Record<(typeof methods)[number], Handler> {
+  handle: Handler;
+}
 interface CreateProxyOptions {
   /**
    * Filter by prefixes of request url

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

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","names":[],"sources":["../../src/server/proxy.ts"],"mappings":";cAAM,IAAA;AAAA,KAED,KAAA,mBACW,IAAA,aAAiB,GAAA,EAAK,OAAA,KAAY,OAAA,CAAQ,QAAA;AAAA,UAGhD,kBAAA;EAN6D;AAAA;;;;EAYrE,WAAA;EATwD;;;EAcxD,cAAA;EAdC;;;;;EAqBD,aAAA,IAAiB,OAAA,EAAS,OAAA;EArBsC;;AAAA;EA0BhE,SAAA;IACE,OAAA,IAAW,OAAA,EAAS,OAAA,KAAY,OAAA;IAChC,QAAA,IAAY,QAAA,EAAU,QAAA,KAAa,QAAA;EAAA;AAAA;AAAA,iBAIvB,WAAA,CAAY,OAAA,GAAS,kBAAA,GAA0B,KAAA"}
+{"version":3,"file":"proxy.d.ts","names":[],"sources":["../../src/server/proxy.ts"],"mappings":";cAAM,OAAA;AAAA,KAGD,OAAA,IAAW,GAAA,EAAK,OAAA,KAAY,OAAA,CAAQ,QAAA;AAAA,UAExB,KAAA,SAAc,MAAA,SAAe,OAAA,WAAkB,OAAA;EAC9D,MAAA,EAAQ,OAAA;AAAA;AAAA,UAGO,kBAAA;EANZ;;;;;EAYH,WAAA;EAZsC;;;EAiBtC,cAAA;EAjB+B;;;;AAEjC;EAsBE,aAAA,IAAiB,OAAA,EAAS,OAAA;;;;EAK1B,SAAA;IACE,OAAA,IAAW,OAAA,EAAS,OAAA,KAAY,OAAA;IAChC,QAAA,IAAY,QAAA,EAAU,QAAA,KAAa,QAAA;EAAA;AAAA;AAAA,iBAIvB,WAAA,CAAY,OAAA,GAAS,kBAAA,GAA0B,KAAA"}

package/dist/server/proxy.js

@@ -1,5 +1,5 @@
 //#region src/server/proxy.ts
-const keys = [
+const methods = [
 	"GET",
 	"POST",
 	"PUT",
@@ -7,50 +7,60 @@ const keys = [
 	"PATCH",
 	"HEAD"
 ];
+const methodsWithBody = new Set([
+	"POST",
+	"PUT",
+	"PATCH",
+	"DELETE"
+]);
 function createProxy(options = {}) {
 	const { allowedOrigins, allowedUrls, filterRequest = (req) => {
 		return !allowedUrls || allowedUrls.some((item) => req.url.startsWith(item));
 	}, overrides } = options;
-	const handlers = {};
+	const handlers = { handle: handler };
 	async function handler(req) {
-		const url = new URL(req.url).searchParams.get("url");
-		if (!url) return Response.json("[Proxy] A `url` query parameter is required for proxy url", { status: 400 });
-		const parsedUrl = URL.parse(url);
-		if (!parsedUrl) return Response.json("[Proxy] Invalid `url` parameter value.", { status: 400 });
-		if (allowedOrigins && !allowedOrigins.includes(parsedUrl.origin)) return Response.json(`[Proxy] The origin "${parsedUrl.origin}" is not allowed.`, { status: 400 });
-		const contentLength = req.headers.get("content-length");
+		const searchParams = new URL(req.url).searchParams;
+		const rawUrl = searchParams.get("url");
+		if (!rawUrl) return Response.json("[Proxy] A `url` query parameter is required for proxy url", { status: 400 });
+		const targetUrl = URL.parse(rawUrl);
+		if (!targetUrl) return Response.json("[Proxy] Invalid `url` parameter value.", { status: 400 });
+		if (allowedOrigins && !allowedOrigins.includes(targetUrl.origin)) return Response.json(`[Proxy] The origin "${targetUrl.origin}" is not allowed.`, { status: 400 });
+		const proxied = await rewriteRequest(req, targetUrl, searchParams.get("cookie"));
+		if (!filterRequest(proxied)) return Response.json("[Proxy] The proxied request is not allowed", { status: 403 });
+		try {
+			return rewriteResponse(await fetch(proxied));
+		} catch (err) {
+			return Response.json(`[Proxy] Failed to proxy request: ${err instanceof Error ? err.message : "unknown reason"}`, { status: 500 });
+		}
+	}
+	async function rewriteRequest(request, url, cookie) {
+		const headers = new Headers(request.headers);
+		headers.delete("origin");
+		if (cookie) headers.set("Cookie", cookie);
+		const contentLength = headers.get("content-length");
 		const hasBody = contentLength && parseInt(contentLength) > 0;
-		let proxied = new Request(parsedUrl, {
-			method: req.method,
+		const proxied = new Request(url, {
+			method: request.method,
 			cache: "no-cache",
-			headers: req.headers,
-			body: hasBody && [
-				"POST",
-				"PUT",
-				"PATCH",
-				"DELETE"
-			].includes(req.method.toUpperCase()) ? await req.arrayBuffer() : void 0
-		});
-		if (overrides?.request) proxied = overrides.request(proxied);
-		if (!filterRequest(proxied)) return Response.json("[Proxy] The proxied request is not allowed", { status: 403 });
-		proxied.headers.forEach((_value, originalKey) => {
-			if (originalKey.toLowerCase() === "origin") proxied.headers.delete(originalKey);
+			headers,
+			body: hasBody && methodsWithBody.has(request.method.toUpperCase()) ? await request.arrayBuffer() : void 0
 		});
-		let res = await fetch(proxied).catch((e) => new Error(e.toString()));
-		if (res instanceof Error) return Response.json(`[Proxy] Failed to proxy request: ${res.message}`, { status: 500 });
-		if (overrides?.response) res = overrides.response(res);
-		const headers = new Headers(res.headers);
+		return overrides?.request ? overrides.request(proxied) : proxied;
+	}
+	async function rewriteResponse(response) {
+		if (overrides?.response) response = overrides.response(response);
+		const headers = new Headers(response.headers);
 		headers.forEach((_value, originalKey) => {
 			if (originalKey.toLowerCase().startsWith("access-control-")) headers.delete(originalKey);
 		});
-		headers.set("X-Forwarded-Host", res.url);
-		return new Response(res.body, {
-			status: res.status,
-			statusText: res.statusText,
+		headers.set("X-Forwarded-Host", response.url);
+		return new Response(response.body, {
+			status: response.status,
+			statusText: response.statusText,
 			headers
 		});
 	}
-	for (const key of keys) handlers[key] = handler;
+	for (const key of methods) handlers[key] = handler;
 	return handlers;
 }
 //#endregion

package/dist/server/proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.js","names":[],"sources":["../../src/server/proxy.ts"],"sourcesContent":["const keys = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD'] as const;\n\ntype Proxy = {\n  [K in (typeof keys)[number]]: (req: Request) => Promise<Response>;\n};\n\ninterface CreateProxyOptions {\n  /**\n   * Filter by prefixes of request url\n   *\n   * @deprecated Use `allowedOrigins` for filtering origins, or `filterRequest` for more detailed rules.\n   */\n  allowedUrls?: string[];\n\n  /**\n   * List of allowed origins to proxy to.\n   */\n  allowedOrigins?: string[];\n\n  /**\n   * Determine if the proxied request is allowed.\n   *\n   * @returns true if allowed, otherwise forbidden.\n   */\n  filterRequest?: (request: Request) => boolean;\n\n  /**\n   * Override proxied request/response with yours\n   */\n  overrides?: {\n    request?: (request: Request) => Request;\n    response?: (response: Response) => Response;\n  };\n}\n\nexport function createProxy(options: CreateProxyOptions = {}): Proxy {\n  const {\n    allowedOrigins,\n    allowedUrls,\n    filterRequest = (req) => {\n      return !allowedUrls || allowedUrls.some((item) => req.url.startsWith(item));\n    },\n    overrides,\n  } = options;\n  const handlers: Partial<Proxy> = {};\n\n  async function handler(req: Request): Promise<Response> {\n    const searchParams = new URL(req.url).searchParams;\n    const url = searchParams.get('url');\n\n    if (!url)\n      return Response.json('[Proxy] A `url` query parameter is required for proxy url', {\n        status: 400,\n      });\n\n    const parsedUrl = URL.parse(url);\n    if (!parsedUrl)\n      return Response.json('[Proxy] Invalid `url` parameter value.', {\n        status: 400,\n      });\n\n    if (allowedOrigins && !allowedOrigins.includes(parsedUrl.origin)) {\n      return Response.json(`[Proxy] The origin \"${parsedUrl.origin}\" is not allowed.`, {\n        status: 400,\n      });\n    }\n\n    const contentLength = req.headers.get('content-length');\n    const hasBody = contentLength && parseInt(contentLength) > 0;\n\n    let proxied = new Request(parsedUrl, {\n      method: req.method,\n      cache: 'no-cache',\n      headers: req.headers,\n      body:\n        hasBody && ['POST', 'PUT', 'PATCH', 'DELETE'].includes(req.method.toUpperCase())\n          ? await req.arrayBuffer()\n          : undefined,\n    });\n\n    if (overrides?.request) {\n      proxied = overrides.request(proxied);\n    }\n\n    if (!filterRequest(proxied)) {\n      return Response.json('[Proxy] The proxied request is not allowed', {\n        status: 403,\n      });\n    }\n\n    proxied.headers.forEach((_value, originalKey) => {\n      const key = originalKey.toLowerCase();\n\n      if (key === 'origin') {\n        proxied.headers.delete(originalKey);\n      }\n    });\n\n    let res = await fetch(proxied).catch((e) => new Error(e.toString()));\n    if (res instanceof Error) {\n      return Response.json(`[Proxy] Failed to proxy request: ${res.message}`, {\n        status: 500,\n      });\n    }\n\n    if (overrides?.response) {\n      res = overrides.response(res);\n    }\n\n    const headers = new Headers(res.headers);\n    headers.forEach((_value, originalKey) => {\n      const key = originalKey.toLowerCase();\n\n      if (key.startsWith('access-control-')) {\n        headers.delete(originalKey);\n      }\n    });\n    headers.set('X-Forwarded-Host', res.url);\n\n    return new Response(res.body, {\n      status: res.status,\n      statusText: res.statusText,\n      headers,\n    });\n  }\n\n  for (const key of keys) {\n    handlers[key] = handler;\n  }\n\n  return handlers as Proxy;\n}\n"],"mappings":";AAAA,MAAM,OAAO;CAAC;CAAO;CAAQ;CAAO;CAAU;CAAS;CAAO;AAmC9D,SAAgB,YAAY,UAA8B,EAAE,EAAS;CACnE,MAAM,EACJ,gBACA,aACA,iBAAiB,QAAQ;AACvB,SAAO,CAAC,eAAe,YAAY,MAAM,SAAS,IAAI,IAAI,WAAW,KAAK,CAAC;IAE7E,cACE;CACJ,MAAM,WAA2B,EAAE;CAEnC,eAAe,QAAQ,KAAiC;EAEtD,MAAM,MADe,IAAI,IAAI,IAAI,IAAI,CAAC,aACb,IAAI,MAAM;AAEnC,MAAI,CAAC,IACH,QAAO,SAAS,KAAK,6DAA6D,EAChF,QAAQ,KACT,CAAC;EAEJ,MAAM,YAAY,IAAI,MAAM,IAAI;AAChC,MAAI,CAAC,UACH,QAAO,SAAS,KAAK,0CAA0C,EAC7D,QAAQ,KACT,CAAC;AAEJ,MAAI,kBAAkB,CAAC,eAAe,SAAS,UAAU,OAAO,CAC9D,QAAO,SAAS,KAAK,uBAAuB,UAAU,OAAO,oBAAoB,EAC/E,QAAQ,KACT,CAAC;EAGJ,MAAM,gBAAgB,IAAI,QAAQ,IAAI,iBAAiB;EACvD,MAAM,UAAU,iBAAiB,SAAS,cAAc,GAAG;EAE3D,IAAI,UAAU,IAAI,QAAQ,WAAW;GACnC,QAAQ,IAAI;GACZ,OAAO;GACP,SAAS,IAAI;GACb,MACE,WAAW;IAAC;IAAQ;IAAO;IAAS;IAAS,CAAC,SAAS,IAAI,OAAO,aAAa,CAAC,GAC5E,MAAM,IAAI,aAAa,GACvB,KAAA;GACP,CAAC;AAEF,MAAI,WAAW,QACb,WAAU,UAAU,QAAQ,QAAQ;AAGtC,MAAI,CAAC,cAAc,QAAQ,CACzB,QAAO,SAAS,KAAK,8CAA8C,EACjE,QAAQ,KACT,CAAC;AAGJ,UAAQ,QAAQ,SAAS,QAAQ,gBAAgB;AAG/C,OAFY,YAAY,aAAa,KAEzB,SACV,SAAQ,QAAQ,OAAO,YAAY;IAErC;EAEF,IAAI,MAAM,MAAM,MAAM,QAAQ,CAAC,OAAO,MAAM,IAAI,MAAM,EAAE,UAAU,CAAC,CAAC;AACpE,MAAI,eAAe,MACjB,QAAO,SAAS,KAAK,oCAAoC,IAAI,WAAW,EACtE,QAAQ,KACT,CAAC;AAGJ,MAAI,WAAW,SACb,OAAM,UAAU,SAAS,IAAI;EAG/B,MAAM,UAAU,IAAI,QAAQ,IAAI,QAAQ;AACxC,UAAQ,SAAS,QAAQ,gBAAgB;AAGvC,OAFY,YAAY,aAAa,CAE7B,WAAW,kBAAkB,CACnC,SAAQ,OAAO,YAAY;IAE7B;AACF,UAAQ,IAAI,oBAAoB,IAAI,IAAI;AAExC,SAAO,IAAI,SAAS,IAAI,MAAM;GAC5B,QAAQ,IAAI;GACZ,YAAY,IAAI;GAChB;GACD,CAAC;;AAGJ,MAAK,MAAM,OAAO,KAChB,UAAS,OAAO;AAGlB,QAAO"}
+{"version":3,"file":"proxy.js","names":[],"sources":["../../src/server/proxy.ts"],"sourcesContent":["const methods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD'] as const;\nconst methodsWithBody = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);\n\ntype Handler = (req: Request) => Promise<Response>;\n\nexport interface Proxy extends Record<(typeof methods)[number], Handler> {\n  handle: Handler;\n}\n\nexport interface CreateProxyOptions {\n  /**\n   * Filter by prefixes of request url\n   *\n   * @deprecated Use `allowedOrigins` for filtering origins, or `filterRequest` for more detailed rules.\n   */\n  allowedUrls?: string[];\n\n  /**\n   * List of allowed origins to proxy to.\n   */\n  allowedOrigins?: string[];\n\n  /**\n   * Determine if the proxied request is allowed.\n   *\n   * @returns true if allowed, otherwise forbidden.\n   */\n  filterRequest?: (request: Request) => boolean;\n\n  /**\n   * Override proxied request/response with yours\n   */\n  overrides?: {\n    request?: (request: Request) => Request;\n    response?: (response: Response) => Response;\n  };\n}\n\nexport function createProxy(options: CreateProxyOptions = {}): Proxy {\n  const {\n    allowedOrigins,\n    allowedUrls,\n    filterRequest = (req) => {\n      return !allowedUrls || allowedUrls.some((item) => req.url.startsWith(item));\n    },\n    overrides,\n  } = options;\n  const handlers: Partial<Proxy> = {\n    handle: handler,\n  };\n\n  async function handler(req: Request): Promise<Response> {\n    const searchParams = new URL(req.url).searchParams;\n    const rawUrl = searchParams.get('url');\n\n    if (!rawUrl)\n      return Response.json('[Proxy] A `url` query parameter is required for proxy url', {\n        status: 400,\n      });\n\n    const targetUrl = URL.parse(rawUrl);\n    if (!targetUrl)\n      return Response.json('[Proxy] Invalid `url` parameter value.', {\n        status: 400,\n      });\n\n    if (allowedOrigins && !allowedOrigins.includes(targetUrl.origin)) {\n      return Response.json(`[Proxy] The origin \"${targetUrl.origin}\" is not allowed.`, {\n        status: 400,\n      });\n    }\n\n    const proxied = await rewriteRequest(req, targetUrl, searchParams.get('cookie'));\n\n    if (!filterRequest(proxied)) {\n      return Response.json('[Proxy] The proxied request is not allowed', {\n        status: 403,\n      });\n    }\n\n    try {\n      return rewriteResponse(await fetch(proxied));\n    } catch (err) {\n      return Response.json(\n        `[Proxy] Failed to proxy request: ${err instanceof Error ? err.message : 'unknown reason'}`,\n        {\n          status: 500,\n        },\n      );\n    }\n  }\n\n  async function rewriteRequest(\n    request: Request,\n    url: URL,\n    cookie: string | null,\n  ): Promise<Request> {\n    const headers = new Headers(request.headers);\n    headers.delete('origin');\n    if (cookie) {\n      headers.set('Cookie', cookie);\n    }\n\n    const contentLength = headers.get('content-length');\n    const hasBody = contentLength && parseInt(contentLength) > 0;\n\n    const proxied = new Request(url, {\n      method: request.method,\n      cache: 'no-cache',\n      headers,\n      body:\n        hasBody && methodsWithBody.has(request.method.toUpperCase())\n          ? await request.arrayBuffer()\n          : undefined,\n    });\n\n    return overrides?.request ? overrides.request(proxied) : proxied;\n  }\n\n  async function rewriteResponse(response: Response): Promise<Response> {\n    if (overrides?.response) {\n      response = overrides.response(response);\n    }\n\n    const headers = new Headers(response.headers);\n    headers.forEach((_value, originalKey) => {\n      const key = originalKey.toLowerCase();\n\n      if (key.startsWith('access-control-')) {\n        headers.delete(originalKey);\n      }\n    });\n    headers.set('X-Forwarded-Host', response.url);\n\n    return new Response(response.body, {\n      status: response.status,\n      statusText: response.statusText,\n      headers,\n    });\n  }\n\n  for (const key of methods) {\n    handlers[key] = handler;\n  }\n\n  return handlers as Proxy;\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAO;CAAQ;CAAO;CAAU;CAAS;CAAO;AACjE,MAAM,kBAAkB,IAAI,IAAI;CAAC;CAAQ;CAAO;CAAS;CAAS,CAAC;AAqCnE,SAAgB,YAAY,UAA8B,EAAE,EAAS;CACnE,MAAM,EACJ,gBACA,aACA,iBAAiB,QAAQ;AACvB,SAAO,CAAC,eAAe,YAAY,MAAM,SAAS,IAAI,IAAI,WAAW,KAAK,CAAC;IAE7E,cACE;CACJ,MAAM,WAA2B,EAC/B,QAAQ,SACT;CAED,eAAe,QAAQ,KAAiC;EACtD,MAAM,eAAe,IAAI,IAAI,IAAI,IAAI,CAAC;EACtC,MAAM,SAAS,aAAa,IAAI,MAAM;AAEtC,MAAI,CAAC,OACH,QAAO,SAAS,KAAK,6DAA6D,EAChF,QAAQ,KACT,CAAC;EAEJ,MAAM,YAAY,IAAI,MAAM,OAAO;AACnC,MAAI,CAAC,UACH,QAAO,SAAS,KAAK,0CAA0C,EAC7D,QAAQ,KACT,CAAC;AAEJ,MAAI,kBAAkB,CAAC,eAAe,SAAS,UAAU,OAAO,CAC9D,QAAO,SAAS,KAAK,uBAAuB,UAAU,OAAO,oBAAoB,EAC/E,QAAQ,KACT,CAAC;EAGJ,MAAM,UAAU,MAAM,eAAe,KAAK,WAAW,aAAa,IAAI,SAAS,CAAC;AAEhF,MAAI,CAAC,cAAc,QAAQ,CACzB,QAAO,SAAS,KAAK,8CAA8C,EACjE,QAAQ,KACT,CAAC;AAGJ,MAAI;AACF,UAAO,gBAAgB,MAAM,MAAM,QAAQ,CAAC;WACrC,KAAK;AACZ,UAAO,SAAS,KACd,oCAAoC,eAAe,QAAQ,IAAI,UAAU,oBACzE,EACE,QAAQ,KACT,CACF;;;CAIL,eAAe,eACb,SACA,KACA,QACkB;EAClB,MAAM,UAAU,IAAI,QAAQ,QAAQ,QAAQ;AAC5C,UAAQ,OAAO,SAAS;AACxB,MAAI,OACF,SAAQ,IAAI,UAAU,OAAO;EAG/B,MAAM,gBAAgB,QAAQ,IAAI,iBAAiB;EACnD,MAAM,UAAU,iBAAiB,SAAS,cAAc,GAAG;EAE3D,MAAM,UAAU,IAAI,QAAQ,KAAK;GAC/B,QAAQ,QAAQ;GAChB,OAAO;GACP;GACA,MACE,WAAW,gBAAgB,IAAI,QAAQ,OAAO,aAAa,CAAC,GACxD,MAAM,QAAQ,aAAa,GAC3B,KAAA;GACP,CAAC;AAEF,SAAO,WAAW,UAAU,UAAU,QAAQ,QAAQ,GAAG;;CAG3D,eAAe,gBAAgB,UAAuC;AACpE,MAAI,WAAW,SACb,YAAW,UAAU,SAAS,SAAS;EAGzC,MAAM,UAAU,IAAI,QAAQ,SAAS,QAAQ;AAC7C,UAAQ,SAAS,QAAQ,gBAAgB;AAGvC,OAFY,YAAY,aAAa,CAE7B,WAAW,kBAAkB,CACnC,SAAQ,OAAO,YAAY;IAE7B;AACF,UAAQ,IAAI,oBAAoB,SAAS,IAAI;AAE7C,SAAO,IAAI,SAAS,SAAS,MAAM;GACjC,QAAQ,SAAS;GACjB,YAAY,SAAS;GACrB;GACD,CAAC;;AAGJ,MAAK,MAAM,OAAO,QAChB,UAAS,OAAO;AAGlB,QAAO"}