@zuplo/cli 6.62.7 → 6.62.9

package/dist/open-api/merge/merge-engine.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-engine.spec.js","sourceRoot":"","sources":["../../../src/open-api/merge/merge-engine.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it } from \"node:test\";\nimport assert from \"node:assert\";\nimport {\n  isUrl,\n  guessFileNameFromUrl,\n  detectFormat,\n  detectFormatFromContent,\n} from \"./merge-engine.js\";\n\ndescribe(\"Merge Engine\", () => {\n  describe(\"isUrl\", () => {\n    it(\"should return true for valid HTTP URLs\", () => {\n      assert.strictEqual(isUrl(\"http://example.com\"), true);\n      assert.strictEqual(isUrl(\"http://example.com/api.json\"), true);\n      assert.strictEqual(isUrl(\"http://api.example.com/v1/openapi.yaml\"), true);\n    });\n\n    it(\"should return true for valid HTTPS URLs\", () => {\n      assert.strictEqual(isUrl(\"https://example.com\"), true);\n      assert.strictEqual(isUrl(\"https://example.com/api.json\"), true);\n      assert.strictEqual(\n        isUrl(\"https://api.example.com/v1/openapi.yaml\"),\n        true\n      );\n    });\n\n    it(\"should return true for URLs with query parameters\", () => {\n      assert.strictEqual(isUrl(\"https://example.com/api?version=1.0\"), true);\n      assert.strictEqual(\n        isUrl(\"https://example.com/api?format=json&version=2\"),\n        true\n      );\n    });\n\n    it(\"should return true for URLs with fragments\", () => {\n      assert.strictEqual(isUrl(\"https://example.com/api#section\"), true);\n      assert.strictEqual(\n        isUrl(\"https://example.com/api.json#definitions\"),\n        true\n      );\n    });\n\n    it(\"should return true for URLs with ports\", () => {\n      assert.strictEqual(isUrl(\"https://example.com:8080/api\"), true);\n      assert.strictEqual(isUrl(\"http://localhost:3000/openapi.json\"), true);\n    });\n\n    it(\"should return false for relative file paths\", () => {\n      assert.strictEqual(isUrl(\"./api.json\"), false);\n      assert.strictEqual(isUrl(\"../specs/openapi.yaml\"), false);\n      assert.strictEqual(isUrl(\"docs/api.json\"), false);\n    });\n\n    it(\"should return false for absolute file paths\", () => {\n      assert.strictEqual(isUrl(\"/path/to/api.json\"), false);\n      assert.strictEqual(isUrl(\"/Users/name/docs/openapi.yaml\"), false);\n      // Windows absolute paths with drive letters may be interpreted as URLs with protocol\n      // This is expected behavior from the URL constructor\n    });\n\n    it(\"should return false for filenames without paths\", () => {\n      assert.strictEqual(isUrl(\"api.json\"), false);\n      assert.strictEqual(isUrl(\"openapi.yaml\"), false);\n    });\n\n    it(\"should return false for empty strings\", () => {\n      assert.strictEqual(isUrl(\"\"), false);\n    });\n  });\n\n  describe(\"guessFileNameFromUrl\", () => {\n    it(\"should extract filename from URL path\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/api.json\"),\n        \"api\"\n      );\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/openapi.yaml\"),\n        \"openapi\"\n      );\n    });\n\n    it(\"should extract filename from URL with multiple path segments\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/v1/specs/api.json\"),\n        \"api\"\n      );\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://api.example.com/docs/v2/openapi.yaml\"),\n        \"openapi\"\n      );\n    });\n\n    it(\"should extract filename from URL with query parameters\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/api.json?version=1\"),\n        \"api\"\n      );\n      assert.strictEqual(\n        guessFileNameFromUrl(\n          \"https://example.com/openapi.yaml?format=json&v=2\"\n        ),\n        \"openapi\"\n      );\n    });\n\n    it(\"should extract filename from URL with fragments\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/api.json#section\"),\n        \"api\"\n      );\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/spec.yaml#definitions\"),\n        \"spec\"\n      );\n    });\n\n    it(\"should handle URLs with no file extension\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/api\"),\n        \"api\"\n      );\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/v1/openapi\"),\n        \"openapi\"\n      );\n    });\n\n    it(\"should handle URLs ending with slash\", () => {\n      // When URL ends with slash, pop() returns empty string, should use base64\n      const result = guessFileNameFromUrl(\"https://example.com/api/\");\n      assert.strictEqual(result.startsWith(\"imported-\"), true);\n    });\n\n    it(\"should generate base64 name for root URLs\", () => {\n      const result = guessFileNameFromUrl(\"https://example.com/\");\n      assert.strictEqual(result.startsWith(\"imported-\"), true);\n      assert.strictEqual(result.length > 9, true); // \"imported-\" is 9 chars\n    });\n\n    it(\"should handle filenames with multiple dots\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/api.v1.0.json\"),\n        \"api.v1.0\"\n      );\n      assert.strictEqual(\n        guessFileNameFromUrl(\"https://example.com/my.api.spec.yaml\"),\n        \"my.api.spec\"\n      );\n    });\n\n    it(\"should handle complex URLs\", () => {\n      assert.strictEqual(\n        guessFileNameFromUrl(\n          \"https://api.example.com:8080/v2/specs/openapi.json?auth=token#info\"\n        ),\n        \"openapi\"\n      );\n    });\n\n    it(\"should generate consistent base64 names for same URL\", () => {\n      const url = \"https://example.com/\";\n      const name1 = guessFileNameFromUrl(url);\n      const name2 = guessFileNameFromUrl(url);\n      assert.strictEqual(name1, name2);\n    });\n  });\n\n  describe(\"detectFormat (re-exported from common)\", () => {\n    it(\"should detect JSON format\", () => {\n      assert.strictEqual(detectFormat(\"api.json\"), \"json\");\n      assert.strictEqual(detectFormat(\"/path/to/api.json\"), \"json\");\n    });\n\n    it(\"should detect YAML format\", () => {\n      assert.strictEqual(detectFormat(\"api.yaml\"), \"yaml\");\n      assert.strictEqual(detectFormat(\"api.yml\"), \"yaml\");\n    });\n\n    it(\"should return null for unknown extensions\", () => {\n      assert.strictEqual(detectFormat(\"api.txt\"), null);\n    });\n  });\n\n  describe(\"detectFormatFromContent (re-exported from common)\", () => {\n    it(\"should detect JSON content\", () => {\n      const content = '{\"openapi\": \"3.1.0\"}';\n      assert.strictEqual(detectFormatFromContent(content), \"json\");\n    });\n\n    it(\"should detect YAML content\", () => {\n      const content = \"openapi: 3.1.0\\ninfo:\\n  title: Test\";\n      assert.strictEqual(detectFormatFromContent(content), \"yaml\");\n    });\n\n    it(\"should throw error for invalid content\", () => {\n      const content = \"not valid json or yaml: : :\";\n      assert.throws(\n        () => detectFormatFromContent(content),\n        /Failed to parse content/\n      );\n    });\n  });\n});\n"]}

