@scalar/workspace-store 0.34.4 → 0.35.2

package/dist/mutators/auth.js

@@ -59,6 +59,16 @@ const updateSelectedSecuritySchemes = async (store, document, { selectedRequirem
     { selectedIndex: getSelectedIndex(), selectedSchemes: newSelectedSecuritySchemes }
   );
 };
+const clearSelectedSecuritySchemes = (store, document, { meta }) => {
+  const documentName = document?.["x-scalar-navigation"]?.name;
+  if (!documentName) {
+    return;
+  }
+  if (meta.type === "document") {
+    return store?.auth.clearAuthSelectedSchemas({ type: "document", documentName });
+  }
+  return store?.auth.clearAuthSelectedSchemas({ type: "operation", documentName, path: meta.path, method: meta.method });
+};
 const updateSecurityScheme = (document, { payload, name }) => {
   const target = getResolvedRef(document?.components?.securitySchemes?.[name]);
   if (!target) {
@@ -166,13 +176,19 @@ const deleteSecurityScheme = (store, document, { names }) => {
   names.forEach((name) => {
     delete target[name];
   });
-  const filterSecuritySchemes = (schemes) => {
+  const clampIndex = (index, length) => {
+    return Math.max(0, Math.min(index, length - 1));
+  };
+  const filterSecuritySchemes = (_schemes) => {
+    const schemes = unpackProxyObject(_schemes, { depth: 1 }) ?? [];
     return schemes.filter((scheme) => !names.some((name) => Object.keys(scheme).includes(name)));
   };
   const documentSelectedSecurity = store?.auth.getAuthSelectedSchemas({ type: "document", documentName });
   if (documentSelectedSecurity) {
-    documentSelectedSecurity.selectedSchemes = filterSecuritySchemes(
-      unpackProxyObject(documentSelectedSecurity.selectedSchemes, { depth: 1 }) ?? []
+    documentSelectedSecurity.selectedSchemes = filterSecuritySchemes(documentSelectedSecurity.selectedSchemes);
+    documentSelectedSecurity.selectedIndex = clampIndex(
+      documentSelectedSecurity.selectedIndex,
+      documentSelectedSecurity.selectedSchemes.length
     );
   }
   if (document["security"]) {
@@ -194,8 +210,10 @@ const deleteSecurityScheme = (store, document, { names }) => {
         method
       });
       if (operationSelectedSecurity) {
-        operationSelectedSecurity.selectedSchemes = filterSecuritySchemes(
-          unpackProxyObject(operationSelectedSecurity.selectedSchemes, { depth: 1 }) ?? []
+        operationSelectedSecurity.selectedSchemes = filterSecuritySchemes(operationSelectedSecurity.selectedSchemes);
+        operationSelectedSecurity.selectedIndex = clampIndex(
+          operationSelectedSecurity.selectedIndex,
+          operationSelectedSecurity.selectedSchemes.length
         );
       }
     });
@@ -207,6 +225,7 @@ const authMutatorsFactory = ({
 }) => {
   return {
     updateSelectedSecuritySchemes: (payload) => updateSelectedSecuritySchemes(store, document, payload),
+    clearSelectedSecuritySchemes: (payload) => clearSelectedSecuritySchemes(store, document, payload),
     updateSecurityScheme: (payload) => updateSecurityScheme(document, payload),
     updateSecuritySchemeSecrets: (payload) => updateSecuritySchemeSecrets(store, document, payload),
     clearSecuritySchemeSecrets: (payload) => clearSecuritySchemeSecrets(store, document, payload),

package/dist/mutators/auth.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/auth.ts"],
-  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { AuthEvents } from '@/events/definitions/auth'\nimport { generateUniqueValue } from '@/helpers/generate-unique-value'\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport { isNonOptionalSecurityRequirement } from '@/helpers/is-non-optional-security-requirement'\nimport { mergeObjects } from '@/helpers/merge-object'\nimport { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport type { WorkspaceDocument } from '@/schemas'\nimport type { SecurityRequirementObject } from '@/schemas/v3.1/strict/security-requirement'\nimport type { OAuth2Object } from '@/schemas/v3.1/strict/security-scheme'\n\n/**\n * Updates the selected security schemes for either the entire document or a specific operation.\n * - Adds newly created security schemes (if any) to the workspace document's components.\n * - Ensures that each new scheme name is unique within the document by using `generateUniqueValue`.\n * - Updates the `x-scalar-selected-security` property on the target (document or operation) to reflect the new set of selected security schemes.\n * - Corrects and maintains the selected index so it points to a valid security scheme.\n *\n * @param document - The workspace OpenAPI document to mutate (can be null, in which case nothing happens)\n * @param selectedSecuritySchemes - The current list of selected security scheme objects\n * @param create - Array of new schemes to create, each with a name and a scheme definition\n * @param meta - Location to update: whole document or a specific operation (`{ type: 'document' }` or `{ type: 'operation', path, method }`)\n *\n * Example usage:\n * ```\n * updateSelectedSecuritySchemes({\n *   document,\n *   selectedSecuritySchemes: [{ bearerAuth: [] }],\n *   create: [\n *     { name: 'ApiKeyAuth', scheme: { type: 'apiKey', in: 'header', name: 'X-API-Key' } }\n *   ],\n *   meta: { type: 'document' }\n * })\n * ```\n */\nexport const updateSelectedSecuritySchemes = async (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { selectedRequirements, newSchemes, meta }: AuthEvents['auth:update:selected-security-schemes'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // Helper to get the target (whole document or a specific operation)\n  const getTarget = () => {\n    if (meta.type === 'document') {\n      return store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n    }\n\n    return store?.auth.getAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n  }\n\n  const createdSecurityRequirements = await Promise.all(\n    newSchemes.map(async (newScheme) => {\n      const uniqueSchemeName = await generateUniqueValue({\n        defaultValue: newScheme.name,\n        validation: (value) => !document.components?.securitySchemes?.[value],\n        maxRetries: 100,\n      })\n\n      if (!uniqueSchemeName) {\n        return\n      }\n\n      // Ensure components and securitySchemes exist\n      if (!document.components) {\n        document.components = {}\n      }\n      if (!document.components.securitySchemes) {\n        document.components.securitySchemes = {}\n      }\n\n      // Add the new security scheme definition\n      document.components.securitySchemes[uniqueSchemeName] = newScheme.scheme\n\n      // Return an OpenAPI Security Requirement Object for this new scheme (empty scope array)\n      return {\n        [uniqueSchemeName]: [],\n      }\n    }),\n  )\n\n  // Create any new security schemes required, ensuring unique names for the components\n  const createdSchemes = createdSecurityRequirements.filter(Boolean) as SecurityRequirementObject[]\n\n  const target = getTarget()\n\n  const newSelectedSecuritySchemes = [...selectedRequirements, ...createdSchemes]\n\n  const getSelectedIndex = () => {\n    if (!target?.selectedIndex) {\n      return 0\n    }\n\n    if (target.selectedIndex >= newSelectedSecuritySchemes.length) {\n      return newSelectedSecuritySchemes.length - 1\n    }\n\n    return target.selectedIndex\n  }\n\n  // if (payload. === 'document') {\n  if (meta.type === 'document') {\n    return store?.auth.setAuthSelectedSchemas(\n      { type: 'document', documentName },\n      { selectedIndex: getSelectedIndex(), selectedSchemes: newSelectedSecuritySchemes },\n    )\n  }\n  return store?.auth.setAuthSelectedSchemas(\n    { type: 'operation', documentName, path: meta.path, method: meta.method },\n    { selectedIndex: getSelectedIndex(), selectedSchemes: newSelectedSecuritySchemes },\n  )\n}\n\n/**\n * Updates a security scheme in the OpenAPI document's components object.\n * Handles updates for HTTP, API Key, and OAuth2 types, saving secret information and configuration for UI-auth flows.\n *\n * @param document - The OpenAPI workspace document (can be null)\n * @param data - The update information, including type and payload\n * @param name - The name of the security scheme in document.components.securitySchemes\n *\n * Example usage:\n *\n * updateSecurityScheme({\n *   document,\n *   data: {\n *     type: 'http',\n *     payload: {\n *       username: 'user123',\n *       password: 'pw123',\n *       token: 'tokenval'\n *     }\n *   },\n *   name: 'MyHttpAuth',\n * })\n */\nexport const updateSecurityScheme = (\n  document: WorkspaceDocument | null,\n  { payload, name }: AuthEvents['auth:update:security-scheme'],\n) => {\n  const target = getResolvedRef(document?.components?.securitySchemes?.[name])\n  if (!target) {\n    console.error(`Security scheme ${name} not found`)\n    return\n  }\n\n  // Handle HTTP (basic, bearer, etc.)\n  if (target.type === payload.type) {\n    mergeObjects(target, payload)\n  }\n\n  return target\n}\n\nconst updateSecuritySchemeSecrets = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { payload, name, overwrite = false }: AuthEvents['auth:update:security-scheme-secrets'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // If we want to remove properties then we should set replace to true\n  if (overwrite) {\n    store?.auth.setAuthSecrets(documentName, name, payload)\n    return\n  }\n\n  const auth = store?.auth.getAuthSecrets(documentName, name)\n  const result = mergeObjects(\n    unpackProxyObject(auth, { depth: 1 }) ?? {},\n    payload,\n  ) as AuthEvents['auth:update:security-scheme-secrets']['payload']\n  store?.auth.setAuthSecrets(documentName, name, result)\n}\n\nconst clearSecuritySchemeSecrets = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { name }: AuthEvents['auth:clear:security-scheme-secrets'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  store?.auth.clearAuthSecrets(documentName, name)\n}\n\n/**\n * Sets the selected authentication tab (scheme) index for the given OpenAPI document or operation.\n * - When on the document level, updates the 'selectedIndex' on the document's x-scalar-selected-security extension.\n * - When on an operation (endpoint) level, updates the 'selectedIndex' for that operation's x-scalar-selected-security.\n *\n * Also initializes the x-scalar-selected-security extension if it does not exist.\n *\n * @param document The OpenAPI document object (may be null)\n * @param index The index to set as selected\n * @param meta Context where the selection applies ('document' or specific operation)\n *\n * @example\n * // Document-level tab selection\n * updateSelectedAuthTab({\n *   document,\n *   index: 1,\n *   meta: { type: 'document' }\n * });\n *\n * // Operation-level tab selection (e.g., GET /pets)\n * updateSelectedAuthTab({\n *   document,\n *   index: 0,\n *   meta: { type: 'operation', path: '/pets', method: 'get' }\n * });\n */\nexport const updateSelectedAuthTab = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { index, meta }: AuthEvents['auth:update:active-index'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // Ensure the path/method exists in the document\n  if (meta.type === 'operation' && document?.paths?.[meta.path]?.[meta.method] === undefined) {\n    return\n  }\n\n  // Determine the target object for setting the auth tab index:\n  // - Document/root level\n  // - Operation/endpoint level (if meta specifies operation)\n  const getTarget = () => {\n    if (meta.type === 'document') {\n      return store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n    }\n    return store?.auth.getAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n  }\n\n  const target = getTarget()\n\n  if (!target) {\n    if (meta.type === 'document') {\n      return store?.auth.setAuthSelectedSchemas(\n        { type: 'document', documentName },\n        { selectedIndex: index, selectedSchemes: [] },\n      )\n    }\n    return store?.auth.setAuthSelectedSchemas(\n      { type: 'operation', documentName, path: meta.path, method: meta.method },\n      { selectedIndex: index, selectedSchemes: [] },\n    )\n  }\n\n  // Set the selected index\n  target.selectedIndex = index\n}\n\n/**\n * Updates the scopes for a specific security requirement in the selected security schemes of\n * a document or operation. Also allow to add a new scope to the scheme.\n *\n * @param document - The OpenAPI WorkspaceDocument to update.\n * @param id - An array of scheme names that uniquely identifies the target security requirement.\n *             For example: ['OAuth', 'ApiKeyAuth']\n * @param name - The security scheme name to update scopes for (e.g., 'OAuth').\n * @param scopes - The new list of scopes to set. For example: ['read:pets', 'write:pets']\n * @param newScopePayload - The payload to add a new scope with\n * @param meta - The context specifying whether the update is at the document-level or operation-level.\n *\n * Example usage:\n * ```ts\n * // Suppose your document (or operation) x-scalar-selected-security looks like:\n * // \"x-scalar-selected-security\": {\n * //   selectedIndex: 0,\n * //   selectedSchemes: [\n * //     { \"OAuth\": [\"read:pets\"] },\n * //     { \"ApiKeyAuth\": [] }\n * //   ]\n * // }\n *\n * updateSelectedScopes({\n *   document,\n *   id: [\"OAuth\"],     // identifies the scheme object: { \"OAuth\": [...] }\n *   name: \"OAuth\",     // scheme name to update within this security requirement\n *   scopes: [\"write:pets\"], // new scopes array\n *   meta: { type: \"document\" }\n * })\n * // After, the first scheme becomes: { \"OAuth\": [\"write:pets\"] }\n * ```\n */\nexport const updateSelectedScopes = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { id, name, scopes, newScopePayload, meta }: AuthEvents['auth:update:selected-scopes'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // Determine the target object (document or the operation)\n  const getTarget = () => {\n    if (meta.type === 'document') {\n      return store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n    }\n    return store?.auth.getAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n  }\n\n  const target = getTarget()\n  if (!target) {\n    return\n  }\n\n  // Find the security requirement that matches the given id (scheme key names)\n  // For example: if id = [\"OAuth\"], matches { OAuth: [...] }\n  const scheme = target.selectedSchemes.find((scheme) => JSON.stringify(Object.keys(scheme)) === JSON.stringify(id))\n\n  // If the scheme is optional, do nothing as it cannot have scopes\n  if (!isNonOptionalSecurityRequirement(scheme)) {\n    return\n  }\n\n  // If we have a new scope payload, add it to the scheme\n  if (newScopePayload) {\n    const securityScheme = getResolvedRef(document.components?.securitySchemes?.[name])\n    const flow = (securityScheme as OAuth2Object)?.flows?.[newScopePayload?.flowType]\n    if (!flow) {\n      return\n    }\n    flow.scopes ||= {}\n\n    flow.scopes[newScopePayload.name] = newScopePayload.description\n    scheme[name] = [...scopes, newScopePayload.name]\n    return\n  }\n\n  // Set the scopes array for the named security scheme within the found security requirement\n  scheme[name] = scopes\n}\n\n/**\n * Deletes one or more security schemes from an OpenAPI WorkspaceDocument,\n * and removes all references to those schemes from selected security, document-level security,\n * and operation-level security/selected security (e.g., on paths).\n *\n * Example usage:\n *\n * ```ts\n * deleteSecurityScheme({\n *   document,                                // The OpenAPI document to update\n *   names: ['ApiKeyAuth', 'BearerAuth'],     // The names of security schemes you want to delete\n * });\n * ```\n *\n * After running this function:\n * - The named security schemes are removed from the components.securitySchemes section.\n * - All document-level and operation-level security entries referencing those schemes are removed.\n * - Any extended x-scalar-selected-security references to those schemes are also removed.\n */\nexport const deleteSecurityScheme = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { names }: AuthEvents['auth:delete:security-scheme'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    // Early exit if there is no document to modify\n    return\n  }\n\n  // Get the mutable reference to securitySchemes in components (may be a proxy/resolved reference)\n  const target = getResolvedRef(document.components?.securitySchemes)\n\n  if (!target) {\n    // If there are no security schemes to delete from, return early\n    return\n  }\n\n  // Remove each named security scheme from the components.securitySchemes object\n  names.forEach((name) => {\n    delete target[name]\n  })\n\n  // Function to remove any security requirement objects that reference given scheme names.\n  const filterSecuritySchemes = (schemes: SecurityRequirementObject[]) => {\n    // Remove schemes whose key is included in the `names` to be deleted.\n    return schemes.filter((scheme) => !names.some((name) => Object.keys(scheme).includes(name)))\n  }\n\n  const documentSelectedSecurity = store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n\n  // -- Remove from document-level `x-scalar-selected-security` extension, if present\n  if (documentSelectedSecurity) {\n    documentSelectedSecurity.selectedSchemes = filterSecuritySchemes(\n      unpackProxyObject(documentSelectedSecurity.selectedSchemes, { depth: 1 }) ?? [],\n    )\n  }\n\n  // -- Remove from document-level `security` property, if present\n  if (document['security']) {\n    document['security'] = filterSecuritySchemes(document['security'])\n  }\n\n  // -- For each path and operation, remove deleted security schemes from operation-level security and custom extension\n  Object.entries(document.paths ?? {}).forEach(([path, pathItemObject]) => {\n    Object.entries(pathItemObject).forEach(([method, operation]) => {\n      if (typeof operation !== 'object') {\n        // Ignore operations that are not objects (could be undefined)\n        return\n      }\n\n      // Get mutable reference for the operation (could resolve $ref proxies)\n      const resolvedOperation = getResolvedRef(operation)\n\n      // Remove from operation-level security array\n      if ('security' in resolvedOperation && resolvedOperation['security']) {\n        resolvedOperation['security'] = filterSecuritySchemes(resolvedOperation['security'])\n      }\n\n      // // Remove from operation-level x-scalar-selected-security array\n      const operationSelectedSecurity = store?.auth.getAuthSelectedSchemas({\n        type: 'operation',\n        documentName,\n        path,\n        method,\n      })\n      if (operationSelectedSecurity) {\n        operationSelectedSecurity.selectedSchemes = filterSecuritySchemes(\n          unpackProxyObject(operationSelectedSecurity.selectedSchemes, { depth: 1 }) ?? [],\n        )\n      }\n    })\n  })\n}\n\nexport const authMutatorsFactory = ({\n  document,\n  store,\n}: {\n  document: WorkspaceDocument | null\n  store: WorkspaceStore | null\n}) => {\n  return {\n    updateSelectedSecuritySchemes: (payload: AuthEvents['auth:update:selected-security-schemes']) =>\n      updateSelectedSecuritySchemes(store, document, payload),\n    updateSecurityScheme: (payload: AuthEvents['auth:update:security-scheme']) =>\n      updateSecurityScheme(document, payload),\n    updateSecuritySchemeSecrets: (payload: AuthEvents['auth:update:security-scheme-secrets']) =>\n      updateSecuritySchemeSecrets(store, document, payload),\n    clearSecuritySchemeSecrets: (payload: AuthEvents['auth:clear:security-scheme-secrets']) =>\n      clearSecuritySchemeSecrets(store, document, payload),\n    updateSelectedAuthTab: (payload: AuthEvents['auth:update:active-index']) =>\n      updateSelectedAuthTab(store, document, payload),\n    updateSelectedScopes: (payload: AuthEvents['auth:update:selected-scopes']) =>\n      updateSelectedScopes(store, document, payload),\n    deleteSecurityScheme: (payload: AuthEvents['auth:delete:security-scheme']) =>\n      deleteSecurityScheme(store, document, payload),\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { AuthEvents } from '@/events/definitions/auth'\nimport { generateUniqueValue } from '@/helpers/generate-unique-value'\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport { isNonOptionalSecurityRequirement } from '@/helpers/is-non-optional-security-requirement'\nimport { mergeObjects } from '@/helpers/merge-object'\nimport { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport type { WorkspaceDocument } from '@/schemas'\nimport type { SecurityRequirementObject } from '@/schemas/v3.1/strict/security-requirement'\nimport type { OAuth2Object } from '@/schemas/v3.1/strict/security-scheme'\n\n/**\n * Updates the selected security schemes for either the entire document or a specific operation.\n * - Adds newly created security schemes (if any) to the workspace document's components.\n * - Ensures that each new scheme name is unique within the document by using `generateUniqueValue`.\n * - Updates the `x-scalar-selected-security` property on the target (document or operation) to reflect the new set of selected security schemes.\n * - Corrects and maintains the selected index so it points to a valid security scheme.\n *\n * @param document - The workspace OpenAPI document to mutate (can be null, in which case nothing happens)\n * @param selectedSecuritySchemes - The current list of selected security scheme objects\n * @param create - Array of new schemes to create, each with a name and a scheme definition\n * @param meta - Location to update: whole document or a specific operation (`{ type: 'document' }` or `{ type: 'operation', path, method }`)\n *\n * Example usage:\n * ```\n * updateSelectedSecuritySchemes({\n *   document,\n *   selectedSecuritySchemes: [{ bearerAuth: [] }],\n *   create: [\n *     { name: 'ApiKeyAuth', scheme: { type: 'apiKey', in: 'header', name: 'X-API-Key' } }\n *   ],\n *   meta: { type: 'document' }\n * })\n * ```\n */\nexport const updateSelectedSecuritySchemes = async (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { selectedRequirements, newSchemes, meta }: AuthEvents['auth:update:selected-security-schemes'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // Helper to get the target (whole document or a specific operation)\n  const getTarget = () => {\n    if (meta.type === 'document') {\n      return store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n    }\n\n    return store?.auth.getAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n  }\n\n  const createdSecurityRequirements = await Promise.all(\n    newSchemes.map(async (newScheme) => {\n      const uniqueSchemeName = await generateUniqueValue({\n        defaultValue: newScheme.name,\n        validation: (value) => !document.components?.securitySchemes?.[value],\n        maxRetries: 100,\n      })\n\n      if (!uniqueSchemeName) {\n        return\n      }\n\n      // Ensure components and securitySchemes exist\n      if (!document.components) {\n        document.components = {}\n      }\n      if (!document.components.securitySchemes) {\n        document.components.securitySchemes = {}\n      }\n\n      // Add the new security scheme definition\n      document.components.securitySchemes[uniqueSchemeName] = newScheme.scheme\n\n      // Return an OpenAPI Security Requirement Object for this new scheme (empty scope array)\n      return {\n        [uniqueSchemeName]: [],\n      }\n    }),\n  )\n\n  // Create any new security schemes required, ensuring unique names for the components\n  const createdSchemes = createdSecurityRequirements.filter(Boolean) as SecurityRequirementObject[]\n\n  const target = getTarget()\n\n  const newSelectedSecuritySchemes = [...selectedRequirements, ...createdSchemes]\n\n  const getSelectedIndex = () => {\n    if (!target?.selectedIndex) {\n      return 0\n    }\n\n    if (target.selectedIndex >= newSelectedSecuritySchemes.length) {\n      return newSelectedSecuritySchemes.length - 1\n    }\n\n    return target.selectedIndex\n  }\n\n  // if (payload. === 'document') {\n  if (meta.type === 'document') {\n    return store?.auth.setAuthSelectedSchemas(\n      { type: 'document', documentName },\n      { selectedIndex: getSelectedIndex(), selectedSchemes: newSelectedSecuritySchemes },\n    )\n  }\n  return store?.auth.setAuthSelectedSchemas(\n    { type: 'operation', documentName, path: meta.path, method: meta.method },\n    { selectedIndex: getSelectedIndex(), selectedSchemes: newSelectedSecuritySchemes },\n  )\n}\n\n/**\n * Clears the selected security schemes from the workspace store for a document or operation.\n * This function will remove any selection state related to security (auth) for either the entire document\n * or for a specific operation if meta.type is 'operation'.\n * If the document name cannot be determined, nothing happens.\n */\nconst clearSelectedSecuritySchemes = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { meta }: AuthEvents['auth:clear:selected-security-schemes'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  if (meta.type === 'document') {\n    return store?.auth.clearAuthSelectedSchemas({ type: 'document', documentName })\n  }\n  return store?.auth.clearAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n}\n\n/**\n * Updates a security scheme in the OpenAPI document's components object.\n * Handles updates for HTTP, API Key, and OAuth2 types, saving secret information and configuration for UI-auth flows.\n *\n * @param document - The OpenAPI workspace document (can be null)\n * @param data - The update information, including type and payload\n * @param name - The name of the security scheme in document.components.securitySchemes\n *\n * Example usage:\n *\n * updateSecurityScheme({\n *   document,\n *   data: {\n *     type: 'http',\n *     payload: {\n *       username: 'user123',\n *       password: 'pw123',\n *       token: 'tokenval'\n *     }\n *   },\n *   name: 'MyHttpAuth',\n * })\n */\nexport const updateSecurityScheme = (\n  document: WorkspaceDocument | null,\n  { payload, name }: AuthEvents['auth:update:security-scheme'],\n) => {\n  const target = getResolvedRef(document?.components?.securitySchemes?.[name])\n  if (!target) {\n    console.error(`Security scheme ${name} not found`)\n    return\n  }\n\n  // Handle HTTP (basic, bearer, etc.)\n  if (target.type === payload.type) {\n    mergeObjects(target, payload)\n  }\n\n  return target\n}\n\nconst updateSecuritySchemeSecrets = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { payload, name, overwrite = false }: AuthEvents['auth:update:security-scheme-secrets'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // If we want to remove properties then we should set replace to true\n  if (overwrite) {\n    store?.auth.setAuthSecrets(documentName, name, payload)\n    return\n  }\n\n  const auth = store?.auth.getAuthSecrets(documentName, name)\n  const result = mergeObjects(\n    unpackProxyObject(auth, { depth: 1 }) ?? {},\n    payload,\n  ) as AuthEvents['auth:update:security-scheme-secrets']['payload']\n  store?.auth.setAuthSecrets(documentName, name, result)\n}\n\nconst clearSecuritySchemeSecrets = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { name }: AuthEvents['auth:clear:security-scheme-secrets'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  store?.auth.clearAuthSecrets(documentName, name)\n}\n\n/**\n * Sets the selected authentication tab (scheme) index for the given OpenAPI document or operation.\n * - When on the document level, updates the 'selectedIndex' on the document's x-scalar-selected-security extension.\n * - When on an operation (endpoint) level, updates the 'selectedIndex' for that operation's x-scalar-selected-security.\n *\n * Also initializes the x-scalar-selected-security extension if it does not exist.\n *\n * @param document The OpenAPI document object (may be null)\n * @param index The index to set as selected\n * @param meta Context where the selection applies ('document' or specific operation)\n *\n * @example\n * // Document-level tab selection\n * updateSelectedAuthTab({\n *   document,\n *   index: 1,\n *   meta: { type: 'document' }\n * });\n *\n * // Operation-level tab selection (e.g., GET /pets)\n * updateSelectedAuthTab({\n *   document,\n *   index: 0,\n *   meta: { type: 'operation', path: '/pets', method: 'get' }\n * });\n */\nexport const updateSelectedAuthTab = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { index, meta }: AuthEvents['auth:update:active-index'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // Ensure the path/method exists in the document\n  if (meta.type === 'operation' && document?.paths?.[meta.path]?.[meta.method] === undefined) {\n    return\n  }\n\n  // Determine the target object for setting the auth tab index:\n  // - Document/root level\n  // - Operation/endpoint level (if meta specifies operation)\n  const getTarget = () => {\n    if (meta.type === 'document') {\n      return store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n    }\n    return store?.auth.getAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n  }\n\n  const target = getTarget()\n\n  if (!target) {\n    if (meta.type === 'document') {\n      return store?.auth.setAuthSelectedSchemas(\n        { type: 'document', documentName },\n        { selectedIndex: index, selectedSchemes: [] },\n      )\n    }\n    return store?.auth.setAuthSelectedSchemas(\n      { type: 'operation', documentName, path: meta.path, method: meta.method },\n      { selectedIndex: index, selectedSchemes: [] },\n    )\n  }\n\n  // Set the selected index\n  target.selectedIndex = index\n}\n\n/**\n * Updates the scopes for a specific security requirement in the selected security schemes of\n * a document or operation. Also allow to add a new scope to the scheme.\n *\n * @param document - The OpenAPI WorkspaceDocument to update.\n * @param id - An array of scheme names that uniquely identifies the target security requirement.\n *             For example: ['OAuth', 'ApiKeyAuth']\n * @param name - The security scheme name to update scopes for (e.g., 'OAuth').\n * @param scopes - The new list of scopes to set. For example: ['read:pets', 'write:pets']\n * @param newScopePayload - The payload to add a new scope with\n * @param meta - The context specifying whether the update is at the document-level or operation-level.\n *\n * Example usage:\n * ```ts\n * // Suppose your document (or operation) x-scalar-selected-security looks like:\n * // \"x-scalar-selected-security\": {\n * //   selectedIndex: 0,\n * //   selectedSchemes: [\n * //     { \"OAuth\": [\"read:pets\"] },\n * //     { \"ApiKeyAuth\": [] }\n * //   ]\n * // }\n *\n * updateSelectedScopes({\n *   document,\n *   id: [\"OAuth\"],     // identifies the scheme object: { \"OAuth\": [...] }\n *   name: \"OAuth\",     // scheme name to update within this security requirement\n *   scopes: [\"write:pets\"], // new scopes array\n *   meta: { type: \"document\" }\n * })\n * // After, the first scheme becomes: { \"OAuth\": [\"write:pets\"] }\n * ```\n */\nexport const updateSelectedScopes = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { id, name, scopes, newScopePayload, meta }: AuthEvents['auth:update:selected-scopes'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    return\n  }\n\n  // Determine the target object (document or the operation)\n  const getTarget = () => {\n    if (meta.type === 'document') {\n      return store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n    }\n    return store?.auth.getAuthSelectedSchemas({ type: 'operation', documentName, path: meta.path, method: meta.method })\n  }\n\n  const target = getTarget()\n  if (!target) {\n    return\n  }\n\n  // Find the security requirement that matches the given id (scheme key names)\n  // For example: if id = [\"OAuth\"], matches { OAuth: [...] }\n  const scheme = target.selectedSchemes.find((scheme) => JSON.stringify(Object.keys(scheme)) === JSON.stringify(id))\n\n  // If the scheme is optional, do nothing as it cannot have scopes\n  if (!isNonOptionalSecurityRequirement(scheme)) {\n    return\n  }\n\n  // If we have a new scope payload, add it to the scheme\n  if (newScopePayload) {\n    const securityScheme = getResolvedRef(document.components?.securitySchemes?.[name])\n    const flow = (securityScheme as OAuth2Object)?.flows?.[newScopePayload?.flowType]\n    if (!flow) {\n      return\n    }\n    flow.scopes ||= {}\n\n    flow.scopes[newScopePayload.name] = newScopePayload.description\n    scheme[name] = [...scopes, newScopePayload.name]\n    return\n  }\n\n  // Set the scopes array for the named security scheme within the found security requirement\n  scheme[name] = scopes\n}\n\n/**\n * Deletes one or more security schemes from an OpenAPI WorkspaceDocument,\n * and removes all references to those schemes from selected security, document-level security,\n * and operation-level security/selected security (e.g., on paths).\n *\n * Example usage:\n *\n * ```ts\n * deleteSecurityScheme({\n *   document,                                // The OpenAPI document to update\n *   names: ['ApiKeyAuth', 'BearerAuth'],     // The names of security schemes you want to delete\n * });\n * ```\n *\n * After running this function:\n * - The named security schemes are removed from the components.securitySchemes section.\n * - All document-level and operation-level security entries referencing those schemes are removed.\n * - Any extended x-scalar-selected-security references to those schemes are also removed.\n */\nexport const deleteSecurityScheme = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { names }: AuthEvents['auth:delete:security-scheme'],\n) => {\n  const documentName = document?.['x-scalar-navigation']?.name\n  if (!documentName) {\n    // Early exit if there is no document to modify\n    return\n  }\n\n  // Get the mutable reference to securitySchemes in components (may be a proxy/resolved reference)\n  const target = getResolvedRef(document.components?.securitySchemes)\n\n  if (!target) {\n    // If there are no security schemes to delete from, return early\n    return\n  }\n\n  // Remove each named security scheme from the components.securitySchemes object\n  names.forEach((name) => {\n    delete target[name]\n  })\n\n  const clampIndex = (index: number, length: number) => {\n    return Math.max(0, Math.min(index, length - 1))\n  }\n\n  // Function to remove any security requirement objects that reference given scheme names.\n  const filterSecuritySchemes = (_schemes: SecurityRequirementObject[]) => {\n    const schemes = unpackProxyObject(_schemes, { depth: 1 }) ?? []\n    // Remove schemes whose key is included in the `names` to be deleted.\n    return schemes.filter((scheme) => !names.some((name) => Object.keys(scheme).includes(name)))\n  }\n\n  const documentSelectedSecurity = store?.auth.getAuthSelectedSchemas({ type: 'document', documentName })\n\n  // -- Remove from document-level `x-scalar-selected-security` extension, if present\n  if (documentSelectedSecurity) {\n    documentSelectedSecurity.selectedSchemes = filterSecuritySchemes(documentSelectedSecurity.selectedSchemes)\n    documentSelectedSecurity.selectedIndex = clampIndex(\n      documentSelectedSecurity.selectedIndex,\n      documentSelectedSecurity.selectedSchemes.length,\n    )\n  }\n\n  // -- Remove from document-level `security` property, if present\n  if (document['security']) {\n    document['security'] = filterSecuritySchemes(document['security'])\n  }\n\n  // -- For each path and operation, remove deleted security schemes from operation-level security and custom extension\n  Object.entries(document.paths ?? {}).forEach(([path, pathItemObject]) => {\n    Object.entries(pathItemObject).forEach(([method, operation]) => {\n      if (typeof operation !== 'object') {\n        // Ignore operations that are not objects (could be undefined)\n        return\n      }\n\n      // Get mutable reference for the operation (could resolve $ref proxies)\n      const resolvedOperation = getResolvedRef(operation)\n\n      // Remove from operation-level security array\n      if ('security' in resolvedOperation && resolvedOperation['security']) {\n        resolvedOperation['security'] = filterSecuritySchemes(resolvedOperation['security'])\n      }\n\n      // // Remove from operation-level x-scalar-selected-security array\n      const operationSelectedSecurity = store?.auth.getAuthSelectedSchemas({\n        type: 'operation',\n        documentName,\n        path,\n        method,\n      })\n      if (operationSelectedSecurity) {\n        operationSelectedSecurity.selectedSchemes = filterSecuritySchemes(operationSelectedSecurity.selectedSchemes)\n        operationSelectedSecurity.selectedIndex = clampIndex(\n          operationSelectedSecurity.selectedIndex,\n          operationSelectedSecurity.selectedSchemes.length,\n        )\n      }\n    })\n  })\n}\n\nexport const authMutatorsFactory = ({\n  document,\n  store,\n}: {\n  document: WorkspaceDocument | null\n  store: WorkspaceStore | null\n}) => {\n  return {\n    updateSelectedSecuritySchemes: (payload: AuthEvents['auth:update:selected-security-schemes']) =>\n      updateSelectedSecuritySchemes(store, document, payload),\n    clearSelectedSecuritySchemes: (payload: AuthEvents['auth:clear:selected-security-schemes']) =>\n      clearSelectedSecuritySchemes(store, document, payload),\n    updateSecurityScheme: (payload: AuthEvents['auth:update:security-scheme']) =>\n      updateSecurityScheme(document, payload),\n    updateSecuritySchemeSecrets: (payload: AuthEvents['auth:update:security-scheme-secrets']) =>\n      updateSecuritySchemeSecrets(store, document, payload),\n    clearSecuritySchemeSecrets: (payload: AuthEvents['auth:clear:security-scheme-secrets']) =>\n      clearSecuritySchemeSecrets(store, document, payload),\n    updateSelectedAuthTab: (payload: AuthEvents['auth:update:active-index']) =>\n      updateSelectedAuthTab(store, document, payload),\n    updateSelectedScopes: (payload: AuthEvents['auth:update:selected-scopes']) =>\n      updateSelectedScopes(store, document, payload),\n    deleteSecurityScheme: (payload: AuthEvents['auth:delete:security-scheme']) =>\n      deleteSecurityScheme(store, document, payload),\n  }\n}\n"],
+  "mappings": "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",
   "names": ["scheme"]
 }

package/dist/mutators/document.d.ts

@@ -1,10 +1,6 @@
 import type { WorkspaceStore } from '../client.js';
 import type { DocumentEvents } from '../events/definitions/document.js';
 import type { WorkspaceDocument } from '../schemas.js';
-/**
- * Toggle setting selected security schemes at the operation level
- */
-export declare const toggleSecurity: (document: WorkspaceDocument | null) => void;
 /**
  * Updates the "watch mode" state of the given document.
  *
@@ -53,7 +49,6 @@ export declare const documentMutatorsFactory: ({ document, store, }: {
     document: WorkspaceDocument | null;
     store: WorkspaceStore | null;
 }) => {
-    toggleSecurity: () => void;
     updateDocumentInfo: (payload: DocumentEvents["document:update:info"]) => void;
     updateWatchMode: (payload: DocumentEvents["document:update:watch-mode"]) => void;
     updateDocumentIcon: (payload: DocumentEvents["document:update:icon"]) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/mutators/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,iBAAiB,GAAG,IAAI,SAMhE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,WAAW,OAAO,SAOrF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,iBAAiB,GAAG,IAAI,EAClC,SAAS,cAAc,CAAC,sBAAsB,CAAC,SAahD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,MAAM,MAAM,SASlF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,SAAS,cAAc,CAAC,gCAAgC,CAAC,kBA8B1D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,cAAc,CAAC,0BAA0B,CAAC,SAM/G,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,sBAGrC;IACD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;;kCAGiC,cAAc,CAAC,sBAAsB,CAAC;+BACzC,cAAc,CAAC,4BAA4B,CAAC;kCACzC,cAAc,CAAC,sBAAsB,CAAC;mCACrC,cAAc,CAAC,gCAAgC,CAAC;8BAErD,cAAc,CAAC,0BAA0B,CAAC;CAEvE,CAAA"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/mutators/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,WAAW,OAAO,SAOrF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,iBAAiB,GAAG,IAAI,EAClC,SAAS,cAAc,CAAC,sBAAsB,CAAC,SAahD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,iBAAiB,GAAG,IAAI,EAAE,MAAM,MAAM,SASlF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,SAAS,cAAc,CAAC,gCAAgC,CAAC,kBA8B1D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,cAAc,CAAC,0BAA0B,CAAC,SAM/G,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,sBAGrC;IACD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;kCAEiC,cAAc,CAAC,sBAAsB,CAAC;+BACzC,cAAc,CAAC,4BAA4B,CAAC;kCACzC,cAAc,CAAC,sBAAsB,CAAC;mCACrC,cAAc,CAAC,gCAAgC,CAAC;8BAErD,cAAc,CAAC,0BAA0B,CAAC;CAEvE,CAAA"}

package/dist/mutators/document.js

@@ -1,10 +1,4 @@
 import { mergeObjects } from "../helpers/merge-object.js";
-const toggleSecurity = (document) => {
-  if (!document) {
-    return;
-  }
-  document["x-scalar-set-operation-security"] = !document["x-scalar-set-operation-security"];
-};
 const updateWatchMode = (document, watchMode) => {
   if (!document) {
     return;
@@ -61,7 +55,6 @@ const documentMutatorsFactory = ({
   store
 }) => {
   return {
-    toggleSecurity: () => toggleSecurity(document),
     updateDocumentInfo: (payload) => updateDocumentInfo(document, payload),
     updateWatchMode: (payload) => updateWatchMode(document, payload),
     updateDocumentIcon: (payload) => updateDocumentIcon(document, payload),
@@ -73,7 +66,6 @@ export {
   createEmptyDocument,
   deleteDocument,
   documentMutatorsFactory,
-  toggleSecurity,
   updateDocumentIcon,
   updateDocumentInfo,
   updateWatchMode

package/dist/mutators/document.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/document.ts"],
-  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { DocumentEvents } from '@/events/definitions/document'\nimport { mergeObjects } from '@/helpers/merge-object'\nimport type { WorkspaceDocument } from '@/schemas'\n\n/**\n * Toggle setting selected security schemes at the operation level\n */\nexport const toggleSecurity = (document: WorkspaceDocument | null) => {\n  if (!document) {\n    return\n  }\n\n  document['x-scalar-set-operation-security'] = !document['x-scalar-set-operation-security']\n}\n\n/**\n * Updates the \"watch mode\" state of the given document.\n *\n * @param document WorkspaceDocument or null \u2013 The document to modify.\n * @param watchMode boolean \u2013 True enables watch mode, false disables it.\n *\n * If document is null, does nothing.\n */\nexport const updateWatchMode = (document: WorkspaceDocument | null, watchMode: boolean) => {\n  if (!document) {\n    return\n  }\n\n  // Set (or unset) the x-scalar-watch-mode property on the document\n  document['x-scalar-watch-mode'] = watchMode\n}\n\n/**\n * Updates the document's info object (typically, title, description, version, etc.).\n *\n * Uses a shallow merge: only properties present in payload will be overwritten or added.\n *\n * @param document WorkspaceDocument | null \u2013 The document whose info should be updated.\n * @param payload DocumentEvents['document:update:info'] \u2013 Partial info fields to update/merge.\n *\n * If document is null, does nothing.\n */\nexport const updateDocumentInfo = (\n  document: WorkspaceDocument | null,\n  payload: DocumentEvents['document:update:info'],\n) => {\n  if (!document) {\n    return\n  }\n  // Merge the given payload into the document's info object\n  mergeObjects(document.info, payload)\n\n  // Update the document title if it is present and the navigation object is present\n  // We do this because we don't want to rebuild the entire navigation object if only the title is changed\n  if (payload.title && document['x-scalar-navigation']) {\n    document['x-scalar-navigation'].title = payload.title\n  }\n}\n\n/**\n * Update the document icon and also update the corresponding sidebar entry\n *\n * Does not perform a sidebar rebuild for performance benefit\n */\nexport const updateDocumentIcon = (document: WorkspaceDocument | null, icon: string) => {\n  if (!document || !document['x-scalar-navigation']) {\n    return\n  }\n\n  // Update the document icon\n  document['x-scalar-icon'] = icon\n  // Update the sidebar document icon\n  document['x-scalar-navigation'].icon = icon\n}\n\n/**\n * Creates an empty OpenAPI document and adds it to the workspace.\n *\n * - If the store is null, this is a no-op.\n * - The document name must be unique; if already present, callback is called with `false`.\n * - On success, a new OpenAPI 3.1.0 document is added with a basic path and info.\n * - Callback is called with `true` if document is created.\n *\n * @param store WorkspaceStore | null \u2013 The workspace store to add the document to.\n * @param payload DocumentEvents['document:create:empty-document'] \u2013 Contains name, icon, and callback.\n */\nexport const createEmptyDocument = async (\n  store: WorkspaceStore | null,\n  payload: DocumentEvents['document:create:empty-document'],\n) => {\n  if (!store) {\n    return\n  }\n\n  // Check if the document already exists by name for uniqueness\n  if (store.workspace.documents[payload.name]) {\n    // Document name already exists, call callback with false\n    payload.callback?.(false)\n    return\n  }\n\n  // Add a new empty OpenAPI 3.1.0 document with minimal info and icon\n  await store.addDocument({\n    name: payload.name,\n    document: {\n      openapi: '3.1.0',\n      info: { title: payload.name, version: '1.0.0' },\n      paths: {\n        '/': {\n          get: {},\n        },\n      },\n      'x-scalar-icon': payload.icon,\n    },\n  })\n\n  // Notify success via callback\n  payload.callback?.(true)\n}\n\n/**\n * Deletes a document from the workspace by its name.\n *\n * Safely no-ops if the store is null.\n */\nexport const deleteDocument = (store: WorkspaceStore | null, payload: DocumentEvents['document:delete:document']) => {\n  if (!store) {\n    return\n  }\n\n  store.deleteDocument(payload.name)\n}\n\nexport const documentMutatorsFactory = ({\n  document,\n  store,\n}: {\n  document: WorkspaceDocument | null\n  store: WorkspaceStore | null\n}) => {\n  return {\n    toggleSecurity: () => toggleSecurity(document),\n    updateDocumentInfo: (payload: DocumentEvents['document:update:info']) => updateDocumentInfo(document, payload),\n    updateWatchMode: (payload: DocumentEvents['document:update:watch-mode']) => updateWatchMode(document, payload),\n    updateDocumentIcon: (payload: DocumentEvents['document:update:icon']) => updateDocumentIcon(document, payload),\n    createEmptyDocument: (payload: DocumentEvents['document:create:empty-document']) =>\n      createEmptyDocument(store, payload),\n    deleteDocument: (payload: DocumentEvents['document:delete:document']) => deleteDocument(store, payload),\n  }\n}\n"],
-  "mappings": "AAEA,SAAS,oBAAoB;AAMtB,MAAM,iBAAiB,CAAC,aAAuC;AACpE,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,WAAS,iCAAiC,IAAI,CAAC,SAAS,iCAAiC;AAC3F;AAUO,MAAM,kBAAkB,CAAC,UAAoC,cAAuB;AACzF,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAGA,WAAS,qBAAqB,IAAI;AACpC;AAYO,MAAM,qBAAqB,CAChC,UACA,YACG;AACH,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,eAAa,SAAS,MAAM,OAAO;AAInC,MAAI,QAAQ,SAAS,SAAS,qBAAqB,GAAG;AACpD,aAAS,qBAAqB,EAAE,QAAQ,QAAQ;AAAA,EAClD;AACF;AAOO,MAAM,qBAAqB,CAAC,UAAoC,SAAiB;AACtF,MAAI,CAAC,YAAY,CAAC,SAAS,qBAAqB,GAAG;AACjD;AAAA,EACF;AAGA,WAAS,eAAe,IAAI;AAE5B,WAAS,qBAAqB,EAAE,OAAO;AACzC;AAaO,MAAM,sBAAsB,OACjC,OACA,YACG;AACH,MAAI,CAAC,OAAO;AACV;AAAA,EACF;AAGA,MAAI,MAAM,UAAU,UAAU,QAAQ,IAAI,GAAG;AAE3C,YAAQ,WAAW,KAAK;AACxB;AAAA,EACF;AAGA,QAAM,MAAM,YAAY;AAAA,IACtB,MAAM,QAAQ;AAAA,IACd,UAAU;AAAA,MACR,SAAS;AAAA,MACT,MAAM,EAAE,OAAO,QAAQ,MAAM,SAAS,QAAQ;AAAA,MAC9C,OAAO;AAAA,QACL,KAAK;AAAA,UACH,KAAK,CAAC;AAAA,QACR;AAAA,MACF;AAAA,MACA,iBAAiB,QAAQ;AAAA,IAC3B;AAAA,EACF,CAAC;AAGD,UAAQ,WAAW,IAAI;AACzB;AAOO,MAAM,iBAAiB,CAAC,OAA8B,YAAwD;AACnH,MAAI,CAAC,OAAO;AACV;AAAA,EACF;AAEA,QAAM,eAAe,QAAQ,IAAI;AACnC;AAEO,MAAM,0BAA0B,CAAC;AAAA,EACtC;AAAA,EACA;AACF,MAGM;AACJ,SAAO;AAAA,IACL,gBAAgB,MAAM,eAAe,QAAQ;AAAA,IAC7C,oBAAoB,CAAC,YAAoD,mBAAmB,UAAU,OAAO;AAAA,IAC7G,iBAAiB,CAAC,YAA0D,gBAAgB,UAAU,OAAO;AAAA,IAC7G,oBAAoB,CAAC,YAAoD,mBAAmB,UAAU,OAAO;AAAA,IAC7G,qBAAqB,CAAC,YACpB,oBAAoB,OAAO,OAAO;AAAA,IACpC,gBAAgB,CAAC,YAAwD,eAAe,OAAO,OAAO;AAAA,EACxG;AACF;",
+  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { DocumentEvents } from '@/events/definitions/document'\nimport { mergeObjects } from '@/helpers/merge-object'\nimport type { WorkspaceDocument } from '@/schemas'\n\n/**\n * Updates the \"watch mode\" state of the given document.\n *\n * @param document WorkspaceDocument or null \u2013 The document to modify.\n * @param watchMode boolean \u2013 True enables watch mode, false disables it.\n *\n * If document is null, does nothing.\n */\nexport const updateWatchMode = (document: WorkspaceDocument | null, watchMode: boolean) => {\n  if (!document) {\n    return\n  }\n\n  // Set (or unset) the x-scalar-watch-mode property on the document\n  document['x-scalar-watch-mode'] = watchMode\n}\n\n/**\n * Updates the document's info object (typically, title, description, version, etc.).\n *\n * Uses a shallow merge: only properties present in payload will be overwritten or added.\n *\n * @param document WorkspaceDocument | null \u2013 The document whose info should be updated.\n * @param payload DocumentEvents['document:update:info'] \u2013 Partial info fields to update/merge.\n *\n * If document is null, does nothing.\n */\nexport const updateDocumentInfo = (\n  document: WorkspaceDocument | null,\n  payload: DocumentEvents['document:update:info'],\n) => {\n  if (!document) {\n    return\n  }\n  // Merge the given payload into the document's info object\n  mergeObjects(document.info, payload)\n\n  // Update the document title if it is present and the navigation object is present\n  // We do this because we don't want to rebuild the entire navigation object if only the title is changed\n  if (payload.title && document['x-scalar-navigation']) {\n    document['x-scalar-navigation'].title = payload.title\n  }\n}\n\n/**\n * Update the document icon and also update the corresponding sidebar entry\n *\n * Does not perform a sidebar rebuild for performance benefit\n */\nexport const updateDocumentIcon = (document: WorkspaceDocument | null, icon: string) => {\n  if (!document || !document['x-scalar-navigation']) {\n    return\n  }\n\n  // Update the document icon\n  document['x-scalar-icon'] = icon\n  // Update the sidebar document icon\n  document['x-scalar-navigation'].icon = icon\n}\n\n/**\n * Creates an empty OpenAPI document and adds it to the workspace.\n *\n * - If the store is null, this is a no-op.\n * - The document name must be unique; if already present, callback is called with `false`.\n * - On success, a new OpenAPI 3.1.0 document is added with a basic path and info.\n * - Callback is called with `true` if document is created.\n *\n * @param store WorkspaceStore | null \u2013 The workspace store to add the document to.\n * @param payload DocumentEvents['document:create:empty-document'] \u2013 Contains name, icon, and callback.\n */\nexport const createEmptyDocument = async (\n  store: WorkspaceStore | null,\n  payload: DocumentEvents['document:create:empty-document'],\n) => {\n  if (!store) {\n    return\n  }\n\n  // Check if the document already exists by name for uniqueness\n  if (store.workspace.documents[payload.name]) {\n    // Document name already exists, call callback with false\n    payload.callback?.(false)\n    return\n  }\n\n  // Add a new empty OpenAPI 3.1.0 document with minimal info and icon\n  await store.addDocument({\n    name: payload.name,\n    document: {\n      openapi: '3.1.0',\n      info: { title: payload.name, version: '1.0.0' },\n      paths: {\n        '/': {\n          get: {},\n        },\n      },\n      'x-scalar-icon': payload.icon,\n    },\n  })\n\n  // Notify success via callback\n  payload.callback?.(true)\n}\n\n/**\n * Deletes a document from the workspace by its name.\n *\n * Safely no-ops if the store is null.\n */\nexport const deleteDocument = (store: WorkspaceStore | null, payload: DocumentEvents['document:delete:document']) => {\n  if (!store) {\n    return\n  }\n\n  store.deleteDocument(payload.name)\n}\n\nexport const documentMutatorsFactory = ({\n  document,\n  store,\n}: {\n  document: WorkspaceDocument | null\n  store: WorkspaceStore | null\n}) => {\n  return {\n    updateDocumentInfo: (payload: DocumentEvents['document:update:info']) => updateDocumentInfo(document, payload),\n    updateWatchMode: (payload: DocumentEvents['document:update:watch-mode']) => updateWatchMode(document, payload),\n    updateDocumentIcon: (payload: DocumentEvents['document:update:icon']) => updateDocumentIcon(document, payload),\n    createEmptyDocument: (payload: DocumentEvents['document:create:empty-document']) =>\n      createEmptyDocument(store, payload),\n    deleteDocument: (payload: DocumentEvents['document:delete:document']) => deleteDocument(store, payload),\n  }\n}\n"],
+  "mappings": "AAEA,SAAS,oBAAoB;AAWtB,MAAM,kBAAkB,CAAC,UAAoC,cAAuB;AACzF,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAGA,WAAS,qBAAqB,IAAI;AACpC;AAYO,MAAM,qBAAqB,CAChC,UACA,YACG;AACH,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,eAAa,SAAS,MAAM,OAAO;AAInC,MAAI,QAAQ,SAAS,SAAS,qBAAqB,GAAG;AACpD,aAAS,qBAAqB,EAAE,QAAQ,QAAQ;AAAA,EAClD;AACF;AAOO,MAAM,qBAAqB,CAAC,UAAoC,SAAiB;AACtF,MAAI,CAAC,YAAY,CAAC,SAAS,qBAAqB,GAAG;AACjD;AAAA,EACF;AAGA,WAAS,eAAe,IAAI;AAE5B,WAAS,qBAAqB,EAAE,OAAO;AACzC;AAaO,MAAM,sBAAsB,OACjC,OACA,YACG;AACH,MAAI,CAAC,OAAO;AACV;AAAA,EACF;AAGA,MAAI,MAAM,UAAU,UAAU,QAAQ,IAAI,GAAG;AAE3C,YAAQ,WAAW,KAAK;AACxB;AAAA,EACF;AAGA,QAAM,MAAM,YAAY;AAAA,IACtB,MAAM,QAAQ;AAAA,IACd,UAAU;AAAA,MACR,SAAS;AAAA,MACT,MAAM,EAAE,OAAO,QAAQ,MAAM,SAAS,QAAQ;AAAA,MAC9C,OAAO;AAAA,QACL,KAAK;AAAA,UACH,KAAK,CAAC;AAAA,QACR;AAAA,MACF;AAAA,MACA,iBAAiB,QAAQ;AAAA,IAC3B;AAAA,EACF,CAAC;AAGD,UAAQ,WAAW,IAAI;AACzB;AAOO,MAAM,iBAAiB,CAAC,OAA8B,YAAwD;AACnH,MAAI,CAAC,OAAO;AACV;AAAA,EACF;AAEA,QAAM,eAAe,QAAQ,IAAI;AACnC;AAEO,MAAM,0BAA0B,CAAC;AAAA,EACtC;AAAA,EACA;AACF,MAGM;AACJ,SAAO;AAAA,IACL,oBAAoB,CAAC,YAAoD,mBAAmB,UAAU,OAAO;AAAA,IAC7G,iBAAiB,CAAC,YAA0D,gBAAgB,UAAU,OAAO;AAAA,IAC7G,oBAAoB,CAAC,YAAoD,mBAAmB,UAAU,OAAO;AAAA,IAC7G,qBAAqB,CAAC,YACpB,oBAAoB,OAAO,OAAO;AAAA,IACpC,gBAAgB,CAAC,YAAwD,eAAe,OAAO,OAAO;AAAA,EACxG;AACF;",
   "names": []
 }

package/dist/mutators/index.d.ts

@@ -64,6 +64,7 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
     active: () => {
         auth: {
             updateSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:selected-security-schemes"]) => Promise<void>;
+            clearSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:selected-security-schemes"]) => void;
             updateSecurityScheme: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme"]) => import("../schemas/v3.1/strict/security-scheme.js").ApiKeyObject | import("../schemas/v3.1/strict/security-scheme.js").HttpObject | import("../schemas/v3.1/strict/security-scheme.js").OAuth2Object | import("../schemas/v3.1/strict/security-scheme.js").OpenIdConnectObject | undefined;
             updateSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme-secrets"]) => void;
             clearSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:security-scheme-secrets"]) => void;
@@ -82,7 +83,6 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
             }) => boolean;
         };
         document: {
-            toggleSecurity: () => void;
             updateDocumentInfo: (payload: import("../events/definitions/document.js").DocumentEvents["document:update:info"]) => void;
             updateWatchMode: (payload: import("../events/definitions/document.js").DocumentEvents["document:update:watch-mode"]) => void;
             updateDocumentIcon: (payload: import("../events/definitions/document.js").DocumentEvents["document:update:icon"]) => void;
@@ -91,7 +91,7 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
         };
         operation: {
             createOperation: (payload: import("../events/index.js").OperationEvents["operation:create:operation"]) => string | undefined;
-            updateOperationSummary: (payload: import("../events/index.js").OperationEvents["operation:update:summary"]) => void;
+            updateOperationMeta: (payload: import("../events/index.js").OperationEvents["operation:update:meta"]) => void;
             updateOperationPathMethod: (payload: import("../events/index.js").OperationEvents["operation:update:pathMethod"]) => void;
             deleteOperation: (payload: import("../events/index.js").OperationEvents["operation:delete:operation"]) => void;
             createOperationDraftExample: (payload: import("../events/index.js").OperationEvents["operation:create:draft-example"]) => void;
@@ -108,9 +108,11 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
             reloadOperationHistory: (payload: import("../events/index.js").OperationEvents["operation:reload:history"]) => void;
         };
         server: {
-            addServer: () => import("../schemas/v3.1/strict/server.js").ServerObject | undefined;
+            initializeServers: (payload: import("../events/definitions/server.js").ServerEvents["server:initialize:servers"]) => import("../schemas/v3.1/strict/server.js").ServerObject[] | undefined;
+            addServer: (payload: import("../events/definitions/server.js").ServerEvents["server:add:server"]) => import("../schemas/v3.1/strict/server.js").ServerObject | undefined;
             updateServer: (payload: import("../events/definitions/server.js").ServerEvents["server:update:server"]) => import("../schemas/v3.1/strict/server.js").ServerObject | undefined;
             deleteServer: (payload: import("../events/definitions/server.js").ServerEvents["server:delete:server"]) => void;
+            clearServers: (payload: import("../events/definitions/server.js").ServerEvents["server:clear:servers"]) => void;
             updateServerVariables: (payload: import("../events/definitions/server.js").ServerEvents["server:update:variables"]) => import("../schemas/v3.1/strict/server-variable.js").ServerVariableObject | undefined;
             updateSelectedServer: (payload: import("../events/definitions/server.js").ServerEvents["server:update:selected"]) => string | undefined;
         };
@@ -147,6 +149,7 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
     doc: (name: string) => {
         auth: {
             updateSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:selected-security-schemes"]) => Promise<void>;
+            clearSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:selected-security-schemes"]) => void;
             updateSecurityScheme: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme"]) => import("../schemas/v3.1/strict/security-scheme.js").ApiKeyObject | import("../schemas/v3.1/strict/security-scheme.js").HttpObject | import("../schemas/v3.1/strict/security-scheme.js").OAuth2Object | import("../schemas/v3.1/strict/security-scheme.js").OpenIdConnectObject | undefined;
             updateSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme-secrets"]) => void;
             clearSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:security-scheme-secrets"]) => void;
@@ -165,7 +168,6 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
             }) => boolean;
         };
         document: {
-            toggleSecurity: () => void;
             updateDocumentInfo: (payload: import("../events/definitions/document.js").DocumentEvents["document:update:info"]) => void;
             updateWatchMode: (payload: import("../events/definitions/document.js").DocumentEvents["document:update:watch-mode"]) => void;
             updateDocumentIcon: (payload: import("../events/definitions/document.js").DocumentEvents["document:update:icon"]) => void;
@@ -174,7 +176,7 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
         };
         operation: {
             createOperation: (payload: import("../events/index.js").OperationEvents["operation:create:operation"]) => string | undefined;
-            updateOperationSummary: (payload: import("../events/index.js").OperationEvents["operation:update:summary"]) => void;
+            updateOperationMeta: (payload: import("../events/index.js").OperationEvents["operation:update:meta"]) => void;
             updateOperationPathMethod: (payload: import("../events/index.js").OperationEvents["operation:update:pathMethod"]) => void;
             deleteOperation: (payload: import("../events/index.js").OperationEvents["operation:delete:operation"]) => void;
             createOperationDraftExample: (payload: import("../events/index.js").OperationEvents["operation:create:draft-example"]) => void;
@@ -191,9 +193,11 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
             reloadOperationHistory: (payload: import("../events/index.js").OperationEvents["operation:reload:history"]) => void;
         };
         server: {
-            addServer: () => import("../schemas/v3.1/strict/server.js").ServerObject | undefined;
+            initializeServers: (payload: import("../events/definitions/server.js").ServerEvents["server:initialize:servers"]) => import("../schemas/v3.1/strict/server.js").ServerObject[] | undefined;
+            addServer: (payload: import("../events/definitions/server.js").ServerEvents["server:add:server"]) => import("../schemas/v3.1/strict/server.js").ServerObject | undefined;
             updateServer: (payload: import("../events/definitions/server.js").ServerEvents["server:update:server"]) => import("../schemas/v3.1/strict/server.js").ServerObject | undefined;
             deleteServer: (payload: import("../events/definitions/server.js").ServerEvents["server:delete:server"]) => void;
+            clearServers: (payload: import("../events/definitions/server.js").ServerEvents["server:clear:servers"]) => void;
             updateServerVariables: (payload: import("../events/definitions/server.js").ServerEvents["server:update:variables"]) => import("../schemas/v3.1/strict/server-variable.js").ServerVariableObject | undefined;
             updateSelectedServer: (payload: import("../events/definitions/server.js").ServerEvents["server:update:selected"]) => string | undefined;
         };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mutators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAa9C;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAqC/D;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;;OAIG;gBACS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mutators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAa9C;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAqC/D;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;;OAIG;gBACS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErB"}

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

@@ -7,7 +7,7 @@ export declare const operationMutatorsFactory: ({ document, store, }: {
     store: WorkspaceStore | null;
 }) => {
     createOperation: (payload: OperationEvents["operation:create:operation"]) => string | undefined;
-    updateOperationSummary: (payload: OperationEvents["operation:update:summary"]) => void;
+    updateOperationMeta: (payload: OperationEvents["operation:update:meta"]) => void;
     updateOperationPathMethod: (payload: OperationEvents["operation:update:pathMethod"]) => void;
     deleteOperation: (payload: OperationEvents["operation:delete:operation"]) => void;
     createOperationDraftExample: (payload: OperationEvents["operation:create:draft-example"]) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAsBrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,eAAO,MAAM,wBAAwB,GAAI,sBAGtC;IACD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;+BAE8B,eAAe,CAAC,4BAA4B,CAAC;sCACtC,eAAe,CAAC,0BAA0B,CAAC;yCAExC,eAAe,CAAC,6BAA6B,CAAC;+BAExD,eAAe,CAAC,4BAA4B,CAAC;2CACjC,eAAe,CAAC,gCAAgC,CAAC;sCAEtD,eAAe,CAAC,0BAA0B,CAAC;wCAEzC,eAAe,CAAC,4BAA4B,CAAC;8CAEvC,eAAe,CAAC,mCAAmC,CAAC;wCAE1D,eAAe,CAAC,4BAA4B,CAAC;wCAE7C,eAAe,CAAC,4BAA4B,CAAC;4CAEzC,eAAe,CAAC,iCAAiC,CAAC;qDAEzC,eAAe,CAAC,0CAA0C,CAAC;iDAE/D,eAAe,CAAC,oCAAoC,CAAC;mDAEnD,eAAe,CAAC,wCAAwC,CAAC;oCAExE,WAAW,CAAC,2BAA2B,CAAC;sCAEtC,eAAe,CAAC,0BAA0B,CAAC;CAGhF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAsBrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,eAAO,MAAM,wBAAwB,GAAI,sBAGtC;IACD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;+BAE8B,eAAe,CAAC,4BAA4B,CAAC;mCACzC,eAAe,CAAC,uBAAuB,CAAC;yCAElC,eAAe,CAAC,6BAA6B,CAAC;+BAExD,eAAe,CAAC,4BAA4B,CAAC;2CACjC,eAAe,CAAC,gCAAgC,CAAC;sCAEtD,eAAe,CAAC,0BAA0B,CAAC;wCAEzC,eAAe,CAAC,4BAA4B,CAAC;8CAEvC,eAAe,CAAC,mCAAmC,CAAC;wCAE1D,eAAe,CAAC,4BAA4B,CAAC;wCAE7C,eAAe,CAAC,4BAA4B,CAAC;4CAEzC,eAAe,CAAC,iCAAiC,CAAC;qDAEzC,eAAe,CAAC,0CAA0C,CAAC;iDAE/D,eAAe,CAAC,oCAAoC,CAAC;mDAEnD,eAAe,CAAC,wCAAwC,CAAC;oCAExE,WAAW,CAAC,2BAA2B,CAAC;sCAEtC,eAAe,CAAC,0BAA0B,CAAC;CAGhF,CAAA"}

package/dist/mutators/operation/index.js

@@ -10,8 +10,8 @@ import {
   createOperationDraftExample,
   deleteOperation,
   deleteOperationExample,
-  updateOperationPathMethod,
-  updateOperationSummary
+  updateOperationMeta,
+  updateOperationPathMethod
 } from "../../mutators/operation/operation.js";
 import {
   deleteAllOperationParameters,
@@ -25,7 +25,7 @@ const operationMutatorsFactory = ({
 }) => {
   return {
     createOperation: (payload) => createOperation(store, payload),
-    updateOperationSummary: (payload) => updateOperationSummary(store, document, payload),
+    updateOperationMeta: (payload) => updateOperationMeta(store, document, payload),
     updateOperationPathMethod: (payload) => updateOperationPathMethod(document, store, payload),
     deleteOperation: (payload) => deleteOperation(store, payload),
     createOperationDraftExample: (payload) => createOperationDraftExample(store, payload),

package/dist/mutators/operation/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/mutators/operation/index.ts"],
-  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { HooksEvents } from '@/events/definitions/hooks'\nimport type { OperationEvents } from '@/events/definitions/operation'\nimport {\n  updateOperationRequestBodyContentType,\n  updateOperationRequestBodyExample,\n  updateOperationRequestBodyFormValue,\n} from '@/mutators/operation/body'\nimport { updateOperationExtension } from '@/mutators/operation/extensions'\nimport { addResponseToHistory, reloadOperationHistory } from '@/mutators/operation/history'\nimport {\n  createOperation,\n  createOperationDraftExample,\n  deleteOperation,\n  deleteOperationExample,\n  updateOperationPathMethod,\n  updateOperationSummary,\n} from '@/mutators/operation/operation'\nimport {\n  deleteAllOperationParameters,\n  deleteOperationParameter,\n  updateOperationExtraParameters,\n  upsertOperationParameter,\n} from '@/mutators/operation/parameters'\nimport type { WorkspaceDocument } from '@/schemas'\n\nexport const operationMutatorsFactory = ({\n  document,\n  store,\n}: {\n  document: WorkspaceDocument | null\n  store: WorkspaceStore | null\n}) => {\n  return {\n    createOperation: (payload: OperationEvents['operation:create:operation']) => createOperation(store, payload),\n    updateOperationSummary: (payload: OperationEvents['operation:update:summary']) =>\n      updateOperationSummary(store, document, payload),\n    updateOperationPathMethod: (payload: OperationEvents['operation:update:pathMethod']) =>\n      updateOperationPathMethod(document, store, payload),\n    deleteOperation: (payload: OperationEvents['operation:delete:operation']) => deleteOperation(store, payload),\n    createOperationDraftExample: (payload: OperationEvents['operation:create:draft-example']) =>\n      createOperationDraftExample(store, payload),\n    deleteOperationExample: (payload: OperationEvents['operation:delete:example']) =>\n      deleteOperationExample(store, payload),\n    updateOperationExtension: (payload: OperationEvents['operation:update:extension']) =>\n      updateOperationExtension(document, payload),\n    updateOperationExtraParameters: (payload: OperationEvents['operation:update:extra-parameters']) =>\n      updateOperationExtraParameters(document, payload),\n    upsertOperationParameter: (payload: OperationEvents['operation:upsert:parameter']) =>\n      upsertOperationParameter(document, payload),\n    deleteOperationParameter: (payload: OperationEvents['operation:delete:parameter']) =>\n      deleteOperationParameter(document, payload),\n    deleteAllOperationParameters: (payload: OperationEvents['operation:delete-all:parameters']) =>\n      deleteAllOperationParameters(document, payload),\n    updateOperationRequestBodyContentType: (payload: OperationEvents['operation:update:requestBody:contentType']) =>\n      updateOperationRequestBodyContentType(document, payload),\n    updateOperationRequestBodyExample: (payload: OperationEvents['operation:update:requestBody:value']) =>\n      updateOperationRequestBodyExample(document, payload),\n    updateOperationRequestBodyFormValue: (payload: OperationEvents['operation:update:requestBody:formValue']) =>\n      updateOperationRequestBodyFormValue(document, payload),\n    addResponseToHistory: (payload: HooksEvents['hooks:on:request:complete']) =>\n      addResponseToHistory(store, document, payload),\n    reloadOperationHistory: (payload: OperationEvents['operation:reload:history']) =>\n      reloadOperationHistory(store, document, payload),\n  }\n}\n"],
-  "mappings": "AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,sBAAsB,8BAA8B;AAC7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGA,MAAM,2BAA2B,CAAC;AAAA,EACvC;AAAA,EACA;AACF,MAGM;AACJ,SAAO;AAAA,IACL,iBAAiB,CAAC,YAA2D,gBAAgB,OAAO,OAAO;AAAA,IAC3G,wBAAwB,CAAC,YACvB,uBAAuB,OAAO,UAAU,OAAO;AAAA,IACjD,2BAA2B,CAAC,YAC1B,0BAA0B,UAAU,OAAO,OAAO;AAAA,IACpD,iBAAiB,CAAC,YAA2D,gBAAgB,OAAO,OAAO;AAAA,IAC3G,6BAA6B,CAAC,YAC5B,4BAA4B,OAAO,OAAO;AAAA,IAC5C,wBAAwB,CAAC,YACvB,uBAAuB,OAAO,OAAO;AAAA,IACvC,0BAA0B,CAAC,YACzB,yBAAyB,UAAU,OAAO;AAAA,IAC5C,gCAAgC,CAAC,YAC/B,+BAA+B,UAAU,OAAO;AAAA,IAClD,0BAA0B,CAAC,YACzB,yBAAyB,UAAU,OAAO;AAAA,IAC5C,0BAA0B,CAAC,YACzB,yBAAyB,UAAU,OAAO;AAAA,IAC5C,8BAA8B,CAAC,YAC7B,6BAA6B,UAAU,OAAO;AAAA,IAChD,uCAAuC,CAAC,YACtC,sCAAsC,UAAU,OAAO;AAAA,IACzD,mCAAmC,CAAC,YAClC,kCAAkC,UAAU,OAAO;AAAA,IACrD,qCAAqC,CAAC,YACpC,oCAAoC,UAAU,OAAO;AAAA,IACvD,sBAAsB,CAAC,YACrB,qBAAqB,OAAO,UAAU,OAAO;AAAA,IAC/C,wBAAwB,CAAC,YACvB,uBAAuB,OAAO,UAAU,OAAO;AAAA,EACnD;AACF;",
+  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport type { HooksEvents } from '@/events/definitions/hooks'\nimport type { OperationEvents } from '@/events/definitions/operation'\nimport {\n  updateOperationRequestBodyContentType,\n  updateOperationRequestBodyExample,\n  updateOperationRequestBodyFormValue,\n} from '@/mutators/operation/body'\nimport { updateOperationExtension } from '@/mutators/operation/extensions'\nimport { addResponseToHistory, reloadOperationHistory } from '@/mutators/operation/history'\nimport {\n  createOperation,\n  createOperationDraftExample,\n  deleteOperation,\n  deleteOperationExample,\n  updateOperationMeta,\n  updateOperationPathMethod,\n} from '@/mutators/operation/operation'\nimport {\n  deleteAllOperationParameters,\n  deleteOperationParameter,\n  updateOperationExtraParameters,\n  upsertOperationParameter,\n} from '@/mutators/operation/parameters'\nimport type { WorkspaceDocument } from '@/schemas'\n\nexport const operationMutatorsFactory = ({\n  document,\n  store,\n}: {\n  document: WorkspaceDocument | null\n  store: WorkspaceStore | null\n}) => {\n  return {\n    createOperation: (payload: OperationEvents['operation:create:operation']) => createOperation(store, payload),\n    updateOperationMeta: (payload: OperationEvents['operation:update:meta']) =>\n      updateOperationMeta(store, document, payload),\n    updateOperationPathMethod: (payload: OperationEvents['operation:update:pathMethod']) =>\n      updateOperationPathMethod(document, store, payload),\n    deleteOperation: (payload: OperationEvents['operation:delete:operation']) => deleteOperation(store, payload),\n    createOperationDraftExample: (payload: OperationEvents['operation:create:draft-example']) =>\n      createOperationDraftExample(store, payload),\n    deleteOperationExample: (payload: OperationEvents['operation:delete:example']) =>\n      deleteOperationExample(store, payload),\n    updateOperationExtension: (payload: OperationEvents['operation:update:extension']) =>\n      updateOperationExtension(document, payload),\n    updateOperationExtraParameters: (payload: OperationEvents['operation:update:extra-parameters']) =>\n      updateOperationExtraParameters(document, payload),\n    upsertOperationParameter: (payload: OperationEvents['operation:upsert:parameter']) =>\n      upsertOperationParameter(document, payload),\n    deleteOperationParameter: (payload: OperationEvents['operation:delete:parameter']) =>\n      deleteOperationParameter(document, payload),\n    deleteAllOperationParameters: (payload: OperationEvents['operation:delete-all:parameters']) =>\n      deleteAllOperationParameters(document, payload),\n    updateOperationRequestBodyContentType: (payload: OperationEvents['operation:update:requestBody:contentType']) =>\n      updateOperationRequestBodyContentType(document, payload),\n    updateOperationRequestBodyExample: (payload: OperationEvents['operation:update:requestBody:value']) =>\n      updateOperationRequestBodyExample(document, payload),\n    updateOperationRequestBodyFormValue: (payload: OperationEvents['operation:update:requestBody:formValue']) =>\n      updateOperationRequestBodyFormValue(document, payload),\n    addResponseToHistory: (payload: HooksEvents['hooks:on:request:complete']) =>\n      addResponseToHistory(store, document, payload),\n    reloadOperationHistory: (payload: OperationEvents['operation:reload:history']) =>\n      reloadOperationHistory(store, document, payload),\n  }\n}\n"],
+  "mappings": "AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,gCAAgC;AACzC,SAAS,sBAAsB,8BAA8B;AAC7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGA,MAAM,2BAA2B,CAAC;AAAA,EACvC;AAAA,EACA;AACF,MAGM;AACJ,SAAO;AAAA,IACL,iBAAiB,CAAC,YAA2D,gBAAgB,OAAO,OAAO;AAAA,IAC3G,qBAAqB,CAAC,YACpB,oBAAoB,OAAO,UAAU,OAAO;AAAA,IAC9C,2BAA2B,CAAC,YAC1B,0BAA0B,UAAU,OAAO,OAAO;AAAA,IACpD,iBAAiB,CAAC,YAA2D,gBAAgB,OAAO,OAAO;AAAA,IAC3G,6BAA6B,CAAC,YAC5B,4BAA4B,OAAO,OAAO;AAAA,IAC5C,wBAAwB,CAAC,YACvB,uBAAuB,OAAO,OAAO;AAAA,IACvC,0BAA0B,CAAC,YACzB,yBAAyB,UAAU,OAAO;AAAA,IAC5C,gCAAgC,CAAC,YAC/B,+BAA+B,UAAU,OAAO;AAAA,IAClD,0BAA0B,CAAC,YACzB,yBAAyB,UAAU,OAAO;AAAA,IAC5C,0BAA0B,CAAC,YACzB,yBAAyB,UAAU,OAAO;AAAA,IAC5C,8BAA8B,CAAC,YAC7B,6BAA6B,UAAU,OAAO;AAAA,IAChD,uCAAuC,CAAC,YACtC,sCAAsC,UAAU,OAAO;AAAA,IACzD,mCAAmC,CAAC,YAClC,kCAAkC,UAAU,OAAO;AAAA,IACrD,qCAAqC,CAAC,YACpC,oCAAoC,UAAU,OAAO;AAAA,IACvD,sBAAsB,CAAC,YACrB,qBAAqB,OAAO,UAAU,OAAO;AAAA,IAC/C,wBAAwB,CAAC,YACvB,uBAAuB,OAAO,UAAU,OAAO;AAAA,EACnD;AACF;",
   "names": []
 }

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

@@ -19,20 +19,18 @@ import type { WorkspaceDocument } from '../../schemas.js';
  */
 export declare const createOperation: (workspaceStore: WorkspaceStore | null, payload: OperationEvents["operation:create:operation"]) => string | undefined;
 /**
- * Updates the `summary` of an operation.
+ * Updates the `description` of an operation.
  * Safely no-ops if the document or operation does not exist.
  *
  * Example:
  * ```ts
- * updateOperationSummary(
+ * updateOperationDescription(
  *   document,
- *   {
- *   meta: { method: 'get', path: '/users/{id}' },
- *   payload: { summary: 'Get a single user' },
+ *   { meta: { method: 'get', path: '/users' }, payload: { description: 'Get a single user' },
  * })
  * ```
  */
-export declare const updateOperationSummary: (store: WorkspaceStore | null, document: WorkspaceDocument | null, { meta, payload: { summary } }: OperationEvents["operation:update:summary"]) => void;
+export declare const updateOperationMeta: (store: WorkspaceStore | null, document: WorkspaceDocument | null, { meta, payload }: OperationEvents["operation:update:meta"]) => void;
 /**
  * Updates the HTTP method and/or path of an operation and moves it to the new location.
  * This function:

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

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/operation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAOrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,GAAG,IAAI,EACrC,SAAS,eAAe,CAAC,4BAA4B,CAAC,KACrD,MAAM,GAAG,SAwDX,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,gCAAgC,eAAe,CAAC,0BAA0B,CAAC,SAqB5E,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,OAAO,cAAc,GAAG,IAAI,EAC5B,+CAA+C,eAAe,CAAC,6BAA6B,CAAC,KAC5F,IA+FF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,cAAc,GAAG,IAAI,EAChC,wBAAwB,eAAe,CAAC,4BAA4B,CAAC,SAgBtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,cAAc,GAAG,IAAI,EAChC,uDAAuD,eAAe,CAAC,gCAAgC,CAAC,SAuBzG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,sDAAsD,eAAe,CAAC,0BAA0B,CAAC,SAiDlG,CAAA"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/operation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAOrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,GAAG,IAAI,EACrC,SAAS,eAAe,CAAC,4BAA4B,CAAC,KACrD,MAAM,GAAG,SAwDX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,eAAe,CAAC,uBAAuB,CAAC,SAsB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,OAAO,cAAc,GAAG,IAAI,EAC5B,+CAA+C,eAAe,CAAC,6BAA6B,CAAC,KAC5F,IA+FF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,cAAc,GAAG,IAAI,EAChC,wBAAwB,eAAe,CAAC,4BAA4B,CAAC,SAgBtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,cAAc,GAAG,IAAI,EAChC,uDAAuD,eAAe,CAAC,gCAAgC,CAAC,SAuBzG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,sDAAsD,eAAe,CAAC,0BAA0B,CAAC,SAiDlG,CAAA"}

package/dist/mutators/operation/operation.js

@@ -44,7 +44,7 @@ const createOperation = (workspaceStore, payload) => {
   payload.callback?.(true);
   return normalizedPath;
 };
-const updateOperationSummary = (store, document, { meta, payload: { summary } }) => {
+const updateOperationMeta = (store, document, { meta, payload }) => {
   if (!document || !store) {
     return;
   }
@@ -54,9 +54,10 @@ const updateOperationSummary = (store, document, { meta, payload: { summary } })
   }
   const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
   if (!operation) {
+    console.error("Operation not found", { meta, document });
     return;
   }
-  operation.summary = summary;
+  Object.assign(operation, payload);
   store.buildSidebar(documentName);
 };
 const updateOperationPathMethod = (document, store, { meta, payload: { method, path }, callback }) => {
@@ -186,7 +187,7 @@ export {
   createOperationDraftExample,
   deleteOperation,
   deleteOperationExample,
-  updateOperationPathMethod,
-  updateOperationSummary
+  updateOperationMeta,
+  updateOperationPathMethod
 };
 //# sourceMappingURL=operation.js.map

package/dist/mutators/operation/operation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/mutators/operation/operation.ts"],
-  "sourcesContent": ["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { isHttpMethod } from '@scalar/helpers/http/is-http-method'\nimport { preventPollution } from '@scalar/helpers/object/prevent-pollution'\nimport { findVariables } from '@scalar/helpers/regex/find-variables'\n\nimport type { WorkspaceStore } from '@/client'\nimport type { OperationEvents } from '@/events/definitions/operation'\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport { syncParametersForPathChange } from '@/mutators/operation/helpers/sync-path-parameters'\nimport { getOperationEntries } from '@/navigation'\nimport { getNavigationOptions } from '@/navigation/get-navigation-options'\nimport { updateOrderIds } from '@/navigation/helpers/update-order-ids'\nimport type { WorkspaceDocument } from '@/schemas'\n\n/**\n * Creates a new operation at a specific path and method in the document.\n * Automatically normalizes the path to ensure it starts with a slash.\n *\n * Returns the normalized path if successful, undefined otherwise.\n *\n * Example:\n * ```ts\n * createOperation(\n *   document,\n *   'users',\n *   'get',\n *   { tags: ['Users'] },\n * )\n * ```\n */\nexport const createOperation = (\n  workspaceStore: WorkspaceStore | null,\n  payload: OperationEvents['operation:create:operation'],\n): string | undefined => {\n  const document = workspaceStore?.workspace.documents[payload.documentName]\n  if (!document) {\n    payload.callback?.(false)\n    return undefined\n  }\n\n  const { path, method, operation } = payload\n\n  /** Ensure the path starts with a slash */\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`\n\n  /** Create the operation in the document */\n  if (!document.paths) {\n    document.paths = {}\n  }\n\n  if (!document.paths[normalizedPath]) {\n    document.paths[normalizedPath] = {}\n  }\n\n  /** Prevent pollution of the path and method */\n  preventPollution(normalizedPath)\n  preventPollution(method)\n\n  /** Create the operation in the document */\n  document.paths[normalizedPath][method] = operation\n\n  // Make sure that we are selecting the new operation server\n  const { servers } = operation\n  const firstServer = unpackProxyObject(servers?.[0])\n\n  // For now we only support document servers but in the future we might support operation servers\n  for (const server of servers ?? []) {\n    // If the server does not exist in the document, add it\n    if (!document.servers?.some((s) => s.url === server.url)) {\n      if (!document.servers) {\n        document.servers = []\n      }\n      document.servers.push(unpackProxyObject(server))\n    }\n  }\n\n  // Update the selected server to the first server of the created operation\n  if (firstServer) {\n    document['x-scalar-selected-server'] = firstServer.url\n  }\n\n  // Sync path variables\n  const newParameters = syncParametersForPathChange(normalizedPath, normalizedPath, operation.parameters ?? [])\n  if (newParameters.length > 0) {\n    operation.parameters = newParameters\n  }\n\n  payload.callback?.(true)\n  return normalizedPath\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  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { meta, payload: { summary } }: OperationEvents['operation:update:summary'],\n) => {\n  if (!document || !store) {\n    return\n  }\n\n  const documentName = document['x-scalar-navigation']?.name\n  if (documentName === undefined) {\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  // Rebuild the sidebar to reflect the cahnges\n  // We can't just go any find all the entries this operation is part so we just rebuild the sidebar\n  store.buildSidebar(documentName)\n}\n\n/**\n * Updates the HTTP method and/or path of an operation and moves it to the new location.\n * This function:\n * 1. Moves the operation from the old method/path to the new method/path under paths\n * 2. Updates x-scalar-order to maintain the operation's position in the sidebar\n * 3. Syncs path parameters when the path changes\n *\n * Safely no-ops if nothing has changed, or if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationPathMethod({\n *   document,\n *   store,\n *   meta: { method: 'get', path: '/users' },\n *   payload: { method: 'post', path: '/api/users' },\n * })\n * ```\n */\nexport const updateOperationPathMethod = (\n  document: WorkspaceDocument | null,\n  store: WorkspaceStore | null,\n  { meta, payload: { method, path }, callback }: OperationEvents['operation:update:pathMethod'],\n): void => {\n  const methodChanged = meta.method !== method\n  const pathChanged = meta.path !== path\n\n  // If nothing has changed, no need to do anything\n  if (!methodChanged && !pathChanged) {\n    callback('no-change')\n    return\n  }\n\n  // Determine the final method and path\n  const finalMethod = methodChanged ? method : meta.method\n  const finalPath = pathChanged ? path : meta.path\n\n  // Check for conflicts at the target location\n  if (document?.paths?.[finalPath]?.[finalMethod as HttpMethod]) {\n    callback('conflict')\n    return\n  }\n\n  const documentNavigation = document?.['x-scalar-navigation']\n  if (!documentNavigation || !store) {\n    console.error('Document or workspace not found', { document })\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method as HttpMethod])\n  if (!operation) {\n    console.error('Operation not found', { meta, document })\n    return\n  }\n\n  // Sync path parameters if the path has changed\n  if (pathChanged) {\n    const oldPathParams = findVariables(meta.path, { includePath: true, includeEnv: false }).filter(\n      (v): v is string => v !== undefined,\n    )\n    const newPathParams = findVariables(finalPath, { 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(finalPath, meta.path, existingParameters)\n    }\n  }\n\n  /**\n   * We don't pass navigation options as we don't have config on the client,\n   * and we don't change path or method on the references\n   */\n  const { generateId } = getNavigationOptions(documentNavigation.name)\n\n  /** Grabs all of the current operation entries for the given path and method */\n  const operationEntriesMap = getOperationEntries(documentNavigation)\n  const entries = operationEntriesMap.get(`${meta.path}|${meta.method}`)\n\n  // Updates the order ID so we don't lose the sidebar ordering when it rebuilds\n  if (entries) {\n    updateOrderIds({ store, operation, generateId, method: finalMethod, path: finalPath, entries })\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[finalPath]) {\n    document.paths[finalPath] = {}\n  }\n\n  // Prevent assigning dangerous keys to the path items object\n  preventPollution(finalPath)\n  preventPollution(meta.path)\n  preventPollution(finalMethod)\n\n  // Move the operation to the new location\n  document.paths[finalPath][finalMethod] = unpackProxyObject(operation)\n\n  // Remove the operation from the old location\n  const oldPathItems = document.paths[meta.path]\n  if (oldPathItems && isHttpMethod(meta.method)) {\n    delete oldPathItems[meta.method]\n\n    // If the old path has no more operations, remove the path entry\n    if (Object.keys(oldPathItems).length === 0) {\n      delete document.paths[meta.path]\n    }\n  }\n\n  // We need to reset the history for the operation when the path or method changes\n  store.history.clearOperationHistory(document['x-scalar-navigation']?.name ?? '', meta.path, meta.method)\n\n  callback('success')\n}\n\n/**\n * Deletes an operation from the workspace\n *\n * Example:\n * ```ts\n * deleteOperation({\n *   document,\n *   meta: { method: 'get', path: '/users' },\n * })\n * ```\n */\nexport const deleteOperation = (\n  workspace: WorkspaceStore | null,\n  { meta, documentName }: OperationEvents['operation:delete:operation'],\n) => {\n  const document = workspace?.workspace.documents[documentName]\n  if (!document) {\n    return\n  }\n\n  preventPollution(meta.path)\n  preventPollution(meta.method)\n\n  delete document.paths?.[meta.path]?.[meta.method]\n\n  // If the path has no more operations, remove the path entry\n  if (Object.keys(document.paths?.[meta.path] ?? {}).length === 0) {\n    delete document.paths?.[meta.path]\n  }\n}\n\n/**\n * Adds an example name to the 'x-draft-examples' array for a specific operation in a document.\n *\n * - Finds the target operation using the provided path and method within the specified document.\n * - If the operation is found and has an 'x-draft-examples' array, pushes the new exampleName to it.\n * - Safely no-ops if the document or operation does not exist.\n */\nexport const createOperationDraftExample = (\n  workspace: WorkspaceStore | null,\n  { meta: { path, method }, documentName, exampleName }: OperationEvents['operation:create:draft-example'],\n) => {\n  const document = workspace?.workspace.documents[documentName]\n  if (!document) {\n    console.error('Document not found', { documentName })\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[path]?.[method])\n  if (!operation) {\n    console.error('Operation not found', { path, method })\n    return\n  }\n\n  // Ensure that the x-draft-examples array exists\n  operation['x-draft-examples'] ??= []\n\n  // Remove duplicates\n  const dedupe = new Set(operation['x-draft-examples'])\n  // Add the new example name\n  dedupe.add(exampleName)\n  // Update the operation with the new x-draft-examples array\n  operation['x-draft-examples'] = Array.from(dedupe)\n}\n\n/**\n * Deletes an example with the given exampleKey from operation parameters and request body.\n *\n * - Finds the target operation within the specified document and path/method.\n * - Removes example values matching exampleKey from both parameter-level and content-level examples.\n * - Safely no-ops if the document, operation, or request body does not exist.\n */\nexport const deleteOperationExample = (\n  workspace: WorkspaceStore | null,\n  { meta: { path, method, exampleKey }, documentName }: OperationEvents['operation:delete:example'],\n) => {\n  // Find the document in workspace based on documentName\n  const document = workspace?.workspace.documents[documentName]\n  if (!document) {\n    return\n  }\n\n  // Get the operation object for the given path and method\n  const operation = getResolvedRef(document.paths?.[path]?.[method])\n  if (!operation) {\n    return\n  }\n\n  // Remove the example from the x-draft-examples array\n  const dedupe = new Set(operation['x-draft-examples'] ?? [])\n  dedupe.delete(exampleKey)\n\n  if (operation['x-draft-examples'] !== undefined) {\n    operation['x-draft-examples'] = Array.from(dedupe)\n  }\n\n  // Remove the example from all operation parameters\n  operation.parameters?.forEach((parameter) => {\n    const resolvedParameter = getResolvedRef(parameter)\n\n    // Remove from content-level examples (if parameter uses content)\n    if ('content' in resolvedParameter && resolvedParameter.content) {\n      Object.values(resolvedParameter.content).forEach((mediaType) => {\n        delete mediaType.examples?.[exampleKey]\n      })\n    }\n\n    // Remove from parameter-level examples\n    if ('examples' in resolvedParameter && resolvedParameter.examples) {\n      delete resolvedParameter.examples?.[exampleKey]\n    }\n  })\n\n  // Remove the example from request body content types (if requestBody exists)\n  const requestBody = getResolvedRef(operation.requestBody)\n  if (!requestBody) {\n    return\n  }\n\n  // For each media type, remove the example matching exampleKey\n  Object.values(requestBody.content ?? {}).forEach((mediaType) => {\n    delete mediaType.examples?.[exampleKey]\n  })\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport { isHttpMethod } from '@scalar/helpers/http/is-http-method'\nimport { preventPollution } from '@scalar/helpers/object/prevent-pollution'\nimport { findVariables } from '@scalar/helpers/regex/find-variables'\n\nimport type { WorkspaceStore } from '@/client'\nimport type { OperationEvents } from '@/events/definitions/operation'\nimport { getResolvedRef } from '@/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@/helpers/unpack-proxy'\nimport { syncParametersForPathChange } from '@/mutators/operation/helpers/sync-path-parameters'\nimport { getOperationEntries } from '@/navigation'\nimport { getNavigationOptions } from '@/navigation/get-navigation-options'\nimport { updateOrderIds } from '@/navigation/helpers/update-order-ids'\nimport type { WorkspaceDocument } from '@/schemas'\n\n/**\n * Creates a new operation at a specific path and method in the document.\n * Automatically normalizes the path to ensure it starts with a slash.\n *\n * Returns the normalized path if successful, undefined otherwise.\n *\n * Example:\n * ```ts\n * createOperation(\n *   document,\n *   'users',\n *   'get',\n *   { tags: ['Users'] },\n * )\n * ```\n */\nexport const createOperation = (\n  workspaceStore: WorkspaceStore | null,\n  payload: OperationEvents['operation:create:operation'],\n): string | undefined => {\n  const document = workspaceStore?.workspace.documents[payload.documentName]\n  if (!document) {\n    payload.callback?.(false)\n    return undefined\n  }\n\n  const { path, method, operation } = payload\n\n  /** Ensure the path starts with a slash */\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`\n\n  /** Create the operation in the document */\n  if (!document.paths) {\n    document.paths = {}\n  }\n\n  if (!document.paths[normalizedPath]) {\n    document.paths[normalizedPath] = {}\n  }\n\n  /** Prevent pollution of the path and method */\n  preventPollution(normalizedPath)\n  preventPollution(method)\n\n  /** Create the operation in the document */\n  document.paths[normalizedPath][method] = operation\n\n  // Make sure that we are selecting the new operation server\n  const { servers } = operation\n  const firstServer = unpackProxyObject(servers?.[0])\n\n  // For now we only support document servers but in the future we might support operation servers\n  for (const server of servers ?? []) {\n    // If the server does not exist in the document, add it\n    if (!document.servers?.some((s) => s.url === server.url)) {\n      if (!document.servers) {\n        document.servers = []\n      }\n      document.servers.push(unpackProxyObject(server))\n    }\n  }\n\n  // Update the selected server to the first server of the created operation\n  if (firstServer) {\n    document['x-scalar-selected-server'] = firstServer.url\n  }\n\n  // Sync path variables\n  const newParameters = syncParametersForPathChange(normalizedPath, normalizedPath, operation.parameters ?? [])\n  if (newParameters.length > 0) {\n    operation.parameters = newParameters\n  }\n\n  payload.callback?.(true)\n  return normalizedPath\n}\n\n/**\n * Updates the `description` of an operation.\n * Safely no-ops if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationDescription(\n *   document,\n *   { meta: { method: 'get', path: '/users' }, payload: { description: 'Get a single user' },\n * })\n * ```\n */\nexport const updateOperationMeta = (\n  store: WorkspaceStore | null,\n  document: WorkspaceDocument | null,\n  { meta, payload }: OperationEvents['operation:update:meta'],\n) => {\n  if (!document || !store) {\n    return\n  }\n\n  const documentName = document['x-scalar-navigation']?.name\n  if (documentName === undefined) {\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method as HttpMethod])\n  if (!operation) {\n    console.error('Operation not found', { meta, document })\n    return\n  }\n\n  // Update the description of the operation\n  Object.assign(operation, payload)\n\n  // Rebuild the sidebar to reflect the cahnges\n  store.buildSidebar(documentName)\n}\n\n/**\n * Updates the HTTP method and/or path of an operation and moves it to the new location.\n * This function:\n * 1. Moves the operation from the old method/path to the new method/path under paths\n * 2. Updates x-scalar-order to maintain the operation's position in the sidebar\n * 3. Syncs path parameters when the path changes\n *\n * Safely no-ops if nothing has changed, or if the document or operation does not exist.\n *\n * Example:\n * ```ts\n * updateOperationPathMethod({\n *   document,\n *   store,\n *   meta: { method: 'get', path: '/users' },\n *   payload: { method: 'post', path: '/api/users' },\n * })\n * ```\n */\nexport const updateOperationPathMethod = (\n  document: WorkspaceDocument | null,\n  store: WorkspaceStore | null,\n  { meta, payload: { method, path }, callback }: OperationEvents['operation:update:pathMethod'],\n): void => {\n  const methodChanged = meta.method !== method\n  const pathChanged = meta.path !== path\n\n  // If nothing has changed, no need to do anything\n  if (!methodChanged && !pathChanged) {\n    callback('no-change')\n    return\n  }\n\n  // Determine the final method and path\n  const finalMethod = methodChanged ? method : meta.method\n  const finalPath = pathChanged ? path : meta.path\n\n  // Check for conflicts at the target location\n  if (document?.paths?.[finalPath]?.[finalMethod as HttpMethod]) {\n    callback('conflict')\n    return\n  }\n\n  const documentNavigation = document?.['x-scalar-navigation']\n  if (!documentNavigation || !store) {\n    console.error('Document or workspace not found', { document })\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method as HttpMethod])\n  if (!operation) {\n    console.error('Operation not found', { meta, document })\n    return\n  }\n\n  // Sync path parameters if the path has changed\n  if (pathChanged) {\n    const oldPathParams = findVariables(meta.path, { includePath: true, includeEnv: false }).filter(\n      (v): v is string => v !== undefined,\n    )\n    const newPathParams = findVariables(finalPath, { 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(finalPath, meta.path, existingParameters)\n    }\n  }\n\n  /**\n   * We don't pass navigation options as we don't have config on the client,\n   * and we don't change path or method on the references\n   */\n  const { generateId } = getNavigationOptions(documentNavigation.name)\n\n  /** Grabs all of the current operation entries for the given path and method */\n  const operationEntriesMap = getOperationEntries(documentNavigation)\n  const entries = operationEntriesMap.get(`${meta.path}|${meta.method}`)\n\n  // Updates the order ID so we don't lose the sidebar ordering when it rebuilds\n  if (entries) {\n    updateOrderIds({ store, operation, generateId, method: finalMethod, path: finalPath, entries })\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[finalPath]) {\n    document.paths[finalPath] = {}\n  }\n\n  // Prevent assigning dangerous keys to the path items object\n  preventPollution(finalPath)\n  preventPollution(meta.path)\n  preventPollution(finalMethod)\n\n  // Move the operation to the new location\n  document.paths[finalPath][finalMethod] = unpackProxyObject(operation)\n\n  // Remove the operation from the old location\n  const oldPathItems = document.paths[meta.path]\n  if (oldPathItems && isHttpMethod(meta.method)) {\n    delete oldPathItems[meta.method]\n\n    // If the old path has no more operations, remove the path entry\n    if (Object.keys(oldPathItems).length === 0) {\n      delete document.paths[meta.path]\n    }\n  }\n\n  // We need to reset the history for the operation when the path or method changes\n  store.history.clearOperationHistory(document['x-scalar-navigation']?.name ?? '', meta.path, meta.method)\n\n  callback('success')\n}\n\n/**\n * Deletes an operation from the workspace\n *\n * Example:\n * ```ts\n * deleteOperation({\n *   document,\n *   meta: { method: 'get', path: '/users' },\n * })\n * ```\n */\nexport const deleteOperation = (\n  workspace: WorkspaceStore | null,\n  { meta, documentName }: OperationEvents['operation:delete:operation'],\n) => {\n  const document = workspace?.workspace.documents[documentName]\n  if (!document) {\n    return\n  }\n\n  preventPollution(meta.path)\n  preventPollution(meta.method)\n\n  delete document.paths?.[meta.path]?.[meta.method]\n\n  // If the path has no more operations, remove the path entry\n  if (Object.keys(document.paths?.[meta.path] ?? {}).length === 0) {\n    delete document.paths?.[meta.path]\n  }\n}\n\n/**\n * Adds an example name to the 'x-draft-examples' array for a specific operation in a document.\n *\n * - Finds the target operation using the provided path and method within the specified document.\n * - If the operation is found and has an 'x-draft-examples' array, pushes the new exampleName to it.\n * - Safely no-ops if the document or operation does not exist.\n */\nexport const createOperationDraftExample = (\n  workspace: WorkspaceStore | null,\n  { meta: { path, method }, documentName, exampleName }: OperationEvents['operation:create:draft-example'],\n) => {\n  const document = workspace?.workspace.documents[documentName]\n  if (!document) {\n    console.error('Document not found', { documentName })\n    return\n  }\n\n  const operation = getResolvedRef(document.paths?.[path]?.[method])\n  if (!operation) {\n    console.error('Operation not found', { path, method })\n    return\n  }\n\n  // Ensure that the x-draft-examples array exists\n  operation['x-draft-examples'] ??= []\n\n  // Remove duplicates\n  const dedupe = new Set(operation['x-draft-examples'])\n  // Add the new example name\n  dedupe.add(exampleName)\n  // Update the operation with the new x-draft-examples array\n  operation['x-draft-examples'] = Array.from(dedupe)\n}\n\n/**\n * Deletes an example with the given exampleKey from operation parameters and request body.\n *\n * - Finds the target operation within the specified document and path/method.\n * - Removes example values matching exampleKey from both parameter-level and content-level examples.\n * - Safely no-ops if the document, operation, or request body does not exist.\n */\nexport const deleteOperationExample = (\n  workspace: WorkspaceStore | null,\n  { meta: { path, method, exampleKey }, documentName }: OperationEvents['operation:delete:example'],\n) => {\n  // Find the document in workspace based on documentName\n  const document = workspace?.workspace.documents[documentName]\n  if (!document) {\n    return\n  }\n\n  // Get the operation object for the given path and method\n  const operation = getResolvedRef(document.paths?.[path]?.[method])\n  if (!operation) {\n    return\n  }\n\n  // Remove the example from the x-draft-examples array\n  const dedupe = new Set(operation['x-draft-examples'] ?? [])\n  dedupe.delete(exampleKey)\n\n  if (operation['x-draft-examples'] !== undefined) {\n    operation['x-draft-examples'] = Array.from(dedupe)\n  }\n\n  // Remove the example from all operation parameters\n  operation.parameters?.forEach((parameter) => {\n    const resolvedParameter = getResolvedRef(parameter)\n\n    // Remove from content-level examples (if parameter uses content)\n    if ('content' in resolvedParameter && resolvedParameter.content) {\n      Object.values(resolvedParameter.content).forEach((mediaType) => {\n        delete mediaType.examples?.[exampleKey]\n      })\n    }\n\n    // Remove from parameter-level examples\n    if ('examples' in resolvedParameter && resolvedParameter.examples) {\n      delete resolvedParameter.examples?.[exampleKey]\n    }\n  })\n\n  // Remove the example from request body content types (if requestBody exists)\n  const requestBody = getResolvedRef(operation.requestBody)\n  if (!requestBody) {\n    return\n  }\n\n  // For each media type, remove the example matching exampleKey\n  Object.values(requestBody.content ?? {}).forEach((mediaType) => {\n    delete mediaType.examples?.[exampleKey]\n  })\n}\n"],
+  "mappings": "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",
   "names": []
 }