@zuplo/cli 7.9.12 → 7.9.13

package/dist/__tests__/integration/source-upgrade.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source-upgrade.integration.test.d.ts.map

package/dist/__tests__/integration/source-upgrade.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-upgrade.integration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/source-upgrade.integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/integration/source-upgrade.integration.test.js

@@ -0,0 +1,100 @@
+import yargs from "yargs/yargs";
+import upgrade from "../../cmds/source/upgrade.js";
+import { shutdownAnalytics } from "../../common/analytics/lib.js";
+import { upgradeGateway } from "../../source/ai-gateway/handler.js";
+import { update } from "../../source/update/handler.js";
+jest.mock("../../source/update/handler.js", () => ({
+    update: jest.fn().mockResolvedValue(undefined),
+}));
+jest.mock("../../source/ai-gateway/handler.js", () => ({
+    upgradeGateway: jest.fn().mockResolvedValue(0),
+}));
+jest.mock("../../common/analytics/lib.js", () => ({
+    captureEvent: jest.fn().mockResolvedValue(undefined),
+    shutdownAnalytics: jest.fn().mockResolvedValue(undefined),
+}));
+jest.mock("../../common/middleware/user-identification.js", () => ({
+    identify: jest.fn(),
+}));
+jest.mock("../../common/validators/file-system-validator.js", () => ({
+    ZuploProjectValidator: jest.fn().mockImplementation(() => ({
+        validate: jest.fn().mockResolvedValue({ ok: true }),
+    })),
+}));
+const originalArgv = process.argv;
+const originalEnv = { ...process.env };
+afterEach(() => {
+    process.argv = originalArgv;
+    for (const key of Object.keys(process.env))
+        if (!(key in originalEnv))
+            delete process.env[key];
+    Object.assign(process.env, originalEnv);
+    jest.clearAllMocks();
+});
+async function run(args) {
+    process.argv = ["node", "zuplo", "source", ...args];
+    return yargs(args)
+        .env("ZUPLO")
+        .option("prompt", { type: "boolean", default: true })
+        .command(upgrade)
+        .exitProcess(false)
+        .fail((message, error) => {
+        throw error ?? new Error(message);
+    })
+        .parseAsync();
+}
+describe("source upgrade command compatibility", () => {
+    it("preserves the existing invocation and explicit api type", async () => {
+        await run(["upgrade"]);
+        expect(update).toHaveBeenCalledWith(expect.objectContaining({ dir: ".", prompt: true }));
+        expect(upgradeGateway).not.toHaveBeenCalled();
+        await run(["upgrade", "--type", "api"]);
+        expect(update).toHaveBeenCalledTimes(2);
+    });
+    it.each([["--type", "ai-gateway"], ["--type=ai-gateway"]])("routes type spelling %j to preview only", async (...args) => {
+        await run(["upgrade", ...args]);
+        expect(upgradeGateway).toHaveBeenCalledWith(expect.objectContaining({ type: "ai-gateway", apply: false }));
+        expect(update).not.toHaveBeenCalled();
+    });
+    it("supports the type environment variable without enabling application", async () => {
+        process.env.ZUPLO_TYPE = "ai-gateway";
+        await run(["upgrade"]);
+        expect(upgradeGateway).toHaveBeenCalledWith(expect.objectContaining({ apply: false }));
+    });
+    it.each(["--apply", "--apply=true"])("accepts explicit %s and noninteractive confirmation", async (apply) => {
+        await run(["upgrade", "--type=ai-gateway", apply, "--prompt=false"]);
+        expect(upgradeGateway).toHaveBeenCalledWith(expect.objectContaining({ apply: true, prompt: false }));
+    });
+    it("rejects an environment-only apply and unsupported types", async () => {
+        process.env.ZUPLO_APPLY = "true";
+        await expect(run(["upgrade", "--type", "ai-gateway"])).rejects.toThrow(/explicitly supplied/);
+        delete process.env.ZUPLO_APPLY;
+        await expect(run(["upgrade", "--type", "unknown"])).rejects.toThrow();
+        await expect(run(["upgrade", "--apply"])).rejects.toThrow(/requires --type/);
+        expect(update).not.toHaveBeenCalled();
+        expect(upgradeGateway).not.toHaveBeenCalled();
+    });
+    it("keeps existing dir and prompt flag spellings", async () => {
+        for (const args of [
+            ["--dir", "./example", "--prompt", "false"],
+            ["--dir=./example", "--prompt=false"],
+        ]) {
+            await run(["upgrade", ...args]);
+            expect(update).toHaveBeenLastCalledWith(expect.objectContaining({ dir: "example", prompt: false }));
+        }
+    });
+    it.each([false, true])("preserves the blocked exit code with analytics rejection=%s", async (reject) => {
+        if (reject)
+            jest
+                .mocked(shutdownAnalytics)
+                .mockRejectedValueOnce(new Error("analytics failed"));
+        jest.mocked(upgradeGateway).mockResolvedValueOnce(2);
+        const exit = jest.spyOn(process, "exit").mockImplementation(() => {
+            throw new Error("exit");
+        });
+        await expect(run(["upgrade", "--type=ai-gateway"])).rejects.toThrow("exit");
+        expect(exit).toHaveBeenCalledWith(2);
+        exit.mockRestore();
+    });
+});
+//# sourceMappingURL=source-upgrade.integration.test.js.map