package/dist/open-api/merge/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/open-api/merge/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,mBAAmB,UAA6B,CAAC;AAE9D,eAAO,MAAM,gBAAgB,GAAU,SAAS,MAAM,EAAE,UAAU,MAAM,6DAYvE,CAAC;AAMF,eAAO,MAAM,0BAA0B,GACrC,SAAS,WAAW,CAAC,QAAQ,GAAG,oBAAoB,SA4BrD,CAAC"}

package/dist/open-api/merge/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/open-api/merge/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAG1B,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,OAAe,EAAE,QAAgB,EAAE,EAAE;IAC1E,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,gDAAgD,mBAAmB,CAAC,IAAI,CACtE,IAAI,CACL,EAAE,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAgD,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAgD,CAAC;AAC5E,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,OAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG;YACd,KAAK;YACL,KAAK;YACL,MAAM;YACN,QAAQ;YACR,SAAS;YACT,MAAM;YACN,OAAO;YACP,OAAO;SACqB,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;gBACxC,SAAS,CAAC,WAAW,GAAG,EAAE,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC","sourcesContent":["import yaml from \"js-yaml\";\nimport { OpenAPIV3_1 } from \"openapi-types\";\nimport { v4 } from \"uuid\";\nimport { ZuploOpenApiDocument } from \"./interfaces.js\";\n\nexport const OPERATION_PATH_MERGE_DELIMITER = \">\";\nexport const OPEN_API_FILE_TYPES = [\".json\", \".yml\", \".yaml\"];\n\nexport const parseOpenApiFile = async (extName: string, fileText: string) => {\n  if (!OPEN_API_FILE_TYPES.includes(extName)) {\n    throw new Error(\n      `Invalid file type. Supported file types are: ${OPEN_API_FILE_TYPES.join(\n        \", \"\n      )}`\n    );\n  }\n  if (extName.includes(\"json\")) {\n    return JSON.parse(fileText) as OpenAPIV3_1.Document | ZuploOpenApiDocument;\n  }\n  return yaml.load(fileText) as OpenAPIV3_1.Document | ZuploOpenApiDocument;\n};\n\n/**\n * Add operation ID to any operations that don't have one, this makes\n * onboarding smoother for new users\n */\nexport const addOperationIdsAsNecessary = (\n  openApi: OpenAPIV3_1.Document | ZuploOpenApiDocument\n) => {\n  const paths = openApi.paths;\n  if (!paths) {\n    return;\n  }\n  for (const path of Object.keys(paths)) {\n    const pathItem = paths[path];\n    if (!pathItem) {\n      continue;\n    }\n    const methods = [\n      \"get\",\n      \"put\",\n      \"post\",\n      \"delete\",\n      \"options\",\n      \"head\",\n      \"patch\",\n      \"trace\",\n    ] as OpenAPIV3_1.HttpMethods[];\n    for (const method of methods) {\n      const operation = pathItem[method];\n      if (operation && !operation.operationId) {\n        operation.operationId = v4();\n      }\n    }\n  }\n};\n"]}

