@zuplo/cli 6.63.3 → 6.63.4

package/dist/cmds/mtls-certificates/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cmds/mtls-certificates/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,yCAAyC,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE5E,eAAe;IACb,IAAI,EAAE,2CAA2C;IACjD,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,IAAqB,CAAC,CAAC;IACpC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { list } from \"../../mtls-certificates/list/handler.js\";\nimport { ListArguments } from \"../../mtls-certificates/models.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { fetchProject } from \"../../common/middleware/get-project-param.js\";\n\nexport default {\n  desc: \"Lists all mTLS certificates for a project\",\n  command: \"list\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .option(\"project\", {\n        type: \"string\",\n        describe: \"The project name\",\n      })\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        fetchProject,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo mtls-certificates list\" });\n    await list(argv as ListArguments);\n  },\n};\n"]}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cmds/mtls-certificates/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,yCAAyC,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE5E,eAAe;IACb,IAAI,EAAE,2CAA2C;IACjD,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,qCAAqC,CAAC;aAC5C,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,OAAO,CAAC;YACP;gBACE,2BAA2B;gBAC3B,6CAA6C;aAC9C;YACD;gBACE,qEAAqE;gBACrE,4CAA4C;aAC7C;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,IAAqB,CAAC,CAAC;IACpC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { list } from \"../../mtls-certificates/list/handler.js\";\nimport { ListArguments } from \"../../mtls-certificates/models.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { fetchProject } from \"../../common/middleware/get-project-param.js\";\n\nexport default {\n  desc: \"Lists all mTLS certificates for a project\",\n  command: \"list\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 mtls-certificates list [options]\")\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .option(\"project\", {\n        type: \"string\",\n        describe: \"The project name\",\n      })\n      .example([\n        [\n          \"$0 mtls-certificates list\",\n          \"List all mTLS certificates for your project\",\n        ],\n        [\n          \"$0 mtls-certificates list --account my-account --project my-project\",\n          \"Explicitly specify the account and project\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        fetchProject,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo mtls-certificate list\" });\n    await list(argv as ListArguments);\n  },\n};\n"]}

package/dist/cmds/mtls-certificates/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cmds/mtls-certificates/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAcV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAmCf,OAAO;;AAtC/B,wBA0CE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cmds/mtls-certificates/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAcV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAoDf,OAAO;;AAvD/B,wBA2DE"}

package/dist/cmds/mtls-certificates/update.js

@@ -11,6 +11,7 @@ export default {
     command: "update",
     builder: (yargs) => {
         return yargs
+            .usage("$0 mtls-certificates update --cert-id <id> --environment <env> [options]")
             .option("cert-id", {
             type: "string",
             describe: "The ID of the certificate to update",
@@ -34,6 +35,20 @@ export default {
             describe: "The project name",
         })
             .demandOption(["cert-id", "environment"])
+            .example([
+            [
+                "$0 mtls-certificates update --cert-id cert_abc123 --environment production",
+                "Update certificate to be enabled only for production environment",
+            ],
+            [
+                "$0 mtls-certificates update --cert-id cert_abc123 --environment development --environment preview --environment production",
+                "Update certificate to be enabled for all environments",
+            ],
+            [
+                "$0 mtls-certificates update --cert-id cert_abc123 --environment development --account my-account --project my-project",
+                "Explicitly specify the account and project",
+            ],
+        ])
             .middleware([
             setBlocking,
             authenticate,
@@ -44,7 +59,7 @@ export default {
         ]);
     },
     handler: async (argv) => {
-        await captureEvent({ argv, event: "zuplo mtls-certificates update" });
+        await captureEvent({ argv, event: "zuplo mtls-certificate update" });
         await update(argv);
     },
 };

package/dist/cmds/mtls-certificates/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cmds/mtls-certificates/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE5E,eAAe;IACb,IAAI,EAAE,0DAA0D;IAChE,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,qCAAqC;SAChD,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,OAAO;YACb,QAAQ,EACN,4HAA4H;YAC9H,OAAO,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,YAAY,CAAC;SAClD,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;aACxC,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,CAAC,IAAuB,CAAC,CAAC;IACxC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { update } from \"../../mtls-certificates/update/handler.js\";\nimport { UpdateArguments } from \"../../mtls-certificates/models.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { fetchProject } from \"../../common/middleware/get-project-param.js\";\n\nexport default {\n  desc: \"Updates the environment settings for an mTLS certificate\",\n  command: \"update\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"cert-id\", {\n        type: \"string\",\n        describe: \"The ID of the certificate to update\",\n      })\n      .option(\"environment\", {\n        type: \"array\",\n        describe:\n          \"Environments where the certificate should be enabled (can be repeated: --environment development --environment production)\",\n        choices: [\"development\", \"preview\", \"production\"],\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .option(\"project\", {\n        type: \"string\",\n        describe: \"The project name\",\n      })\n      .demandOption([\"cert-id\", \"environment\"])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        fetchProject,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo mtls-certificates update\" });\n    await update(argv as UpdateArguments);\n  },\n};\n"]}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cmds/mtls-certificates/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAE5E,eAAe;IACb,IAAI,EAAE,0DAA0D;IAChE,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CACJ,0EAA0E,CAC3E;aACA,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,qCAAqC;SAChD,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,OAAO;YACb,QAAQ,EACN,4HAA4H;YAC9H,OAAO,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,YAAY,CAAC;SAClD,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;aACxC,OAAO,CAAC;YACP;gBACE,4EAA4E;gBAC5E,kEAAkE;aACnE;YACD;gBACE,4HAA4H;gBAC5H,uDAAuD;aACxD;YACD;gBACE,uHAAuH;gBACvH,4CAA4C;aAC7C;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;QACrE,MAAM,MAAM,CAAC,IAAuB,CAAC,CAAC;IACxC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { update } from \"../../mtls-certificates/update/handler.js\";\nimport { UpdateArguments } from \"../../mtls-certificates/models.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { fetchProject } from \"../../common/middleware/get-project-param.js\";\n\nexport default {\n  desc: \"Updates the environment settings for an mTLS certificate\",\n  command: \"update\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\n        \"$0 mtls-certificates update --cert-id <id> --environment <env> [options]\"\n      )\n      .option(\"cert-id\", {\n        type: \"string\",\n        describe: \"The ID of the certificate to update\",\n      })\n      .option(\"environment\", {\n        type: \"array\",\n        describe:\n          \"Environments where the certificate should be enabled (can be repeated: --environment development --environment production)\",\n        choices: [\"development\", \"preview\", \"production\"],\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .option(\"project\", {\n        type: \"string\",\n        describe: \"The project name\",\n      })\n      .demandOption([\"cert-id\", \"environment\"])\n      .example([\n        [\n          \"$0 mtls-certificates update --cert-id cert_abc123 --environment production\",\n          \"Update certificate to be enabled only for production environment\",\n        ],\n        [\n          \"$0 mtls-certificates update --cert-id cert_abc123 --environment development --environment preview --environment production\",\n          \"Update certificate to be enabled for all environments\",\n        ],\n        [\n          \"$0 mtls-certificates update --cert-id cert_abc123 --environment development --account my-account --project my-project\",\n          \"Explicitly specify the account and project\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        fetchProject,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo mtls-certificate update\" });\n    await update(argv as UpdateArguments);\n  },\n};\n"]}

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

