@scalar/workspace-store 0.19.0 → 0.21.0

package/dist/mutators/operation.js

@@ -1,9 +1,73 @@
+import { findVariables } from "@scalar/helpers/regex/find-variables";
 import { getResolvedRef } from "../helpers/get-resolved-ref.js";
-const updateOperationSummary = ({
-  document,
-  meta,
-  payload: { summary }
-}) => {
+import { unpackProxyObject } from "../helpers/unpack-proxy.js";
+import { isContentTypeParameterObject } from "../schemas/v3.1/strict/type-guards.js";
+const getParameterPositions = (path, parameters) => {
+  const positions = {};
+  for (const paramName of parameters) {
+    const position = path.indexOf(`{${paramName}}`);
+    if (position !== -1) {
+      positions[paramName] = position;
+    }
+  }
+  return positions;
+};
+const syncParametersForPathChange = (newPath, oldPath, existingParameters) => {
+  const oldPathParams = findVariables(oldPath, { includePath: true, includeEnv: false }).filter(
+    (v) => v !== void 0
+  );
+  const newPathParams = findVariables(newPath, { includePath: true, includeEnv: false }).filter(
+    (v) => v !== void 0
+  );
+  const oldPositions = getParameterPositions(oldPath, oldPathParams);
+  const newPositions = getParameterPositions(newPath, newPathParams);
+  const pathParameters = [];
+  const nonPathParameters = [];
+  for (const param of existingParameters) {
+    const resolved = getResolvedRef(param);
+    if (resolved?.in === "path") {
+      pathParameters.push(param);
+    } else {
+      nonPathParameters.push(param);
+    }
+  }
+  const existingPathParamsByName = /* @__PURE__ */ new Map();
+  for (const param of pathParameters) {
+    const resolved = getResolvedRef(param);
+    if (resolved?.name) {
+      existingPathParamsByName.set(resolved.name, param);
+    }
+  }
+  const usedOldParams = /* @__PURE__ */ new Set();
+  const syncedPathParameters = [];
+  for (const newParamName of newPathParams) {
+    if (existingPathParamsByName.has(newParamName)) {
+      syncedPathParameters.push(existingPathParamsByName.get(newParamName));
+      usedOldParams.add(newParamName);
+      continue;
+    }
+    const newParamPosition = newPositions[newParamName];
+    const oldParamAtPosition = oldPathParams.find(
+      (oldParam) => oldPositions[oldParam] === newParamPosition && !usedOldParams.has(oldParam)
+    );
+    if (oldParamAtPosition && existingPathParamsByName.has(oldParamAtPosition)) {
+      const oldParam = existingPathParamsByName.get(oldParamAtPosition);
+      const resolved = getResolvedRef(oldParam);
+      if (resolved) {
+        resolved.name = newParamName;
+        syncedPathParameters.push(oldParam);
+        usedOldParams.add(oldParamAtPosition);
+        continue;
+      }
+    }
+    syncedPathParameters.push({
+      name: newParamName,
+      in: "path"
+    });
+  }
+  return [...syncedPathParameters, ...nonPathParameters];
+};
+const updateOperationSummary = (document, { meta, payload: { summary } }) => {
   if (!document) {
     return;
   }
@@ -13,25 +77,21 @@ const updateOperationSummary = ({
   }
   operation.summary = summary;
 };
-const updateOperationMethodDraft = ({
-  document,
-  meta,
-  payload: { method }
-}) => {
-  if (!document) {
+const updateOperationMethod = (document, { meta, payload: { method } }) => {
+  const operation = getResolvedRef(document?.paths?.[meta.path]?.[meta.method]);
+  if (!operation) {
+    console.error("Operation not found", { meta, document });
     return;
   }
-  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
-  if (!operation) {
+  const path = document?.paths?.[meta.path];
+  if (!path) {
+    console.error("Path not found", { meta, document });
     return;
   }
-  operation["x-scalar-method"] = method;
+  path[method] = unpackProxyObject(operation);
+  delete path[meta.method];
 };
-const updateOperationPathDraft = ({
-  document,
-  meta,
-  payload: { path }
-}) => {
+const updateOperationPath = (document, { meta, payload: { path } }) => {
   if (!document) {
     return;
   }
@@ -39,24 +99,35 @@ const updateOperationPathDraft = ({
   if (!operation) {
     return;
   }
-  operation["x-scalar-path"] = path;
-  const pathVariables = Array.from(path.matchAll(/{([^\/}]+)}/g), (m) => m[1]);
-  const pathVariablesWithoutPathParameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== "path");
-  operation.parameters = [
-    ...pathVariablesWithoutPathParameters ?? [],
-    ...pathVariables.map((it) => ({
-      name: it ?? "",
-      in: "path",
-      required: true
-    }))
-  ];
+  if (meta.path === path) {
+    return;
+  }
+  const oldPathParams = findVariables(meta.path, { includePath: true, includeEnv: false }).filter(
+    (v) => v !== void 0
+  );
+  const newPathParams = findVariables(path, { includePath: true, includeEnv: false }).filter(
+    (v) => v !== void 0
+  );
+  if (oldPathParams.length > 0 || newPathParams.length > 0) {
+    const existingParameters = operation.parameters ?? [];
+    operation.parameters = syncParametersForPathChange(path, meta.path, existingParameters);
+  }
+  if (!document.paths) {
+    document.paths = {};
+  }
+  if (!document.paths[path]) {
+    document.paths[path] = {};
+  }
+  document.paths[path][meta.method] = unpackProxyObject(operation);
+  const oldPath = document.paths[meta.path];
+  if (oldPath) {
+    delete oldPath[meta.method];
+    if (Object.keys(oldPath).length === 0) {
+      delete document.paths[meta.path];
+    }
+  }
 };
-const addOperationParameter = ({
-  document,
-  meta,
-  payload,
-  type
-}) => {
+const addOperationParameter = (document, { meta, payload, type }) => {
   if (!document) {
     return;
   }
@@ -79,13 +150,7 @@ const addOperationParameter = ({
     }
   });
 };
-const updateOperationParameter = ({
-  document,
-  meta,
-  type,
-  payload,
-  index
-}) => {
+const updateOperationParameter = (document, { meta, type, payload, index }) => {
   if (!document) {
     return;
   }
@@ -99,24 +164,24 @@ const updateOperationParameter = ({
     return;
   }
   parameter.name = payload.key ?? parameter.name ?? "";
-  if ("examples" in parameter) {
-    if (!parameter.examples) {
-      parameter.examples = {};
-    }
-    const example = getResolvedRef(parameter.examples[meta.exampleKey]);
-    if (!example) {
-      return;
-    }
-    example.value = payload.value ?? example?.value ?? "";
-    example["x-disabled"] = payload.isEnabled === void 0 ? example["x-disabled"] : !payload.isEnabled;
+  if (isContentTypeParameterObject(parameter)) {
+    return;
+  }
+  if (!parameter.examples) {
+    parameter.examples = {};
+  }
+  const example = getResolvedRef(parameter.examples[meta.exampleKey]);
+  if (!example) {
+    parameter.examples[meta.exampleKey] = {
+      value: payload.value ?? "",
+      "x-disabled": payload.isEnabled === void 0 ? false : !payload.isEnabled
+    };
+    return;
   }
+  example.value = payload.value ?? example?.value ?? "";
+  example["x-disabled"] = payload.isEnabled === void 0 ? example["x-disabled"] : !payload.isEnabled;
 };
-const deleteOperationParameter = ({
-  document,
-  meta,
-  index,
-  type
-}) => {
+const deleteOperationParameter = (document, { meta, index, type }) => {
   if (!document) {
     return;
   }
@@ -132,11 +197,7 @@ const deleteOperationParameter = ({
   const actualIndex = operation.parameters?.findIndex((it) => getResolvedRef(it) === parameter);
   operation.parameters?.splice(actualIndex, 1);
 };
-const deleteAllOperationParameters = ({
-  document,
-  meta,
-  type
-}) => {
+const deleteAllOperationParameters = (document, { meta, type }) => {
   if (!document) {
     return;
   }
@@ -146,11 +207,7 @@ const deleteAllOperationParameters = ({
   }
   operation.parameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== type) ?? [];
 };
-const updateOperationRequestBodyContentType = ({
-  document,
-  meta,
-  payload
-}) => {
+const updateOperationRequestBodyContentType = (document, { meta, payload }) => {
   if (!document) {
     return;
   }
@@ -170,12 +227,7 @@ const updateOperationRequestBodyContentType = ({
   }
   requestBody["x-scalar-selected-content-type"][meta.exampleKey] = payload.contentType;
 };
-const updateOperationRequestBodyExample = ({
-  document,
-  meta,
-  payload,
-  contentType
-}) => {
+const updateOperationRequestBodyExample = (document, { meta, payload, contentType }) => {
   if (!document) {
     return;
   }
@@ -207,12 +259,7 @@ const updateOperationRequestBodyExample = ({
   }
   example.value = payload.value;
 };
-const addOperationRequestBodyFormRow = ({
-  document,
-  meta,
-  payload,
-  contentType
-}) => {
+const addOperationRequestBodyFormRow = (document, { meta, payload, contentType }) => {
   if (!document) {
     return;
   }
@@ -253,13 +300,7 @@ const addOperationRequestBodyFormRow = ({
     value: payload.value ?? ""
   });
 };
-const updateOperationRequestBodyFormRow = ({
-  document,
-  meta,
-  index,
-  payload,
-  contentType
-}) => {
+const updateOperationRequestBodyFormRow = (document, { meta, index, payload, contentType }) => {
   if (!document) {
     return;
   }
@@ -290,12 +331,7 @@ const updateOperationRequestBodyFormRow = ({
     value: payload.value === null ? void 0 : payload.value ?? example.value[index]?.value ?? ""
   };
 };
-const deleteOperationRequestBodyFormRow = ({
-  document,
-  meta,
-  index,
-  contentType
-}) => {
+const deleteOperationRequestBodyFormRow = (document, { meta, index, contentType }) => {
   if (!document) {
     return;
   }
@@ -329,9 +365,9 @@ export {
   deleteAllOperationParameters,
   deleteOperationParameter,
   deleteOperationRequestBodyFormRow,
-  updateOperationMethodDraft,
+  updateOperationMethod,
   updateOperationParameter,
-  updateOperationPathDraft,
+  updateOperationPath,
   updateOperationRequestBodyContentType,
   updateOperationRequestBodyExample,
   updateOperationRequestBodyFormRow,

package/dist/mutators/operation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/operation.ts"],
-  "sourcesContent": ["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\n\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport type { WorkspaceDocument } from '@/schemas'\n\n/**\n * Describes the minimal identity for an operation in the workspace document.\n * It is used by mutators to find the target operation under `paths`.\n *\n * Example:\n * ```ts\n * const meta: OperationMeta = { method: 'get', path: '/users/{id}' }\n * ```\n */\nexport type OperationMeta = {\n  method: HttpMethod\n  path: string\n}\n\n/**\n * Extends {@link OperationMeta} with an `exampleKey` to address a specific\n * example variant (e.g. per environment or scenario) for request/parameters.\n *\n * Example:\n * ```ts\n * const meta: OperationExampleMeta = {\n *   method: 'post',\n *   path: '/upload',\n *   exampleKey: 'default',\n * }\n * ```\n */\nexport type OperationExampleMeta = OperationMeta & {\n  exampleKey: string\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Operation Draft Mutators\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Updates the `summary` of an operation.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationSummary({\n *   document,\n *   meta: { method: 'get', path: '/users/{id}' },\n *   payload: { summary: 'Get a single user' },\n * })\n * ```\n */\nexport const updateOperationSummary = ({\n  document,\n  meta,\n  payload: { summary },\n}: {\n  document: WorkspaceDocument | null\n  payload: { summary: string }\n  meta: OperationMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method as HttpMethod])\n\n  if (!operation) {\n    return\n  }\n\n  operation.summary = summary\n}\n\n/**\n * Stores the chosen HTTP method under `x-scalar-method` on the operation.\n * This does not move the operation to a different method slot under `paths`;\n * it records the desired method as an extension for downstream consumers.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationMethodDraft({\n *   document,\n *   meta: { method: 'get', path: '/users' },\n *   payload: { method: 'post' },\n * })\n * ```\n */\nexport const updateOperationMethodDraft = ({\n  document,\n  meta,\n  payload: { method },\n}: {\n  document: WorkspaceDocument | null\n  payload: { method: HttpMethod }\n  meta: OperationMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  if (!operation) {\n    return\n  }\n\n  operation['x-scalar-method'] = method\n}\n\n/**\n * Records a normalized path for the operation under `x-scalar-path`, and\n * synchronizes path parameters in `operation.parameters` with the placeholders\n * present in the provided `path` (e.g. `/users/{id}`). Existing non-path\n * parameters are preserved.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationPathDraft({\n *   document,\n *   meta: { method: 'get', path: '/users/{id}' },\n *   payload: { path: '/users/{id}' },\n * })\n * ```\n */\nexport const updateOperationPathDraft = ({\n  document,\n  meta,\n  payload: { path },\n}: {\n  document: WorkspaceDocument | null\n  payload: { path: string }\n  meta: OperationMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  if (!operation) {\n    return\n  }\n\n  operation['x-scalar-path'] = path\n\n  // Extract the path variables from the path\n  const pathVariables = Array.from(path.matchAll(/{([^\\/}]+)}/g), (m) => m[1])\n\n  // now we need to update the operation path variables\n  const pathVariablesWithoutPathParameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== 'path')\n\n  operation.parameters = [\n    ...(pathVariablesWithoutPathParameters ?? []),\n    ...pathVariables.map((it) => ({\n      name: it ?? '',\n      in: 'path' as const,\n      required: true,\n    })),\n  ]\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Operation Parameters Mutators\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Adds a parameter to the operation with an example value tracked by `exampleKey`.\n * For `path` parameters `required` is set to true automatically.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * addOperationParameter({\n *   document,\n *   type: 'query',\n *   meta: { method: 'get', path: '/search', exampleKey: 'default' },\n *   payload: { key: 'q', value: 'john', isEnabled: true },\n * })\n * ```\n */\nexport const addOperationParameter = ({\n  document,\n  meta,\n  payload,\n  type,\n}: {\n  document: WorkspaceDocument | null\n  type: 'header' | 'path' | 'query' | 'cookie'\n  payload: {\n    key: string\n    value: string\n    isEnabled: boolean\n  }\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Initialize parameters array if it doesn't exist\n  if (!operation.parameters) {\n    operation.parameters = []\n  }\n\n  // Add the new parameter\n  operation.parameters.push({\n    name: payload.key,\n    in: type,\n    required: type === 'path' ? true : false,\n    examples: {\n      [meta.exampleKey]: {\n        value: payload.value,\n        'x-disabled': !payload.isEnabled,\n      },\n    },\n  })\n}\n\n/**\n * Updates an existing parameter of a given `type` by its index within that\n * type subset (e.g. the N-th query parameter). Supports updating name, value,\n * and enabled state for the targeted example.\n * Safely no-ops if the document, operation, or parameter does not exist.\n *\n * Example:\n * ```ts\n * updateOperationParameter({\n *   document,\n *   type: 'query',\n *   index: 0,\n *   meta: { method: 'get', path: '/search', exampleKey: 'default' },\n *   payload: { value: 'alice', isEnabled: true },\n * })\n * ```\n */\nexport const updateOperationParameter = ({\n  document,\n  meta,\n  type,\n  payload,\n  index,\n}: {\n  document: WorkspaceDocument | null\n  type: 'header' | 'path' | 'query' | 'cookie'\n  index: number\n  payload: Partial<{\n    key: string\n    value: string\n    isEnabled: boolean\n  }>\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Get all resolved parameters of the specified type\n  // The passed index corresponds to this filtered list\n  const resolvedParameters = operation.parameters?.map((it) => getResolvedRef(it)).filter((it) => it.in === type) ?? []\n  const parameter = resolvedParameters[index]\n\n  // Don't proceed if parameter doesn't exist\n  if (!parameter) {\n    return\n  }\n\n  parameter.name = payload.key ?? parameter.name ?? ''\n\n  // TODO: handle content-type parameters\n  if ('examples' in parameter) {\n    if (!parameter.examples) {\n      parameter.examples = {}\n    }\n\n    const example = getResolvedRef(parameter.examples[meta.exampleKey])\n\n    if (!example) {\n      return\n    }\n\n    example.value = payload.value ?? example?.value ?? ''\n    example['x-disabled'] = payload.isEnabled === undefined ? example['x-disabled'] : !payload.isEnabled\n  }\n}\n\n/**\n * Removes a parameter from the operation by resolving its position within\n * the filtered list of parameters of the specified `type`.\n * Safely no-ops if the document, operation, or parameter does not exist.\n *\n * Example:\n * ```ts\n * deleteOperationParameter({\n *   document,\n *   type: 'header',\n *   index: 1,\n *   meta: { method: 'get', path: '/users', exampleKey: 'default' },\n * })\n * ```\n */\nexport const deleteOperationParameter = ({\n  document,\n  meta,\n  index,\n  type,\n}: {\n  document: WorkspaceDocument | null\n  type: 'header' | 'path' | 'query' | 'cookie'\n  index: number\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Translate the index from the filtered list to the actual parameters array\n  const resolvedParameters = operation.parameters?.map((it) => getResolvedRef(it)).filter((it) => it.in === type) ?? []\n  const parameter = resolvedParameters[index]\n\n  // Don't proceed if parameter doesn't exist\n  if (!parameter) {\n    return\n  }\n\n  const actualIndex = operation.parameters?.findIndex((it) => getResolvedRef(it) === parameter) as number\n\n  // Remove the parameter from the operation\n  operation.parameters?.splice(actualIndex, 1)\n}\n\n/**\n * Deletes all parameters of a given `type` from the operation.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * deleteAllOperationParameters({\n *   document,\n *   type: 'cookie',\n *   meta: { method: 'get', path: '/users' },\n * })\n * ```\n */\nexport const deleteAllOperationParameters = ({\n  document,\n  meta,\n  type,\n}: {\n  document: WorkspaceDocument | null\n  type: 'header' | 'path' | 'query' | 'cookie'\n  meta: OperationMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Filter out parameters of the specified type\n  operation.parameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== type) ?? []\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Operation Request Body Mutators\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Sets the selected request-body content type for the current `exampleKey`.\n * This stores the selection under `x-scalar-selected-content-type` on the\n * resolved requestBody. Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationRequestBodyContentType({\n *   document,\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n *   payload: { contentType: 'multipart/form-data' },\n * })\n * ```\n */\nexport const updateOperationRequestBodyContentType = ({\n  document,\n  meta,\n  payload,\n}: {\n  document: WorkspaceDocument | null\n  payload: {\n    contentType: string\n  }\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!['x-scalar-selected-content-type']) {\n    requestBody!['x-scalar-selected-content-type'] = {}\n  }\n\n  requestBody!['x-scalar-selected-content-type'][meta.exampleKey] = payload.contentType\n}\n\n/**\n * Creates or updates a concrete example value for a specific request-body\n * `contentType` and `exampleKey`. Safely no-ops if the document or operation\n * does not exist.\n *\n * Example:\n * ```ts\n * updateOperationRequestBodyExample({\n *   document,\n *   contentType: 'application/json',\n *   meta: { method: 'post', path: '/users', exampleKey: 'default' },\n *   payload: { value: JSON.stringify({ name: 'Ada' }) },\n * })\n * ```\n */\nexport const updateOperationRequestBodyExample = ({\n  document,\n  meta,\n  payload,\n  contentType,\n}: {\n  document: WorkspaceDocument | null\n  contentType: string\n  payload: {\n    value: string | File | undefined\n  }\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!.content[contentType]) {\n    requestBody!.content[contentType] = {\n      examples: {},\n    }\n  }\n\n  // Ensure examples object exists and get a resolved reference\n  const mediaType = requestBody!.content[contentType]!\n  mediaType.examples ??= {}\n  const examples = getResolvedRef(mediaType.examples)!\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n\n  if (!example) {\n    examples[meta.exampleKey] = {\n      value: payload.value,\n    }\n    return\n  }\n\n  example.value = payload.value\n}\n\n/**\n * Appends a form-data row to the request-body example identified by\n * `contentType` and `exampleKey`. Initializes the example as an array when\n * needed. Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * addOperationRequestBodyFormRow({\n *   document,\n *   contentType: 'multipart/form-data',\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n *   payload: { key: 'file', value: new File(['x'], 'a.txt') },\n * })\n * ```\n */\nexport const addOperationRequestBodyFormRow = ({\n  document,\n  meta,\n  payload,\n  contentType,\n}: {\n  document: WorkspaceDocument | null\n  payload: Partial<{ key: string; value?: string | File }>\n  contentType: string\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!.content[contentType]) {\n    requestBody!.content[contentType] = {\n      examples: {},\n    }\n  }\n\n  if (!requestBody!.content[contentType]!.examples) {\n    requestBody!.content[contentType]!.examples = {}\n  }\n\n  const examples = getResolvedRef(requestBody!.content[contentType]!.examples)\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n\n  if (!example || !Array.isArray(example.value)) {\n    examples[meta.exampleKey] = {\n      value: [\n        {\n          name: payload.key,\n          value: payload.value,\n        },\n      ],\n    }\n    return\n  }\n\n  // Add the new row to the example\n  example.value.push({\n    name: payload.key ?? '',\n    value: payload.value ?? '',\n  })\n}\n\n/**\n * Updates a form-data row at a given `index` for the specified example and\n * `contentType`. Setting `payload.value` to `null` clears the value (sets to\n * `undefined`). Safely no-ops if the document, operation, or example does not exist.\n *\n * Example:\n * ```ts\n * updateOperationRequestBodyFormRow({\n *   document,\n *   index: 0,\n *   contentType: 'multipart/form-data',\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n *   payload: { key: 'description', value: 'Profile picture' },\n * })\n * ```\n */\nexport const updateOperationRequestBodyFormRow = ({\n  document,\n  meta,\n  index,\n  payload,\n  contentType,\n}: {\n  document: WorkspaceDocument | null\n  index: number\n  payload: Partial<{ key: string; value: string | File | null }>\n  contentType: string\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!.content[contentType]) {\n    return\n  }\n\n  const examples = getResolvedRef(requestBody!.content[contentType]!.examples)\n\n  if (!examples) {\n    return\n  }\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n\n  if (!example || !Array.isArray(example.value)) {\n    return\n  }\n\n  example.value[index] = {\n    name: payload.key ?? example.value[index]?.name ?? '',\n    value: payload.value === null ? undefined : (payload.value ?? example.value[index]?.value ?? ''),\n  }\n}\n\n/**\n * Deletes a form-data row at a given `index` from the example for the given\n * `contentType`. If the example becomes empty, the example entry is removed.\n * Safely no-ops if the document, operation, example, or row does not exist.\n *\n * Example:\n * ```ts\n * deleteOperationRequestBodyFormRow({\n *   document,\n *   index: 0,\n *   contentType: 'multipart/form-data',\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n * })\n * ```\n */\nexport const deleteOperationRequestBodyFormRow = ({\n  document,\n  meta,\n  index,\n  contentType,\n}: {\n  document: WorkspaceDocument | null\n  index: number\n  contentType: string\n  meta: OperationExampleMeta\n}) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  const requestBody = getResolvedRef(operation.requestBody)\n\n  if (!requestBody) {\n    return\n  }\n\n  if (!requestBody.content[contentType]) {\n    return\n  }\n\n  const examples = getResolvedRef(requestBody.content[contentType]!.examples)\n\n  if (!examples) {\n    return\n  }\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n\n  if (!example || !Array.isArray(example.value)) {\n    return\n  }\n\n  example.value.splice(index, 1)\n\n  if (example.value.length === 0) {\n    delete requestBody.content[contentType]!.examples![meta.exampleKey]\n  }\n}\n"],
-  "mappings": "AAEA,SAAS,sBAAsB;AAmDxB,MAAM,yBAAyB,CAAC;AAAA,EACrC;AAAA,EACA;AAAA,EACA,SAAS,EAAE,QAAQ;AACrB,MAIM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAoB,CAAC;AAEzF,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,YAAU,UAAU;AACtB;AAiBO,MAAM,6BAA6B,CAAC;AAAA,EACzC;AAAA,EACA;AAAA,EACA,SAAS,EAAE,OAAO;AACpB,MAIM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAE3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,YAAU,iBAAiB,IAAI;AACjC;AAkBO,MAAM,2BAA2B,CAAC;AAAA,EACvC;AAAA,EACA;AAAA,EACA,SAAS,EAAE,KAAK;AAClB,MAIM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAE3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,YAAU,eAAe,IAAI;AAG7B,QAAM,gBAAgB,MAAM,KAAK,KAAK,SAAS,cAAc,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAG3E,QAAM,qCAAqC,UAAU,YAAY,OAAO,CAAC,OAAO,eAAe,EAAE,EAAE,OAAO,MAAM;AAEhH,YAAU,aAAa;AAAA,IACrB,GAAI,sCAAsC,CAAC;AAAA,IAC3C,GAAG,cAAc,IAAI,CAAC,QAAQ;AAAA,MAC5B,MAAM,MAAM;AAAA,MACZ,IAAI;AAAA,MACJ,UAAU;AAAA,IACZ,EAAE;AAAA,EACJ;AACF;AAqBO,MAAM,wBAAwB,CAAC;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MASM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAGA,MAAI,CAAC,UAAU,YAAY;AACzB,cAAU,aAAa,CAAC;AAAA,EAC1B;AAGA,YAAU,WAAW,KAAK;AAAA,IACxB,MAAM,QAAQ;AAAA,IACd,IAAI;AAAA,IACJ,UAAU,SAAS,SAAS,OAAO;AAAA,IACnC,UAAU;AAAA,MACR,CAAC,KAAK,UAAU,GAAG;AAAA,QACjB,OAAO,QAAQ;AAAA,QACf,cAAc,CAAC,QAAQ;AAAA,MACzB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAmBO,MAAM,2BAA2B,CAAC;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAUM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAIA,QAAM,qBAAqB,UAAU,YAAY,IAAI,CAAC,OAAO,eAAe,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,IAAI,KAAK,CAAC;AACpH,QAAM,YAAY,mBAAmB,KAAK;AAG1C,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,YAAU,OAAO,QAAQ,OAAO,UAAU,QAAQ;AAGlD,MAAI,cAAc,WAAW;AAC3B,QAAI,CAAC,UAAU,UAAU;AACvB,gBAAU,WAAW,CAAC;AAAA,IACxB;AAEA,UAAM,UAAU,eAAe,UAAU,SAAS,KAAK,UAAU,CAAC;AAElE,QAAI,CAAC,SAAS;AACZ;AAAA,IACF;AAEA,YAAQ,QAAQ,QAAQ,SAAS,SAAS,SAAS;AACnD,YAAQ,YAAY,IAAI,QAAQ,cAAc,SAAY,QAAQ,YAAY,IAAI,CAAC,QAAQ;AAAA,EAC7F;AACF;AAiBO,MAAM,2BAA2B,CAAC;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAKM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAGA,QAAM,qBAAqB,UAAU,YAAY,IAAI,CAAC,OAAO,eAAe,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,IAAI,KAAK,CAAC;AACpH,QAAM,YAAY,mBAAmB,KAAK;AAG1C,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,QAAM,cAAc,UAAU,YAAY,UAAU,CAAC,OAAO,eAAe,EAAE,MAAM,SAAS;AAG5F,YAAU,YAAY,OAAO,aAAa,CAAC;AAC7C;AAeO,MAAM,+BAA+B,CAAC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF,MAIM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAGA,YAAU,aAAa,UAAU,YAAY,OAAO,CAAC,OAAO,eAAe,EAAE,EAAE,OAAO,IAAI,KAAK,CAAC;AAClG;AAoBO,MAAM,wCAAwC,CAAC;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AACF,MAMM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,MAAI,cAAc,eAAe,UAAU,WAAW;AAEtD,MAAI,CAAC,aAAa;AAChB,cAAU,cAAc;AAAA,MACtB,SAAS,CAAC;AAAA,IACZ;AACA,kBAAc,eAAe,UAAU,WAAW;AAAA,EACpD;AAEA,MAAI,CAAC,YAAa,gCAAgC,GAAG;AACnD,gBAAa,gCAAgC,IAAI,CAAC;AAAA,EACpD;AAEA,cAAa,gCAAgC,EAAE,KAAK,UAAU,IAAI,QAAQ;AAC5E;AAiBO,MAAM,oCAAoC,CAAC;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAOM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,MAAI,cAAc,eAAe,UAAU,WAAW;AAEtD,MAAI,CAAC,aAAa;AAChB,cAAU,cAAc;AAAA,MACtB,SAAS,CAAC;AAAA,IACZ;AACA,kBAAc,eAAe,UAAU,WAAW;AAAA,EACpD;AAEA,MAAI,CAAC,YAAa,QAAQ,WAAW,GAAG;AACtC,gBAAa,QAAQ,WAAW,IAAI;AAAA,MAClC,UAAU,CAAC;AAAA,IACb;AAAA,EACF;AAGA,QAAM,YAAY,YAAa,QAAQ,WAAW;AAClD,YAAU,aAAa,CAAC;AACxB,QAAM,WAAW,eAAe,UAAU,QAAQ;AAElD,QAAM,UAAU,eAAe,SAAS,KAAK,UAAU,CAAC;AAExD,MAAI,CAAC,SAAS;AACZ,aAAS,KAAK,UAAU,IAAI;AAAA,MAC1B,OAAO,QAAQ;AAAA,IACjB;AACA;AAAA,EACF;AAEA,UAAQ,QAAQ,QAAQ;AAC1B;AAiBO,MAAM,iCAAiC,CAAC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAKM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,MAAI,cAAc,eAAe,UAAU,WAAW;AAEtD,MAAI,CAAC,aAAa;AAChB,cAAU,cAAc;AAAA,MACtB,SAAS,CAAC;AAAA,IACZ;AACA,kBAAc,eAAe,UAAU,WAAW;AAAA,EACpD;AAEA,MAAI,CAAC,YAAa,QAAQ,WAAW,GAAG;AACtC,gBAAa,QAAQ,WAAW,IAAI;AAAA,MAClC,UAAU,CAAC;AAAA,IACb;AAAA,EACF;AAEA,MAAI,CAAC,YAAa,QAAQ,WAAW,EAAG,UAAU;AAChD,gBAAa,QAAQ,WAAW,EAAG,WAAW,CAAC;AAAA,EACjD;AAEA,QAAM,WAAW,eAAe,YAAa,QAAQ,WAAW,EAAG,QAAQ;AAE3E,QAAM,UAAU,eAAe,SAAS,KAAK,UAAU,CAAC;AAExD,MAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,QAAQ,KAAK,GAAG;AAC7C,aAAS,KAAK,UAAU,IAAI;AAAA,MAC1B,OAAO;AAAA,QACL;AAAA,UACE,MAAM,QAAQ;AAAA,UACd,OAAO,QAAQ;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AACA;AAAA,EACF;AAGA,UAAQ,MAAM,KAAK;AAAA,IACjB,MAAM,QAAQ,OAAO;AAAA,IACrB,OAAO,QAAQ,SAAS;AAAA,EAC1B,CAAC;AACH;AAkBO,MAAM,oCAAoC,CAAC;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAMM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,MAAI,cAAc,eAAe,UAAU,WAAW;AAEtD,MAAI,CAAC,aAAa;AAChB,cAAU,cAAc;AAAA,MACtB,SAAS,CAAC;AAAA,IACZ;AACA,kBAAc,eAAe,UAAU,WAAW;AAAA,EACpD;AAEA,MAAI,CAAC,YAAa,QAAQ,WAAW,GAAG;AACtC;AAAA,EACF;AAEA,QAAM,WAAW,eAAe,YAAa,QAAQ,WAAW,EAAG,QAAQ;AAE3E,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,UAAU,eAAe,SAAS,KAAK,UAAU,CAAC;AAExD,MAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,QAAQ,KAAK,GAAG;AAC7C;AAAA,EACF;AAEA,UAAQ,MAAM,KAAK,IAAI;AAAA,IACrB,MAAM,QAAQ,OAAO,QAAQ,MAAM,KAAK,GAAG,QAAQ;AAAA,IACnD,OAAO,QAAQ,UAAU,OAAO,SAAa,QAAQ,SAAS,QAAQ,MAAM,KAAK,GAAG,SAAS;AAAA,EAC/F;AACF;AAiBO,MAAM,oCAAoC,CAAC;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAKM;AACJ,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,YAAY,eAAe,SAAS,QAAQ,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;AAG3E,MAAI,CAAC,WAAW;AACd;AAAA,EACF;AAEA,QAAM,cAAc,eAAe,UAAU,WAAW;AAExD,MAAI,CAAC,aAAa;AAChB;AAAA,EACF;AAEA,MAAI,CAAC,YAAY,QAAQ,WAAW,GAAG;AACrC;AAAA,EACF;AAEA,QAAM,WAAW,eAAe,YAAY,QAAQ,WAAW,EAAG,QAAQ;AAE1E,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,QAAM,UAAU,eAAe,SAAS,KAAK,UAAU,CAAC;AAExD,MAAI,CAAC,WAAW,CAAC,MAAM,QAAQ,QAAQ,KAAK,GAAG;AAC7C;AAAA,EACF;AAEA,UAAQ,MAAM,OAAO,OAAO,CAAC;AAE7B,MAAI,QAAQ,MAAM,WAAW,GAAG;AAC9B,WAAO,YAAY,QAAQ,WAAW,EAAG,SAAU,KAAK,UAAU;AAAA,EACpE;AACF;",
+  "sourcesContent": ["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { findVariables } from '@scalar/helpers/regex/find-variables'\n\nimport type { OperationEvents } from '@/events/definitions/operation'\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport type { WorkspaceDocument } from '@/schemas'\nimport type { ParameterObject } from '@/schemas/v3.1/strict/openapi-document'\nimport type { ReferenceType } from '@/schemas/v3.1/strict/reference'\nimport { isContentTypeParameterObject } from '@/schemas/v3.1/strict/type-guards'\n\n/**\n * Describes the minimal identity for an operation in the workspace document.\n * It is used by mutators to find the target operation under `paths`.\n *\n * Example:\n * ```ts\n * const meta: OperationMeta = { method: 'get', path: '/users/{id}' }\n * ```\n */\nexport type OperationMeta = {\n  method: HttpMethod\n  path: string\n}\n\n/**\n * Extends {@link OperationMeta} with an `exampleKey` to address a specific\n * example variant (e.g. per environment or scenario) for request/parameters.\n *\n * Example:\n * ```ts\n * const meta: OperationExampleMeta = {\n *   method: 'post',\n *   path: '/upload',\n *   exampleKey: 'default',\n * }\n * ```\n */\nexport type OperationExampleMeta = OperationMeta & {\n  exampleKey: string\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Helper Functions for Path Parameter Synchronization\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Creates a map of parameter names to their character positions in a path.\n * Used to detect renamed path parameters by position matching.\n */\nconst getParameterPositions = (path: string, parameters: readonly string[]): Record<string, number> => {\n  const positions: Record<string, number> = {}\n\n  for (const paramName of parameters) {\n    const position = path.indexOf(`{${paramName}}`)\n    if (position !== -1) {\n      positions[paramName] = position\n    }\n  }\n\n  return positions\n}\n\n/**\n * Syncs path parameters when the path changes.\n *\n * Preserves parameter configurations by:\n * 1. Keeping parameters with matching names\n * 2. Renaming parameters at the same position\n * 3. Creating new parameters with empty examples\n * 4. Removing parameters that no longer exist in the new path\n */\nconst syncParametersForPathChange = (\n  newPath: string,\n  oldPath: string,\n  existingParameters: ReferenceType<ParameterObject>[],\n): ReferenceType<ParameterObject>[] => {\n  // Extract path parameter names from both paths\n  const oldPathParams = findVariables(oldPath, { includePath: true, includeEnv: false }).filter(\n    (v): v is string => v !== undefined,\n  )\n  const newPathParams = findVariables(newPath, { includePath: true, includeEnv: false }).filter(\n    (v): v is string => v !== undefined,\n  )\n\n  const oldPositions = getParameterPositions(oldPath, oldPathParams)\n  const newPositions = getParameterPositions(newPath, newPathParams)\n\n  // Separate path and non-path parameters, keeping original references\n  const pathParameters: ReferenceType<ParameterObject>[] = []\n  const nonPathParameters: ReferenceType<ParameterObject>[] = []\n\n  for (const param of existingParameters) {\n    const resolved = getResolvedRef(param)\n    if (resolved?.in === 'path') {\n      pathParameters.push(param)\n    } else {\n      nonPathParameters.push(param)\n    }\n  }\n\n  // Create a map of existing path parameters by name for quick lookup\n  const existingPathParamsByName = new Map<string, ReferenceType<ParameterObject>>()\n  for (const param of pathParameters) {\n    const resolved = getResolvedRef(param)\n    if (resolved?.name) {\n      existingPathParamsByName.set(resolved.name, param)\n    }\n  }\n\n  const usedOldParams = new Set<string>()\n  const syncedPathParameters: ReferenceType<ParameterObject>[] = []\n\n  for (const newParamName of newPathParams) {\n    // Case 1: Parameter with same name exists - preserve its config\n    if (existingPathParamsByName.has(newParamName)) {\n      syncedPathParameters.push(existingPathParamsByName.get(newParamName)!)\n      usedOldParams.add(newParamName)\n      continue\n    }\n\n    // Case 2: Check for parameter at same position (likely a rename)\n    const newParamPosition = newPositions[newParamName]\n    const oldParamAtPosition = oldPathParams.find(\n      (oldParam) => oldPositions[oldParam] === newParamPosition && !usedOldParams.has(oldParam),\n    )\n\n    if (oldParamAtPosition && existingPathParamsByName.has(oldParamAtPosition)) {\n      // Rename: transfer the old parameter's config to the new name\n      const oldParam = existingPathParamsByName.get(oldParamAtPosition)!\n      const resolved = getResolvedRef(oldParam)\n      if (resolved) {\n        resolved.name = newParamName\n        syncedPathParameters.push(oldParam)\n        usedOldParams.add(oldParamAtPosition)\n        continue\n      }\n    }\n\n    // Case 3: New parameter - create with empty examples\n    syncedPathParameters.push({\n      name: newParamName,\n      in: 'path',\n    })\n  }\n\n  // Return all parameters: synced path parameters + preserved non-path parameters\n  return [...syncedPathParameters, ...nonPathParameters]\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Operation Draft Mutators\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Updates the `summary` of an operation.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationSummary(\n *   document,\n *   {\n *   meta: { method: 'get', path: '/users/{id}' },\n *   payload: { summary: 'Get a single user' },\n * })\n * ```\n */\nexport const updateOperationSummary = (\n  document: WorkspaceDocument | null,\n  { meta, payload: { summary } }: OperationEvents['operation:update:summary'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method as HttpMethod])\n  if (!operation) {\n    return\n  }\n\n  operation.summary = summary\n}\n\n/**\n * Stores the chosen HTTP method under `x-scalar-method` on the operation.\n * This does not move the operation to a different method slot under `paths`;\n * it records the desired method as an extension for downstream consumers.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationMethodDraft({\n *   document,\n *   meta: { method: 'get', path: '/users' },\n *   payload: { method: 'post' },\n * })\n * ```\n */\nexport const updateOperationMethod = (\n  document: WorkspaceDocument | null,\n  { meta, payload: { method } }: OperationEvents['operation:update:method'],\n) => {\n  const operation = getResolvedRef(document?.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    console.error('Operation not found', { meta, document })\n    return\n  }\n\n  /** Ensure the path exists */\n  const path = document?.paths?.[meta.path]\n  if (!path) {\n    console.error('Path not found', { meta, document })\n    return\n  }\n\n  path[method] = unpackProxyObject(operation)\n  delete path[meta.method]\n}\n\n/**\n * Moves the operation to a new path in the document and synchronizes path\n * parameters in `operation.parameters` with the placeholders present in the\n * provided `path` (e.g. `/users/{id}`). When path parameters change,\n * intelligently syncs them by preserving configurations for renamed parameters\n * (detected by position) and existing parameters. Existing non-path parameters\n * are preserved. The operation is removed from the old path location.\n *\n * Example:\n * ```ts\n * updateOperationPath({\n *   document,\n *   meta: { method: 'get', path: '/users/{id}' },\n *   payload: { path: '/users/{userId}' },\n * })\n * ```\n */\nexport const updateOperationPath = (\n  document: WorkspaceDocument | null,\n  { meta, payload: { path } }: OperationEvents['operation:update:path'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    return\n  }\n\n  // If the path has not changed, no need to move the operation\n  if (meta.path === path) {\n    return\n  }\n\n  // Sync path parameters if either the old or new path has path parameters\n  const oldPathParams = findVariables(meta.path, { includePath: true, includeEnv: false }).filter(\n    (v): v is string => v !== undefined,\n  )\n  const newPathParams = findVariables(path, { includePath: true, includeEnv: false }).filter(\n    (v): v is string => v !== undefined,\n  )\n\n  if (oldPathParams.length > 0 || newPathParams.length > 0) {\n    const existingParameters = operation.parameters ?? []\n    operation.parameters = syncParametersForPathChange(path, meta.path, existingParameters)\n  }\n\n  // Initialize the paths object if it does not exist\n  if (!document.paths) {\n    document.paths = {}\n  }\n\n  // Initialize the new path if it does not exist\n  if (!document.paths[path]) {\n    document.paths[path] = {}\n  }\n\n  // Move the operation to the new path\n  document.paths[path][meta.method] = unpackProxyObject(operation)\n\n  // Remove the operation from the old path\n  const oldPath = document.paths[meta.path]\n  if (oldPath) {\n    delete oldPath[meta.method]\n\n    // If the old path has no more operations, remove the path entry\n    if (Object.keys(oldPath).length === 0) {\n      delete document.paths[meta.path]\n    }\n  }\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Operation Parameters Mutators\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Adds a parameter to the operation with an example value tracked by `exampleKey`.\n * For `path` parameters `required` is set to true automatically.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * addOperationParameter({\n *   document,\n *   type: 'query',\n *   meta: { method: 'get', path: '/search', exampleKey: 'default' },\n *   payload: { key: 'q', value: 'john', isEnabled: true },\n * })\n * ```\n */\nexport const addOperationParameter = (\n  document: WorkspaceDocument | null,\n  { meta, payload, type }: OperationEvents['operation:add:parameter'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Initialize parameters array if it doesn't exist\n  if (!operation.parameters) {\n    operation.parameters = []\n  }\n\n  // Add the new parameter\n  operation.parameters.push({\n    name: payload.key,\n    in: type,\n    required: type === 'path' ? true : false,\n    examples: {\n      [meta.exampleKey]: {\n        value: payload.value,\n        'x-disabled': !payload.isEnabled,\n      },\n    },\n  })\n}\n\n/**\n * Updates an existing parameter of a given `type` by its index within that\n * type subset (e.g. the N-th query parameter). Supports updating name, value,\n * and enabled state for the targeted example.\n * Safely no-ops if the document, operation, or parameter does not exist.\n *\n * Example:\n * ```ts\n * updateOperationParameter({\n *   document,\n *   type: 'query',\n *   index: 0,\n *   meta: { method: 'get', path: '/search', exampleKey: 'default' },\n *   payload: { value: 'alice', isEnabled: true },\n * })\n * ```\n */\nexport const updateOperationParameter = (\n  document: WorkspaceDocument | null,\n  { meta, type, payload, index }: OperationEvents['operation:update:parameter'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Get all resolved parameters of the specified type\n  // The passed index corresponds to this filtered list\n  const resolvedParameters = operation.parameters?.map((it) => getResolvedRef(it)).filter((it) => it.in === type) ?? []\n  const parameter = resolvedParameters[index]\n  if (!parameter) {\n    return\n  }\n\n  parameter.name = payload.key ?? parameter.name ?? ''\n\n  if (isContentTypeParameterObject(parameter)) {\n    // TODO: handle content-type parameters\n    return\n  }\n\n  if (!parameter.examples) {\n    parameter.examples = {}\n  }\n\n  const example = getResolvedRef(parameter.examples[meta.exampleKey])\n\n  // Create the example if it doesn't exist\n  if (!example) {\n    parameter.examples[meta.exampleKey] = {\n      value: payload.value ?? '',\n      'x-disabled': payload.isEnabled === undefined ? false : !payload.isEnabled,\n    }\n    return\n  }\n\n  // Update existing example value\n  example.value = payload.value ?? example?.value ?? ''\n  example['x-disabled'] = payload.isEnabled === undefined ? example['x-disabled'] : !payload.isEnabled\n}\n\n/**\n * Removes a parameter from the operation by resolving its position within\n * the filtered list of parameters of the specified `type`.\n * Safely no-ops if the document, operation, or parameter does not exist.\n *\n * Example:\n * ```ts\n * deleteOperationParameter({\n *   document,\n *   type: 'header',\n *   index: 1,\n *   meta: { method: 'get', path: '/users', exampleKey: 'default' },\n * })\n * ```\n */\nexport const deleteOperationParameter = (\n  document: WorkspaceDocument | null,\n  { meta, index, type }: OperationEvents['operation:delete:parameter'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  // Translate the index from the filtered list to the actual parameters array\n  const resolvedParameters = operation.parameters?.map((it) => getResolvedRef(it)).filter((it) => it.in === type) ?? []\n  const parameter = resolvedParameters[index]\n  if (!parameter) {\n    return\n  }\n\n  const actualIndex = operation.parameters?.findIndex((it) => getResolvedRef(it) === parameter) as number\n\n  // Remove the parameter from the operation\n  operation.parameters?.splice(actualIndex, 1)\n}\n\n/**\n * Deletes all parameters of a given `type` from the operation.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * deleteAllOperationParameters({\n *   document,\n *   type: 'cookie',\n *   meta: { method: 'get', path: '/users' },\n * })\n * ```\n */\nexport const deleteAllOperationParameters = (\n  document: WorkspaceDocument | null,\n  { meta, type }: OperationEvents['operation:delete-all:parameters'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    return\n  }\n\n  // Filter out parameters of the specified type\n  operation.parameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== type) ?? []\n}\n\n/** ------------------------------------------------------------------------------------------------\n * Operation Request Body Mutators\n * ------------------------------------------------------------------------------------------------ */\n\n/**\n * Sets the selected request-body content type for the current `exampleKey`.\n * This stores the selection under `x-scalar-selected-content-type` on the\n * resolved requestBody. Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationRequestBodyContentType({\n *   document,\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n *   payload: { contentType: 'multipart/form-data' },\n * })\n * ```\n */\nexport const updateOperationRequestBodyContentType = (\n  document: WorkspaceDocument | null,\n  { meta, payload }: OperationEvents['operation:update:requestBody:contentType'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!['x-scalar-selected-content-type']) {\n    requestBody!['x-scalar-selected-content-type'] = {}\n  }\n\n  requestBody!['x-scalar-selected-content-type'][meta.exampleKey] = payload.contentType\n}\n\n/**\n * Creates or updates a concrete example value for a specific request-body\n * `contentType` and `exampleKey`. Safely no-ops if the document or operation\n * does not exist.\n *\n * Example:\n * ```ts\n * updateOperationRequestBodyExample({\n *   document,\n *   contentType: 'application/json',\n *   meta: { method: 'post', path: '/users', exampleKey: 'default' },\n *   payload: { value: JSON.stringify({ name: 'Ada' }) },\n * })\n * ```\n */\nexport const updateOperationRequestBodyExample = (\n  document: WorkspaceDocument | null,\n  { meta, payload, contentType }: OperationEvents['operation:update:requestBody:value'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!.content[contentType]) {\n    requestBody!.content[contentType] = {\n      examples: {},\n    }\n  }\n\n  // Ensure examples object exists and get a resolved reference\n  const mediaType = requestBody!.content[contentType]!\n  mediaType.examples ??= {}\n  const examples = getResolvedRef(mediaType.examples)!\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n  if (!example) {\n    examples[meta.exampleKey] = {\n      value: payload.value,\n    }\n    return\n  }\n\n  example.value = payload.value\n}\n\n/**\n * Appends a form-data row to the request-body example identified by\n * `contentType` and `exampleKey`. Initializes the example as an array when\n * needed. Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * addOperationRequestBodyFormRow({\n *   document,\n *   contentType: 'multipart/form-data',\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n *   payload: { key: 'file', value: new File(['x'], 'a.txt') },\n * })\n * ```\n */\nexport const addOperationRequestBodyFormRow = (\n  document: WorkspaceDocument | null,\n  { meta, payload, contentType }: OperationEvents['operation:add:requestBody:formRow'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n\n  // Don't proceed if operation doesn't exist\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!.content[contentType]) {\n    requestBody!.content[contentType] = {\n      examples: {},\n    }\n  }\n\n  if (!requestBody!.content[contentType]!.examples) {\n    requestBody!.content[contentType]!.examples = {}\n  }\n\n  const examples = getResolvedRef(requestBody!.content[contentType]!.examples)\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n\n  if (!example || !Array.isArray(example.value)) {\n    examples[meta.exampleKey] = {\n      value: [\n        {\n          name: payload.key,\n          value: payload.value,\n        },\n      ],\n    }\n    return\n  }\n\n  // Add the new row to the example\n  example.value.push({\n    name: payload.key ?? '',\n    value: payload.value ?? '',\n  })\n}\n\n/**\n * Updates a form-data row at a given `index` for the specified example and\n * `contentType`. Setting `payload.value` to `null` clears the value (sets to\n * `undefined`). Safely no-ops if the document, operation, or example does not exist.\n *\n * Example:\n * ```ts\n * updateOperationRequestBodyFormRow({\n *   document,\n *   index: 0,\n *   contentType: 'multipart/form-data',\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n *   payload: { key: 'description', value: 'Profile picture' },\n * })\n * ```\n */\nexport const updateOperationRequestBodyFormRow = (\n  document: WorkspaceDocument | null,\n  { meta, index, payload, contentType }: OperationEvents['operation:update:requestBody:formRow'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    return\n  }\n\n  let requestBody = getResolvedRef(operation.requestBody)\n  if (!requestBody) {\n    operation.requestBody = {\n      content: {},\n    }\n    requestBody = getResolvedRef(operation.requestBody)\n  }\n\n  if (!requestBody!.content[contentType]) {\n    return\n  }\n\n  const examples = getResolvedRef(requestBody!.content[contentType]!.examples)\n  if (!examples) {\n    return\n  }\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n  if (!example || !Array.isArray(example.value)) {\n    return\n  }\n\n  example.value[index] = {\n    name: payload.key ?? example.value[index]?.name ?? '',\n    value: payload.value === null ? undefined : (payload.value ?? example.value[index]?.value ?? ''),\n  }\n}\n\n/**\n * Deletes a form-data row at a given `index` from the example for the given\n * `contentType`. If the example becomes empty, the example entry is removed.\n * Safely no-ops if the document, operation, example, or row does not exist.\n *\n * Example:\n * ```ts\n * deleteOperationRequestBodyFormRow({\n *   document,\n *   index: 0,\n *   contentType: 'multipart/form-data',\n *   meta: { method: 'post', path: '/upload', exampleKey: 'default' },\n * })\n * ```\n */\nexport const deleteOperationRequestBodyFormRow = (\n  document: WorkspaceDocument | null,\n  { meta, index, contentType }: OperationEvents['operation:delete:requestBody:formRow'],\n) => {\n  if (!document) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method])\n  if (!operation) {\n    return\n  }\n\n  const requestBody = getResolvedRef(operation.requestBody)\n  if (!requestBody) {\n    return\n  }\n\n  if (!requestBody.content[contentType]) {\n    return\n  }\n\n  const examples = getResolvedRef(requestBody.content[contentType]!.examples)\n  if (!examples) {\n    return\n  }\n\n  const example = getResolvedRef(examples[meta.exampleKey])\n  if (!example || !Array.isArray(example.value)) {\n    return\n  }\n\n  example.value.splice(index, 1)\n\n  if (example.value.length === 0) {\n    delete requestBody.content[contentType]!.examples![meta.exampleKey]\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/mutators/server.d.ts

@@ -1,12 +1,47 @@
-import type { ServerObject } from '../schemas/v3.1/strict/openapi-document.js';
+import type { ServerEvents } from '../events/definitions/server.js';
+import { type ServerObject } from '../schemas/v3.1/strict/openapi-document.js';
+import type { WorkspaceDocument } from '../schemas/workspace.js';
 /**
- * Provides mutator functions for managing an array of OpenAPI ServerObject entries.
+ * Adds a new ServerObject to the document.
  *
- * @param target - The array of ServerObject to mutate. If not provided, mutators will be no-ops.
- * @returns An object with addServer and deleteServer methods.
+ * @param document - The document to add the server to
+ * @returns the new server object or undefined if the document is not found
  */
-export declare const serverMutators: (target?: ServerObject[]) => {
-    addServer: (server: ServerObject) => boolean;
-    deleteServer: (url: string) => boolean;
-};
+export declare const addServer: (document: WorkspaceDocument | null) => ServerObject | undefined;
+/**
+ * Updates a ServerObject in the document.
+ * When the URL changes, intelligently syncs variables by preserving configurations
+ * for renamed variables (detected by position) and existing variables.
+ *
+ * @param document - The document containing the server to update
+ * @param index - The index of the server to update
+ * @param server - The partial server object with fields to update
+ * @returns the updated server object or undefined if the server is not found
+ */
+export declare const updateServer: (document: WorkspaceDocument | null, { index, server }: ServerEvents["server:update:server"]) => ServerObject | undefined;
+/**
+ * Deletes a ServerObject at the specified index from the target array.
+ *
+ * @param document - The document to delete the server from
+ * @param index - The index of the server to delete.
+ */
+export declare const deleteServer: (document: WorkspaceDocument | null, { index }: ServerEvents["server:delete:server"]) => void;
+/**
+ * Updates a server variable for the selected server
+ *
+ * @param document - The document to update the server variables in
+ * @param index - The index of the server to update
+ * @param key - The key of the variable to update
+ * @param value - The new value of the variable
+ * @returns the updated variable or undefined if the variable is not found
+ */
+export declare const updateServerVariables: (document: WorkspaceDocument | null, { index, key, value }: ServerEvents["server:update:variables"]) => import("../schemas/v3.1/strict/openapi-document.js").ServerVariableObject | undefined;
+/**
+ * Updates the selected server for the document
+ *
+ * @param document - The document to update the selected server in
+ * @param index - The index of the server to update
+ * @returns the url of the selected server or undefined if the server is not found
+ */
+export declare const updateSelectedServer: (document: WorkspaceDocument | null, { url }: ServerEvents["server:update:selected"]) => string | undefined;
 //# sourceMappingURL=server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mutators/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,YAAY,EAAE;wBAMzB,YAAY,KAAG,OAAO;wBAatB,MAAM,KAAG,OAAO;CAc5C,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mutators/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,wCAAwC,CAAA;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,iBAAiB,GAAG,IAAI,KAAG,YAAY,GAAG,SAc7E,CAAA;AAgFD;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,YAAY,CAAC,sBAAsB,CAAC,KACtD,YAAY,GAAG,SA+BjB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,WAAW,YAAY,CAAC,sBAAsB,CAAC,SAY/G,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,iBAAiB,GAAG,IAAI,EAClC,uBAAuB,YAAY,CAAC,yBAAyB,CAAC,sFAkB/D,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,iBAAiB,GAAG,IAAI,EAClC,SAAS,YAAY,CAAC,wBAAwB,CAAC,KAC9C,MAAM,GAAG,SAaX,CAAA"}