package/dist/open-api/overlay/handler.d.ts

@@ -0,0 +1,10 @@
+export interface Arguments {
+  overlay: string;
+  input: string;
+  output: string;
+  format?: "json" | "yaml";
+  json?: boolean;
+  yaml?: boolean;
+}
+export declare function applyOverlay(args: Arguments): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/open-api/overlay/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/open-api/overlay/handler.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA2DD,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAyEjE"}

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

@@ -0,0 +1,92 @@
+import fs from "node:fs";
+import path from "node:path";
+import { detectFormatFromExtension, parseFile, serializeContent, } from "../../common/file-format.js";
+import { printDiagnosticsToConsole } from "../../common/output.js";
+import { logger } from "../../common/logger.js";
+import { applyOverlay as applyOverlayEngine, applyAction, deepClone, } from "./overlay-engine.js";
+function applyOverlayWithProgress(openapi, overlay) {
+    printDiagnosticsToConsole(`\nApplying overlay: ${overlay.info?.title || "Unnamed"}`);
+    printDiagnosticsToConsole(`Version: ${overlay.overlay || "unknown"}\n`);
+    const result = deepClone(openapi);
+    const stats = { applied: 0, skipped: 0, totalNodes: 0 };
+    for (const [index, action] of overlay.actions.entries()) {
+        const desc = action.description || `Action ${index + 1}`;
+        process.stdout.write(`  [${index + 1}/${overlay.actions.length}] ${desc}... `);
+        try {
+            const { applied, count } = applyAction(result, action);
+            if (applied) {
+                printDiagnosticsToConsole(`✓ (${count} node${count !== 1 ? "s" : ""})`);
+                stats.applied++;
+                stats.totalNodes += count;
+            }
+            else {
+                printDiagnosticsToConsole("⊘ skipped");
+                stats.skipped++;
+            }
+        }
+        catch (error) {
+            printDiagnosticsToConsole(`✗ failed`);
+            logger.warn(error, `Failed to apply action: ${desc}`);
+            stats.skipped++;
+        }
+    }
+    printDiagnosticsToConsole(`\n=== Summary ===`);
+    printDiagnosticsToConsole(`Applied: ${stats.applied}/${overlay.actions.length} actions`);
+    printDiagnosticsToConsole(`Modified: ${stats.totalNodes} nodes`);
+    if (stats.skipped > 0) {
+        printDiagnosticsToConsole(`Skipped: ${stats.skipped} actions`);
+    }
+    const { result: finalResult } = applyOverlayEngine(openapi, overlay);
+    return finalResult;
+}
+export async function applyOverlay(args) {
+    const { overlay: overlayPath, input: openapiPath, output: outputPath } = args;
+    if (!fs.existsSync(openapiPath)) {
+        throw new Error(`OpenAPI file not found: ${openapiPath}`);
+    }
+    if (!fs.existsSync(overlayPath)) {
+        throw new Error(`Overlay file not found: ${overlayPath}`);
+    }
+    printDiagnosticsToConsole("OpenAPI Overlay Applicator");
+    printDiagnosticsToConsole("===========================");
+    printDiagnosticsToConsole(`OpenAPI file: ${openapiPath}`);
+    printDiagnosticsToConsole(`Overlay file: ${overlayPath}`);
+    printDiagnosticsToConsole(`Output file:  ${outputPath}`);
+    try {
+        const openapiContent = fs.readFileSync(openapiPath, "utf-8");
+        const overlayContent = fs.readFileSync(overlayPath, "utf-8");
+        const { document: openapi } = parseFile(openapiContent, openapiPath);
+        const { document: overlay } = parseFile(overlayContent, overlayPath);
+        if (!overlay.overlay || !overlay.actions) {
+            throw new Error("Invalid overlay format. Must include 'overlay' version and 'actions' array.");
+        }
+        const result = applyOverlayWithProgress(openapi, overlay);
+        let outputFormat;
+        if (args.format) {
+            outputFormat = args.format;
+        }
+        else if (args.json) {
+            outputFormat = "json";
+        }
+        else if (args.yaml) {
+            outputFormat = "yaml";
+        }
+        else {
+            const formatFromExt = detectFormatFromExtension(outputPath);
+            outputFormat = formatFromExt || "json";
+        }
+        const outputContent = serializeContent(result, outputFormat);
+        const outputDir = path.dirname(outputPath);
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        fs.writeFileSync(outputPath, outputContent, "utf-8");
+        printDiagnosticsToConsole(`\n✓ Output written to: ${outputPath} (${outputFormat.toUpperCase()})`);
+    }
+    catch (error) {
+        logger.error(error, "Error applying overlay");
+        printDiagnosticsToConsole(`Error: ${error.message}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/open-api/overlay/handler.ts"],"names":[],"mappings":"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","sourcesContent":["/** biome-ignore-all lint/suspicious/noConsole: CLI output file */\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  detectFormatFromExtension,\n  parseFile,\n  serializeContent,\n  type FileFormat,\n} from \"../../common/file-format.js\";\nimport { printDiagnosticsToConsole } from \"../../common/output.js\";\nimport { logger } from \"../../common/logger.js\";\nimport {\n  applyOverlay as applyOverlayEngine,\n  applyAction,\n  deepClone,\n  type OverlayDocument,\n} from \"./overlay-engine.js\";\n\nexport interface Arguments {\n  overlay: string;\n  input: string;\n  output: string;\n  format?: \"json\" | \"yaml\";\n  json?: boolean;\n  yaml?: boolean;\n}\n\n/**\n * Apply overlay to OpenAPI document with console output\n */\n// biome-ignore lint/suspicious/noExplicitAny: Working with dynamic JSON structures\nfunction applyOverlayWithProgress(openapi: any, overlay: OverlayDocument): any {\n  printDiagnosticsToConsole(\n    `\\nApplying overlay: ${overlay.info?.title || \"Unnamed\"}`\n  );\n  printDiagnosticsToConsole(`Version: ${overlay.overlay || \"unknown\"}\\n`);\n\n  // Clone the document for modification\n  const result = deepClone(openapi);\n  const stats = { applied: 0, skipped: 0, totalNodes: 0 };\n\n  // Apply actions with progress reporting\n  for (const [index, action] of overlay.actions.entries()) {\n    const desc = action.description || `Action ${index + 1}`;\n    process.stdout.write(\n      `  [${index + 1}/${overlay.actions.length}] ${desc}... `\n    );\n\n    try {\n      const { applied, count } = applyAction(result, action);\n\n      if (applied) {\n        printDiagnosticsToConsole(`✓ (${count} node${count !== 1 ? \"s\" : \"\"})`);\n        stats.applied++;\n        stats.totalNodes += count;\n      } else {\n        printDiagnosticsToConsole(\"⊘ skipped\");\n        stats.skipped++;\n      }\n    } catch (error) {\n      printDiagnosticsToConsole(`✗ failed`);\n      logger.warn(error, `Failed to apply action: ${desc}`);\n      stats.skipped++;\n    }\n  }\n\n  printDiagnosticsToConsole(`\\n=== Summary ===`);\n  printDiagnosticsToConsole(\n    `Applied: ${stats.applied}/${overlay.actions.length} actions`\n  );\n  printDiagnosticsToConsole(`Modified: ${stats.totalNodes} nodes`);\n  if (stats.skipped > 0) {\n    printDiagnosticsToConsole(`Skipped: ${stats.skipped} actions`);\n  }\n\n  // Use the engine's reordering functions\n  const { result: finalResult } = applyOverlayEngine(openapi, overlay);\n\n  return finalResult;\n}\n\n/**\n * Main handler function\n */\nexport async function applyOverlay(args: Arguments): Promise<void> {\n  const { overlay: overlayPath, input: openapiPath, output: outputPath } = args;\n\n  // Validate input files exist\n  if (!fs.existsSync(openapiPath)) {\n    throw new Error(`OpenAPI file not found: ${openapiPath}`);\n  }\n\n  if (!fs.existsSync(overlayPath)) {\n    throw new Error(`Overlay file not found: ${overlayPath}`);\n  }\n\n  printDiagnosticsToConsole(\"OpenAPI Overlay Applicator\");\n  printDiagnosticsToConsole(\"===========================\");\n  printDiagnosticsToConsole(`OpenAPI file: ${openapiPath}`);\n  printDiagnosticsToConsole(`Overlay file: ${overlayPath}`);\n  printDiagnosticsToConsole(`Output file:  ${outputPath}`);\n\n  try {\n    // Load files with flexible parsing\n    const openapiContent = fs.readFileSync(openapiPath, \"utf-8\");\n    const overlayContent = fs.readFileSync(overlayPath, \"utf-8\");\n\n    // Parse with automatic format detection\n    const { document: openapi } = parseFile(openapiContent, openapiPath);\n    const { document: overlay } = parseFile(overlayContent, overlayPath);\n\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    // Apply overlay with progress output\n    const result = applyOverlayWithProgress(\n      openapi,\n      overlay as OverlayDocument\n    );\n\n    // Determine output format\n    let outputFormat: FileFormat;\n    if (args.format) {\n      outputFormat = args.format;\n    } else if (args.json) {\n      outputFormat = \"json\";\n    } else if (args.yaml) {\n      outputFormat = \"yaml\";\n    } else {\n      // Try to detect from output file extension\n      const formatFromExt = detectFormatFromExtension(outputPath);\n      outputFormat = formatFromExt || \"json\"; // Default to JSON if no extension\n    }\n\n    // Serialize output\n    const outputContent = serializeContent(result, outputFormat);\n\n    // Create output directory if it doesn't exist\n    const outputDir = path.dirname(outputPath);\n    if (!fs.existsSync(outputDir)) {\n      fs.mkdirSync(outputDir, { recursive: true });\n    }\n\n    fs.writeFileSync(outputPath, outputContent, \"utf-8\");\n\n    printDiagnosticsToConsole(\n      `\\n✓ Output written to: ${outputPath} (${outputFormat.toUpperCase()})`\n    );\n  } catch (error) {\n    logger.error(error, \"Error applying overlay\");\n    printDiagnosticsToConsole(`Error: ${(error as Error).message}`);\n    throw error;\n  }\n}\n"]}

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

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

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

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

package/dist/open-api/overlay/handler.spec.js

@@ -0,0 +1,304 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { fileURLToPath } from "node:url";
+import assert from "node:assert";
+import { applyOverlay } from "./handler.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const testTmpPath = path.join(__dirname, "..", "..", "__tests__", "test-tmp", "overlay-handler");
+describe("Overlay Handler", () => {
+    beforeEach(async () => {
+        await fs.mkdir(testTmpPath, { recursive: true });
+    });
+    afterEach(async () => {
+        try {
+            await fs.rm(testTmpPath, { recursive: true, force: true });
+        }
+        catch {
+        }
+    });
+    describe("applyOverlay", () => {
+        it("should apply overlay to OpenAPI document (JSON to JSON)", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.json");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [
+                    {
+                        target: "$.info.title",
+                        update: "Updated API",
+                    },
+                ],
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            });
+            const result = JSON.parse(await fs.readFile(outputPath, "utf-8"));
+            assert.strictEqual(result.info.title, "Updated API");
+            assert.strictEqual(result.openapi, "3.1.0");
+        });
+        it("should support YAML input and JSON output", async () => {
+            const inputPath = path.join(testTmpPath, "input.yaml");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.json");
+            const inputDoc = `openapi: 3.1.0
+info:
+  title: Original API
+  version: 1.0.0
+paths: {}`;
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [
+                    {
+                        target: "$.info.version",
+                        update: "2.0.0",
+                    },
+                ],
+            };
+            await fs.writeFile(inputPath, inputDoc);
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            });
+            const result = JSON.parse(await fs.readFile(outputPath, "utf-8"));
+            assert.strictEqual(result.info.version, "2.0.0");
+        });
+        it("should support JSON input and YAML output", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.yaml");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [],
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            });
+            const result = await fs.readFile(outputPath, "utf-8");
+            assert.strictEqual(result.includes("openapi: 3.1.0"), true);
+            assert.strictEqual(result.includes("title: Original API"), true);
+        });
+        it("should support --format flag to override output format", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.txt");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [],
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+                format: "yaml",
+            });
+            const result = await fs.readFile(outputPath, "utf-8");
+            assert.strictEqual(result.includes("openapi: 3.1.0"), true);
+        });
+        it("should support --json flag", async () => {
+            const inputPath = path.join(testTmpPath, "input.yaml");
+            const overlayPath = path.join(testTmpPath, "overlay.yaml");
+            const outputPath = path.join(testTmpPath, "output.txt");
+            const inputDoc = `openapi: 3.1.0
+info:
+  title: Original API
+  version: 1.0.0
+paths: {}`;
+            const overlayDoc = `overlay: 1.0.0
+info:
+  title: Test Overlay
+  version: 1.0.0
+actions: []`;
+            await fs.writeFile(inputPath, inputDoc);
+            await fs.writeFile(overlayPath, overlayDoc);
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+                json: true,
+            });
+            const result = await fs.readFile(outputPath, "utf-8");
+            const parsed = JSON.parse(result);
+            assert.strictEqual(parsed.openapi, "3.1.0");
+        });
+        it("should support --yaml flag", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.txt");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [],
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+                yaml: true,
+            });
+            const result = await fs.readFile(outputPath, "utf-8");
+            assert.strictEqual(result.includes("openapi: 3.1.0"), true);
+        });
+        it("should create output directory if it doesn't exist", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "nested", "dir", "output.json");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [],
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            });
+            const result = JSON.parse(await fs.readFile(outputPath, "utf-8"));
+            assert.strictEqual(result.openapi, "3.1.0");
+        });
+        it("should throw error when input file does not exist", async () => {
+            const inputPath = path.join(testTmpPath, "nonexistent.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.json");
+            const overlayDoc = {
+                overlay: "1.0.0",
+                info: {
+                    title: "Test Overlay",
+                    version: "1.0.0",
+                },
+                actions: [],
+            };
+            await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));
+            await assert.rejects(() => applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            }), /OpenAPI file not found/);
+        });
+        it("should throw error when overlay file does not exist", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "nonexistent.json");
+            const outputPath = path.join(testTmpPath, "output.json");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await assert.rejects(() => applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            }), /Overlay file not found/);
+        });
+        it("should throw error when overlay is invalid", async () => {
+            const inputPath = path.join(testTmpPath, "input.json");
+            const overlayPath = path.join(testTmpPath, "overlay.json");
+            const outputPath = path.join(testTmpPath, "output.json");
+            const inputDoc = {
+                openapi: "3.1.0",
+                info: {
+                    title: "Original API",
+                    version: "1.0.0",
+                },
+                paths: {},
+            };
+            const invalidOverlay = {
+                info: {
+                    title: "Missing overlay version",
+                },
+            };
+            await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));
+            await fs.writeFile(overlayPath, JSON.stringify(invalidOverlay, null, 2));
+            await assert.rejects(() => applyOverlay({
+                input: inputPath,
+                overlay: overlayPath,
+                output: outputPath,
+            }), /Invalid overlay format/);
+        });
+    });
+});
+//# sourceMappingURL=handler.spec.js.map

