@scalar/workspace-store 0.20.0 → 0.21.0

package/dist/mutators/operation.d.ts

@@ -1,4 +1,5 @@
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+import type { OperationEvents } from '../events/definitions/operation.js';
 import type { WorkspaceDocument } from '../schemas.js';
 /**
  * Describes the minimal identity for an operation in the workspace document.
@@ -38,20 +39,15 @@ export type OperationExampleMeta = OperationMeta & {
  *
  * Example:
  * ```ts
- * updateOperationSummary({
+ * updateOperationSummary(
  *   document,
+ *   {
  *   meta: { method: 'get', path: '/users/{id}' },
  *   payload: { summary: 'Get a single user' },
  * })
  * ```
  */
-export declare const updateOperationSummary: ({ document, meta, payload: { summary }, }: {
-    document: WorkspaceDocument | null;
-    payload: {
-        summary: string;
-    };
-    meta: OperationMeta;
-}) => void;
+export declare const updateOperationSummary: (document: WorkspaceDocument | null, { meta, payload: { summary } }: OperationEvents["operation:update:summary"]) => void;
 /**
  * Stores the chosen HTTP method under `x-scalar-method` on the operation.
  * This does not move the operation to a different method slot under `paths`;
@@ -67,36 +63,25 @@ export declare const updateOperationSummary: ({ document, meta, payload: { summa
  * })
  * ```
  */
-export declare const updateOperationMethodDraft: ({ document, meta, payload: { method }, }: {
-    document: WorkspaceDocument | null;
-    payload: {
-        method: HttpMethod;
-    };
-    meta: OperationMeta;
-}) => void;
+export declare const updateOperationMethod: (document: WorkspaceDocument | null, { meta, payload: { method } }: OperationEvents["operation:update:method"]) => void;
 /**
- * Records a normalized path for the operation under `x-scalar-path`, and
- * synchronizes path parameters in `operation.parameters` with the placeholders
- * present in the provided `path` (e.g. `/users/{id}`). Existing non-path
- * parameters are preserved.
- * Safely no-ops if the document or operation does not exist.
+ * Moves the operation to a new path in the document and synchronizes path
+ * parameters in `operation.parameters` with the placeholders present in the
+ * provided `path` (e.g. `/users/{id}`). When path parameters change,
+ * intelligently syncs them by preserving configurations for renamed parameters
+ * (detected by position) and existing parameters. Existing non-path parameters
+ * are preserved. The operation is removed from the old path location.
  *
  * Example:
  * ```ts
- * updateOperationPathDraft({
+ * updateOperationPath({
  *   document,
  *   meta: { method: 'get', path: '/users/{id}' },
- *   payload: { path: '/users/{id}' },
+ *   payload: { path: '/users/{userId}' },
  * })
  * ```
  */
-export declare const updateOperationPathDraft: ({ document, meta, payload: { path }, }: {
-    document: WorkspaceDocument | null;
-    payload: {
-        path: string;
-    };
-    meta: OperationMeta;
-}) => void;
+export declare const updateOperationPath: (document: WorkspaceDocument | null, { meta, payload: { path } }: OperationEvents["operation:update:path"]) => void;
 /** ------------------------------------------------------------------------------------------------
  * Operation Parameters Mutators
  * ------------------------------------------------------------------------------------------------ */