package/dist/__tests__/integration/source-upgrade.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-upgrade.integration.test.js","sourceRoot":"","sources":["../../../src/__tests__/integration/source-upgrade.integration.test.ts"],"names":[],"mappings":"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","sourcesContent":["import yargs from \"yargs/yargs\";\nimport upgrade from \"../../cmds/source/upgrade.js\";\nimport { shutdownAnalytics } from \"../../common/analytics/lib.js\";\nimport { upgradeGateway } from \"../../source/ai-gateway/handler.js\";\nimport { update } from \"../../source/update/handler.js\";\n\njest.mock(\"../../source/update/handler.js\", () => ({\n  update: jest.fn().mockResolvedValue(undefined),\n}));\njest.mock(\"../../source/ai-gateway/handler.js\", () => ({\n  upgradeGateway: jest.fn().mockResolvedValue(0),\n}));\njest.mock(\"../../common/analytics/lib.js\", () => ({\n  captureEvent: jest.fn().mockResolvedValue(undefined),\n  shutdownAnalytics: jest.fn().mockResolvedValue(undefined),\n}));\njest.mock(\"../../common/middleware/user-identification.js\", () => ({\n  identify: jest.fn(),\n}));\njest.mock(\"../../common/validators/file-system-validator.js\", () => ({\n  ZuploProjectValidator: jest.fn().mockImplementation(() => ({\n    validate: jest.fn().mockResolvedValue({ ok: true }),\n  })),\n}));\n\nconst originalArgv = process.argv;\nconst originalEnv = { ...process.env };\nafterEach(() => {\n  process.argv = originalArgv;\n  for (const key of Object.keys(process.env))\n    if (!(key in originalEnv)) delete process.env[key];\n  Object.assign(process.env, originalEnv);\n  jest.clearAllMocks();\n});\nasync function run(args: string[]) {\n  process.argv = [\"node\", \"zuplo\", \"source\", ...args];\n  return yargs(args)\n    .env(\"ZUPLO\")\n    .option(\"prompt\", { type: \"boolean\", default: true })\n    .command(upgrade)\n    .exitProcess(false)\n    .fail((message, error) => {\n      throw error ?? new Error(message);\n    })\n    .parseAsync();\n}\n\ndescribe(\"source upgrade command compatibility\", () => {\n  it(\"preserves the existing invocation and explicit api type\", async () => {\n    await run([\"upgrade\"]);\n    expect(update).toHaveBeenCalledWith(\n      expect.objectContaining({ dir: \".\", prompt: true })\n    );\n    expect(upgradeGateway).not.toHaveBeenCalled();\n    await run([\"upgrade\", \"--type\", \"api\"]);\n    expect(update).toHaveBeenCalledTimes(2);\n  });\n  it.each([[\"--type\", \"ai-gateway\"], [\"--type=ai-gateway\"]])(\n    \"routes type spelling %j to preview only\",\n    async (...args) => {\n      await run([\"upgrade\", ...args]);\n      expect(upgradeGateway).toHaveBeenCalledWith(\n        expect.objectContaining({ type: \"ai-gateway\", apply: false })\n      );\n      expect(update).not.toHaveBeenCalled();\n    }\n  );\n  it(\"supports the type environment variable without enabling application\", async () => {\n    process.env.ZUPLO_TYPE = \"ai-gateway\";\n    await run([\"upgrade\"]);\n    expect(upgradeGateway).toHaveBeenCalledWith(\n      expect.objectContaining({ apply: false })\n    );\n  });\n  it.each([\"--apply\", \"--apply=true\"])(\n    \"accepts explicit %s and noninteractive confirmation\",\n    async (apply) => {\n      await run([\"upgrade\", \"--type=ai-gateway\", apply, \"--prompt=false\"]);\n      expect(upgradeGateway).toHaveBeenCalledWith(\n        expect.objectContaining({ apply: true, prompt: false })\n      );\n    }\n  );\n  it(\"rejects an environment-only apply and unsupported types\", async () => {\n    process.env.ZUPLO_APPLY = \"true\";\n    await expect(run([\"upgrade\", \"--type\", \"ai-gateway\"])).rejects.toThrow(\n      /explicitly supplied/\n    );\n    delete process.env.ZUPLO_APPLY;\n    await expect(run([\"upgrade\", \"--type\", \"unknown\"])).rejects.toThrow();\n    await expect(run([\"upgrade\", \"--apply\"])).rejects.toThrow(\n      /requires --type/\n    );\n    expect(update).not.toHaveBeenCalled();\n    expect(upgradeGateway).not.toHaveBeenCalled();\n  });\n  it(\"keeps existing dir and prompt flag spellings\", async () => {\n    for (const args of [\n      [\"--dir\", \"./example\", \"--prompt\", \"false\"],\n      [\"--dir=./example\", \"--prompt=false\"],\n    ]) {\n      await run([\"upgrade\", ...args]);\n      expect(update).toHaveBeenLastCalledWith(\n        expect.objectContaining({ dir: \"example\", prompt: false })\n      );\n    }\n  });\n  it.each([false, true])(\n    \"preserves the blocked exit code with analytics rejection=%s\",\n    async (reject) => {\n      if (reject)\n        jest\n          .mocked(shutdownAnalytics)\n          .mockRejectedValueOnce(new Error(\"analytics failed\"));\n      jest.mocked(upgradeGateway).mockResolvedValueOnce(2);\n      const exit = jest.spyOn(process, \"exit\").mockImplementation(() => {\n        throw new Error(\"exit\");\n      });\n      await expect(run([\"upgrade\", \"--type=ai-gateway\"])).rejects.toThrow(\n        \"exit\"\n      );\n      expect(exit).toHaveBeenCalledWith(2);\n      exit.mockRestore();\n    }\n  );\n});\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cmds/source/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAUV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBA2Bf,OAAO;;AA9B/B,wBAkCE"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cmds/source/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAWV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAgEf,OAAO;;AAnE/B,wBAiFE"}