package/dist/open-api/overlay/handler.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.spec.js","sourceRoot":"","sources":["../../../src/open-api/overlay/handler.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { afterEach, beforeEach, describe, it } from \"node:test\";\nimport { fileURLToPath } from \"node:url\";\nimport assert from \"node:assert\";\nimport { applyOverlay } from \"./handler.js\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst testTmpPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"__tests__\",\n  \"test-tmp\",\n  \"overlay-handler\"\n);\n\ndescribe(\"Overlay Handler\", () => {\n  beforeEach(async () => {\n    // Ensure test-tmp directory exists\n    await fs.mkdir(testTmpPath, { recursive: true });\n  });\n\n  afterEach(async () => {\n    // Clean up test files\n    try {\n      await fs.rm(testTmpPath, { recursive: true, force: true });\n    } catch {\n      // Ignore cleanup errors\n    }\n  });\n\n  describe(\"applyOverlay\", () => {\n    it(\"should apply overlay to OpenAPI document (JSON to JSON)\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.json\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [\n          {\n            target: \"$.info.title\",\n            update: \"Updated API\",\n          },\n        ],\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n      });\n\n      const result = JSON.parse(await fs.readFile(outputPath, \"utf-8\"));\n      assert.strictEqual(result.info.title, \"Updated API\");\n      assert.strictEqual(result.openapi, \"3.1.0\");\n    });\n\n    it(\"should support YAML input and JSON output\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.yaml\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.json\");\n\n      const inputDoc = `openapi: 3.1.0\ninfo:\n  title: Original API\n  version: 1.0.0\npaths: {}`;\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [\n          {\n            target: \"$.info.version\",\n            update: \"2.0.0\",\n          },\n        ],\n      };\n\n      await fs.writeFile(inputPath, inputDoc);\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n      });\n\n      const result = JSON.parse(await fs.readFile(outputPath, \"utf-8\"));\n      assert.strictEqual(result.info.version, \"2.0.0\");\n    });\n\n    it(\"should support JSON input and YAML output\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.yaml\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [],\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n      });\n\n      const result = await fs.readFile(outputPath, \"utf-8\");\n      assert.strictEqual(result.includes(\"openapi: 3.1.0\"), true);\n      assert.strictEqual(result.includes(\"title: Original API\"), true);\n    });\n\n    it(\"should support --format flag to override output format\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.txt\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [],\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n        format: \"yaml\",\n      });\n\n      const result = await fs.readFile(outputPath, \"utf-8\");\n      assert.strictEqual(result.includes(\"openapi: 3.1.0\"), true);\n    });\n\n    it(\"should support --json flag\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.yaml\");\n      const overlayPath = path.join(testTmpPath, \"overlay.yaml\");\n      const outputPath = path.join(testTmpPath, \"output.txt\");\n\n      const inputDoc = `openapi: 3.1.0\ninfo:\n  title: Original API\n  version: 1.0.0\npaths: {}`;\n\n      const overlayDoc = `overlay: 1.0.0\ninfo:\n  title: Test Overlay\n  version: 1.0.0\nactions: []`;\n\n      await fs.writeFile(inputPath, inputDoc);\n      await fs.writeFile(overlayPath, overlayDoc);\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n        json: true,\n      });\n\n      const result = await fs.readFile(outputPath, \"utf-8\");\n      const parsed = JSON.parse(result);\n      assert.strictEqual(parsed.openapi, \"3.1.0\");\n    });\n\n    it(\"should support --yaml flag\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.txt\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [],\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n        yaml: true,\n      });\n\n      const result = await fs.readFile(outputPath, \"utf-8\");\n      assert.strictEqual(result.includes(\"openapi: 3.1.0\"), true);\n    });\n\n    it(\"should create output directory if it doesn't exist\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"nested\", \"dir\", \"output.json\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [],\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await applyOverlay({\n        input: inputPath,\n        overlay: overlayPath,\n        output: outputPath,\n      });\n\n      const result = JSON.parse(await fs.readFile(outputPath, \"utf-8\"));\n      assert.strictEqual(result.openapi, \"3.1.0\");\n    });\n\n    it(\"should throw error when input file does not exist\", async () => {\n      const inputPath = path.join(testTmpPath, \"nonexistent.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.json\");\n\n      const overlayDoc = {\n        overlay: \"1.0.0\",\n        info: {\n          title: \"Test Overlay\",\n          version: \"1.0.0\",\n        },\n        actions: [],\n      };\n\n      await fs.writeFile(overlayPath, JSON.stringify(overlayDoc, null, 2));\n\n      await assert.rejects(\n        () =>\n          applyOverlay({\n            input: inputPath,\n            overlay: overlayPath,\n            output: outputPath,\n          }),\n        /OpenAPI file not found/\n      );\n    });\n\n    it(\"should throw error when overlay file does not exist\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"nonexistent.json\");\n      const outputPath = path.join(testTmpPath, \"output.json\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n\n      await assert.rejects(\n        () =>\n          applyOverlay({\n            input: inputPath,\n            overlay: overlayPath,\n            output: outputPath,\n          }),\n        /Overlay file not found/\n      );\n    });\n\n    it(\"should throw error when overlay is invalid\", async () => {\n      const inputPath = path.join(testTmpPath, \"input.json\");\n      const overlayPath = path.join(testTmpPath, \"overlay.json\");\n      const outputPath = path.join(testTmpPath, \"output.json\");\n\n      const inputDoc = {\n        openapi: \"3.1.0\",\n        info: {\n          title: \"Original API\",\n          version: \"1.0.0\",\n        },\n        paths: {},\n      };\n\n      const invalidOverlay = {\n        info: {\n          title: \"Missing overlay version\",\n        },\n      };\n\n      await fs.writeFile(inputPath, JSON.stringify(inputDoc, null, 2));\n      await fs.writeFile(overlayPath, JSON.stringify(invalidOverlay, null, 2));\n\n      await assert.rejects(\n        () =>\n          applyOverlay({\n            input: inputPath,\n            overlay: overlayPath,\n            output: outputPath,\n          }),\n        /Invalid overlay format/\n      );\n    });\n  });\n});\n"]}

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

