@zuplo/cli 6.62.8 → 6.62.10

package/README.md

@@ -23,17 +23,49 @@ Commands:
   zuplo link      Links information from your Zuplo account to your local machine
   zuplo login     Authenticates the user
   zuplo test      Runs the tests under /tests against an endpoint
-  zuplo project   Project commands
+  zuplo openapi   OpenAPI commands (aliases: oas, open-api)
+  zuplo project   Project management commands
+  zuplo proxies   Proxy configuration commands
+  zuplo source    Source code management commands
   zuplo tunnel    Tunnel commands
   zuplo variable  Variable commands
 
+zuplo openapi
+
+OpenAPI commands
+
+Commands:
+  zuplo openapi convert   Convert OpenAPI files between JSON and YAML formats
+  zuplo openapi merge     Merge an OpenAPI file into your Zuplo project
+  zuplo openapi overlay   Apply an OpenAPI Overlay to an OpenAPI document
+
+Aliases: oas, open-api
+
 zuplo project
 
-Project commands
+Project management commands
+
+Commands:
+  zuplo project create  Creates a new project in your account
+
+zuplo proxies
+
+Proxy configuration commands
+
+Commands:
+  zuplo proxies create    Creates a new proxy configuration for a fleet
+  zuplo proxies update    Updates an existing proxy configuration for a fleet
+  zuplo proxies describe  Describes a proxy configuration for a fleet
+  zuplo proxies delete    Deletes a proxy configuration for a fleet
+
+zuplo source
+
+Source code management commands
 
 Commands:
-  zuplo project update  Updates your project structure to the latest conventions
-  zuplo project import-openapi  Import an OpenAPI file into your Zuplo project
+  zuplo source upgrade          Updates your project structure to the latest conventions
+  zuplo source migrate          Migration commands
+    zuplo source migrate dev-portal  Migrates legacy dev portal configuration to new format
 
 zuplo tunnel
 

package/dist/__tests__/import-openapi-utils.test.js

@@ -4,8 +4,7 @@ import { describe, it } from "node:test";
 import { fileURLToPath } from "node:url";
 import { mergeOpenApiDocuments } from "@zuplo/openapi-tools";
 import { expect } from "chai";
-import { BASE_TEMPLATE } from "../source/import-openapi/handler.js";
-import { addOperationIdsAsNecessary, parseOpenApiFile, } from "../source/import-openapi/utils.js";
+import { BASE_TEMPLATE, addOperationIdsAsNecessary, parseOpenApiFile, } from "../open-api/merge/merge-engine.js";
 import { baseRoutesFileOnImportTests, baseRoutesFileWOOperationIDs, } from "./oas-test-data.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);

