@zuplo/cli 6.62.7 → 6.62.9

package/dist/open-api/overlay/overlay-engine.js

@@ -0,0 +1,280 @@
+import { JSONPath } from "jsonpath-plus";
+export function deepClone(obj) {
+    if (typeof structuredClone === "function") {
+        return structuredClone(obj);
+    }
+    return JSON.parse(JSON.stringify(obj));
+}
+export function deepMerge(target, source) {
+    if (!source || typeof source !== "object") {
+        return source;
+    }
+    if (!target || typeof target !== "object") {
+        return deepClone(source);
+    }
+    if (Array.isArray(source)) {
+        if (!Array.isArray(target)) {
+            return deepClone(source);
+        }
+        if (source.length > 0 &&
+            source[0].name !== undefined &&
+            source[0].in !== undefined) {
+            const merged = [...target];
+            for (const sourceParam of source) {
+                const existingIndex = merged.findIndex((p) => p.name === sourceParam.name && p.in === sourceParam.in);
+                if (existingIndex >= 0) {
+                    merged[existingIndex] = deepMerge(merged[existingIndex], sourceParam);
+                }
+                else {
+                    merged.push(deepClone(sourceParam));
+                }
+            }
+            return merged;
+        }
+        return [...target, ...deepClone(source)];
+    }
+    const result = { ...target };
+    for (const [key, value] of Object.entries(source)) {
+        if (key in result) {
+            result[key] = deepMerge(result[key], value);
+        }
+        else {
+            result[key] = deepClone(value);
+        }
+    }
+    return result;
+}
+export function checkCondition(value, condition) {
+    if (condition.empty) {
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            return Object.keys(value).length === 0;
+        }
+        if (Array.isArray(value)) {
+            return value.length === 0;
+        }
+        return false;
+    }
+    if (condition.missing) {
+        const parts = condition.missing.split(".");
+        let current = value;
+        for (const part of parts) {
+            if (current && typeof current === "object" && part in current) {
+                current = current[part];
+            }
+            else {
+                return true;
+            }
+        }
+        return false;
+    }
+    return false;
+}
+const JSONPATH_SEGMENT_PATTERN = /[^.[]+|\[[^\]]+\]/g;
+function extractBracketKey(bracketNotation) {
+    const inner = bracketNotation.slice(1, -1);
+    if (inner.startsWith("'") && inner.endsWith("'")) {
+        return inner.slice(1, -1);
+    }
+    if (inner.startsWith('"') && inner.endsWith('"')) {
+        return inner.slice(1, -1);
+    }
+    return inner;
+}
+export function setValueAtPath(doc, target, value) {
+    const targetPath = target.replace(/^\$\./, "");
+    const parts = targetPath.match(JSONPATH_SEGMENT_PATTERN) || [];
+    let current = doc;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (part.startsWith("[")) {
+            const key = extractBracketKey(part);
+            if (!(key in current)) {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        else {
+            if (!(part in current)) {
+                current[part] = {};
+            }
+            current = current[part];
+        }
+    }
+    const lastPart = parts[parts.length - 1];
+    if (lastPart.startsWith("[")) {
+        const key = extractBracketKey(lastPart);
+        current[key] = value;
+    }
+    else {
+        current[lastPart] = value;
+    }
+}
+export function applyAction(doc, action) {
+    if (action.update) {
+        if (action.target === "$") {
+            Object.assign(doc, deepMerge(doc, action.update));
+            return { applied: true, count: 1 };
+        }
+        try {
+            const results = JSONPath({
+                path: action.target,
+                json: doc,
+                resultType: "all",
+            });
+            if (results.length > 0) {
+                let count = 0;
+                for (const result of results) {
+                    const { parent, parentProperty } = result;
+                    if (parent && parentProperty !== undefined) {
+                        parent[parentProperty] = deepMerge(parent[parentProperty], action.update);
+                        count++;
+                    }
+                }
+                return { applied: true, count };
+            }
+            setValueAtPath(doc, action.target, action.update);
+            return { applied: true, count: 1 };
+        }
+        catch (error) {
+            throw new Error(`Failed to apply update: ${error.message}`);
+        }
+    }
+    else if (action.remove) {
+        try {
+            const results = JSONPath({
+                path: action.target,
+                json: doc,
+                resultType: "all",
+            });
+            if (results.length === 0) {
+                return { applied: false, count: 0 };
+            }
+            let count = 0;
+            for (let i = results.length - 1; i >= 0; i--) {
+                const result = results[i];
+                const { parent, parentProperty, value } = result;
+                const shouldRemove = typeof action.remove === "object"
+                    ? checkCondition(value, action.remove)
+                    : true;
+                if (shouldRemove && parent && parentProperty !== undefined) {
+                    if (Array.isArray(parent)) {
+                        parent.splice(parentProperty, 1);
+                    }
+                    else {
+                        delete parent[parentProperty];
+                    }
+                    count++;
+                }
+            }
+            return { applied: true, count };
+        }
+        catch (error) {
+            throw new Error(`Failed to remove: ${error.message}`);
+        }
+    }
+    return { applied: false, count: 0 };
+}
+export function extractPathOrder(overlay) {
+    const pathOrder = [];
+    const seenPaths = new Set();
+    for (const action of overlay.actions) {
+        const match = action.target.match(/^\$\.paths\['([^']+)'\]/);
+        if (match) {
+            const targetPath = match[1];
+            if (!seenPaths.has(targetPath)) {
+                pathOrder.push(targetPath);
+                seenPaths.add(targetPath);
+            }
+        }
+    }
+    return pathOrder;
+}
+export function reorderOperationProperties(operation) {
+    const priorityKeys = ["summary", "description", "operationId"];
+    const reordered = {};
+    for (const key of priorityKeys) {
+        if (key in operation) {
+            reordered[key] = operation[key];
+        }
+    }
+    for (const [key, value] of Object.entries(operation)) {
+        if (!priorityKeys.includes(key)) {
+            reordered[key] = value;
+        }
+    }
+    return reordered;
+}
+export function reorderPaths(doc, pathOrder) {
+    if (!doc.paths || pathOrder.length === 0) {
+        return doc;
+    }
+    const originalPaths = doc.paths;
+    const reorderedPaths = {};
+    for (const targetPath of pathOrder) {
+        if (targetPath in originalPaths) {
+            reorderedPaths[targetPath] = originalPaths[targetPath];
+        }
+    }
+    for (const [targetPath, value] of Object.entries(originalPaths)) {
+        if (!(targetPath in reorderedPaths)) {
+            reorderedPaths[targetPath] = value;
+        }
+    }
+    for (const pathItem of Object.values(reorderedPaths)) {
+        const httpMethods = [
+            "get",
+            "post",
+            "put",
+            "patch",
+            "delete",
+            "options",
+            "head",
+            "trace",
+        ];
+        for (const method of httpMethods) {
+            if (pathItem[method] &&
+                typeof pathItem[method] === "object") {
+                pathItem[method] = reorderOperationProperties(pathItem[method]);
+            }
+        }
+    }
+    doc.paths = reorderedPaths;
+    return doc;
+}
+export function reorderDocumentProperties(doc) {
+    const priorityKeys = ["openapi", "info", "tags"];
+    const reordered = {};
+    for (const key of priorityKeys) {
+        if (key in doc) {
+            reordered[key] = doc[key];
+        }
+    }
+    for (const [key, value] of Object.entries(doc)) {
+        if (!priorityKeys.includes(key)) {
+            reordered[key] = value;
+        }
+    }
+    return reordered;
+}
+export function applyOverlay(openapi, overlay) {
+    if (!overlay.overlay || !overlay.actions) {
+        throw new Error("Invalid overlay format. Must include 'overlay' version and 'actions' array.");
+    }
+    const result = deepClone(openapi);
+    const stats = { applied: 0, skipped: 0, totalNodes: 0 };
+    for (const action of overlay.actions) {
+        const { applied, count } = applyAction(result, action);
+        if (applied) {
+            stats.applied++;
+            stats.totalNodes += count;
+        }
+        else {
+            stats.skipped++;
+        }
+    }
+    const pathOrder = extractPathOrder(overlay);
+    reorderPaths(result, pathOrder);
+    const reordered = reorderDocumentProperties(result);
+    return { result: reordered, stats };
+}
+//# sourceMappingURL=overlay-engine.js.map

package/dist/open-api/overlay/overlay-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.js","sourceRoot":"","sources":["../../../src/open-api/overlay/overlay-engine.ts"],"names":[],"mappings":"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","sourcesContent":["/** biome-ignore-all lint/suspicious/noExplicitAny: Complex overlay algorithm working with dynamic JSON structures */\nimport { JSONPath } from \"jsonpath-plus\";\n\nexport interface OverlayDocument {\n  overlay: string;\n  info: {\n    title: string;\n    version: string;\n  };\n  actions: OverlayAction[];\n  extends?: string;\n}\n\nexport interface OverlayAction {\n  target: string;\n  description?: string;\n  update?: any;\n  remove?: boolean | RemoveCondition;\n}\n\nexport interface RemoveCondition {\n  empty?: boolean;\n  missing?: string;\n}\n\nexport interface ApplyResult {\n  applied: boolean;\n  count: number;\n}\n\nexport interface OverlayStats {\n  applied: number;\n  skipped: number;\n  totalNodes: number;\n}\n\n/**\n * Deep clone an object using structuredClone for better performance and correctness\n * Falls back to JSON parse/stringify for environments without structuredClone\n */\nexport function deepClone<T>(obj: T): T {\n  if (typeof structuredClone === \"function\") {\n    return structuredClone(obj);\n  }\n  return JSON.parse(JSON.stringify(obj));\n}\n\n/**\n * Deep merge two objects\n * Special handling for OpenAPI parameters (merge by name+in)\n */\nexport function deepMerge(target: any, source: any): any {\n  if (!source || typeof source !== \"object\") {\n    return source;\n  }\n\n  if (!target || typeof target !== \"object\") {\n    return deepClone(source);\n  }\n\n  if (Array.isArray(source)) {\n    if (!Array.isArray(target)) {\n      return deepClone(source);\n    }\n\n    // Special case for OpenAPI parameters - merge by name+in\n    if (\n      source.length > 0 &&\n      source[0].name !== undefined &&\n      source[0].in !== undefined\n    ) {\n      const merged = [...target];\n      for (const sourceParam of source) {\n        const existingIndex = merged.findIndex(\n          (p) => p.name === sourceParam.name && p.in === sourceParam.in\n        );\n        if (existingIndex >= 0) {\n          merged[existingIndex] = deepMerge(merged[existingIndex], sourceParam);\n        } else {\n          merged.push(deepClone(sourceParam));\n        }\n      }\n      return merged;\n    }\n\n    // For other arrays, concatenate\n    return [...target, ...deepClone(source)];\n  }\n\n  const result = { ...target };\n  for (const [key, value] of Object.entries(source)) {\n    if (key in result) {\n      result[key] = deepMerge(result[key], value);\n    } else {\n      result[key] = deepClone(value);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Check if a condition is met for conditional removal\n */\nexport function checkCondition(\n  value: any,\n  condition: RemoveCondition\n): boolean {\n  // Support \"empty\" condition to check if object has no keys\n  if (condition.empty) {\n    if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n      return Object.keys(value).length === 0;\n    }\n    if (Array.isArray(value)) {\n      return value.length === 0;\n    }\n    return false;\n  }\n\n  // Support \"missing\" condition to check if a property doesn't exist\n  if (condition.missing) {\n    const parts = condition.missing.split(\".\");\n    let current = value;\n    for (const part of parts) {\n      if (current && typeof current === \"object\" && part in current) {\n        current = current[part];\n      } else {\n        return true; // Property is missing\n      }\n    }\n    return false; // Property exists\n  }\n\n  return false;\n}\n\n/**\n * Regular expression for parsing JSONPath segments\n * Matches: word, or [quoted], or ['quoted'], or [\"quoted\"], or numeric indices [0]\n */\nconst JSONPATH_SEGMENT_PATTERN = /[^.[]+|\\[[^\\]]+\\]/g;\n\n/**\n * Extract key from bracket notation, handling various formats:\n * - ['key'] -> key\n * - [\"key\"] -> key\n * - [key] -> key\n * - [0] -> 0 (as string for consistency)\n */\nfunction extractBracketKey(bracketNotation: string): string {\n  const inner = bracketNotation.slice(1, -1); // Remove [ and ]\n\n  // Handle single-quoted: ['key'] -> key\n  if (inner.startsWith(\"'\") && inner.endsWith(\"'\")) {\n    return inner.slice(1, -1);\n  }\n\n  // Handle double-quoted: [\"key\"] -> key\n  if (inner.startsWith('\"') && inner.endsWith('\"')) {\n    return inner.slice(1, -1);\n  }\n\n  // Handle unquoted: [key] or [0] -> key or 0\n  return inner;\n}\n\n/**\n * Set a value at a JSONPath, creating parent paths as needed\n * Handles patterns like:\n *   $.paths['/route'].method\n *   $.components.parameters['name']\n *   $.paths[\"/users\"].get\n *   $.paths[users].get\n *   $.items[0].value\n */\nexport function setValueAtPath(doc: any, target: string, value: any): void {\n  // Parse the path manually to handle both bracket and dot notation\n  // Example: $.paths['/route'].post -> [\"paths\", \"['/route']\", \"post\"]\n\n  // Remove leading $.\n  const targetPath = target.replace(/^\\$\\./, \"\");\n\n  // Split by dots, but keep bracket notation together\n  const parts = targetPath.match(JSONPATH_SEGMENT_PATTERN) || [];\n\n  let current = doc;\n\n  for (let i = 0; i < parts.length - 1; i++) {\n    const part = parts[i];\n\n    // Handle bracket notation\n    if (part.startsWith(\"[\")) {\n      const key = extractBracketKey(part);\n      if (!(key in current)) {\n        current[key] = {};\n      }\n      current = current[key];\n    } else {\n      // Handle regular property\n      if (!(part in current)) {\n        current[part] = {};\n      }\n      current = current[part];\n    }\n  }\n\n  // Set the final value\n  const lastPart = parts[parts.length - 1];\n  if (lastPart.startsWith(\"[\")) {\n    const key = extractBracketKey(lastPart);\n    current[key] = value;\n  } else {\n    current[lastPart] = value;\n  }\n}\n\n/**\n * Apply a single overlay action to the document\n */\nexport function applyAction(doc: any, action: OverlayAction): ApplyResult {\n  if (action.update) {\n    // Handle root level updates specially\n    if (action.target === \"$\") {\n      Object.assign(doc, deepMerge(doc, action.update));\n      return { applied: true, count: 1 };\n    }\n\n    try {\n      // Try to find existing nodes\n      const results = JSONPath({\n        path: action.target,\n        json: doc,\n        resultType: \"all\",\n      });\n\n      if (results.length > 0) {\n        // Path exists, merge the update\n        let count = 0;\n        for (const result of results) {\n          const { parent, parentProperty } = result;\n          if (parent && parentProperty !== undefined) {\n            parent[parentProperty] = deepMerge(\n              parent[parentProperty],\n              action.update\n            );\n            count++;\n          }\n        }\n        return { applied: true, count };\n      }\n\n      // Path doesn't exist, create it manually\n      setValueAtPath(doc, action.target, action.update);\n      return { applied: true, count: 1 };\n    } catch (error) {\n      throw new Error(`Failed to apply update: ${(error as Error).message}`);\n    }\n  } else if (action.remove) {\n    try {\n      const results = JSONPath({\n        path: action.target,\n        json: doc,\n        resultType: \"all\",\n      });\n\n      if (results.length === 0) {\n        return { applied: false, count: 0 };\n      }\n\n      let count = 0;\n      // Process in reverse to avoid index issues when removing\n      for (let i = results.length - 1; i >= 0; i--) {\n        const result = results[i];\n        const { parent, parentProperty, value } = result;\n\n        // Check condition if specified\n        const shouldRemove =\n          typeof action.remove === \"object\"\n            ? checkCondition(value, action.remove)\n            : true;\n\n        if (shouldRemove && parent && parentProperty !== undefined) {\n          if (Array.isArray(parent)) {\n            parent.splice(parentProperty as number, 1);\n          } else {\n            delete parent[parentProperty];\n          }\n          count++;\n        }\n      }\n\n      return { applied: true, count };\n    } catch (error) {\n      throw new Error(`Failed to remove: ${(error as Error).message}`);\n    }\n  }\n\n  return { applied: false, count: 0 };\n}\n\n/**\n * Extract path order from overlay actions\n * Returns array of paths in the order they appear in overlay\n */\nexport function extractPathOrder(overlay: OverlayDocument): string[] {\n  const pathOrder: string[] = [];\n  const seenPaths = new Set<string>();\n\n  for (const action of overlay.actions) {\n    // Match patterns like $.paths['/route'].method\n    const match = action.target.match(/^\\$\\.paths\\['([^']+)'\\]/);\n    if (match) {\n      const targetPath = match[1];\n      if (!seenPaths.has(targetPath)) {\n        pathOrder.push(targetPath);\n        seenPaths.add(targetPath);\n      }\n    }\n  }\n\n  return pathOrder;\n}\n\n/**\n * Reorder operation properties so summary, description, operationId come first\n */\nexport function reorderOperationProperties(operation: any): any {\n  const priorityKeys = [\"summary\", \"description\", \"operationId\"];\n  const reordered: any = {};\n\n  // Add priority keys first (in order)\n  for (const key of priorityKeys) {\n    if (key in operation) {\n      reordered[key] = operation[key];\n    }\n  }\n\n  // Add remaining keys\n  for (const [key, value] of Object.entries(operation)) {\n    if (!priorityKeys.includes(key)) {\n      reordered[key] = value;\n    }\n  }\n\n  return reordered;\n}\n\n/**\n * Reorder paths object to match the order from overlay\n */\nexport function reorderPaths(doc: any, pathOrder: string[]): any {\n  if (!doc.paths || pathOrder.length === 0) {\n    return doc;\n  }\n\n  const originalPaths = doc.paths;\n  const reorderedPaths: any = {};\n\n  // First, add paths in the order specified by overlay\n  for (const targetPath of pathOrder) {\n    if (targetPath in originalPaths) {\n      reorderedPaths[targetPath] = originalPaths[targetPath];\n    }\n  }\n\n  // Then add any remaining paths that weren't in the overlay\n  for (const [targetPath, value] of Object.entries(originalPaths)) {\n    if (!(targetPath in reorderedPaths)) {\n      reorderedPaths[targetPath] = value;\n    }\n  }\n\n  // Reorder operation properties within each path\n  for (const pathItem of Object.values(reorderedPaths)) {\n    const httpMethods = [\n      \"get\",\n      \"post\",\n      \"put\",\n      \"patch\",\n      \"delete\",\n      \"options\",\n      \"head\",\n      \"trace\",\n    ];\n\n    for (const method of httpMethods) {\n      if (\n        (pathItem as any)[method] &&\n        typeof (pathItem as any)[method] === \"object\"\n      ) {\n        (pathItem as any)[method] = reorderOperationProperties(\n          (pathItem as any)[method]\n        );\n      }\n    }\n  }\n\n  doc.paths = reorderedPaths;\n  return doc;\n}\n\n/**\n * Reorder top-level document properties to ensure proper ordering\n * OpenAPI spec should have: openapi, info, tags, servers, paths, components, etc.\n */\nexport function reorderDocumentProperties(doc: any): any {\n  const priorityKeys = [\"openapi\", \"info\", \"tags\"];\n  const reordered: any = {};\n\n  // Add priority keys first\n  for (const key of priorityKeys) {\n    if (key in doc) {\n      reordered[key] = doc[key];\n    }\n  }\n\n  // Add remaining keys\n  for (const [key, value] of Object.entries(doc)) {\n    if (!priorityKeys.includes(key)) {\n      reordered[key] = value;\n    }\n  }\n\n  return reordered;\n}\n\n/**\n * Apply overlay to OpenAPI document\n * @param openapi The OpenAPI document to modify\n * @param overlay The overlay document to apply\n * @returns The modified OpenAPI document and statistics\n */\nexport function applyOverlay(\n  openapi: any,\n  overlay: OverlayDocument\n): { result: any; stats: OverlayStats } {\n  // Validate overlay format\n  if (!overlay.overlay || !overlay.actions) {\n    throw new Error(\n      \"Invalid overlay format. Must include 'overlay' version and 'actions' array.\"\n    );\n  }\n\n  const result = deepClone(openapi);\n  const stats: OverlayStats = { applied: 0, skipped: 0, totalNodes: 0 };\n\n  for (const action of overlay.actions) {\n    const { applied, count } = applyAction(result, action);\n\n    if (applied) {\n      stats.applied++;\n      stats.totalNodes += count;\n    } else {\n      stats.skipped++;\n    }\n  }\n\n  // Reorder paths to match overlay order\n  const pathOrder = extractPathOrder(overlay);\n  reorderPaths(result, pathOrder);\n\n  // Reorder top-level document properties\n  const reordered = reorderDocumentProperties(result);\n\n  return { result: reordered, stats };\n}\n"]}

package/dist/open-api/overlay/overlay-engine.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=overlay-engine.spec.d.ts.map

package/dist/open-api/overlay/overlay-engine.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.spec.d.ts","sourceRoot":"","sources":["../../../src/open-api/overlay/overlay-engine.spec.ts"],"names":[],"mappings":""}