Function run

packages/cli/src/commands/lambda.ts:194–417

({ args })

    json: { type: "boolean", description: "Emit machine-readable JSON" },
  },
  async run({ args }) {
    const subcommand = args.subcommand;
    if (!subcommand) {
      console.log(HELP);
      return;
    }

    const stackName =
      (args["stack-name"] as string | undefined) ??
      // Lazy-imported so the dispatcher doesn't pull state.ts (and its
      // node:fs deps) on every CLI invocation — only on lambda runs.
      (await import("./lambda/state.js")).DEFAULT_STACK_NAME;

    // Apply --profile globally before any AWS-SDK / `aws` / `sam` call runs.
    // The AWS SDK + the SAM CLI both read AWS_PROFILE from the environment,
    // so setting it here threads the value through render / progress / sites
    // (which don't take an explicit awsProfile arg) without each subverb
    // having to know about it. Region gets the same treatment so the SDK
    // clients constructed inside the SDK pick it up too.
    const profileFlag = args.profile as string | undefined;
    if (profileFlag) process.env.AWS_PROFILE = profileFlag;
    const regionFlag = args.region as string | undefined;
    if (regionFlag) process.env.AWS_REGION = regionFlag;

    // The lambda subverbs dynamic-import `@hyperframes/aws-lambda` at call
    // time. We keep aws-lambda as a workspace devDependency (not a runtime
    // dep) so the published CLI install stays small for users who don't
    // deploy to Lambda. Subverbs other than `policies` need aws-lambda;
    // catch the missing-module error here and turn it into a friendly hint.
    const verbsNeedingSDK = new Set([
      "deploy",
      "sites",
      "render",
      "render-batch",
      "progress",
      "destroy",
    ]);
    if (verbsNeedingSDK.has(subcommand)) {
      try {
        await import("@hyperframes/aws-lambda/sdk");
      } catch (err) {
        if ((err as NodeJS.ErrnoException).code === "ERR_MODULE_NOT_FOUND") {
          console.error(
            `${c.error("@hyperframes/aws-lambda is not installed.")} The ${c.accent(`hyperframes lambda ${subcommand}`)} command needs it at runtime.\n` +
              `Install it alongside the CLI:\n` +
              `  ${c.accent("npm install -g @hyperframes/aws-lambda")}\n` +
              `Or, for an opt-in dev setup:\n` +
              `  ${c.accent("npm install @hyperframes/aws-lambda")}`,
          );
          process.exit(1);
        }
        throw err;
      }
    }

    switch (subcommand) {
      case "deploy": {
        const { runDeploy } = await import("./lambda/deploy.js");