package/dist/__tests__/import-openapi-utils.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-openapi-utils.test.js","sourceRoot":"","sources":["../../src/__tests__/import-openapi-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { describe, it } from \"node:test\";\nimport { fileURLToPath } from \"node:url\";\nimport { mergeOpenApiDocuments } from \"@zuplo/openapi-tools\";\nimport { expect } from \"chai\";\nimport { ZuploOpenApiDocument } from \"../../../types/dist/open-api.js\";\nimport { BASE_TEMPLATE } from \"../source/import-openapi/handler.js\";\nimport {\n  addOperationIdsAsNecessary,\n  parseOpenApiFile,\n} from \"../source/import-openapi/utils.js\";\nimport {\n  baseRoutesFileOnImportTests,\n  baseRoutesFileWOOperationIDs,\n} from \"./oas-test-data.js\";\nconst __filename = fileURLToPath(import.meta.url); // get the resolved path to the file\nconst __dirname = path.dirname(__filename); // get the name of the directory\n\nconst testAssetsPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"src\",\n  \"__tests__\",\n  \"test-assets\"\n);\n\ndescribe(\"Import open api utils\", async function () {\n  it(\"should generate merge changes between two different oas files\", async function () {\n    const toImportPath = path.join(testAssetsPath, \"toimport.oas.json\");\n    const toImportContent = await fs.readFile(toImportPath, \"utf-8\");\n    const toImportOpenApiSpec = await parseOpenApiFile(\n      \".json\",\n      toImportContent\n    );\n\n    const originalDocument = (await parseOpenApiFile(\n      \".json\",\n      JSON.stringify(baseRoutesFileOnImportTests)\n    )) as ZuploOpenApiDocument;\n\n    const { created, merged, retained } = mergeOpenApiDocuments(\n      originalDocument,\n      toImportOpenApiSpec,\n      \"path-method\"\n    );\n\n    const expectedMergedResult = new Set().add(\n      \"post>/v2/second/{userUid}/nature\"\n    );\n    const expectedRetainedResult = new Set().add(\n      \"post>/v1/second/{userUid}/nature\"\n    );\n\n    expect(created).to.deep.equals(new Set());\n    expect(merged).to.deep.equals(expectedMergedResult);\n    expect(retained).to.deep.equals(expectedRetainedResult);\n  });\n\n  it(\"should generate merge changes between a oas file and the default base template\", async function () {\n    const toImportPath = path.join(testAssetsPath, \"toimport.oas.json\");\n    const toImportContent = await fs.readFile(toImportPath, \"utf-8\");\n    const toImportOpenApiSpec = await parseOpenApiFile(\n      \".json\",\n      toImportContent\n    );\n\n    const originalDocument = (await parseOpenApiFile(\n      \".json\",\n      BASE_TEMPLATE\n    )) as ZuploOpenApiDocument;\n\n    const { created, merged, retained } = mergeOpenApiDocuments(\n      originalDocument,\n      toImportOpenApiSpec,\n      \"path-method\"\n    );\n\n    expect(created).to.deep.equals(\n      new Set().add(\"post>/v2/second/{userUid}/nature\")\n    );\n    expect(merged).to.deep.equals(new Set());\n    expect(retained).to.deep.equals(new Set());\n  });\n\n  it(\"should generate missing operation ids\", async function () {\n    const oasDocument = await parseOpenApiFile(\n      \".json\",\n      JSON.stringify(baseRoutesFileWOOperationIDs)\n    );\n\n    addOperationIdsAsNecessary(oasDocument);\n\n    expect(oasDocument.paths).to.not.be.empty;\n    // @ts-expect-error\n    expect(oasDocument.paths[\"/v2/second/{userUid}/nature\"]?.post?.operationId)\n      .to.not.be.empty;\n  });\n\n  it(\"should not change existing operation ids\", async function () {\n    const oasDocument = await parseOpenApiFile(\n      \".json\",\n      JSON.stringify(baseRoutesFileOnImportTests)\n    );\n\n    addOperationIdsAsNecessary(oasDocument);\n\n    expect(oasDocument.paths).to.not.be.empty;\n    expect(\n      // @ts-expect-error\n      oasDocument.paths[\"/v1/second/{userUid}/nature\"]?.post?.operationId\n    ).to.equal(\"12345\");\n    expect(\n      // @ts-expect-error\n      oasDocument.paths[\"/v2/second/{userUid}/nature\"]?.post?.operationId\n    ).to.equal(\"67920\");\n  });\n\n  it(\"should successfully parse a yaml open api file\", async function () {\n    const toImportPath = path.join(testAssetsPath, \"toimportv2.yaml\");\n    const toImportContent = await fs.readFile(toImportPath, \"utf-8\");\n    const toImportOpenApiSpec = await parseOpenApiFile(\n      \".yaml\",\n      toImportContent\n    );\n\n    expect(toImportOpenApiSpec).to.not.be.empty;\n    expect(toImportOpenApiSpec.info).to.deep.equals({\n      title: \"Protect API\",\n      description: \"Buy & sell\",\n      version: \"0.2.0\",\n      contact: {\n        name: \"Zuplo YAML Test\",\n        url: \"https://zuplo.com/\",\n        email: \"test@example.com\",\n      },\n    });\n    expect(toImportOpenApiSpec.servers).to.deep.equals([\n      {\n        url: \"https://api.zuplo.com\",\n        description: \"Production\",\n      },\n    ]);\n    expect(toImportOpenApiSpec.tags).to.deep.equals([\n      {\n        name: \"Order\",\n      },\n      {\n        name: \"Organization\",\n      },\n      {\n        name: \"Site\",\n      },\n      {\n        name: \"Supervisor\",\n      },\n    ]);\n\n    expect(toImportOpenApiSpec.paths).to.not.be.empty;\n\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orders\"]).to.not.be.empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orders/wa/{waaaa}\"]).to.not.be.empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orders/{order}\"]).to.not.be.empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orgs/{organization}\"]).to.not.be\n      .empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/sites\"]).to.deep.equals({\n      get: {\n        operationId: \"get-sites\",\n        summary: \"Get Sites\",\n        description: \"Sites are locations\",\n        tags: [\"Site\"],\n        responses: {\n          \"200\": {\n            description: \"OK\",\n            content: {\n              \"application/json\": {\n                schema: {\n                  type: \"array\",\n                  items: {\n                    $ref: \"#/components/schemas/Site\",\n                  },\n                },\n              },\n            },\n            headers: {\n              \"Cache-Control\": {\n                required: true,\n                schema: {\n                  type: \"string\",\n                },\n                description:\n                  \"Responses are cacheable following standard HTTP headers.\",\n              },\n            },\n          },\n        },\n      },\n    });\n    expect(toImportOpenApiSpec.components).to.not.be.empty;\n  });\n});\n"]}
+{"version":3,"file":"import-openapi-utils.test.js","sourceRoot":"","sources":["../../src/__tests__/import-openapi-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { describe, it } from \"node:test\";\nimport { fileURLToPath } from \"node:url\";\nimport { mergeOpenApiDocuments } from \"@zuplo/openapi-tools\";\nimport { expect } from \"chai\";\nimport { ZuploOpenApiDocument } from \"../../../types/dist/open-api.js\";\nimport {\n  BASE_TEMPLATE,\n  addOperationIdsAsNecessary,\n  parseOpenApiFile,\n} from \"../open-api/merge/merge-engine.js\";\nimport {\n  baseRoutesFileOnImportTests,\n  baseRoutesFileWOOperationIDs,\n} from \"./oas-test-data.js\";\nconst __filename = fileURLToPath(import.meta.url); // get the resolved path to the file\nconst __dirname = path.dirname(__filename); // get the name of the directory\n\nconst testAssetsPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"src\",\n  \"__tests__\",\n  \"test-assets\"\n);\n\ndescribe(\"Import open api utils\", async function () {\n  it(\"should generate merge changes between two different oas files\", async function () {\n    const toImportPath = path.join(testAssetsPath, \"toimport.oas.json\");\n    const toImportContent = await fs.readFile(toImportPath, \"utf-8\");\n    const toImportOpenApiSpec = await parseOpenApiFile(\n      \".json\",\n      toImportContent\n    );\n\n    const originalDocument = (await parseOpenApiFile(\n      \".json\",\n      JSON.stringify(baseRoutesFileOnImportTests)\n    )) as ZuploOpenApiDocument;\n\n    const { created, merged, retained } = mergeOpenApiDocuments(\n      originalDocument,\n      toImportOpenApiSpec,\n      \"path-method\"\n    );\n\n    const expectedMergedResult = new Set().add(\n      \"post>/v2/second/{userUid}/nature\"\n    );\n    const expectedRetainedResult = new Set().add(\n      \"post>/v1/second/{userUid}/nature\"\n    );\n\n    expect(created).to.deep.equals(new Set());\n    expect(merged).to.deep.equals(expectedMergedResult);\n    expect(retained).to.deep.equals(expectedRetainedResult);\n  });\n\n  it(\"should generate merge changes between a oas file and the default base template\", async function () {\n    const toImportPath = path.join(testAssetsPath, \"toimport.oas.json\");\n    const toImportContent = await fs.readFile(toImportPath, \"utf-8\");\n    const toImportOpenApiSpec = await parseOpenApiFile(\n      \".json\",\n      toImportContent\n    );\n\n    const originalDocument = (await parseOpenApiFile(\n      \".json\",\n      BASE_TEMPLATE\n    )) as ZuploOpenApiDocument;\n\n    const { created, merged, retained } = mergeOpenApiDocuments(\n      originalDocument,\n      toImportOpenApiSpec,\n      \"path-method\"\n    );\n\n    expect(created).to.deep.equals(\n      new Set().add(\"post>/v2/second/{userUid}/nature\")\n    );\n    expect(merged).to.deep.equals(new Set());\n    expect(retained).to.deep.equals(new Set());\n  });\n\n  it(\"should generate missing operation ids\", async function () {\n    const oasDocument = await parseOpenApiFile(\n      \".json\",\n      JSON.stringify(baseRoutesFileWOOperationIDs)\n    );\n\n    addOperationIdsAsNecessary(oasDocument);\n\n    expect(oasDocument.paths).to.not.be.empty;\n    // @ts-expect-error\n    expect(oasDocument.paths[\"/v2/second/{userUid}/nature\"]?.post?.operationId)\n      .to.not.be.empty;\n  });\n\n  it(\"should not change existing operation ids\", async function () {\n    const oasDocument = await parseOpenApiFile(\n      \".json\",\n      JSON.stringify(baseRoutesFileOnImportTests)\n    );\n\n    addOperationIdsAsNecessary(oasDocument);\n\n    expect(oasDocument.paths).to.not.be.empty;\n    expect(\n      // @ts-expect-error\n      oasDocument.paths[\"/v1/second/{userUid}/nature\"]?.post?.operationId\n    ).to.equal(\"12345\");\n    expect(\n      // @ts-expect-error\n      oasDocument.paths[\"/v2/second/{userUid}/nature\"]?.post?.operationId\n    ).to.equal(\"67920\");\n  });\n\n  it(\"should successfully parse a yaml open api file\", async function () {\n    const toImportPath = path.join(testAssetsPath, \"toimportv2.yaml\");\n    const toImportContent = await fs.readFile(toImportPath, \"utf-8\");\n    const toImportOpenApiSpec = await parseOpenApiFile(\n      \".yaml\",\n      toImportContent\n    );\n\n    expect(toImportOpenApiSpec).to.not.be.empty;\n    expect(toImportOpenApiSpec.info).to.deep.equals({\n      title: \"Protect API\",\n      description: \"Buy & sell\",\n      version: \"0.2.0\",\n      contact: {\n        name: \"Zuplo YAML Test\",\n        url: \"https://zuplo.com/\",\n        email: \"test@example.com\",\n      },\n    });\n    expect(toImportOpenApiSpec.servers).to.deep.equals([\n      {\n        url: \"https://api.zuplo.com\",\n        description: \"Production\",\n      },\n    ]);\n    expect(toImportOpenApiSpec.tags).to.deep.equals([\n      {\n        name: \"Order\",\n      },\n      {\n        name: \"Organization\",\n      },\n      {\n        name: \"Site\",\n      },\n      {\n        name: \"Supervisor\",\n      },\n    ]);\n\n    expect(toImportOpenApiSpec.paths).to.not.be.empty;\n\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orders\"]).to.not.be.empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orders/wa/{waaaa}\"]).to.not.be.empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orders/{order}\"]).to.not.be.empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/orgs/{organization}\"]).to.not.be\n      .empty;\n    //@ts-expect-error\n    expect(toImportOpenApiSpec.paths[\"/v1/sites\"]).to.deep.equals({\n      get: {\n        operationId: \"get-sites\",\n        summary: \"Get Sites\",\n        description: \"Sites are locations\",\n        tags: [\"Site\"],\n        responses: {\n          \"200\": {\n            description: \"OK\",\n            content: {\n              \"application/json\": {\n                schema: {\n                  type: \"array\",\n                  items: {\n                    $ref: \"#/components/schemas/Site\",\n                  },\n                },\n              },\n            },\n            headers: {\n              \"Cache-Control\": {\n                required: true,\n                schema: {\n                  type: \"string\",\n                },\n                description:\n                  \"Responses are cacheable following standard HTTP headers.\",\n              },\n            },\n          },\n        },\n      },\n    });\n    expect(toImportOpenApiSpec.components).to.not.be.empty;\n  });\n});\n"]}