package/dist/cmds/source/upgrade.js

@@ -1,7 +1,8 @@
-import { captureEvent } from "../../common/analytics/lib.js";
+import { captureEvent, shutdownAnalytics } from "../../common/analytics/lib.js";
 import { identify } from "../../common/middleware/user-identification.js";
 import { ZuploProjectValidator } from "../../common/validators/file-system-validator.js";
 import { YargsChecker } from "../../common/validators/lib.js";
+import { upgradeGateway } from "../../source/ai-gateway/handler.js";
 import { update } from "../../source/update/handler.js";
 export default {
     desc: "Updates your project structure to the latest conventions",
@@ -9,6 +10,17 @@ export default {
     builder: (yargs) => {
         return yargs
             .usage("$0 source upgrade [options]")
+            .option("type", {
+            type: "string",
+            choices: ["api", "ai-gateway"],
+            default: "api",
+            describe: "Upgrade project scaffolding (api) or preview AI Gateway template additions",
+        })
+            .option("apply", {
+            type: "boolean",
+            default: false,
+            describe: "Apply verified AI Gateway additions after preview and confirmation",
+        })
             .option("dir", {
             type: "string",
             describe: "The directory containing your Zuplo API",
@@ -25,15 +37,46 @@ export default {
                 "$0 source upgrade --dir ./my-zuplo-project",
                 "Specify the project directory path",
             ],
+            [
+                "$0 source upgrade --type ai-gateway",
+                "Preview versioned AI Gateway additions without changing files",
+            ],
+            [
+                "$0 source upgrade --type ai-gateway --apply",
+                "Validate, preview, and confirm AI Gateway additions",
+            ],
         ])
             .middleware([identify])
             .check(async (argv) => {
+            if (typeof argv.type !== "string" || typeof argv.apply !== "boolean") {
+                throw new Error("Supply --type and --apply at most once.");
+            }
+            if (argv.apply && argv.type !== "ai-gateway") {
+                throw new Error("--apply requires --type ai-gateway.");
+            }
+            if (argv.apply &&
+                !process.argv.some((arg) => arg === "--apply" || arg === "--apply=true")) {
+                throw new Error("Applying an upgrade requires an explicitly supplied --apply flag; ZUPLO_APPLY cannot enable writes.");
+            }
             return await new YargsChecker(new ZuploProjectValidator()).check(argv);
         });
     },
     handler: async (argv) => {
         await captureEvent({ argv, event: "zuplo source upgrade" });
-        await update(argv);
+        const args = argv;
+        if (args.type === "ai-gateway") {
+            const exitCode = await upgradeGateway(args);
+            if (exitCode !== 0) {
+                try {
+                    await shutdownAnalytics();
+                }
+                finally {
+                    process.exit(exitCode);
+                }
+            }
+        }
+        else
+            await update(args);
     },
 };
 //# sourceMappingURL=upgrade.js.map

package/dist/cmds/source/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cmds/source/upgrade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAa,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAEnE,eAAe;IACb,IAAI,EAAE,0DAA0D;IAChE,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,6BAA6B,CAAC;aACpC,MAAM,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;YACnD,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;SACb,CAAC;aACD,OAAO,CAAC;YACP;gBACE,mBAAmB;gBACnB,0DAA0D;aAC3D;YACD;gBACE,4CAA4C;gBAC5C,oCAAoC;aACrC;SACF,CAAC;aACD,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC;aACtB,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,OAAO,MAAM,IAAI,YAAY,CAC3B,IAAI,qBAAqB,EAAE,CAC5B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAiB,CAAC,CAAC;IAClC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../../common/analytics/lib.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { ZuploProjectValidator } from \"../../common/validators/file-system-validator.js\";\nimport { YargsChecker } from \"../../common/validators/lib.js\";\nimport { Arguments, update } from \"../../source/update/handler.js\";\n\nexport default {\n  desc: \"Updates your project structure to the latest conventions\",\n  command: \"upgrade\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 source upgrade [options]\")\n      .option(\"dir\", {\n        type: \"string\",\n        describe: \"The directory containing your Zuplo API\",\n        default: \".\",\n        normalize: true,\n        hidden: true,\n      })\n      .example([\n        [\n          \"$0 source upgrade\",\n          \"Upgrade your project structure to the latest conventions\",\n        ],\n        [\n          \"$0 source upgrade --dir ./my-zuplo-project\",\n          \"Specify the project directory path\",\n        ],\n      ])\n      .middleware([identify])\n      .check(async (argv) => {\n        return await new YargsChecker<typeof argv>(\n          new ZuploProjectValidator()\n        ).check(argv);\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo source upgrade\" });\n    await update(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cmds/source/upgrade.ts"],"names":[],"mappings":"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","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent, shutdownAnalytics } from \"../../common/analytics/lib.js\";\nimport { identify } from \"../../common/middleware/user-identification.js\";\nimport { ZuploProjectValidator } from \"../../common/validators/file-system-validator.js\";\nimport { YargsChecker } from \"../../common/validators/lib.js\";\nimport { upgradeGateway } from \"../../source/ai-gateway/handler.js\";\nimport { Arguments, update } from \"../../source/update/handler.js\";\n\nexport default {\n  desc: \"Updates your project structure to the latest conventions\",\n  command: \"upgrade\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 source upgrade [options]\")\n      .option(\"type\", {\n        type: \"string\",\n        choices: [\"api\", \"ai-gateway\"],\n        default: \"api\",\n        describe:\n          \"Upgrade project scaffolding (api) or preview AI Gateway template additions\",\n      })\n      .option(\"apply\", {\n        type: \"boolean\",\n        default: false,\n        describe:\n          \"Apply verified AI Gateway additions after preview and confirmation\",\n      })\n      .option(\"dir\", {\n        type: \"string\",\n        describe: \"The directory containing your Zuplo API\",\n        default: \".\",\n        normalize: true,\n        hidden: true,\n      })\n      .example([\n        [\n          \"$0 source upgrade\",\n          \"Upgrade your project structure to the latest conventions\",\n        ],\n        [\n          \"$0 source upgrade --dir ./my-zuplo-project\",\n          \"Specify the project directory path\",\n        ],\n        [\n          \"$0 source upgrade --type ai-gateway\",\n          \"Preview versioned AI Gateway additions without changing files\",\n        ],\n        [\n          \"$0 source upgrade --type ai-gateway --apply\",\n          \"Validate, preview, and confirm AI Gateway additions\",\n        ],\n      ])\n      .middleware([identify])\n      .check(async (argv) => {\n        if (typeof argv.type !== \"string\" || typeof argv.apply !== \"boolean\") {\n          throw new Error(\"Supply --type and --apply at most once.\");\n        }\n        if (argv.apply && argv.type !== \"ai-gateway\") {\n          throw new Error(\"--apply requires --type ai-gateway.\");\n        }\n        if (\n          argv.apply &&\n          !process.argv.some(\n            (arg) => arg === \"--apply\" || arg === \"--apply=true\"\n          )\n        ) {\n          throw new Error(\n            \"Applying an upgrade requires an explicitly supplied --apply flag; ZUPLO_APPLY cannot enable writes.\"\n          );\n        }\n        return await new YargsChecker<typeof argv>(\n          new ZuploProjectValidator()\n        ).check(argv);\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({ argv, event: \"zuplo source upgrade\" });\n    const args = argv as Arguments & { type?: string; apply?: boolean };\n    if (args.type === \"ai-gateway\") {\n      const exitCode = await upgradeGateway(args);\n      if (exitCode !== 0) {\n        try {\n          await shutdownAnalytics();\n        } finally {\n          process.exit(exitCode);\n        }\n      }\n    } else await update(args);\n  },\n};\n"]}