@@ -1 +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;oBA6Df,OAAO;;AAhE/B,wBAoEE"}
+{"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;oBA8Ef,OAAO;;AAjF/B,wBAqFE"}

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

@@ -7,6 +7,7 @@ export default {
     command: "convert",
     builder: (yargs) => {
         return yargs
+            .usage("$0 oas convert --input <file> (--json|--yaml|--format <format>) [options]")
             .option("input", {
             type: "string",
             alias: "i",
@@ -36,6 +37,20 @@ export default {
             describe: "Output file path (if not specified, generates based on input)",
             normalize: true,
         })
+            .example([
+            [
+                "$0 oas convert --input openapi.yaml --json",
+                "Convert a YAML OpenAPI file to JSON format",
+            ],
+            [
+                "$0 oas convert -i openapi.json --yaml -o api-spec.yaml",
+                "Convert a JSON OpenAPI file to YAML with custom output path",
+            ],
+            [
+                "$0 oas convert --input api.yaml --format json",
+                "Convert using --format flag instead of --json/--yaml",
+            ],
+        ])
             .check((argv) => {
             if (!argv.input) {
                 throw new Error("Input file is required");

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

@@ -1 +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,SAAS;IAClB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,uCAAuC;YACjD,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,IAAI;SACnB,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\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"input\", {\n        type: \"string\",\n        alias: \"i\",\n        describe: \"The input OpenAPI file (JSON or YAML)\",\n        normalize: true,\n        demandOption: 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"]}
+{"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,SAAS;IAClB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CACJ,2EAA2E,CAC5E;aACA,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,QAAQ,EAAE,uCAAuC;YACjD,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,IAAI;SACnB,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,OAAO,CAAC;YACP;gBACE,4CAA4C;gBAC5C,4CAA4C;aAC7C;YACD;gBACE,wDAAwD;gBACxD,6DAA6D;aAC9D;YACD;gBACE,+CAA+C;gBAC/C,sDAAsD;aACvD;SACF,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\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\n        \"$0 oas convert --input <file> (--json|--yaml|--format <format>) [options]\"\n      )\n      .option(\"input\", {\n        type: \"string\",\n        alias: \"i\",\n        describe: \"The input OpenAPI file (JSON or YAML)\",\n        normalize: true,\n        demandOption: 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      .example([\n        [\n          \"$0 oas convert --input openapi.yaml --json\",\n          \"Convert a YAML OpenAPI file to JSON format\",\n        ],\n        [\n          \"$0 oas convert -i openapi.json --yaml -o api-spec.yaml\",\n          \"Convert a JSON OpenAPI file to YAML with custom output path\",\n        ],\n        [\n          \"$0 oas convert --input api.yaml --format json\",\n          \"Convert using --format flag instead of --json/--yaml\",\n        ],\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/merge.d.ts.map

@@ -1 +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;oBAwCf,OAAO;;AA3C/B,wBA+CE"}
+{"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;oBAuDf,OAAO;;AA1D/B,wBA8DE"}

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

@@ -5,6 +5,7 @@ export default {
     command: "merge",
     builder: (yargs) => {
         return yargs
+            .usage("$0 oas merge --source <file|url> --destination <file> [options]")
             .option("source", {
             type: "string",
             alias: "s",
@@ -30,6 +31,20 @@ export default {
             default: false,
             hidden: true,
         })
+            .example([
+            [
+                "$0 oas merge --source openapi.yaml --destination ./config/routes.oas.json",
+                "Merge an OpenAPI file into your Zuplo project",
+            ],
+            [
+                "$0 oas merge -s https://api.example.com/openapi.json -d ./config/api.oas.json",
+                "Merge an OpenAPI file from a URL",
+            ],
+            [
+                "$0 oas merge --source openapi.yaml --destination ./config/routes.oas.json --merge-mode operation-id",
+                "Merge using operation-id instead of path-method matching",
+            ],
+        ])
             .check((argv) => {
             if (!argv.source) {
                 throw new Error("Source is required");

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

@@ -1 +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,OAAO;IAChB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,8CAA8C;SACzD,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,0BAA0B;YACnC,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\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"source\", {\n        type: \"string\",\n        alias: \"s\",\n        demandOption: true,\n        describe: \"The OpenAPI file to merge (file path or URL)\",\n      })\n      .option(\"destination\", {\n        type: \"string\",\n        alias: \"d\",\n        default: \"./config/routes.oas.json\",\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"]}
+{"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,OAAO;IAChB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,iEAAiE,CAAC;aACxE,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,8CAA8C;SACzD,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,0BAA0B;YACnC,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,OAAO,CAAC;YACP;gBACE,2EAA2E;gBAC3E,+CAA+C;aAChD;YACD;gBACE,+EAA+E;gBAC/E,kCAAkC;aACnC;YACD;gBACE,qGAAqG;gBACrG,0DAA0D;aAC3D;SACF,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\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 oas merge --source <file|url> --destination <file> [options]\")\n      .option(\"source\", {\n        type: \"string\",\n        alias: \"s\",\n        demandOption: true,\n        describe: \"The OpenAPI file to merge (file path or URL)\",\n      })\n      .option(\"destination\", {\n        type: \"string\",\n        alias: \"d\",\n        default: \"./config/routes.oas.json\",\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      .example([\n        [\n          \"$0 oas merge --source openapi.yaml --destination ./config/routes.oas.json\",\n          \"Merge an OpenAPI file into your Zuplo project\",\n        ],\n        [\n          \"$0 oas merge -s https://api.example.com/openapi.json -d ./config/api.oas.json\",\n          \"Merge an OpenAPI file from a URL\",\n        ],\n        [\n          \"$0 oas merge --source openapi.yaml --destination ./config/routes.oas.json --merge-mode operation-id\",\n          \"Merge using operation-id instead of path-method matching\",\n        ],\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.map

@@ -1 +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;oBA0Ef,OAAO;;AA7E/B,wBAiFE"}
+{"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;oBA2Ff,OAAO;;AA9F/B,wBAkGE"}

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

@@ -7,6 +7,7 @@ export default {
     command: "overlay",
     builder: (yargs) => {
         return yargs
+            .usage("$0 oas overlay --input <file> --overlay <file> --output <file> [options]")
             .option("input", {
             type: "string",
             alias: "i",
@@ -44,6 +45,20 @@ export default {
             describe: "Output in YAML format",
             conflicts: ["json", "format"],
         })
+            .example([
+            [
+                "$0 oas overlay --input openapi.json --overlay changes.json --output result.json",
+                "Apply an overlay to an OpenAPI document",
+            ],
+            [
+                "$0 oas overlay -i api.yaml -v overlay.yaml -o result.yaml --yaml",
+                "Apply overlay and output in YAML format",
+            ],
+            [
+                "$0 oas overlay --input openapi.json --overlay overlay.json --output result.yaml --format yaml",
+                "Apply overlay and convert format in one step",
+            ],
+        ])
             .check((argv) => {
             if (!argv.input || !argv.overlay || !argv.output) {
                 throw new Error("All three arguments are required: input, overlay, and output");

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

@@ -1 +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\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"input\", {\n        type: \"string\",\n        alias: \"i\",\n        describe: \"The input OpenAPI file\",\n        normalize: true,\n        demandOption: true,\n      })\n      .option(\"overlay\", {\n        type: \"string\",\n        alias: \"v\",\n        describe: \"The overlay file\",\n        normalize: true,\n        demandOption: true,\n      })\n      .option(\"output\", {\n        type: \"string\",\n        alias: \"o\",\n        describe: \"The output OpenAPI file path\",\n        normalize: true,\n        demandOption: 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"]}
+{"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\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\n        \"$0 oas overlay --input <file> --overlay <file> --output <file> [options]\"\n      )\n      .option(\"input\", {\n        type: \"string\",\n        alias: \"i\",\n        describe: \"The input OpenAPI file\",\n        normalize: true,\n        demandOption: true,\n      })\n      .option(\"overlay\", {\n        type: \"string\",\n        alias: \"v\",\n        describe: \"The overlay file\",\n        normalize: true,\n        demandOption: true,\n      })\n      .option(\"output\", {\n        type: \"string\",\n        alias: \"o\",\n        describe: \"The output OpenAPI file path\",\n        normalize: true,\n        demandOption: 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      .example([\n        [\n          \"$0 oas overlay --input openapi.json --overlay changes.json --output result.json\",\n          \"Apply an overlay to an OpenAPI document\",\n        ],\n        [\n          \"$0 oas overlay -i api.yaml -v overlay.yaml -o result.yaml --yaml\",\n          \"Apply overlay and output in YAML format\",\n        ],\n        [\n          \"$0 oas overlay --input openapi.json --overlay overlay.json --output result.yaml --format yaml\",\n          \"Apply overlay and convert format in one step\",\n        ],\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/project/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cmds/project/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAYV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAmBf,OAAO;;AAtB/B,wBA4CE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cmds/project/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAYV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA+Bf,OAAO;;AAlC/B,wBAwDE"}

package/dist/cmds/project/create.js

@@ -11,6 +11,7 @@ export default {
     command: "create",
     builder: (yargs) => {
         return yargs
+            .usage("$0 project create [--name <name>] [options]")
             .option("name", {
             type: "string",
             describe: "The name of the project to create",
@@ -20,6 +21,17 @@ export default {
             describe: "The API Key from Zuplo",
             envVar: "API_KEY",
         })
+            .example([
+            [
+                "$0 project create --name my-api-project",
+                "Create a new project with the specified name",
+            ],
+            ["$0 project create", "Create a new project (will prompt for name)"],
+            [
+                "$0 project create --name my-project --account my-account",
+                "Explicitly specify the account",
+            ],
+        ])
             .middleware([
             setBlocking,
             authenticate,

package/dist/cmds/project/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cmds/project/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,MAAM,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,eAAe;IACb,IAAI,EAAE,uCAAuC;IAC7C,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,mCAAmC;SAC9C,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAiB,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,MAAM,KAAK,CAAC;gBACtB,OAAO,EAAE,0BAA0B;aACpC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, create } from \"../../project/create/handler.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { input } from \"@inquirer/prompts\";\nexport default {\n  desc: \"Creates a new project in your account\",\n  command: \"create\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"name\", {\n        type: \"string\",\n        describe: \"The name of the project to create\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    if (!argv || typeof argv !== \"object\") {\n      throw new Error(\n        \"Invalid state: name is not set. Please provide a project name.\"\n      );\n    }\n\n    const args = argv as Arguments;\n    if (!args.name) {\n      args.name = await input({\n        message: \"Enter the project name: \",\n      });\n      if (!args.name) {\n        throw new Error(\n          \"Invalid state: name is not set. Please provide a project name.\"\n        );\n      }\n    }\n\n    await captureEvent({ argv, event: \"zuplo project create\" });\n    await create(args);\n  },\n};\n"]}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cmds/project/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,MAAM,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,eAAe;IACb,IAAI,EAAE,uCAAuC;IAC7C,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,6CAA6C,CAAC;aACpD,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,mCAAmC;SAC9C,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,OAAO,CAAC;YACP;gBACE,yCAAyC;gBACzC,8CAA8C;aAC/C;YACD,CAAC,mBAAmB,EAAE,6CAA6C,CAAC;YACpE;gBACE,0DAA0D;gBAC1D,gCAAgC;aACjC;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAiB,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,MAAM,KAAK,CAAC;gBACtB,OAAO,EAAE,0BAA0B;aACpC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, create } from \"../../project/create/handler.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { input } from \"@inquirer/prompts\";\nexport default {\n  desc: \"Creates a new project in your account\",\n  command: \"create\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 project create [--name <name>] [options]\")\n      .option(\"name\", {\n        type: \"string\",\n        describe: \"The name of the project to create\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .example([\n        [\n          \"$0 project create --name my-api-project\",\n          \"Create a new project with the specified name\",\n        ],\n        [\"$0 project create\", \"Create a new project (will prompt for name)\"],\n        [\n          \"$0 project create --name my-project --account my-account\",\n          \"Explicitly specify the account\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    if (!argv || typeof argv !== \"object\") {\n      throw new Error(\n        \"Invalid state: name is not set. Please provide a project name.\"\n      );\n    }\n\n    const args = argv as Arguments;\n    if (!args.name) {\n      args.name = await input({\n        message: \"Enter the project name: \",\n      });\n      if (!args.name) {\n        throw new Error(\n          \"Invalid state: name is not set. Please provide a project name.\"\n        );\n      }\n    }\n\n    await captureEvent({ argv, event: \"zuplo project create\" });\n    await create(args);\n  },\n};\n"]}

package/dist/cmds/proxies/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAaV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA8Bf,OAAO;;AAjC/B,wBAwCE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAaV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA2Cf,OAAO;;AA9C/B,wBAqDE"}

package/dist/cmds/proxies/create.js

@@ -11,6 +11,7 @@ export default {
     command: "create",
     builder: (yargs) => {
         return yargs
+            .usage("$0 proxies create --fleet <fleet-id> --configuration-file <file> [options]")
             .option("fleet", {
             type: "string",
             describe: "The fleet ID",
@@ -30,6 +31,16 @@ export default {
         })
             .demandOption(["fleet", "configuration-file"])
             .demandOption("api-key", "You must provide an API key with --api-key")
+            .example([
+            [
+                "$0 proxies create --fleet fleet_abc123 --configuration-file ./proxy-config.json",
+                "Create a new proxy configuration for a fleet",
+            ],
+            [
+                "$0 proxies create --fleet fleet_abc123 --configuration-file ./config.json --account my-account",
+                "Explicitly specify the account",
+            ],
+        ])
             .middleware([
             setBlocking,
             authenticate,

package/dist/cmds/proxies/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cmds/proxies/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEpE,eAAe;IACb,IAAI,EAAE,+CAA+C;IACrD,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC5B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,iCAAiC;SAC5C,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;aAC7C,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAiB,CAAC,CAAC;IAClC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, create } from \"../../proxies/create/handler.js\";\n\nexport default {\n  desc: \"Creates a new proxy configuration for a fleet\",\n  command: \"create\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"configuration-file\", {\n        type: \"string\",\n        describe: \"Path to JSON configuration file\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\", \"configuration-file\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies create\",\n    });\n    await create(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/cmds/proxies/create.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEpE,eAAe;IACb,IAAI,EAAE,+CAA+C;IACrD,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CACJ,4EAA4E,CAC7E;aACA,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC5B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,iCAAiC;SAC5C,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;aAC7C,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,OAAO,CAAC;YACP;gBACE,iFAAiF;gBACjF,8CAA8C;aAC/C;YACD;gBACE,gGAAgG;gBAChG,gCAAgC;aACjC;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAiB,CAAC,CAAC;IAClC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, create } from \"../../proxies/create/handler.js\";\n\nexport default {\n  desc: \"Creates a new proxy configuration for a fleet\",\n  command: \"create\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\n        \"$0 proxies create --fleet <fleet-id> --configuration-file <file> [options]\"\n      )\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"configuration-file\", {\n        type: \"string\",\n        describe: \"Path to JSON configuration file\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\", \"configuration-file\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .example([\n        [\n          \"$0 proxies create --fleet fleet_abc123 --configuration-file ./proxy-config.json\",\n          \"Create a new proxy configuration for a fleet\",\n        ],\n        [\n          \"$0 proxies create --fleet fleet_abc123 --configuration-file ./config.json --account my-account\",\n          \"Explicitly specify the account\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies create\",\n    });\n    await create(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/proxies/delete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAgBV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA0Bf,OAAO;;AA7B/B,wBAoCE"}
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAgBV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAqCf,OAAO;;AAxC/B,wBA+CE"}

package/dist/cmds/proxies/delete.js

@@ -11,6 +11,7 @@ export default {
     command: "delete",
     builder: (yargs) => {
         return yargs
+            .usage("$0 proxies delete --fleet <fleet-id> [options]")
             .option("fleet", {
             type: "string",
             describe: "The fleet ID",
@@ -26,6 +27,16 @@ export default {
         })
             .demandOption(["fleet"])
             .demandOption("api-key", "You must provide an API key with --api-key")
+            .example([
+            [
+                "$0 proxies delete --fleet fleet_abc123",
+                "Delete a proxy configuration for a fleet",
+            ],
+            [
+                "$0 proxies delete --fleet fleet_abc123 --account my-account",
+                "Explicitly specify the account",
+            ],
+        ])
             .middleware([
             setBlocking,
             authenticate,

package/dist/cmds/proxies/delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/cmds/proxies/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAEL,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,eAAe;IACb,IAAI,EAAE,2CAA2C;IACjD,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;aACvB,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,MAAM,wBAAwB,CAAC,IAAiB,CAAC,CAAC;IACpD,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport {\n  Arguments,\n  deleteProxyConfiguration,\n} from \"../../proxies/delete/handler.js\";\n\nexport default {\n  desc: \"Deletes a proxy configuration for a fleet\",\n  command: \"delete\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies delete\",\n    });\n    await deleteProxyConfiguration(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/cmds/proxies/delete.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAEL,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,eAAe;IACb,IAAI,EAAE,2CAA2C;IACjD,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,gDAAgD,CAAC;aACvD,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;aACvB,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,OAAO,CAAC;YACP;gBACE,wCAAwC;gBACxC,0CAA0C;aAC3C;YACD;gBACE,6DAA6D;gBAC7D,gCAAgC;aACjC;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,MAAM,wBAAwB,CAAC,IAAiB,CAAC,CAAC;IACpD,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport {\n  Arguments,\n  deleteProxyConfiguration,\n} from \"../../proxies/delete/handler.js\";\n\nexport default {\n  desc: \"Deletes a proxy configuration for a fleet\",\n  command: \"delete\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 proxies delete --fleet <fleet-id> [options]\")\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .example([\n        [\n          \"$0 proxies delete --fleet fleet_abc123\",\n          \"Delete a proxy configuration for a fleet\",\n        ],\n        [\n          \"$0 proxies delete --fleet fleet_abc123 --account my-account\",\n          \"Explicitly specify the account\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies delete\",\n    });\n    await deleteProxyConfiguration(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/proxies/describe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAaV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA0Bf,OAAO;;AA7B/B,wBAoCE"}
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAaV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAqCf,OAAO;;AAxC/B,wBA+CE"}

package/dist/cmds/proxies/describe.js

@@ -11,6 +11,7 @@ export default {
     command: "describe",
     builder: (yargs) => {
         return yargs
+            .usage("$0 proxies describe --fleet <fleet-id> [options]")
             .option("fleet", {
             type: "string",
             describe: "The fleet ID",
@@ -26,6 +27,16 @@ export default {
         })
             .demandOption(["fleet"])
             .demandOption("api-key", "You must provide an API key with --api-key")
+            .example([
+            [
+                "$0 proxies describe --fleet fleet_abc123",
+                "View the proxy configuration for a fleet",
+            ],
+            [
+                "$0 proxies describe --fleet fleet_abc123 --account my-account",
+                "Explicitly specify the account",
+            ],
+        ])
             .middleware([
             setBlocking,
             authenticate,

package/dist/cmds/proxies/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../src/cmds/proxies/describe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAe;IACb,IAAI,EAAE,6CAA6C;IACnD,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;aACvB,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,wBAAwB;SAChC,CAAC,CAAC;QACH,MAAM,QAAQ,CAAC,IAAiB,CAAC,CAAC;IACpC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, describe } from \"../../proxies/describe/handler.js\";\n\nexport default {\n  desc: \"Describes a proxy configuration for a fleet\",\n  command: \"describe\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies describe\",\n    });\n    await describe(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../src/cmds/proxies/describe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAe;IACb,IAAI,EAAE,6CAA6C;IACnD,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,kDAAkD,CAAC;aACzD,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC;aACvB,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,OAAO,CAAC;YACP;gBACE,0CAA0C;gBAC1C,0CAA0C;aAC3C;YACD;gBACE,+DAA+D;gBAC/D,gCAAgC;aACjC;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,wBAAwB;SAChC,CAAC,CAAC;QACH,MAAM,QAAQ,CAAC,IAAiB,CAAC,CAAC;IACpC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, describe } from \"../../proxies/describe/handler.js\";\n\nexport default {\n  desc: \"Describes a proxy configuration for a fleet\",\n  command: \"describe\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 proxies describe --fleet <fleet-id> [options]\")\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .example([\n        [\n          \"$0 proxies describe --fleet fleet_abc123\",\n          \"View the proxy configuration for a fleet\",\n        ],\n        [\n          \"$0 proxies describe --fleet fleet_abc123 --account my-account\",\n          \"Explicitly specify the account\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies describe\",\n    });\n    await describe(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/proxies/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAaV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA8Bf,OAAO;;AAjC/B,wBAwCE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cmds/proxies/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAaV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA2Cf,OAAO;;AA9C/B,wBAqDE"}

package/dist/cmds/proxies/update.js

@@ -11,6 +11,7 @@ export default {
     command: "update",
     builder: (yargs) => {
         return yargs
+            .usage("$0 proxies update --fleet <fleet-id> --configuration-file <file> [options]")
             .option("fleet", {
             type: "string",
             describe: "The fleet ID",
@@ -30,6 +31,16 @@ export default {
         })
             .demandOption(["fleet", "configuration-file"])
             .demandOption("api-key", "You must provide an API key with --api-key")
+            .example([
+            [
+                "$0 proxies update --fleet fleet_abc123 --configuration-file ./proxy-config.json",
+                "Update an existing proxy configuration for a fleet",
+            ],
+            [
+                "$0 proxies update --fleet fleet_abc123 --configuration-file ./updated-config.json --account my-account",
+                "Explicitly specify the account",
+            ],
+        ])
             .middleware([
             setBlocking,
             authenticate,

package/dist/cmds/proxies/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cmds/proxies/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEpE,eAAe;IACb,IAAI,EAAE,qDAAqD;IAC3D,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC5B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,iCAAiC;SAC5C,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;aAC7C,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAiB,CAAC,CAAC;IAClC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, update } from \"../../proxies/update/handler.js\";\n\nexport default {\n  desc: \"Updates an existing proxy configuration for a fleet\",\n  command: \"update\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"configuration-file\", {\n        type: \"string\",\n        describe: \"Path to JSON configuration file\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\", \"configuration-file\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies update\",\n    });\n    await update(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cmds/proxies/update.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,WAAW,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAa,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEpE,eAAe;IACb,IAAI,EAAE,qDAAqD;IAC3D,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CACJ,4EAA4E,CAC7E;aACA,MAAM,CAAC,OAAO,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC;aACD,MAAM,CAAC,oBAAoB,EAAE;YAC5B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,iCAAiC;SAC5C,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,wBAAwB;YAClC,MAAM,EAAE,SAAS;SAClB,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,kBAAkB;SAC7B,CAAC;aACD,YAAY,CAAC,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;aAC7C,YAAY,CAAC,SAAS,EAAE,4CAA4C,CAAC;aACrE,OAAO,CAAC;YACP;gBACE,iFAAiF;gBACjF,oDAAoD;aACrD;YACD;gBACE,wGAAwG;gBACxG,gCAAgC;aACjC;SACF,CAAC;aACD,UAAU,CAAC;YACV,WAAW;YACX,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,aAAa;YACb,QAAQ;SACT,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,KAAK,EAAE,sBAAsB;SAC9B,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAiB,CAAC,CAAC;IAClC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { authenticate } from \"../../common/middleware/authentication.js\";\nimport { fetchAccount } from \"../../common/middleware/get-account-param.js\";\nimport { configure } from \"../../common/middleware/user-configuration.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { validateFleet } from \"../../common/middleware/validate-fleet.js\";\nimport setBlocking from \"../../common/output.js\";\nimport { Arguments, update } from \"../../proxies/update/handler.js\";\n\nexport default {\n  desc: \"Updates an existing proxy configuration for a fleet\",\n  command: \"update\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\n        \"$0 proxies update --fleet <fleet-id> --configuration-file <file> [options]\"\n      )\n      .option(\"fleet\", {\n        type: \"string\",\n        describe: \"The fleet ID\",\n      })\n      .option(\"configuration-file\", {\n        type: \"string\",\n        describe: \"Path to JSON configuration file\",\n      })\n      .option(\"api-key\", {\n        type: \"string\",\n        describe: \"The API Key from Zuplo\",\n        envVar: \"API_KEY\",\n      })\n      .option(\"account\", {\n        type: \"string\",\n        describe: \"The account name\",\n      })\n      .demandOption([\"fleet\", \"configuration-file\"])\n      .demandOption(\"api-key\", \"You must provide an API key with --api-key\")\n      .example([\n        [\n          \"$0 proxies update --fleet fleet_abc123 --configuration-file ./proxy-config.json\",\n          \"Update an existing proxy configuration for a fleet\",\n        ],\n        [\n          \"$0 proxies update --fleet fleet_abc123 --configuration-file ./updated-config.json --account my-account\",\n          \"Explicitly specify the account\",\n        ],\n      ])\n      .middleware([\n        setBlocking,\n        authenticate,\n        configure,\n        fetchAccount,\n        validateFleet,\n        identify,\n      ]);\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      event: \"zuplo proxies update\",\n    });\n    await update(argv as Arguments);\n  },\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"import-openapi.d.ts","sourceRoot":"","sources":["../../../src/cmds/source/import-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;;qBASV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAoBf,OAAO;;AAxB/B,wBAgCE"}
+{"version":3,"file":"import-openapi.d.ts","sourceRoot":"","sources":["../../../src/cmds/source/import-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;;qBASV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAuBf,OAAO;;AA3B/B,wBAmCE"}

package/dist/cmds/source/import-openapi.js

@@ -7,6 +7,7 @@ export default {
     deprecated: "Use 'zuplo oas merge' instead",
     builder: (yargs) => {
         return yargs
+            .usage("$0 source import-openapi --source <file> --destination <file> [options]")
             .option("source", {
             type: "string",
             describe: "The OpenAPI file to import",

package/dist/cmds/source/import-openapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-openapi.js","sourceRoot":"","sources":["../../../src/cmds/source/import-openapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAa,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE3E,eAAe;IACb,IAAI,EAAE,0EAA0E;IAChF,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,+BAA+B;IAC3C,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,4BAA4B;YACtC,SAAS,EAAE,CAAC,YAAY,CAAC;SAC1B,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,QAAQ,EACN,+EAA+E;SAClF,CAAC;aACD,YAAY,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;aACvC,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,uDAAuD;YACjE,OAAO,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;YACxC,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,yBAAyB,CACvB,6FAA6F,CAC9F,CAAC;QACF,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;QACnE,MAAM,aAAa,CAAC,IAAiB,CAAC,CAAC;IACzC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { printDiagnosticsToConsole } from \"../../common/output.js\";\nimport { Arguments, importOpenApi } from \"../../open-api/merge/handler.js\";\n\nexport default {\n  desc: \"Import an OpenAPI file into your Zuplo project (use 'oas merge' instead)\",\n  command: \"import-openapi\",\n  deprecated: \"Use 'zuplo oas merge' instead\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .option(\"source\", {\n        type: \"string\",\n        describe: \"The OpenAPI file to import\",\n        conflicts: [\"source-url\"],\n      })\n      .option(\"destination\", {\n        type: \"string\",\n        describe:\n          \"The destination file name. Defaults to the inferred path from the source name\",\n      })\n      .demandOption([\"source\", \"destination\"])\n      .option(\"merge-mode\", {\n        type: \"string\",\n        describe: \"The merge mode to use when importing the OpenAPI file\",\n        choices: [\"path-method\", \"operation-id\"],\n        default: \"path-method\",\n      });\n  },\n  handler: async (argv: unknown) => {\n    printDiagnosticsToConsole(\n      \"WARNING: 'zuplo source import-openapi' is deprecated. Please use 'zuplo oas merge' instead.\"\n    );\n    printDiagnosticsToConsole(\"\");\n    await captureEvent({ argv, event: \"zuplo source import-openapi\" });\n    await importOpenApi(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"import-openapi.js","sourceRoot":"","sources":["../../../src/cmds/source/import-openapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAa,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE3E,eAAe;IACb,IAAI,EAAE,0EAA0E;IAChF,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,+BAA+B;IAC3C,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CACJ,yEAAyE,CAC1E;aACA,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,4BAA4B;YACtC,SAAS,EAAE,CAAC,YAAY,CAAC;SAC1B,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,QAAQ,EACN,+EAA+E;SAClF,CAAC;aACD,YAAY,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;aACvC,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,uDAAuD;YACjE,OAAO,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;YACxC,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,yBAAyB,CACvB,6FAA6F,CAC9F,CAAC;QACF,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;QACnE,MAAM,aAAa,CAAC,IAAiB,CAAC,CAAC;IACzC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { printDiagnosticsToConsole } from \"../../common/output.js\";\nimport { Arguments, importOpenApi } from \"../../open-api/merge/handler.js\";\n\nexport default {\n  desc: \"Import an OpenAPI file into your Zuplo project (use 'oas merge' instead)\",\n  command: \"import-openapi\",\n  deprecated: \"Use 'zuplo oas merge' instead\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\n        \"$0 source import-openapi --source <file> --destination <file> [options]\"\n      )\n      .option(\"source\", {\n        type: \"string\",\n        describe: \"The OpenAPI file to import\",\n        conflicts: [\"source-url\"],\n      })\n      .option(\"destination\", {\n        type: \"string\",\n        describe:\n          \"The destination file name. Defaults to the inferred path from the source name\",\n      })\n      .demandOption([\"source\", \"destination\"])\n      .option(\"merge-mode\", {\n        type: \"string\",\n        describe: \"The merge mode to use when importing the OpenAPI file\",\n        choices: [\"path-method\", \"operation-id\"],\n        default: \"path-method\",\n      });\n  },\n  handler: async (argv: unknown) => {\n    printDiagnosticsToConsole(\n      \"WARNING: 'zuplo source import-openapi' is deprecated. Please use 'zuplo oas merge' instead.\"\n    );\n    printDiagnosticsToConsole(\"\");\n    await captureEvent({ argv, event: \"zuplo source import-openapi\" });\n    await importOpenApi(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/source/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/cmds/source/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,QAAA,MAAM,QAAQ;;;;;CAkCW,CAAC;AAE1B,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/cmds/source/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,QAAA,MAAM,QAAQ;;;;;CAiDW,CAAC;AAE1B,eAAe,QAAQ,CAAC"}

package/dist/cmds/source/migrate.js

@@ -11,6 +11,7 @@ const commands = {
         describe: "Migrates legacy dev portal configuration to the new dev portal format",
         command: "dev-portal",
         builder: (yargs) => yargs
+            .usage("$0 source migrate dev-portal [options]")
             .option("dir", {
             type: "string",
             describe: "The directory containing your Zuplo project and dev portal config",
@@ -22,6 +23,20 @@ const commands = {
             describe: "Force overwrite of existing files",
             default: false,
         })
+            .example([
+            [
+                "$0 source migrate dev-portal",
+                "Migrate legacy dev portal configuration to new format",
+            ],
+            [
+                "$0 source migrate dev-portal --dir ./my-project",
+                "Specify the project directory path",
+            ],
+            [
+                "$0 source migrate dev-portal --force",
+                "Force overwrite existing dev portal files during migration",
+            ],
+        ])
             .middleware([setBlocking, identify]),
         handler: async (argv) => {
             await captureEvent({