package/dist/__tests__/import-openapi.test.js

@@ -4,7 +4,7 @@ import { afterEach, beforeEach, describe, it } from "node:test";
 import { fileURLToPath } from "node:url";
 import { expect } from "chai";
 import { createSandbox } from "sinon";
-import { importOpenApi } from "../source/import-openapi/handler.js";
+import { importOpenApi } from "../open-api/merge/handler.js";
 import { baseRoutesFileOnImportTests } from "./oas-test-data.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -35,11 +35,9 @@ describe("Import open api file", async function () {
         const destinationPath = path.join(testTmpPath, "config", "routes-test-one.oas.json");
         await createOASFile(JSON.stringify(baseRoutesFileOnImportTests), destinationPath);
         await importOpenApi({
-            dir: testAssetsPath,
             prompt: false,
             source: path.join(testAssetsPath, "toimport.oas.json"),
             destination: destinationPath,
-            "source-url": "",
         });
         const mergedContent = await fs.readFile(destinationPath, "utf-8");
         const jsonContent = JSON.parse(mergedContent);
@@ -92,11 +90,9 @@ describe("Import open api file", async function () {
     it("should import a file into a fs destination that does not yet exist", async function () {
         const destinationPath = path.join(testTmpPath, "routes-test-two.oas.json");
         await importOpenApi({
-            dir: testAssetsPath,
             prompt: false,
             source: path.join(testAssetsPath, "toimport.oas.json"),
             destination: destinationPath,
-            "source-url": "",
         });
         const mergedContent = await fs.readFile(destinationPath, "utf-8");
         const jsonContent = JSON.parse(mergedContent);

package/dist/__tests__/import-openapi.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-openapi.test.js","sourceRoot":"","sources":["../../src/__tests__/import-openapi.test.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 { expect } from \"chai\";\nimport { SinonSandbox, SinonStub, createSandbox } from \"sinon\";\nimport { importOpenApi } from \"../source/import-openapi/handler.js\";\nimport { baseRoutesFileOnImportTests } from \"./oas-test-data.js\";\nconst __filename = fileURLToPath(import.meta.url); // get the resolved path to the file\nconst __dirname = path.dirname(__filename); // get the name of the directory\n\nconst testAssetsPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"src\",\n  \"__tests__\",\n  \"test-assets\"\n);\n\nconst testTmpPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"src\",\n  \"__tests__\",\n  \"test-tmp\"\n);\n\nasync function createOASFile(content: string, destinationPath: string) {\n  try {\n    // Get the directory path of the file\n    const dir = path.dirname(destinationPath);\n\n    // Ensure that the directory exists (creates parent directories if necessary)\n    await fs.mkdir(dir, { recursive: true });\n\n    // Write the content to the file (creates the file if it doesn't exist)\n    await fs.writeFile(destinationPath, content, \"utf8\");\n\n    console.log(`File created successfully at ${destinationPath}`);\n  } catch (error) {\n    console.error(`Error creating file at ${destinationPath}:`, error);\n  }\n}\n\nlet sandbox: SinonSandbox;\ndescribe(\"Import open api file\", async function () {\n  let printExit: SinonStub;\n  beforeEach(async function () {\n    sandbox = createSandbox();\n    // @NOTE - need to wrap this or else the cli code kills test run\n    printExit = sandbox.stub(process, \"exit\");\n  });\n\n  afterEach(() => {\n    sandbox.restore();\n  });\n\n  it(\"should merge two existing files correctly\", async function () {\n    const destinationPath = path.join(\n      testTmpPath,\n      \"config\",\n      \"routes-test-one.oas.json\"\n    );\n    // setup by creating the destination file first\n    await createOASFile(\n      JSON.stringify(baseRoutesFileOnImportTests),\n      destinationPath\n    );\n\n    await importOpenApi({\n      dir: testAssetsPath,\n      prompt: false,\n      source: path.join(testAssetsPath, \"toimport.oas.json\"),\n      destination: destinationPath,\n      \"source-url\": \"\",\n    });\n\n    const mergedContent = await fs.readFile(destinationPath, \"utf-8\");\n\n    const jsonContent = JSON.parse(mergedContent);\n\n    expect(jsonContent.paths).to.deep.equals({\n      \"/v1/second/{userUid}/nature\": {\n        post: {\n          summary: \"Test route\",\n          operationId: \"12345\",\n          parameters: [\n            {\n              $ref: \"#/components/parameters/userUid\",\n            },\n          ],\n          responses: {\n            \"200\": {\n              description: \"\",\n            },\n          },\n          security: [{}],\n          servers: [\n            {\n              url: \"https://api.stage.example.com\",\n              description: \"stage\",\n            },\n            {\n              url: \"https://api.example.com\",\n              description: \"production\",\n            },\n          ],\n        },\n      },\n      \"/v2/second/{userUid}/nature\": {\n        post: {\n          operationId: \"67920\",\n          summary: \"Test route v2\",\n          parameters: [\n            {\n              $ref: \"#/components/parameters/userUid\",\n            },\n          ],\n          responses: {\n            \"200\": {\n              description: \"\",\n            },\n          },\n        },\n      },\n    });\n  });\n\n  it(\"should import a file into a fs destination that does not yet exist\", async function () {\n    const destinationPath = path.join(testTmpPath, \"routes-test-two.oas.json\");\n\n    await importOpenApi({\n      dir: testAssetsPath,\n      prompt: false,\n      source: path.join(testAssetsPath, \"toimport.oas.json\"),\n      destination: destinationPath,\n      \"source-url\": \"\",\n    });\n\n    const mergedContent = await fs.readFile(destinationPath, \"utf-8\");\n\n    const jsonContent = JSON.parse(mergedContent);\n\n    expect(jsonContent.info).to.deep.equals({\n      version: \"v2\",\n      title: \"Zuplo test API V2\",\n      description: \"Test api v2\",\n      contact: {\n        name: \"Zuplo test\",\n        url: \"www.zuplo.com\",\n      },\n    });\n\n    expect(jsonContent.openapi).to.equal(\"3.1.0\");\n\n    expect(jsonContent.components).to.deep.equals({\n      parameters: {\n        userUid: {\n          name: \"userUid\",\n          in: \"path\",\n          description: \"Unique UUID of the user.\",\n          required: true,\n          schema: {\n            type: \"string\",\n            format: \"uuid\",\n          },\n        },\n      },\n      securitySchemes: {\n        authorization: {\n          type: \"http\",\n          description: \"Firebase JWT auth token\",\n          scheme: \"bearer\",\n        },\n      },\n    });\n\n    expect(jsonContent.servers).to.deep.equals([\n      {\n        url: \"https://api.stage.example.com\",\n        description: \"Stage\",\n      },\n      {\n        url: \"https://api.example.com\",\n        description: \"Prod\",\n      },\n    ]);\n\n    expect(jsonContent.security).to.deep.equals([{}]);\n\n    expect(jsonContent.tags).to.deep.equals([]);\n\n    expect(jsonContent.paths).to.deep.equals({\n      \"/v2/second/{userUid}/nature\": {\n        post: {\n          summary: \"Test route v2\",\n          operationId: \"67920\",\n          parameters: [\n            {\n              $ref: \"#/components/parameters/userUid\",\n            },\n          ],\n          responses: {\n            \"200\": {\n              description: \"\",\n            },\n          },\n        },\n      },\n    });\n  });\n});\n"]}
+{"version":3,"file":"import-openapi.test.js","sourceRoot":"","sources":["../../src/__tests__/import-openapi.test.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 { expect } from \"chai\";\nimport { SinonSandbox, SinonStub, createSandbox } from \"sinon\";\nimport { importOpenApi } from \"../open-api/merge/handler.js\";\nimport { baseRoutesFileOnImportTests } from \"./oas-test-data.js\";\nconst __filename = fileURLToPath(import.meta.url); // get the resolved path to the file\nconst __dirname = path.dirname(__filename); // get the name of the directory\n\nconst testAssetsPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"src\",\n  \"__tests__\",\n  \"test-assets\"\n);\n\nconst testTmpPath = path.join(\n  __dirname,\n  \"..\",\n  \"..\",\n  \"src\",\n  \"__tests__\",\n  \"test-tmp\"\n);\n\nasync function createOASFile(content: string, destinationPath: string) {\n  try {\n    // Get the directory path of the file\n    const dir = path.dirname(destinationPath);\n\n    // Ensure that the directory exists (creates parent directories if necessary)\n    await fs.mkdir(dir, { recursive: true });\n\n    // Write the content to the file (creates the file if it doesn't exist)\n    await fs.writeFile(destinationPath, content, \"utf8\");\n\n    console.log(`File created successfully at ${destinationPath}`);\n  } catch (error) {\n    console.error(`Error creating file at ${destinationPath}:`, error);\n  }\n}\n\nlet sandbox: SinonSandbox;\ndescribe(\"Import open api file\", async function () {\n  let printExit: SinonStub;\n  beforeEach(async function () {\n    sandbox = createSandbox();\n    // @NOTE - need to wrap this or else the cli code kills test run\n    printExit = sandbox.stub(process, \"exit\");\n  });\n\n  afterEach(() => {\n    sandbox.restore();\n  });\n\n  it(\"should merge two existing files correctly\", async function () {\n    const destinationPath = path.join(\n      testTmpPath,\n      \"config\",\n      \"routes-test-one.oas.json\"\n    );\n    // setup by creating the destination file first\n    await createOASFile(\n      JSON.stringify(baseRoutesFileOnImportTests),\n      destinationPath\n    );\n\n    await importOpenApi({\n      prompt: false,\n      source: path.join(testAssetsPath, \"toimport.oas.json\"),\n      destination: destinationPath,\n    });\n\n    const mergedContent = await fs.readFile(destinationPath, \"utf-8\");\n\n    const jsonContent = JSON.parse(mergedContent);\n\n    expect(jsonContent.paths).to.deep.equals({\n      \"/v1/second/{userUid}/nature\": {\n        post: {\n          summary: \"Test route\",\n          operationId: \"12345\",\n          parameters: [\n            {\n              $ref: \"#/components/parameters/userUid\",\n            },\n          ],\n          responses: {\n            \"200\": {\n              description: \"\",\n            },\n          },\n          security: [{}],\n          servers: [\n            {\n              url: \"https://api.stage.example.com\",\n              description: \"stage\",\n            },\n            {\n              url: \"https://api.example.com\",\n              description: \"production\",\n            },\n          ],\n        },\n      },\n      \"/v2/second/{userUid}/nature\": {\n        post: {\n          operationId: \"67920\",\n          summary: \"Test route v2\",\n          parameters: [\n            {\n              $ref: \"#/components/parameters/userUid\",\n            },\n          ],\n          responses: {\n            \"200\": {\n              description: \"\",\n            },\n          },\n        },\n      },\n    });\n  });\n\n  it(\"should import a file into a fs destination that does not yet exist\", async function () {\n    const destinationPath = path.join(testTmpPath, \"routes-test-two.oas.json\");\n\n    await importOpenApi({\n      prompt: false,\n      source: path.join(testAssetsPath, \"toimport.oas.json\"),\n      destination: destinationPath,\n    });\n\n    const mergedContent = await fs.readFile(destinationPath, \"utf-8\");\n\n    const jsonContent = JSON.parse(mergedContent);\n\n    expect(jsonContent.info).to.deep.equals({\n      version: \"v2\",\n      title: \"Zuplo test API V2\",\n      description: \"Test api v2\",\n      contact: {\n        name: \"Zuplo test\",\n        url: \"www.zuplo.com\",\n      },\n    });\n\n    expect(jsonContent.openapi).to.equal(\"3.1.0\");\n\n    expect(jsonContent.components).to.deep.equals({\n      parameters: {\n        userUid: {\n          name: \"userUid\",\n          in: \"path\",\n          description: \"Unique UUID of the user.\",\n          required: true,\n          schema: {\n            type: \"string\",\n            format: \"uuid\",\n          },\n        },\n      },\n      securitySchemes: {\n        authorization: {\n          type: \"http\",\n          description: \"Firebase JWT auth token\",\n          scheme: \"bearer\",\n        },\n      },\n    });\n\n    expect(jsonContent.servers).to.deep.equals([\n      {\n        url: \"https://api.stage.example.com\",\n        description: \"Stage\",\n      },\n      {\n        url: \"https://api.example.com\",\n        description: \"Prod\",\n      },\n    ]);\n\n    expect(jsonContent.security).to.deep.equals([{}]);\n\n    expect(jsonContent.tags).to.deep.equals([]);\n\n    expect(jsonContent.paths).to.deep.equals({\n      \"/v2/second/{userUid}/nature\": {\n        post: {\n          summary: \"Test route v2\",\n          operationId: \"67920\",\n          parameters: [\n            {\n              $ref: \"#/components/parameters/userUid\",\n            },\n          ],\n          responses: {\n            \"200\": {\n              description: \"\",\n            },\n          },\n        },\n      },\n    });\n  });\n});\n"]}

package/dist/cli.js

@@ -19,6 +19,7 @@ import editor from "./cmds/editor.js";
 import link from "./cmds/link.js";
 import list from "./cmds/list.js";
 import login from "./cmds/login.js";
+import oas from "./cmds/open-api/index.js";
 import project from "./cmds/project/index.js";
 import proxies from "./cmds/proxies/index.js";
 import source from "./cmds/source/index.js";
@@ -91,6 +92,7 @@ if (gte(process.versions.node, MIN_NODE_VERSION)) {
         .command(link)
         .command(login)
         .command(test)
+        .command(oas)
         .command(project)
         .command(source)
         .command(tunnel)

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import * as dotenv from \"dotenv\";\ndotenv.config();\n\n// Undici must be imported first to set the global dispatcher\n// If fetch is used before undici, the process will crash\nimport undici from \"undici\";\n\nimport { readFileSync } from \"node:fs\";\nimport os from \"node:os\";\nimport { fileURLToPath } from \"node:url\";\nimport { confirm } from \"@inquirer/prompts\";\nimport * as Sentry from \"@sentry/node\";\nimport { gte } from \"semver\";\nimport { hideBin } from \"yargs/helpers\";\nimport yargs from \"yargs/yargs\";\nimport build from \"./cmds/build.js\";\nimport compile from \"./cmds/compile.js\";\nimport convert from \"./cmds/convert.js\";\nimport deleteZup from \"./cmds/delete.js\";\nimport deploy from \"./cmds/deploy.js\";\nimport dev from \"./cmds/dev.js\";\nimport editor from \"./cmds/editor.js\";\nimport link from \"./cmds/link.js\";\nimport list from \"./cmds/list.js\";\nimport login from \"./cmds/login.js\";\nimport project from \"./cmds/project/index.js\";\nimport proxies from \"./cmds/proxies/index.js\";\nimport source from \"./cmds/source/index.js\";\nimport test from \"./cmds/test.js\";\nimport tunnel from \"./cmds/tunnel/index.js\";\nimport variable from \"./cmds/variable/index.js\";\nimport { shutdownAnalytics } from \"./common/analytics/lib.js\";\nimport { MAX_WAIT_PENDING_TIME_MS, SENTRY_DSN } from \"./common/constants.js\";\nimport { logger } from \"./common/logger.js\";\nimport { warnIfOutdatedVersion, warnNodeVersion } from \"./common/outdated.js\";\nimport {\n  printCriticalFailureToConsoleAndExit,\n  printWarningToConsole,\n} from \"./common/output.js\";\nimport { logLevel } from \"./common/middleware/logging.js\";\n\n// This allows us to stop the CLI from executing so we can connect the profiler\n\n// biome-ignore lint/style/noProcessEnv: Migrated from ESLint\nif (process.env.ZUPLO_CLI_PROFILING) {\n  await confirm({ message: \"Continue executing CLI?\", default: true });\n}\n\n// Note: We cannot set this to be higher than 18.0.0 because of the way\n// our documentation works -- we tell them to use npx @zuplo/cli@latest (even in CI/CD jobs)\n// If we set this to be higher than 18.0.0, then we will break them.\n// Instead we set the value in package.json to be engine.node >= 20.0.0, so it will warn\nconst MIN_NODE_VERSION = \"18.0.0\";\nconst RECOMMENDED_NODE_VERSION = \"20.0.0\";\n\nif (gte(process.versions.node, MIN_NODE_VERSION)) {\n  let cliVersion: string;\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL(\"../package.json\", import.meta.url)),\n        \"utf-8\"\n      )\n    );\n    cliVersion = packageJson.version;\n  } catch (e) {\n    cliVersion = \"0.0.0\";\n    logger.error(e);\n    await printCriticalFailureToConsoleAndExit(\n      `Unable to load @zuplo/cli. The package.json is missing or malformed.`\n    );\n  }\n\n  await warnNodeVersion(cliVersion, RECOMMENDED_NODE_VERSION);\n\n  if (os.platform() === \"win32\") {\n    printWarningToConsole(\n      \"Running the Zuplo CLI on Windows is currently in beta. Please report any issues to support@zuplo.com.\"\n    );\n  }\n\n  undici.setGlobalDispatcher(\n    undici.getGlobalDispatcher().compose((dispatch) => {\n      return (opts, handler) => {\n        opts.headers = {\n          ...opts.headers,\n          \"user-agent\": `ZuploCLI/${cliVersion}`,\n\n          // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n          ...(process.env.ZUPLO_CANARY ? { \"zp-canary\": \"true\" } : {}),\n        };\n        return dispatch(opts, handler);\n      };\n    })\n  );\n\n  Sentry.init({\n    dsn: SENTRY_DSN,\n    release: cliVersion,\n  });\n\n  const cli = yargs(hideBin(process.argv))\n    // This means that all env vars will have to be prefixed with ZUPLO_\n    .env(\"ZUPLO\")\n    .option(\"prompt\", {\n      type: \"boolean\",\n      describe: \"Bypass confirmation prompts\",\n      default: true,\n      hidden: true,\n    })\n    .option(\"verbose\", {\n      alias: \"v\",\n      type: \"count\",\n      describe: \"Increase verbosity level (-v, -vv, -vvv)\",\n      default: 0,\n      hidden: true,\n    })\n    .middleware(logLevel)\n    .command(compile)\n    .command(convert)\n    .command(deleteZup) // delete is a reserved keyword in JavaScript, so we call this function deleteZup\n    .command(deploy)\n    .command(dev)\n    .command(editor)\n    .command(list)\n    .command(link)\n    .command(login)\n    .command(test)\n    .command(project)\n    .command(source)\n    .command(tunnel)\n    .command(variable)\n    .command(build)\n    .command(proxies)\n    .command({\n      command: \"hello\",\n      handler: async () => {\n        await fetch(\"https://393b4699ced44cc2ae87e4ad86184a29.api.mockbin.io/\");\n      },\n    })\n    .demandCommand()\n    .strictCommands()\n    .version(cliVersion)\n    .fail(false)\n    .help();\n\n  try {\n    await cli.argv;\n\n    // Don't block\n    void warnIfOutdatedVersion(cliVersion);\n\n    void Sentry.close(MAX_WAIT_PENDING_TIME_MS).then(() => {\n      process.exit(0);\n    });\n  } catch (err) {\n    if (err instanceof Error) {\n      Sentry.captureException(err);\n    }\n    await printCriticalFailureToConsoleAndExit(err.message ?? err);\n    cli.showHelp();\n  } finally {\n    await shutdownAnalytics();\n  }\n} else {\n  await printCriticalFailureToConsoleAndExit(\n    `The Zuplo CLI requires at least node.js v${MIN_NODE_VERSION}. You are using v${process.versions.node}. Please update your version of node.js.\n\n    Consider using a Node.js version manager such as https://github.com/nvm-sh/nvm.`\n  );\n}\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import * as dotenv from \"dotenv\";\ndotenv.config();\n\n// Undici must be imported first to set the global dispatcher\n// If fetch is used before undici, the process will crash\nimport undici from \"undici\";\n\nimport { readFileSync } from \"node:fs\";\nimport os from \"node:os\";\nimport { fileURLToPath } from \"node:url\";\nimport { confirm } from \"@inquirer/prompts\";\nimport * as Sentry from \"@sentry/node\";\nimport { gte } from \"semver\";\nimport { hideBin } from \"yargs/helpers\";\nimport yargs from \"yargs/yargs\";\nimport build from \"./cmds/build.js\";\nimport compile from \"./cmds/compile.js\";\nimport convert from \"./cmds/convert.js\";\nimport deleteZup from \"./cmds/delete.js\";\nimport deploy from \"./cmds/deploy.js\";\nimport dev from \"./cmds/dev.js\";\nimport editor from \"./cmds/editor.js\";\nimport link from \"./cmds/link.js\";\nimport list from \"./cmds/list.js\";\nimport login from \"./cmds/login.js\";\nimport oas from \"./cmds/open-api/index.js\";\nimport project from \"./cmds/project/index.js\";\nimport proxies from \"./cmds/proxies/index.js\";\nimport source from \"./cmds/source/index.js\";\nimport test from \"./cmds/test.js\";\nimport tunnel from \"./cmds/tunnel/index.js\";\nimport variable from \"./cmds/variable/index.js\";\nimport { shutdownAnalytics } from \"./common/analytics/lib.js\";\nimport { MAX_WAIT_PENDING_TIME_MS, SENTRY_DSN } from \"./common/constants.js\";\nimport { logger } from \"./common/logger.js\";\nimport { warnIfOutdatedVersion, warnNodeVersion } from \"./common/outdated.js\";\nimport {\n  printCriticalFailureToConsoleAndExit,\n  printWarningToConsole,\n} from \"./common/output.js\";\nimport { logLevel } from \"./common/middleware/logging.js\";\n\n// This allows us to stop the CLI from executing so we can connect the profiler\n\n// biome-ignore lint/style/noProcessEnv: Migrated from ESLint\nif (process.env.ZUPLO_CLI_PROFILING) {\n  await confirm({ message: \"Continue executing CLI?\", default: true });\n}\n\n// Note: We cannot set this to be higher than 18.0.0 because of the way\n// our documentation works -- we tell them to use npx @zuplo/cli@latest (even in CI/CD jobs)\n// If we set this to be higher than 18.0.0, then we will break them.\n// Instead we set the value in package.json to be engine.node >= 20.0.0, so it will warn\nconst MIN_NODE_VERSION = \"18.0.0\";\nconst RECOMMENDED_NODE_VERSION = \"20.0.0\";\n\nif (gte(process.versions.node, MIN_NODE_VERSION)) {\n  let cliVersion: string;\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL(\"../package.json\", import.meta.url)),\n        \"utf-8\"\n      )\n    );\n    cliVersion = packageJson.version;\n  } catch (e) {\n    cliVersion = \"0.0.0\";\n    logger.error(e);\n    await printCriticalFailureToConsoleAndExit(\n      `Unable to load @zuplo/cli. The package.json is missing or malformed.`\n    );\n  }\n\n  await warnNodeVersion(cliVersion, RECOMMENDED_NODE_VERSION);\n\n  if (os.platform() === \"win32\") {\n    printWarningToConsole(\n      \"Running the Zuplo CLI on Windows is currently in beta. Please report any issues to support@zuplo.com.\"\n    );\n  }\n\n  undici.setGlobalDispatcher(\n    undici.getGlobalDispatcher().compose((dispatch) => {\n      return (opts, handler) => {\n        opts.headers = {\n          ...opts.headers,\n          \"user-agent\": `ZuploCLI/${cliVersion}`,\n\n          // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n          ...(process.env.ZUPLO_CANARY ? { \"zp-canary\": \"true\" } : {}),\n        };\n        return dispatch(opts, handler);\n      };\n    })\n  );\n\n  Sentry.init({\n    dsn: SENTRY_DSN,\n    release: cliVersion,\n  });\n\n  const cli = yargs(hideBin(process.argv))\n    // This means that all env vars will have to be prefixed with ZUPLO_\n    .env(\"ZUPLO\")\n    .option(\"prompt\", {\n      type: \"boolean\",\n      describe: \"Bypass confirmation prompts\",\n      default: true,\n      hidden: true,\n    })\n    .option(\"verbose\", {\n      alias: \"v\",\n      type: \"count\",\n      describe: \"Increase verbosity level (-v, -vv, -vvv)\",\n      default: 0,\n      hidden: true,\n    })\n    .middleware(logLevel)\n    .command(compile)\n    .command(convert)\n    .command(deleteZup) // delete is a reserved keyword in JavaScript, so we call this function deleteZup\n    .command(deploy)\n    .command(dev)\n    .command(editor)\n    .command(list)\n    .command(link)\n    .command(login)\n    .command(test)\n    .command(oas)\n    .command(project)\n    .command(source)\n    .command(tunnel)\n    .command(variable)\n    .command(build)\n    .command(proxies)\n    .command({\n      command: \"hello\",\n      handler: async () => {\n        await fetch(\"https://393b4699ced44cc2ae87e4ad86184a29.api.mockbin.io/\");\n      },\n    })\n    .demandCommand()\n    .strictCommands()\n    .version(cliVersion)\n    .fail(false)\n    .help();\n\n  try {\n    await cli.argv;\n\n    // Don't block\n    void warnIfOutdatedVersion(cliVersion);\n\n    void Sentry.close(MAX_WAIT_PENDING_TIME_MS).then(() => {\n      process.exit(0);\n    });\n  } catch (err) {\n    if (err instanceof Error) {\n      Sentry.captureException(err);\n    }\n    await printCriticalFailureToConsoleAndExit(err.message ?? err);\n    cli.showHelp();\n  } finally {\n    await shutdownAnalytics();\n  }\n} else {\n  await printCriticalFailureToConsoleAndExit(\n    `The Zuplo CLI requires at least node.js v${MIN_NODE_VERSION}. You are using v${process.versions.node}. Please update your version of node.js.\n\n    Consider using a Node.js version manager such as https://github.com/nvm-sh/nvm.`\n  );\n}\n"]}

package/dist/cmds/open-api/convert.d.ts

@@ -0,0 +1,9 @@
+import { Argv } from "yargs";
+declare const _default: {
+  desc: string;
+  command: string;
+  builder: (yargs: Argv) => Argv<unknown>;
+  handler: (argv: unknown) => Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=convert.d.ts.map

package/dist/cmds/open-api/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/cmds/open-api/convert.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAOV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAiEf,OAAO;;AApE/B,wBAwEE"}

package/dist/cmds/open-api/convert.js

@@ -0,0 +1,66 @@
+import fs from "node:fs";
+import path from "node:path";
+import { captureEvent } from "../../common/analytics/lib.js";
+import { convertOpenAPI } from "../../open-api/convert/handler.js";
+export default {
+    desc: "Convert OpenAPI files between JSON and YAML formats",
+    command: "convert [input]",
+    builder: (yargs) => {
+        return yargs
+            .positional("input", {
+            type: "string",
+            describe: "The input OpenAPI file (JSON or YAML)",
+            normalize: true,
+        })
+            .option("input", {
+            type: "string",
+            alias: "i",
+            describe: "The input OpenAPI file (JSON or YAML)",
+            normalize: true,
+        })
+            .option("format", {
+            type: "string",
+            alias: "f",
+            describe: "Output format",
+            choices: ["json", "yaml"],
+        })
+            .option("json", {
+            type: "boolean",
+            describe: "Convert to JSON format",
+            conflicts: ["yaml", "format"],
+        })
+            .option("yaml", {
+            type: "boolean",
+            describe: "Convert to YAML format",
+            conflicts: ["json", "format"],
+        })
+            .option("output", {
+            type: "string",
+            alias: "o",
+            describe: "Output file path (if not specified, generates based on input)",
+            normalize: true,
+        })
+            .check((argv) => {
+            if (!argv.input) {
+                throw new Error("Input file is required");
+            }
+            const validExtensions = [".json", ".yaml", ".yml"];
+            const ext = path.extname(argv.input).toLowerCase();
+            if (!validExtensions.includes(ext)) {
+                throw new Error(`Invalid input file extension: ${ext}. Must be .json, .yaml, or .yml`);
+            }
+            if (!fs.existsSync(argv.input)) {
+                throw new Error(`Input file not found: ${argv.input}`);
+            }
+            if (!argv.format && !argv.json && !argv.yaml) {
+                throw new Error("Output format must be specified using --format, --json, or --yaml");
+            }
+            return true;
+        });
+    },
+    handler: async (argv) => {
+        await captureEvent({ argv, event: "zuplo oas convert" });
+        await convertOpenAPI(argv);
+    },
+};
+//# sourceMappingURL=convert.js.map

package/dist/cmds/open-api/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/cmds/open-api/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAa,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAE9E,eAAe;IACb,IAAI,EAAE,qDAAqD;IAC3D,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,UAAU,CAAC,OAAO,EAAE;YACnB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,uCAAuC;YACjD,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,uCAAuC;YACjD,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,eAAe;YACzB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SAC1B,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,wBAAwB;YAClC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;SAC9B,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,wBAAwB;YAClC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;SAC9B,CAAC;aACD,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EACN,+DAA+D;YACjE,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YACd,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YAGD,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,iCAAiC,GAAG,iCAAiC,CACtE,CAAC;YACJ,CAAC;YAGD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAe,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACzD,CAAC;YAGD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACzD,MAAM,cAAc,CAAC,IAAiB,CAAC,CAAC;IAC1C,CAAC;CACF,CAAC","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { Arguments, convertOpenAPI } from \"../../open-api/convert/handler.js\";\n\nexport default {\n  desc: \"Convert OpenAPI files between JSON and YAML formats\",\n  command: \"convert [input]\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .positional(\"input\", {\n        type: \"string\",\n        describe: \"The input OpenAPI file (JSON or YAML)\",\n        normalize: true,\n      })\n      .option(\"input\", {\n        type: \"string\",\n        alias: \"i\",\n        describe: \"The input OpenAPI file (JSON or YAML)\",\n        normalize: true,\n      })\n      .option(\"format\", {\n        type: \"string\",\n        alias: \"f\",\n        describe: \"Output format\",\n        choices: [\"json\", \"yaml\"],\n      })\n      .option(\"json\", {\n        type: \"boolean\",\n        describe: \"Convert to JSON format\",\n        conflicts: [\"yaml\", \"format\"],\n      })\n      .option(\"yaml\", {\n        type: \"boolean\",\n        describe: \"Convert to YAML format\",\n        conflicts: [\"json\", \"format\"],\n      })\n      .option(\"output\", {\n        type: \"string\",\n        alias: \"o\",\n        describe:\n          \"Output file path (if not specified, generates based on input)\",\n        normalize: true,\n      })\n      .check((argv) => {\n        if (!argv.input) {\n          throw new Error(\"Input file is required\");\n        }\n\n        // Validate file extension\n        const validExtensions = [\".json\", \".yaml\", \".yml\"];\n        const ext = path.extname(argv.input as string).toLowerCase();\n        if (!validExtensions.includes(ext)) {\n          throw new Error(\n            `Invalid input file extension: ${ext}. Must be .json, .yaml, or .yml`\n          );\n        }\n\n        // Validate input file exists\n        if (!fs.existsSync(argv.input as string)) {\n          throw new Error(`Input file not found: ${argv.input}`);\n        }\n\n        // Validate output format is specified\n        if (!argv.format && !argv.json && !argv.yaml) {\n          throw new Error(\n            \"Output format must be specified using --format, --json, or --yaml\"\n          );\n        }\n\n        return true;\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo oas convert\" });\n    await convertOpenAPI(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/open-api/index.d.ts

@@ -0,0 +1,4 @@
+import { CommandModule } from "yargs";
+declare const commands: CommandModule;
+export default commands;
+//# sourceMappingURL=index.d.ts.map

package/dist/cmds/open-api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cmds/open-api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAMtC,QAAA,MAAM,QAAQ,EAAE,aAQf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/cmds/open-api/index.js

@@ -0,0 +1,15 @@
+import { groupHandler } from "../../common/handler.js";
+import convert from "./convert.js";
+import merge from "./merge.js";
+import overlay from "./overlay.js";
+const commands = {
+    describe: "OpenAPI commands",
+    command: "openapi",
+    aliases: ["oas", "open-api"],
+    builder: (yargs) => {
+        return yargs.command(convert).command(merge).command(overlay).help();
+    },
+    handler: groupHandler,
+};
+export default commands;
+//# sourceMappingURL=index.js.map

package/dist/cmds/open-api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cmds/open-api/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,QAAQ,GAAkB;IAC9B,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,eAAe,QAAQ,CAAC","sourcesContent":["import { CommandModule } from \"yargs\";\nimport { groupHandler } from \"../../common/handler.js\";\nimport convert from \"./convert.js\";\nimport merge from \"./merge.js\";\nimport overlay from \"./overlay.js\";\n\nconst commands: CommandModule = {\n  describe: \"OpenAPI commands\",\n  command: \"openapi\",\n  aliases: [\"oas\", \"open-api\"],\n  builder: (yargs) => {\n    return yargs.command(convert).command(merge).command(overlay).help();\n  },\n  handler: groupHandler,\n};\n\nexport default commands;\n"]}