@@ -115,16 +100,7 @@ export declare const updateOperationPathDraft: ({ document, meta, payload: { pat
  * })
  * ```
  */
-export declare const addOperationParameter: ({ document, meta, payload, type, }: {
-    document: WorkspaceDocument | null;
-    type: "header" | "path" | "query" | "cookie";
-    payload: {
-        key: string;
-        value: string;
-        isEnabled: boolean;
-    };
-    meta: OperationExampleMeta;
-}) => void;
+export declare const addOperationParameter: (document: WorkspaceDocument | null, { meta, payload, type }: OperationEvents["operation:add:parameter"]) => void;
 /**
  * Updates an existing parameter of a given `type` by its index within that
  * type subset (e.g. the N-th query parameter). Supports updating name, value,
@@ -142,17 +118,7 @@ export declare const addOperationParameter: ({ document, meta, payload, type, }:
  * })
  * ```
  */
-export declare const updateOperationParameter: ({ document, meta, type, payload, index, }: {
-    document: WorkspaceDocument | null;
-    type: "header" | "path" | "query" | "cookie";
-    index: number;
-    payload: Partial<{
-        key: string;
-        value: string;
-        isEnabled: boolean;
-    }>;
-    meta: OperationExampleMeta;
-}) => void;
+export declare const updateOperationParameter: (document: WorkspaceDocument | null, { meta, type, payload, index }: OperationEvents["operation:update:parameter"]) => void;
 /**
  * Removes a parameter from the operation by resolving its position within
  * the filtered list of parameters of the specified `type`.
@@ -168,12 +134,7 @@ export declare const updateOperationParameter: ({ document, meta, type, payload,
  * })
  * ```
  */
-export declare const deleteOperationParameter: ({ document, meta, index, type, }: {
-    document: WorkspaceDocument | null;
-    type: "header" | "path" | "query" | "cookie";
-    index: number;
-    meta: OperationExampleMeta;
-}) => void;
+export declare const deleteOperationParameter: (document: WorkspaceDocument | null, { meta, index, type }: OperationEvents["operation:delete:parameter"]) => void;
 /**
  * Deletes all parameters of a given `type` from the operation.
  * Safely no-ops if the document or operation does not exist.
@@ -187,11 +148,7 @@ export declare const deleteOperationParameter: ({ document, meta, index, type, }
  * })
  * ```
  */
-export declare const deleteAllOperationParameters: ({ document, meta, type, }: {
-    document: WorkspaceDocument | null;
-    type: "header" | "path" | "query" | "cookie";
-    meta: OperationMeta;
-}) => void;
+export declare const deleteAllOperationParameters: (document: WorkspaceDocument | null, { meta, type }: OperationEvents["operation:delete-all:parameters"]) => void;
 /** ------------------------------------------------------------------------------------------------
  * Operation Request Body Mutators
  * ------------------------------------------------------------------------------------------------ */
@@ -209,13 +166,7 @@ export declare const deleteAllOperationParameters: ({ document, meta, type, }: {
  * })
  * ```
  */
-export declare const updateOperationRequestBodyContentType: ({ document, meta, payload, }: {
-    document: WorkspaceDocument | null;
-    payload: {
-        contentType: string;
-    };
-    meta: OperationExampleMeta;
-}) => void;
+export declare const updateOperationRequestBodyContentType: (document: WorkspaceDocument | null, { meta, payload }: OperationEvents["operation:update:requestBody:contentType"]) => void;
 /**
  * Creates or updates a concrete example value for a specific request-body
  * `contentType` and `exampleKey`. Safely no-ops if the document or operation
@@ -231,14 +182,7 @@ export declare const updateOperationRequestBodyContentType: ({ document, meta, p
  * })
  * ```
  */
-export declare const updateOperationRequestBodyExample: ({ document, meta, payload, contentType, }: {
-    document: WorkspaceDocument | null;
-    contentType: string;
-    payload: {
-        value: string | File | undefined;
-    };
-    meta: OperationExampleMeta;
-}) => void;
+export declare const updateOperationRequestBodyExample: (document: WorkspaceDocument | null, { meta, payload, contentType }: OperationEvents["operation:update:requestBody:value"]) => void;
 /**
  * Appends a form-data row to the request-body example identified by
  * `contentType` and `exampleKey`. Initializes the example as an array when
@@ -254,15 +198,7 @@ export declare const updateOperationRequestBodyExample: ({ document, meta, paylo
  * })
  * ```
  */
-export declare const addOperationRequestBodyFormRow: ({ document, meta, payload, contentType, }: {
-    document: WorkspaceDocument | null;
-    payload: Partial<{
-        key: string;
-        value?: string | File;
-    }>;
-    contentType: string;
-    meta: OperationExampleMeta;
-}) => void;
+export declare const addOperationRequestBodyFormRow: (document: WorkspaceDocument | null, { meta, payload, contentType }: OperationEvents["operation:add:requestBody:formRow"]) => void;
 /**
  * Updates a form-data row at a given `index` for the specified example and
  * `contentType`. Setting `payload.value` to `null` clears the value (sets to
@@ -279,16 +215,7 @@ export declare const addOperationRequestBodyFormRow: ({ document, meta, payload,
  * })
  * ```
  */
-export declare const updateOperationRequestBodyFormRow: ({ document, meta, index, payload, contentType, }: {
-    document: WorkspaceDocument | null;
-    index: number;
-    payload: Partial<{
-        key: string;
-        value: string | File | null;
-    }>;
-    contentType: string;
-    meta: OperationExampleMeta;
-}) => void;
+export declare const updateOperationRequestBodyFormRow: (document: WorkspaceDocument | null, { meta, index, payload, contentType }: OperationEvents["operation:update:requestBody:formRow"]) => void;
 /**
  * Deletes a form-data row at a given `index` from the example for the given
  * `contentType`. If the example becomes empty, the example entry is removed.
@@ -304,10 +231,5 @@ export declare const updateOperationRequestBodyFormRow: ({ document, meta, index
  * })
  * ```
  */
-export declare const deleteOperationRequestBodyFormRow: ({ document, meta, index, contentType, }: {
-    document: WorkspaceDocument | null;
-    index: number;
-    contentType: string;
-    meta: OperationExampleMeta;
-}) => void;
+export declare const deleteOperationRequestBodyFormRow: (document: WorkspaceDocument | null, { meta, index, contentType }: OperationEvents["operation:delete:requestBody:formRow"]) => void;
 //# sourceMappingURL=operation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/mutators/operation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/mutators/operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAGnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAGrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAKlD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AA8GD;;sGAEsG;AAEtG;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gCAAgC,eAAe,CAAC,0BAA0B,CAAC,SAY5E,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,iBAAiB,GAAG,IAAI,EAClC,+BAA+B,eAAe,CAAC,yBAAyB,CAAC,SAiB1E,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,eAAe,CAAC,uBAAuB,CAAC,SAoDtE,CAAA;AAED;;sGAEsG;AAEtG;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,iBAAiB,GAAG,IAAI,EAClC,yBAAyB,eAAe,CAAC,yBAAyB,CAAC,SA8BpE,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gCAAgC,eAAe,CAAC,4BAA4B,CAAC,SA8C9E,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,uBAAuB,eAAe,CAAC,4BAA4B,CAAC,SAwBrE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gBAAgB,eAAe,CAAC,iCAAiC,CAAC,SAanE,CAAA;AAED;;sGAEsG;AAEtG;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qCAAqC,GAChD,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,eAAe,CAAC,0CAA0C,CAAC,SAwB/E,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iCAAiC,GAC5C,UAAU,iBAAiB,GAAG,IAAI,EAClC,gCAAgC,eAAe,CAAC,oCAAoC,CAAC,SAuCtF,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,GACzC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gCAAgC,eAAe,CAAC,mCAAmC,CAAC,SAqDrF,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iCAAiC,GAC5C,UAAU,iBAAiB,GAAG,IAAI,EAClC,uCAAuC,eAAe,CAAC,sCAAsC,CAAC,SAqC/F,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iCAAiC,GAC5C,UAAU,iBAAiB,GAAG,IAAI,EAClC,8BAA8B,eAAe,CAAC,sCAAsC,CAAC,SAmCtF,CAAA"}

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,