@@ -0,0 +1,55 @@
+export interface OverlayDocument {
+  overlay: string;
+  info: {
+    title: string;
+    version: string;
+  };
+  actions: OverlayAction[];
+  extends?: string;
+}
+export interface OverlayAction {
+  target: string;
+  description?: string;
+  update?: any;
+  remove?: boolean | RemoveCondition;
+}
+export interface RemoveCondition {
+  empty?: boolean;
+  missing?: string;
+}
+export interface ApplyResult {
+  applied: boolean;
+  count: number;
+}
+export interface OverlayStats {
+  applied: number;
+  skipped: number;
+  totalNodes: number;
+}
+export declare function deepClone<T>(obj: T): T;
+export declare function deepMerge(target: any, source: any): any;
+export declare function checkCondition(
+  value: any,
+  condition: RemoveCondition
+): boolean;
+export declare function setValueAtPath(
+  doc: any,
+  target: string,
+  value: any
+): void;
+export declare function applyAction(
+  doc: any,
+  action: OverlayAction
+): ApplyResult;
+export declare function extractPathOrder(overlay: OverlayDocument): string[];
+export declare function reorderOperationProperties(operation: any): any;
+export declare function reorderPaths(doc: any, pathOrder: string[]): any;
+export declare function reorderDocumentProperties(doc: any): any;
+export declare function applyOverlay(
+  openapi: any,
+  overlay: OverlayDocument
+): {
+  result: any;
+  stats: OverlayStats;
+};
+//# sourceMappingURL=overlay-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-engine.d.ts","sourceRoot":"","sources":["../../../src/open-api/overlay/overlay-engine.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAKtC;AAMD,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAgDvD;AAKD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,eAAe,GACzB,OAAO,CA2BT;AAyCD,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAuCzE;AAKD,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CA+ExE;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAiBnE;AAKD,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,CAmB9D;AAKD,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAiD/D;AAMD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAmBvD;AAQD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,eAAe,GACvB;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA8BtC"}