package/dist/cmds/open-api/merge.d.ts

@@ -0,0 +1,9 @@
+import { Argv } from "yargs";
+declare const _default: {
+  desc: string;
+  command: string;
+  builder: (yargs: Argv) => Argv<unknown>;
+  handler: (argv: unknown) => Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/cmds/open-api/merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAOV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA8Cf,OAAO;;AAjD/B,wBAqDE"}

package/dist/cmds/open-api/merge.js

@@ -0,0 +1,57 @@
+import { captureEvent } from "../../common/analytics/lib.js";
+import { importOpenApi } from "../../open-api/merge/handler.js";
+export default {
+    desc: "Merge an OpenAPI file into your Zuplo project",
+    command: "merge [source] [destination]",
+    builder: (yargs) => {
+        return yargs
+            .positional("source", {
+            type: "string",
+            describe: "The OpenAPI file to merge (file path or URL)",
+        })
+            .positional("destination", {
+            type: "string",
+            describe: "The destination file name (must end with .oas.json)",
+        })
+            .option("source", {
+            type: "string",
+            alias: "s",
+            describe: "The OpenAPI file to merge (file path or URL)",
+        })
+            .option("destination", {
+            type: "string",
+            alias: "d",
+            describe: "The destination file name (must end with .oas.json)",
+        })
+            .option("merge-mode", {
+            type: "string",
+            alias: "m",
+            describe: "The merge mode to use when merging the OpenAPI file",
+            choices: ["path-method", "operation-id"],
+            default: "path-method",
+        })
+            .option("prompt", {
+            type: "boolean",
+            describe: "Prompt for confirmation before merging",
+            default: false,
+            hidden: true,
+        })
+            .check((argv) => {
+            if (!argv.source) {
+                throw new Error("Source is required");
+            }
+            if (!argv.destination) {
+                throw new Error("Destination is required");
+            }
+            if (!argv.destination.endsWith(".oas.json")) {
+                throw new Error("Destination file name must end with '.oas.json'");
+            }
+            return true;
+        });
+    },
+    handler: async (argv) => {
+        await captureEvent({ argv, event: "zuplo oas merge" });
+        await importOpenApi(argv);
+    },
+};
+//# sourceMappingURL=merge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/cmds/open-api/merge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAa,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE3E,eAAe;IACb,IAAI,EAAE,+CAA+C;IACrD,OAAO,EAAE,8BAA8B;IACvC,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,UAAU,CAAC,QAAQ,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,8CAA8C;SACzD,CAAC;aACD,UAAU,CAAC,aAAa,EAAE;YACzB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,qDAAqD;SAChE,CAAC;aACD,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,8CAA8C;SACzD,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,qDAAqD;SAChE,CAAC;aACD,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,qDAAqD;YAC/D,OAAO,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;YACxC,OAAO,EAAE,aAAa;SACvB,CAAC;aACD,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,wCAAwC;YAClD,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,IAAI;SACb,CAAC;aACD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;YACd,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACvD,MAAM,aAAa,CAAC,IAAiB,CAAC,CAAC;IACzC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { Arguments, importOpenApi } from \"../../open-api/merge/handler.js\";\n\nexport default {\n  desc: \"Merge an OpenAPI file into your Zuplo project\",\n  command: \"merge [source] [destination]\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .positional(\"source\", {\n        type: \"string\",\n        describe: \"The OpenAPI file to merge (file path or URL)\",\n      })\n      .positional(\"destination\", {\n        type: \"string\",\n        describe: \"The destination file name (must end with .oas.json)\",\n      })\n      .option(\"source\", {\n        type: \"string\",\n        alias: \"s\",\n        describe: \"The OpenAPI file to merge (file path or URL)\",\n      })\n      .option(\"destination\", {\n        type: \"string\",\n        alias: \"d\",\n        describe: \"The destination file name (must end with .oas.json)\",\n      })\n      .option(\"merge-mode\", {\n        type: \"string\",\n        alias: \"m\",\n        describe: \"The merge mode to use when merging the OpenAPI file\",\n        choices: [\"path-method\", \"operation-id\"],\n        default: \"path-method\",\n      })\n      .option(\"prompt\", {\n        type: \"boolean\",\n        describe: \"Prompt for confirmation before merging\",\n        default: false,\n        hidden: true,\n      })\n      .check((argv) => {\n        if (!argv.source) {\n          throw new Error(\"Source is required\");\n        }\n        if (!argv.destination) {\n          throw new Error(\"Destination is required\");\n        }\n        if (!argv.destination.endsWith(\".oas.json\")) {\n          throw new Error(\"Destination file name must end with '.oas.json'\");\n        }\n        return true;\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo oas merge\" });\n    await importOpenApi(argv as Arguments);\n  },\n};\n"]}

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

@@ -0,0 +1,9 @@
+import { Argv } from "yargs";
+declare const _default: {
+  desc: string;
+  command: string;
+  builder: (yargs: Argv) => Argv<unknown>;
+  handler: (argv: unknown) => Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=overlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../../src/cmds/open-api/overlay.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAOV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAsFf,OAAO;;AAzF/B,wBA6FE"}

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

@@ -0,0 +1,85 @@
+import fs from "node:fs";
+import path from "node:path";
+import { captureEvent } from "../../common/analytics/lib.js";
+import { applyOverlay } from "../../open-api/overlay/handler.js";
+export default {
+    desc: "Apply an OpenAPI Overlay to an OpenAPI document",
+    command: "overlay [input] [overlay] [output]",
+    builder: (yargs) => {
+        return yargs
+            .positional("input", {
+            type: "string",
+            describe: "The input OpenAPI file",
+            normalize: true,
+        })
+            .positional("overlay", {
+            type: "string",
+            describe: "The overlay file",
+            normalize: true,
+        })
+            .positional("output", {
+            type: "string",
+            describe: "The output OpenAPI file path",
+            normalize: true,
+        })
+            .option("input", {
+            type: "string",
+            alias: "i",
+            describe: "The input OpenAPI file",
+            normalize: true,
+        })
+            .option("overlay", {
+            type: "string",
+            alias: "v",
+            describe: "The overlay file",
+            normalize: true,
+        })
+            .option("output", {
+            type: "string",
+            alias: "o",
+            describe: "The output OpenAPI file path",
+            normalize: true,
+        })
+            .option("format", {
+            type: "string",
+            alias: "f",
+            describe: "Output format",
+            choices: ["json", "yaml"],
+        })
+            .option("json", {
+            type: "boolean",
+            describe: "Output in JSON format",
+            conflicts: ["yaml", "format"],
+        })
+            .option("yaml", {
+            type: "boolean",
+            describe: "Output in YAML format",
+            conflicts: ["json", "format"],
+        })
+            .check((argv) => {
+            if (!argv.input || !argv.overlay || !argv.output) {
+                throw new Error("All three arguments are required: input, overlay, and output");
+            }
+            const outputExt = path.extname(argv.output).toLowerCase();
+            const validExtensions = [".json", ".yaml", ".yml"];
+            if (!argv.format &&
+                !argv.json &&
+                !argv.yaml &&
+                !validExtensions.includes(outputExt)) {
+                throw new Error(`Output file must have a .json, .yaml, or .yml extension, or specify output format with --format, --json, or --yaml`);
+            }
+            if (!fs.existsSync(argv.input)) {
+                throw new Error(`Input file not found: ${argv.input}`);
+            }
+            if (!fs.existsSync(argv.overlay)) {
+                throw new Error(`Overlay file not found: ${argv.overlay}`);
+            }
+            return true;
+        });
+    },
+    handler: async (argv) => {
+        await captureEvent({ argv, event: "zuplo oas overlay" });
+        await applyOverlay(argv);
+    },
+};
+//# sourceMappingURL=overlay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../../src/cmds/open-api/overlay.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { Arguments, applyOverlay } from \"../../open-api/overlay/handler.js\";\n\nexport default {\n  desc: \"Apply an OpenAPI Overlay to an OpenAPI document\",\n  command: \"overlay [input] [overlay] [output]\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .positional(\"input\", {\n        type: \"string\",\n        describe: \"The input OpenAPI file\",\n        normalize: true,\n      })\n      .positional(\"overlay\", {\n        type: \"string\",\n        describe: \"The overlay file\",\n        normalize: true,\n      })\n      .positional(\"output\", {\n        type: \"string\",\n        describe: \"The output OpenAPI file path\",\n        normalize: true,\n      })\n      .option(\"input\", {\n        type: \"string\",\n        alias: \"i\",\n        describe: \"The input OpenAPI file\",\n        normalize: true,\n      })\n      .option(\"overlay\", {\n        type: \"string\",\n        alias: \"v\",\n        describe: \"The overlay file\",\n        normalize: true,\n      })\n      .option(\"output\", {\n        type: \"string\",\n        alias: \"o\",\n        describe: \"The output OpenAPI file path\",\n        normalize: true,\n      })\n      .option(\"format\", {\n        type: \"string\",\n        alias: \"f\",\n        describe: \"Output format\",\n        choices: [\"json\", \"yaml\"],\n      })\n      .option(\"json\", {\n        type: \"boolean\",\n        describe: \"Output in JSON format\",\n        conflicts: [\"yaml\", \"format\"],\n      })\n      .option(\"yaml\", {\n        type: \"boolean\",\n        describe: \"Output in YAML format\",\n        conflicts: [\"json\", \"format\"],\n      })\n      .check((argv) => {\n        if (!argv.input || !argv.overlay || !argv.output) {\n          throw new Error(\n            \"All three arguments are required: input, overlay, and output\"\n          );\n        }\n\n        // Validate output file has an extension for format detection\n        const outputExt = path.extname(argv.output as string).toLowerCase();\n        const validExtensions = [\".json\", \".yaml\", \".yml\"];\n\n        // Only require extension if format not explicitly specified\n        if (\n          !argv.format &&\n          !argv.json &&\n          !argv.yaml &&\n          !validExtensions.includes(outputExt)\n        ) {\n          throw new Error(\n            `Output file must have a .json, .yaml, or .yml extension, or specify output format with --format, --json, or --yaml`\n          );\n        }\n\n        // Validate input files exist\n        if (!fs.existsSync(argv.input as string)) {\n          throw new Error(`Input file not found: ${argv.input}`);\n        }\n\n        if (!fs.existsSync(argv.overlay as string)) {\n          throw new Error(`Overlay file not found: ${argv.overlay}`);\n        }\n\n        return true;\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo oas overlay\" });\n    await applyOverlay(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/source/import-openapi.d.ts

@@ -2,6 +2,7 @@ import { Argv } from "yargs";
 declare const _default: {
   desc: string;
   command: string;
+  deprecated: string;
   builder: (yargs: Argv) => Argv<unknown>;
   handler: (argv: unknown) => Promise<void>;
 };