@scalar/api-client 2.38.4 → 2.39.1

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.js

@@ -0,0 +1,41 @@
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { isObject } from "@scalar/helpers/object/is-object";
+import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
+//#region src/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.ts
+/**
+* Recursively resolves all $ref objects in a data structure to their actual values.
+* Traverses through objects, arrays, and nested structures to find and resolve
+* any $ref references at any depth level.
+*
+* Handles circular references gracefully by detecting them and returning '[circular]'
+* to prevent infinite loops.
+*/
+var getResolvedRefDeep = (node) => {
+	const visited = /* @__PURE__ */ new WeakSet();
+	const cachedResults = /* @__PURE__ */ new WeakMap();
+	const resolveNode = (current) => {
+		if (!isObject(current) && !Array.isArray(current)) return current;
+		const rawValue = unpackProxyObject(current, { depth: 1 });
+		if (cachedResults.has(rawValue)) return cachedResults.get(rawValue);
+		if (visited.has(rawValue)) return "[circular]";
+		visited.add(rawValue);
+		if ("$ref" in current) {
+			const result = resolveNode(getResolvedRef(current));
+			cachedResults.set(rawValue, result);
+			return result;
+		}
+		if (Array.isArray(current)) {
+			const result = current.map(resolveNode);
+			cachedResults.set(rawValue, result);
+			return result;
+		}
+		const result = Object.fromEntries(Object.entries(current).map(([key, value]) => [key, resolveNode(value)]));
+		cachedResults.set(rawValue, result);
+		return result;
+	};
+	return resolveNode(node);
+};
+//#endregion
+export { getResolvedRefDeep };
+
+//# sourceMappingURL=get-resolved-ref-deep.js.map

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-resolved-ref-deep.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.ts"],"sourcesContent":["import { isObject } from '@scalar/helpers/object/is-object'\nimport { type Dereference, getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\n\ntype RefNode<Node> = Partial<Node> & { $ref: string; '$ref-value': Node | RefNode<Node> }\ntype NodeInput<Node> = Node | RefNode<Node>\n\n/**\n * Recursively resolves $ref objects\n * This type helper ensures proper typing for deeply nested ref resolution.\n * Properties that could contain $ref objects may resolve to '[circular]' if we have a circular reference.\n */\ntype DeepDereference<T> = Dereference<T> extends T\n  ? T extends readonly (infer U)[]\n    ? DeepDereference<U>[]\n    : T extends object\n      ? { [K in keyof T]: T[K] extends RefNode<any> ? DeepDereference<T[K]> | '[circular]' : DeepDereference<T[K]> }\n      : T\n  : Dereference<T> extends object\n    ? {\n        [K in keyof Dereference<T>]: Dereference<T>[K] extends RefNode<any>\n          ? DeepDereference<Dereference<T>[K]> | '[circular]'\n          : DeepDereference<Dereference<T>[K]>\n      }\n    : Dereference<T>\n\n/**\n * Recursively resolves all $ref objects in a data structure to their actual values.\n * Traverses through objects, arrays, and nested structures to find and resolve\n * any $ref references at any depth level.\n *\n * Handles circular references gracefully by detecting them and returning '[circular]'\n * to prevent infinite loops.\n */\nexport const getResolvedRefDeep = <Node>(node: NodeInput<Node>): DeepDereference<NodeInput<Node>> => {\n  const visited = new WeakSet<object>()\n  const cachedResults = new WeakMap<object, any>()\n\n  const resolveNode = (current: any): any => {\n    // Only recurse into objects and arrays; return primitives as-is\n    if (!isObject(current) && !Array.isArray(current)) {\n      return current\n    }\n\n    const rawValue = unpackProxyObject(current, { depth: 1 })\n\n    // We don't have to recurse into the same object again\n    // This helps us having to manually remove the tracked node after we recurse into the tree\n    if (cachedResults.has(rawValue)) {\n      return cachedResults.get(rawValue)\n    }\n\n    // Break circular references\n    if (visited.has(rawValue)) {\n      return '[circular]'\n    }\n\n    // Track visited nodes\n    visited.add(rawValue)\n\n    if ('$ref' in current) {\n      const resolved = getResolvedRef(current)\n      const result = resolveNode(resolved)\n      cachedResults.set(rawValue, result)\n      return result\n    }\n\n    // For arrays\n    if (Array.isArray(current)) {\n      const result = current.map(resolveNode)\n      cachedResults.set(rawValue, result)\n      return result\n    }\n\n    const result = Object.fromEntries(Object.entries(current).map(([key, value]) => [key, resolveNode(value)]))\n    cachedResults.set(rawValue, result)\n    return result\n  }\n\n  return resolveNode(node)\n}\n"],"mappings":";;;;;;;;;;;;AAkCA,IAAa,sBAA4B,SAA4D;CACnG,MAAM,0BAAU,IAAI,SAAiB;CACrC,MAAM,gCAAgB,IAAI,SAAsB;CAEhD,MAAM,eAAe,YAAsB;AAEzC,MAAI,CAAC,SAAS,QAAQ,IAAI,CAAC,MAAM,QAAQ,QAAQ,CAC/C,QAAO;EAGT,MAAM,WAAW,kBAAkB,SAAS,EAAE,OAAO,GAAG,CAAC;AAIzD,MAAI,cAAc,IAAI,SAAS,CAC7B,QAAO,cAAc,IAAI,SAAS;AAIpC,MAAI,QAAQ,IAAI,SAAS,CACvB,QAAO;AAIT,UAAQ,IAAI,SAAS;AAErB,MAAI,UAAU,SAAS;GAErB,MAAM,SAAS,YADE,eAAe,QAAQ,CACJ;AACpC,iBAAc,IAAI,UAAU,OAAO;AACnC,UAAO;;AAIT,MAAI,MAAM,QAAQ,QAAQ,EAAE;GAC1B,MAAM,SAAS,QAAQ,IAAI,YAAY;AACvC,iBAAc,IAAI,UAAU,OAAO;AACnC,UAAO;;EAGT,MAAM,SAAS,OAAO,YAAY,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,YAAY,MAAM,CAAC,CAAC,CAAC;AAC3G,gBAAc,IAAI,UAAU,OAAO;AACnC,SAAO;;AAGT,QAAO,YAAY,KAAK"}

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.js

@@ -0,0 +1,18 @@
+import { encode } from "js-base64";
+//#region src/v2/blocks/operation-code-sample/helpers/get-secrets.ts
+/** Extract secrets from security schemes */
+var getSecrets = (securitySchemes) => securitySchemes.flatMap((scheme) => {
+	if (scheme.type === "apiKey") return scheme["x-scalar-secret-token"];
+	if (scheme?.type === "http") return [
+		scheme["x-scalar-secret-token"],
+		scheme["x-scalar-secret-username"],
+		scheme["x-scalar-secret-password"],
+		encode(`${scheme["x-scalar-secret-username"]}:${scheme["x-scalar-secret-password"]}`)
+	];
+	if (scheme.type === "oauth2") return Object.values(scheme.flows).map((flow) => flow["x-scalar-secret-token"]);
+	return [];
+}).filter(Boolean);
+//#endregion
+export { getSecrets };
+
+//# sourceMappingURL=get-secrets.js.map

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-secrets.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-secrets.ts"],"sourcesContent":["import { encode } from 'js-base64'\n\nimport type { SecuritySchemeObjectSecret } from '@/v2/blocks/scalar-auth-selector-block/helpers/secret-types'\n\n/** Extract secrets from security schemes */\nexport const getSecrets = (securitySchemes: SecuritySchemeObjectSecret[]): string[] =>\n  securitySchemes\n    .flatMap((scheme) => {\n      if (scheme.type === 'apiKey') {\n        return scheme['x-scalar-secret-token']\n      }\n      if (scheme?.type === 'http') {\n        return [\n          scheme['x-scalar-secret-token'],\n          scheme['x-scalar-secret-username'],\n          scheme['x-scalar-secret-password'],\n          encode(`${scheme['x-scalar-secret-username']}:${scheme['x-scalar-secret-password']}`),\n        ]\n      }\n      if (scheme.type === 'oauth2') {\n        const flows = Object.values(scheme.flows)\n        return flows.map((flow) => flow['x-scalar-secret-token'])\n      }\n\n      return []\n    })\n    .filter(Boolean)\n"],"mappings":";;;AAKA,IAAa,cAAc,oBACzB,gBACG,SAAS,WAAW;AACnB,KAAI,OAAO,SAAS,SAClB,QAAO,OAAO;AAEhB,KAAI,QAAQ,SAAS,OACnB,QAAO;EACL,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO,GAAG,OAAO,4BAA4B,GAAG,OAAO,8BAA8B;EACtF;AAEH,KAAI,OAAO,SAAS,SAElB,QADc,OAAO,OAAO,OAAO,MAAM,CAC5B,KAAK,SAAS,KAAK,yBAAyB;AAG3D,QAAO,EAAE;EACT,CACD,OAAO,QAAQ"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.d.ts

@@ -35,6 +35,11 @@ export type OperationToHarProps = {
      * @default true
      */
     includeDefaultHeaders?: boolean;
+    /**
+     * Selected oneOf/anyOf variants for nested request body example generation
+     * (e.g. from the schema dropdowns in the API reference).
+     */
+    requestBodyCompositionSelection?: Record<string, number>;
 };
 /**
  * Converts an OpenAPI Operation to a HarRequest format for generating HTTP request snippets.
@@ -58,5 +63,5 @@ export type OperationToHarProps = {
  * @see https://w3c.github.io/web-performance/specs/HAR/Overview.html
  * @see https://spec.openapis.org/oas/v3.1.0#operation-object
  */
-export declare const operationToHar: ({ includeDefaultHeaders, operation, contentType, method, path, server, example, securitySchemes, globalCookies, }: OperationToHarProps) => HarRequest;
+export declare const operationToHar: ({ includeDefaultHeaders, operation, contentType, method, path, server, example, securitySchemes, globalCookies, requestBodyCompositionSelection, }: OperationToHarProps) => HarRequest;
 //# sourceMappingURL=operation-to-har.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation-to-har.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AACjH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAIvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAA;AAO7G,MAAM,MAAM,mBAAmB,GAAG;IAChC,+BAA+B;IAC/B,SAAS,EAAE,eAAe,CAAA;IAC1B,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC9C,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,mHAU5B,mBAAmB,KAAG,UA+FxB,CAAA"}
+{"version":3,"file":"operation-to-har.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qEAAqE,CAAA;AACxG,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AACjH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAIvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAA;AAO7G,MAAM,MAAM,mBAAmB,GAAG;IAChC,+BAA+B;IAC/B,SAAS,EAAE,eAAe,CAAA;IAC1B,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5B,2EAA2E;IAC3E,eAAe,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC9C,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;IAC/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B;;;OAGG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,oJAW5B,mBAAmB,KAAG,UAoGxB,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.js

@@ -0,0 +1,107 @@
+import { getDefaultHeaders } from "../../../request-block/helpers/get-default-headers.js";
+import { filterGlobalCookie } from "../../../operation-block/helpers/filter-global-cookies.js";
+import { processBody } from "./process-body.js";
+import { processParameters } from "./process-parameters.js";
+import { processSecuritySchemes } from "./process-security-schemes.js";
+import { processServerUrl } from "./process-server-url.js";
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+//#region src/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.ts
+/**
+* Converts an OpenAPI Operation to a HarRequest format for generating HTTP request snippets.
+*
+* This function transforms OpenAPI 3.1 operation objects into HAR (HTTP Archive) format requests,
+* which can be used to generate code snippets for various programming languages and HTTP clients.
+*
+* The conversion handles:
+* - Server URL processing and path parameter substitution
+* - Query parameter formatting based on OpenAPI parameter styles
+* - Request body processing with content type handling
+* - Security scheme integration (API keys, etc.)
+*
+* The resulting HarRequest object follows the HAR specification and includes:
+* - HTTP method and URL
+* - Headers and query parameters
+* - Request body (if present)
+* - Cookie information
+* - Size calculations for headers and body
+*
+* @see https://w3c.github.io/web-performance/specs/HAR/Overview.html
+* @see https://spec.openapis.org/oas/v3.1.0#operation-object
+*/
+var operationToHar = ({ includeDefaultHeaders = false, operation, contentType, method, path, server = null, example, securitySchemes, globalCookies, requestBodyCompositionSelection }) => {
+	const defaultHeaders = includeDefaultHeaders ? getDefaultHeaders({
+		method,
+		operation,
+		exampleKey: example ?? "default",
+		hideDisabledHeaders: true
+	}).filter((header) => !header.isOverridden) : [];
+	const disabledGlobalCookies = operation["x-scalar-disable-parameters"]?.["global-cookies"]?.[example ?? "default"] ?? {};
+	const harRequest = {
+		method,
+		url: processServerUrl(server, path),
+		headers: defaultHeaders.map((header) => ({
+			name: header.name,
+			value: header.defaultValue
+		})),
+		queryString: [],
+		postData: void 0,
+		httpVersion: "HTTP/1.1",
+		cookies: [],
+		headersSize: -1,
+		bodySize: -1
+	};
+	if (operation.parameters) {
+		const { url, headers, queryString, cookies } = processParameters({
+			harRequest,
+			parameters: operation.parameters,
+			example
+		});
+		const filteredGlobalCookies = globalCookies?.filter((cookie) => filterGlobalCookie({
+			cookie,
+			url,
+			disabledGlobalCookies
+		}))?.map((cookie) => ({
+			name: cookie.name,
+			value: cookie.value
+		})) ?? [];
+		harRequest.url = url;
+		harRequest.headers = headers;
+		harRequest.queryString = queryString;
+		harRequest.cookies = [...filteredGlobalCookies, ...cookies];
+	}
+	const body = getResolvedRef(operation.requestBody);
+	if (body?.content) {
+		const postData = processBody({
+			requestBody: body,
+			contentType,
+			example,
+			requestBodyCompositionSelection
+		});
+		if (postData) {
+			harRequest.postData = postData;
+			harRequest.bodySize = postData.text?.length ?? -1;
+			if (postData.mimeType) {
+				const existingContentTypeHeader = harRequest.headers.find((header) => header.name.toLowerCase() === "content-type");
+				if (existingContentTypeHeader && !existingContentTypeHeader.value) existingContentTypeHeader.value = postData.mimeType;
+				else if (!existingContentTypeHeader) harRequest.headers.push({
+					name: "Content-Type",
+					value: postData.mimeType
+				});
+			}
+		}
+	}
+	if (securitySchemes) {
+		const { headers, queryString, cookies } = processSecuritySchemes(securitySchemes);
+		harRequest.headers.push(...headers);
+		harRequest.queryString.push(...queryString);
+		harRequest.cookies.push(...cookies);
+	}
+	let headersSize = 0;
+	for (const h of harRequest.headers) headersSize += (h.name?.length ?? 0) + 2 + (h.value?.length ?? 0) + 2;
+	harRequest.headersSize = headersSize;
+	return harRequest;
+};
+//#endregion
+export { operationToHar };
+
+//# sourceMappingURL=operation-to-har.js.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-to-har.js","names":[],"sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.ts"],"sourcesContent":["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { XScalarCookie } from '@scalar/workspace-store/schemas/extensions/general/x-scalar-cookies'\nimport type { OperationObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport type { Request as HarRequest } from 'har-format'\n\nimport { filterGlobalCookie } from '@/v2/blocks/operation-block/helpers/filter-global-cookies'\nimport { getDefaultHeaders } from '@/v2/blocks/request-block/helpers/get-default-headers'\nimport type { SecuritySchemeObjectSecret } from '@/v2/blocks/scalar-auth-selector-block/helpers/secret-types'\n\nimport { processBody } from './process-body'\nimport { processParameters } from './process-parameters'\nimport { processSecuritySchemes } from './process-security-schemes'\nimport { processServerUrl } from './process-server-url'\n\nexport type OperationToHarProps = {\n  /** OpenAPI Operation object */\n  operation: OperationObject\n  /** HTTP method of the operation */\n  method: HttpMethod\n  /** Path of the operation */\n  path: string\n  /**\n   * Name of the currently selected operation example\n   *\n   * Applies to both the body and the parameters\n   */\n  example?: string\n  /**\n   * Content type of the operation\n   *\n   * Applies to both the body and the parameters (if applicable)\n   * @defaults to the first content type in the MediaTypeObject\n   */\n  contentType?: string\n  /** OpenAPI Server object */\n  server?: ServerObject | null\n  /** OpenAPI SecurityScheme objects which are applicable to the operation */\n  securitySchemes?: SecuritySchemeObjectSecret[]\n  /** Workspace + document cookies */\n  globalCookies?: XScalarCookie[]\n  /**\n   * Whether to include default headers (e.g., Accept, Content-Type) automatically.\n   * If false, default headers will be omitted from the HAR request.\n   * @default true\n   */\n  includeDefaultHeaders?: boolean\n  /**\n   * Selected oneOf/anyOf variants for nested request body example generation\n   * (e.g. from the schema dropdowns in the API reference).\n   */\n  requestBodyCompositionSelection?: Record<string, number>\n}\n\n/**\n * Converts an OpenAPI Operation to a HarRequest format for generating HTTP request snippets.\n *\n * This function transforms OpenAPI 3.1 operation objects into HAR (HTTP Archive) format requests,\n * which can be used to generate code snippets for various programming languages and HTTP clients.\n *\n * The conversion handles:\n * - Server URL processing and path parameter substitution\n * - Query parameter formatting based on OpenAPI parameter styles\n * - Request body processing with content type handling\n * - Security scheme integration (API keys, etc.)\n *\n * The resulting HarRequest object follows the HAR specification and includes:\n * - HTTP method and URL\n * - Headers and query parameters\n * - Request body (if present)\n * - Cookie information\n * - Size calculations for headers and body\n *\n * @see https://w3c.github.io/web-performance/specs/HAR/Overview.html\n * @see https://spec.openapis.org/oas/v3.1.0#operation-object\n */\nexport const operationToHar = ({\n  includeDefaultHeaders = false,\n  operation,\n  contentType,\n  method,\n  path,\n  server = null,\n  example,\n  securitySchemes,\n  globalCookies,\n  requestBodyCompositionSelection,\n}: OperationToHarProps): HarRequest => {\n  const defaultHeaders = includeDefaultHeaders\n    ? getDefaultHeaders({\n        method,\n        operation,\n        exampleKey: example ?? 'default',\n        hideDisabledHeaders: true,\n      }).filter((header) => !header.isOverridden)\n    : []\n\n  const disabledGlobalCookies =\n    operation['x-scalar-disable-parameters']?.['global-cookies']?.[example ?? 'default'] ?? {}\n\n  const serverUrl = processServerUrl(server, path)\n\n  // Initialize the HAR request with basic properties\n  const harRequest: HarRequest = {\n    method,\n    url: serverUrl,\n    headers: defaultHeaders.map((header) => ({ name: header.name, value: header.defaultValue })),\n    queryString: [],\n    postData: undefined,\n    httpVersion: 'HTTP/1.1',\n    cookies: [],\n    headersSize: -1,\n    bodySize: -1,\n  }\n\n  // Handle parameters\n  if (operation.parameters) {\n    const { url, headers, queryString, cookies } = processParameters({\n      harRequest,\n      parameters: operation.parameters,\n      example,\n    })\n\n    // Correctly filter the global cookies by the processed url\n    const filteredGlobalCookies =\n      globalCookies\n        ?.filter((cookie) => filterGlobalCookie({ cookie, url, disabledGlobalCookies }))\n        ?.map((cookie) => ({ name: cookie.name, value: cookie.value })) ?? []\n\n    harRequest.url = url\n    harRequest.headers = headers\n    harRequest.queryString = queryString\n    harRequest.cookies = [...filteredGlobalCookies, ...cookies]\n  }\n\n  const body = getResolvedRef(operation.requestBody)\n\n  // Handle request body\n  if (body?.content) {\n    const postData = processBody({\n      requestBody: body,\n      contentType,\n      example,\n      requestBodyCompositionSelection,\n    })\n\n    if (postData) {\n      harRequest.postData = postData\n      harRequest.bodySize = postData.text?.length ?? -1\n\n      // Add or update Content-Type header\n      if (postData.mimeType) {\n        const existingContentTypeHeader = harRequest.headers.find(\n          (header) => header.name.toLowerCase() === 'content-type',\n        )\n        // Update existing header if it has an empty value\n        if (existingContentTypeHeader && !existingContentTypeHeader.value) {\n          existingContentTypeHeader.value = postData.mimeType\n        }\n        // Add new header if none exists\n        else if (!existingContentTypeHeader) {\n          harRequest.headers.push({\n            name: 'Content-Type',\n            value: postData.mimeType,\n          })\n        }\n      }\n    }\n  }\n\n  // Handle security schemes\n  if (securitySchemes) {\n    const { headers, queryString, cookies } = processSecuritySchemes(securitySchemes)\n    harRequest.headers.push(...headers)\n    harRequest.queryString.push(...queryString)\n    harRequest.cookies.push(...cookies)\n  }\n\n  // Calculate headers size without allocating a large joined string\n  let headersSize = 0\n  for (const h of harRequest.headers) {\n    // name + \": \" + value + \"\\r\\n\"\n    headersSize += (h.name?.length ?? 0) + 2 + (h.value?.length ?? 0) + 2\n  }\n  harRequest.headersSize = headersSize\n\n  return harRequest\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EA,IAAa,kBAAkB,EAC7B,wBAAwB,OACxB,WACA,aACA,QACA,MACA,SAAS,MACT,SACA,iBACA,eACA,sCACqC;CACrC,MAAM,iBAAiB,wBACnB,kBAAkB;EAChB;EACA;EACA,YAAY,WAAW;EACvB,qBAAqB;EACtB,CAAC,CAAC,QAAQ,WAAW,CAAC,OAAO,aAAa,GAC3C,EAAE;CAEN,MAAM,wBACJ,UAAU,iCAAiC,oBAAoB,WAAW,cAAc,EAAE;CAK5F,MAAM,aAAyB;EAC7B;EACA,KALgB,iBAAiB,QAAQ,KAAK;EAM9C,SAAS,eAAe,KAAK,YAAY;GAAE,MAAM,OAAO;GAAM,OAAO,OAAO;GAAc,EAAE;EAC5F,aAAa,EAAE;EACf,UAAU,KAAA;EACV,aAAa;EACb,SAAS,EAAE;EACX,aAAa;EACb,UAAU;EACX;AAGD,KAAI,UAAU,YAAY;EACxB,MAAM,EAAE,KAAK,SAAS,aAAa,YAAY,kBAAkB;GAC/D;GACA,YAAY,UAAU;GACtB;GACD,CAAC;EAGF,MAAM,wBACJ,eACI,QAAQ,WAAW,mBAAmB;GAAE;GAAQ;GAAK;GAAuB,CAAC,CAAC,EAC9E,KAAK,YAAY;GAAE,MAAM,OAAO;GAAM,OAAO,OAAO;GAAO,EAAE,IAAI,EAAE;AAEzE,aAAW,MAAM;AACjB,aAAW,UAAU;AACrB,aAAW,cAAc;AACzB,aAAW,UAAU,CAAC,GAAG,uBAAuB,GAAG,QAAQ;;CAG7D,MAAM,OAAO,eAAe,UAAU,YAAY;AAGlD,KAAI,MAAM,SAAS;EACjB,MAAM,WAAW,YAAY;GAC3B,aAAa;GACb;GACA;GACA;GACD,CAAC;AAEF,MAAI,UAAU;AACZ,cAAW,WAAW;AACtB,cAAW,WAAW,SAAS,MAAM,UAAU;AAG/C,OAAI,SAAS,UAAU;IACrB,MAAM,4BAA4B,WAAW,QAAQ,MAClD,WAAW,OAAO,KAAK,aAAa,KAAK,eAC3C;AAED,QAAI,6BAA6B,CAAC,0BAA0B,MAC1D,2BAA0B,QAAQ,SAAS;aAGpC,CAAC,0BACR,YAAW,QAAQ,KAAK;KACtB,MAAM;KACN,OAAO,SAAS;KACjB,CAAC;;;;AAOV,KAAI,iBAAiB;EACnB,MAAM,EAAE,SAAS,aAAa,YAAY,uBAAuB,gBAAgB;AACjF,aAAW,QAAQ,KAAK,GAAG,QAAQ;AACnC,aAAW,YAAY,KAAK,GAAG,YAAY;AAC3C,aAAW,QAAQ,KAAK,GAAG,QAAQ;;CAIrC,IAAI,cAAc;AAClB,MAAK,MAAM,KAAK,WAAW,QAEzB,iBAAgB,EAAE,MAAM,UAAU,KAAK,KAAK,EAAE,OAAO,UAAU,KAAK;AAEtE,YAAW,cAAc;AAEzB,QAAO"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.d.ts

@@ -1,13 +1,13 @@
 import type { RequestBodyObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
 import type { PostData } from 'har-format';
-import type { OperationToHarProps } from './operation-to-har';
-type ProcessBodyProps = Pick<OperationToHarProps, 'contentType' | 'example'> & {
+import type { OperationToHarProps } from './operation-to-har.js';
+type ProcessBodyProps = Pick<OperationToHarProps, 'contentType' | 'example' | 'requestBodyCompositionSelection'> & {
     requestBody: RequestBodyObject;
 };
 /**
  * Processes the request body and returns the processed data
  * Returns undefined if no example is found
  */
-export declare const processBody: ({ requestBody, contentType, example }: ProcessBodyProps) => PostData | undefined;
+export declare const processBody: ({ requestBody, contentType, example, requestBodyCompositionSelection, }: ProcessBodyProps) => PostData | undefined;
 export {};
 //# sourceMappingURL=process-body.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,8DAA8D,CAAA;AAEtH,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,YAAY,CAAA;AAIjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,KAAK,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,SAAS,CAAC,GAAG;IAC7E,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAoED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,uCAAuC,gBAAgB,KAAG,QAAQ,GAAG,SA+EhG,CAAA"}
+{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,8DAA8D,CAAA;AAGrE,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,YAAY,CAAA;AAIjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,KAAK,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,SAAS,GAAG,iCAAiC,CAAC,GAAG;IACjH,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAoED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,yEAKzB,gBAAgB,KAAG,QAAQ,GAAG,SAuFhC,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.js

@@ -0,0 +1,114 @@
+import { getResolvedRefDeep } from "../get-resolved-ref-deep.js";
+import { getExample } from "../../../operation-block/helpers/get-example.js";
+import { getExampleFromSchema } from "../get-example-from-schema.js";
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
+import { json2xml } from "@scalar/helpers/file/json2xml";
+//#region src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts
+/**
+* Converts an object to an array of form parameters
+* @param obj - The object to convert
+* @returns Array of form parameters with name and value properties
+*/
+var objectToFormParams = (obj, encoding, parentKey) => {
+	const params = [];
+	/** Ensure we do not include disabled items */
+	const entries = Array.isArray(obj) ? obj.filter((item) => !item.isDisabled).map((item) => [item.name, item.value]) : Object.entries(obj);
+	for (const [key, value] of entries) {
+		if (value === void 0 || value === null) continue;
+		const partContentType = parentKey ? void 0 : encoding?.[key]?.contentType;
+		if (value instanceof File) {
+			const file = unpackProxyObject(value);
+			params.push({
+				name: key,
+				value: `@${file.name}`,
+				...partContentType ? { contentType: partContentType } : {}
+			});
+		} else if (partContentType && typeof value === "object") params.push({
+			name: key,
+			value: JSON.stringify(unpackProxyObject(value)),
+			contentType: partContentType
+		});
+		else if (Array.isArray(value)) for (const item of value) if (item instanceof File) {
+			const file = unpackProxyObject(item);
+			params.push({
+				name: key,
+				value: `@${file.name}`
+			});
+		} else params.push({
+			name: key,
+			value: String(item)
+		});
+		else if (typeof value === "object") {
+			const nestedParams = objectToFormParams(value, void 0, key);
+			for (const param of nestedParams) params.push({
+				name: `${key}.${param.name}`,
+				value: param.value
+			});
+		} else params.push({
+			name: key,
+			value: String(value),
+			...partContentType ? { contentType: partContentType } : {}
+		});
+	}
+	return params;
+};
+/**
+* Processes the request body and returns the processed data
+* Returns undefined if no example is found
+*/
+var processBody = ({ requestBody, contentType, example, requestBodyCompositionSelection }) => {
+	const _contentType = contentType || Object.keys(requestBody.content)[0] || "";
+	const formatBinaryFile = (file) => {
+		return `@${unpackProxyObject(file).name || "filename"}`;
+	};
+	const encoding = requestBody.content[_contentType]?.encoding;
+	const isFormData = _contentType === "multipart/form-data" || _contentType === "application/x-www-form-urlencoded";
+	const isXml = _contentType === "application/xml";
+	const _example = getExample(requestBody, example, contentType)?.value;
+	if (typeof _example !== "undefined") {
+		const exampleValue = _example !== null && typeof _example === "object" ? unpackProxyObject(_example) : _example;
+		if (isFormData && typeof exampleValue === "object" && exampleValue !== null) return {
+			mimeType: _contentType,
+			params: objectToFormParams(exampleValue, _contentType === "multipart/form-data" ? encoding : void 0)
+		};
+		if (isXml && typeof exampleValue === "object" && exampleValue !== null) return {
+			mimeType: _contentType,
+			text: json2xml(exampleValue)
+		};
+		if (exampleValue instanceof File) return {
+			mimeType: _contentType,
+			text: formatBinaryFile(exampleValue)
+		};
+		return {
+			mimeType: _contentType,
+			text: typeof exampleValue === "string" ? exampleValue : JSON.stringify(exampleValue)
+		};
+	}
+	const contentSchema = getResolvedRef(requestBody.content[_contentType]?.schema);
+	if (typeof contentSchema !== "undefined") {
+		const extractedExample = getExampleFromSchema(getResolvedRefDeep(contentSchema), {
+			compositionSelection: requestBodyCompositionSelection,
+			mode: "write",
+			xml: isXml
+		}, { schemaPath: ["requestBody"] });
+		if (extractedExample !== void 0) {
+			if (isFormData && typeof extractedExample === "object" && extractedExample !== null) return {
+				mimeType: _contentType,
+				params: objectToFormParams(extractedExample, _contentType === "multipart/form-data" ? encoding : void 0)
+			};
+			if (isXml && typeof extractedExample === "object" && extractedExample !== null) return {
+				mimeType: _contentType,
+				text: json2xml(extractedExample)
+			};
+			return {
+				mimeType: _contentType,
+				text: typeof extractedExample === "string" ? extractedExample : JSON.stringify(extractedExample)
+			};
+		}
+	}
+};
+//#endregion
+export { processBody };
+
+//# sourceMappingURL=process-body.js.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-body.js","names":[],"sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts"],"sourcesContent":["import { json2xml } from '@scalar/helpers/file/json2xml'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\nimport type {\n  MediaTypeObject,\n  RequestBodyObject,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { getExampleFromSchema } from '@v2/blocks/operation-code-sample/helpers/get-example-from-schema'\nimport { getResolvedRefDeep } from '@v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep'\nimport type { Param, PostData } from 'har-format'\n\nimport { getExample } from '@/v2/blocks/operation-block/helpers/get-example'\n\nimport type { OperationToHarProps } from './operation-to-har'\n\ntype ProcessBodyProps = Pick<OperationToHarProps, 'contentType' | 'example' | 'requestBodyCompositionSelection'> & {\n  requestBody: RequestBodyObject\n}\n\ntype MultipartEncodingMap = MediaTypeObject['encoding']\n\n/**\n * Converts an object to an array of form parameters\n * @param obj - The object to convert\n * @returns Array of form parameters with name and value properties\n */\nconst objectToFormParams = (\n  obj: object | { name: string; value: unknown; isDisabled: boolean }[],\n  encoding?: MultipartEncodingMap,\n  parentKey?: string,\n): Param[] => {\n  const params: Param[] = []\n\n  /** Ensure we do not include disabled items */\n  const entries = Array.isArray(obj)\n    ? obj.filter((item) => !item.isDisabled).map((item) => [item.name, item.value])\n    : Object.entries(obj)\n\n  for (const [key, value] of entries) {\n    if (value === undefined || value === null) {\n      continue\n    }\n\n    const partContentType = parentKey ? undefined : encoding?.[key]?.contentType\n\n    // Handle File objects by converting them to 'BINARY'\n    if (value instanceof File) {\n      const file = unpackProxyObject(value)\n      params.push({ name: key, value: `@${file.name}`, ...(partContentType ? { contentType: partContentType } : {}) })\n    }\n    // Multipart encodings can override the entire top-level part payload\n    else if (partContentType && typeof value === 'object') {\n      params.push({\n        name: key,\n        value: JSON.stringify(unpackProxyObject(value)),\n        contentType: partContentType,\n      })\n    }\n    // Handle arrays by adding each item with the same key\n    else if (Array.isArray(value)) {\n      for (const item of value) {\n        // Check if array item is a File\n        if (item instanceof File) {\n          const file = unpackProxyObject(item)\n          params.push({ name: key, value: `@${file.name}` })\n        } else {\n          params.push({ name: key, value: String(item) })\n        }\n      }\n    }\n    // Handle nested objects by flattening them\n    else if (typeof value === 'object') {\n      const nestedParams = objectToFormParams(value, undefined, key)\n\n      for (const param of nestedParams) {\n        params.push({ name: `${key}.${param.name}`, value: param.value })\n      }\n    } else {\n      params.push({ name: key, value: String(value), ...(partContentType ? { contentType: partContentType } : {}) })\n    }\n  }\n\n  return params\n}\n\n/**\n * Processes the request body and returns the processed data\n * Returns undefined if no example is found\n */\nexport const processBody = ({\n  requestBody,\n  contentType,\n  example,\n  requestBodyCompositionSelection,\n}: ProcessBodyProps): PostData | undefined => {\n  const _contentType = contentType || Object.keys(requestBody.content)[0] || ''\n  const formatBinaryFile = (file: File) => {\n    const unwrappedFile = unpackProxyObject(file)\n    return `@${unwrappedFile.name || 'filename'}`\n  }\n  const encoding = requestBody.content[_contentType]?.encoding\n\n  // Check if this is a form data content type\n  const isFormData = _contentType === 'multipart/form-data' || _contentType === 'application/x-www-form-urlencoded'\n\n  // Check if this is an XML content type\n  const isXml = _contentType === 'application/xml'\n\n  // Get the example value\n  const _example = getExample(requestBody, example, contentType)?.value\n\n  // Return the provided top level example\n  if (typeof _example !== 'undefined') {\n    const exampleValue = _example !== null && typeof _example === 'object' ? unpackProxyObject(_example) : _example\n\n    if (isFormData && typeof exampleValue === 'object' && exampleValue !== null) {\n      return {\n        mimeType: _contentType,\n        params: objectToFormParams(exampleValue, _contentType === 'multipart/form-data' ? encoding : undefined),\n      }\n    }\n\n    if (isXml && typeof exampleValue === 'object' && exampleValue !== null) {\n      return {\n        mimeType: _contentType,\n        text: json2xml(exampleValue),\n      }\n    }\n\n    if (exampleValue instanceof File) {\n      return {\n        mimeType: _contentType,\n        text: formatBinaryFile(exampleValue),\n      }\n    }\n\n    return {\n      mimeType: _contentType,\n      text: typeof exampleValue === 'string' ? exampleValue : JSON.stringify(exampleValue),\n    }\n  }\n\n  // Try to extract examples from the schema\n  const contentSchema = getResolvedRef(requestBody.content[_contentType]?.schema)\n  if (typeof contentSchema !== 'undefined') {\n    const resolvedContentSchema = getResolvedRefDeep(contentSchema) as SchemaObject\n    const extractedExample = getExampleFromSchema(\n      resolvedContentSchema,\n      {\n        compositionSelection: requestBodyCompositionSelection,\n        mode: 'write',\n        xml: isXml,\n      },\n      {\n        schemaPath: ['requestBody'],\n      },\n    )\n\n    if (extractedExample !== undefined) {\n      if (isFormData && typeof extractedExample === 'object' && extractedExample !== null) {\n        return {\n          mimeType: _contentType,\n          params: objectToFormParams(extractedExample, _contentType === 'multipart/form-data' ? encoding : undefined),\n        }\n      }\n\n      if (isXml && typeof extractedExample === 'object' && extractedExample !== null) {\n        return {\n          mimeType: _contentType,\n          text: json2xml(extractedExample),\n        }\n      }\n\n      return {\n        mimeType: _contentType,\n        text: typeof extractedExample === 'string' ? extractedExample : JSON.stringify(extractedExample),\n      }\n    }\n  }\n\n  return undefined\n}\n"],"mappings":"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"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-parameters.js

@@ -0,0 +1,216 @@
+import { getExample } from "../../../operation-block/helpers/get-example.js";
+import { getExampleFromSchema } from "../get-example-from-schema.js";
+import { deSerializeParameter } from "../../../operation-block/helpers/de-serialize-parameter.js";
+import { isParamDisabled } from "../../../request-block/helpers/is-param-disabled.js";
+import { serializeContentValue, serializeDeepObjectStyle, serializeFormStyle, serializeFormStyleForCookies, serializePipeDelimitedStyle, serializeSimpleStyle, serializeSpaceDelimitedStyle } from "../../../operation-block/helpers/serialize-parameter.js";
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+//#region src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-parameters.ts
+/** Ensures we don't have any references in the parameters */
+var deReferenceParams = (params) => (params ?? []).map((param) => getResolvedRef(param));
+/**
+* Get the style and explode values for a parameter according to OpenAPI 3.1.1 specification.
+* Handles defaults and validation for parameter location restrictions.
+*/
+var getParameterStyleAndExplode = (param) => {
+	if (param.in === "header") return {
+		style: "simple",
+		explode: "explode" in param && param.explode !== void 0 ? param.explode : false
+	};
+	if (param.in === "cookie") return {
+		style: "form",
+		explode: "explode" in param && param.explode !== void 0 ? param.explode : true
+	};
+	const defaultStyle = {
+		path: "simple",
+		query: "form",
+		header: "simple",
+		cookie: "form"
+	}[param.in];
+	const style = "style" in param && param.style ? param.style : defaultStyle;
+	return {
+		style,
+		explode: "explode" in param && param.explode !== void 0 ? param.explode : style === "form"
+	};
+};
+/**
+* Extract the value for a parameter from example data or schema.
+* Prioritizes example data over schema examples.
+* Returns null if the parameter is disabled so we can skip it.
+*/
+var getParameterValue = (param, example, contentType) => {
+	const exampleValue = getExample(param, example, contentType);
+	if (isParamDisabled(param, exampleValue)) return;
+	if (exampleValue?.value !== void 0) return deSerializeParameter(exampleValue.value, param);
+	if (!("schema" in param) || !param.schema) return;
+	const options = param.in === "path" ? { emptyString: `{${param.name}}` } : {};
+	return getExampleFromSchema(getResolvedRef(param.schema), options);
+};
+/**
+* Process OpenAPI parameters and return the updated properties.
+* Handles path, query, and header parameters with various styles and explode options.
+*
+* @see https://spec.openapis.org/oas/latest.html#style-values
+*/
+var processParameters = ({ harRequest, parameters, example }) => {
+	const newHeaders = [...harRequest.headers];
+	const newQueryString = [...harRequest.queryString];
+	let newUrl = harRequest.url;
+	const deReferencedParams = deReferenceParams(parameters);
+	for (const param of deReferencedParams) {
+		if (!param.in || !param.name) continue;
+		const paramValue = getParameterValue(param, example, void 0);
+		if (paramValue === void 0) continue;
+		const { style, explode } = getParameterStyleAndExplode(param);
+		switch (param.in) {
+			case "path":
+				newUrl = processPathParameters(newUrl, param, paramValue, style, explode);
+				break;
+			case "query":
+				if ("content" in param && param.content) {
+					const serializedValue = serializeContentValue(paramValue, Object.keys(param.content)[0] ?? "application/json");
+					newQueryString.push({
+						name: param.name,
+						value: serializedValue
+					});
+					break;
+				}
+				switch (style) {
+					case "form": {
+						const serialized = serializeFormStyle(paramValue, explode);
+						if (Array.isArray(serialized)) for (const entry of serialized) {
+							const key = entry.key || param.name;
+							newQueryString.push({
+								name: key,
+								value: String(entry.value)
+							});
+						}
+						else newQueryString.push({
+							name: param.name,
+							value: String(serialized)
+						});
+						break;
+					}
+					case "spaceDelimited": {
+						const serialized = serializeSpaceDelimitedStyle(paramValue);
+						newQueryString.push({
+							name: param.name,
+							value: serialized
+						});
+						break;
+					}
+					case "pipeDelimited": {
+						const serialized = serializePipeDelimitedStyle(paramValue);
+						newQueryString.push({
+							name: param.name,
+							value: serialized
+						});
+						break;
+					}
+					case "deepObject":
+						if (explode) {
+							const entries = serializeDeepObjectStyle(param.name, paramValue);
+							for (const entry of entries) newQueryString.push({
+								name: entry.key,
+								value: entry.value
+							});
+						}
+						break;
+					default: newQueryString.push({
+						name: param.name,
+						value: String(paramValue)
+					});
+				}
+				break;
+			case "header": {
+				const serialized = serializeSimpleStyle(paramValue, explode);
+				newHeaders.push({
+					name: param.name,
+					value: String(serialized)
+				});
+				break;
+			}
+			case "cookie": {
+				const serialized = serializeFormStyleForCookies(paramValue, explode);
+				if (Array.isArray(serialized)) for (const entry of serialized) {
+					const key = entry.key || param.name;
+					const value = entry.value === null ? "null" : String(entry.value);
+					harRequest.cookies.push({
+						name: key,
+						value
+					});
+				}
+				else {
+					const value = serialized === null ? "null" : String(serialized);
+					harRequest.cookies.push({
+						name: param.name,
+						value
+					});
+				}
+				break;
+			}
+		}
+	}
+	return {
+		url: newUrl,
+		headers: newHeaders,
+		queryString: newQueryString,
+		cookies: harRequest.cookies
+	};
+};
+/**
+* Process path parameters according to OpenAPI specification.
+* Handles matrix, label, and simple styles with explode options.
+*
+* @param url - The URL to process
+* @param param - The parameter object
+* @param paramValue - The value of the parameter
+* @param style - The style of the parameter (matrix, label, simple)
+* @param explode - Whether to explode the parameter
+* @returns The updated URL with processed path parameters
+*/
+var processPathParameters = (url, param, paramValue, style, explode) => {
+	switch (style) {
+		case "matrix":
+			if (explode) {
+				if (Array.isArray(paramValue)) {
+					const values = paramValue.map((v) => `${param.name}=${v}`).join(";");
+					return url.replace(`{;${param.name}}`, `;${values}`);
+				}
+				if (typeof paramValue === "object" && paramValue !== null) {
+					const values = Object.entries(paramValue).map(([k, v]) => `${k}=${v}`).join(";");
+					return url.replace(`{;${param.name}}`, `;${values}`);
+				}
+				return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue}`);
+			}
+			if (Array.isArray(paramValue)) return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue.join(",")}`);
+			if (typeof paramValue === "object" && paramValue !== null) {
+				const values = Object.entries(paramValue).map(([k, v]) => `${k},${v}`).join(",");
+				return url.replace(`{;${param.name}}`, `;${param.name}=${values}`);
+			}
+			return url.replace(`{;${param.name}}`, `;${param.name}=${paramValue}`);
+		case "label":
+			if (explode) {
+				if (Array.isArray(paramValue)) return url.replace(`{.${param.name}}`, `.${paramValue.join(".")}`);
+				if (typeof paramValue === "object" && paramValue !== null) {
+					const values = Object.entries(paramValue).map(([k, v]) => `${k}=${v}`).join(".");
+					return url.replace(`{.${param.name}}`, `.${values}`);
+				}
+				return url.replace(`{.${param.name}}`, `.${paramValue}`);
+			}
+			if (Array.isArray(paramValue)) return url.replace(`{.${param.name}}`, `.${paramValue.join(",")}`);
+			if (typeof paramValue === "object" && paramValue !== null) {
+				const values = Object.entries(paramValue).map(([k, v]) => `${k},${v}`).join(",");
+				return url.replace(`{.${param.name}}`, `.${values}`);
+			}
+			return url.replace(`{.${param.name}}`, `.${paramValue}`);
+		case "simple": {
+			const serialized = serializeSimpleStyle(paramValue, explode);
+			return url.replace(`{${param.name}}`, String(serialized));
+		}
+		default: return url.replace(`{${param.name}}`, String(paramValue));
+	}
+};
+//#endregion
+export { processParameters };
+
+//# sourceMappingURL=process-parameters.js.map