@codedrifters/configulator 0.0.195 → 0.0.197

package/lib/index.js

@@ -182,14 +182,17 @@ __export(index_exports, {
   AstroConfig: () => AstroConfig,
   AstroOutput: () => AstroOutput,
   AstroProject: () => AstroProject,
+  AwsCdkProject: () => AwsCdkProject,
   AwsDeployWorkflow: () => AwsDeployWorkflow,
   AwsDeploymentConfig: () => AwsDeploymentConfig,
   AwsDeploymentTarget: () => AwsDeploymentTarget,
+  AwsTeardownWorkflow: () => AwsTeardownWorkflow,
   BUILT_IN_BUNDLES: () => BUILT_IN_BUNDLES,
   CLAUDE_RULE_TARGET: () => CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID: () => COMPLETE_JOB_ID,
   DEFAULT_PRIORITY_LABELS: () => DEFAULT_PRIORITY_LABELS,
   DEFAULT_STATUS_LABELS: () => DEFAULT_STATUS_LABELS,
+  DEFAULT_TEARDOWN_BRANCH_PATTERNS: () => DEFAULT_TEARDOWN_BRANCH_PATTERNS,
   DEFAULT_TYPE_LABELS: () => DEFAULT_TYPE_LABELS,
   JsiiFaker: () => JsiiFaker,
   MCP_TRANSPORT: () => MCP_TRANSPORT,
@@ -5639,8 +5642,14 @@ var TestRunner = {
 };
 var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProject {
   constructor(userOptions) {
-    const pnpmVersion = userOptions.parent && userOptions.parent instanceof MonorepoProject ? userOptions.parent.pnpmVersion : VERSION.PNPM_VERSION;
-    const pnpmWorkspace = userOptions.parent && userOptions.parent instanceof MonorepoProject ? PnpmWorkspace.of(userOptions.parent) : void 0;
+    if (!(userOptions.parent instanceof MonorepoProject)) {
+      throw new Error(
+        "TypeScriptProject must be parented to a MonorepoProject. Pass `parent: <MonorepoProject>` in the project options."
+      );
+    }
+    const parent = userOptions.parent;
+    const pnpmVersion = parent.pnpmVersion;
+    const pnpmWorkspace = PnpmWorkspace.of(parent);
     const testRunner = userOptions.testRunner ?? TestRunner.JEST;
     const useJest = testRunner === TestRunner.JEST;
     const defaultOptions = {
@@ -5906,44 +5915,20 @@ var DEFAULT_INDEX_ASTRO = `---
 var DEFAULT_FAVICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128"><path d="M64 8a56 56 0 1 0 0 112A56 56 0 0 0 64 8Z" fill="#ff5d01"/></svg>
 `;
 
-// src/typescript/typescript-config.ts
-var import_node_path2 = require("path");
-var import_projen18 = require("projen");
-var import_path2 = require("projen/lib/util/path");
-var TypeScriptConfig = class extends import_projen18.Component {
-  constructor(project) {
-    super(project);
-    let tsPaths = {};
-    const workspaceDeps = project.deps.all.filter(
-      (d) => d.version === "workspace:*"
-    );
-    workspaceDeps.forEach((dep) => {
-      const subproject = project.root.subprojects.find((p) => p.package.packageName === dep.name);
-      if (!subproject) {
-        throw new Error(`Could not find subproject ${dep.name} in monorepo.`);
-      }
-      tsPaths = {
-        ...tsPaths,
-        [dep.name]: [
-          (0, import_path2.ensureRelativePathStartsWithDot)(
-            (0, import_node_path2.relative)(project.outdir, subproject.outdir)
-          )
-        ]
-      };
-    });
-    project.tsconfig?.file.addOverride("compilerOptions.paths", tsPaths);
-    project.tsconfigDev?.file.addOverride("compilerOptions.paths", tsPaths);
-  }
-};
+// src/projects/aws-cdk-project.ts
+var import_projen20 = require("projen");
+var import_javascript5 = require("projen/lib/javascript");
+var import_release2 = require("projen/lib/release");
+var import_ts_deepmerge3 = require("ts-deepmerge");
 
 // src/workflows/aws-deploy-workflow.ts
 var import_utils11 = __toESM(require_lib());
-var import_projen19 = require("projen");
+var import_projen18 = require("projen");
 var import_build = require("projen/lib/build");
 var import_github2 = require("projen/lib/github");
 var import_workflows_model5 = require("projen/lib/github/workflows-model");
 var PROD_DEPLOY_NAME = "prod-deploy";
-var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen19.Component {
+var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Component {
   constructor(project, options = {}) {
     super(project);
     this.project = project;
@@ -6206,6 +6191,433 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen19.Compone
     super.preSynthesize();
   }
 };
+
+// src/workflows/aws-teardown-workflow.ts
+var import_projen19 = require("projen");
+var import_github3 = require("projen/lib/github");
+var import_workflows_model6 = require("projen/lib/github/workflows-model");
+var DEFAULT_TEARDOWN_BRANCH_PATTERNS = [
+  "feat/*",
+  "fix/*",
+  "feature/*"
+];
+var resolveBranchPatterns = (explicit, targets) => {
+  if (explicit && explicit.length > 0) {
+    return [...explicit];
+  }
+  const derived = Array.from(
+    new Set(
+      targets.flatMap((target) => target.branches.map((b) => b.branch)).filter((branch) => typeof branch === "string").filter((branch) => branch.includes("*"))
+    )
+  );
+  if (derived.length > 0) {
+    return derived;
+  }
+  return [...DEFAULT_TEARDOWN_BRANCH_PATTERNS];
+};
+var AwsTeardownWorkflow = class extends import_projen19.Component {
+  constructor(rootProject, options) {
+    super(rootProject);
+    this.rootProject = rootProject;
+    const {
+      awsDestructionTargets,
+      repoTagName,
+      stageTypeTagName,
+      environmentTypeTagName,
+      branchNameTagName,
+      deleteBranchPatterns
+    } = options;
+    if (!repoTagName) {
+      throw new Error("AwsTeardownWorkflow requires `repoTagName`");
+    }
+    if (!stageTypeTagName) {
+      throw new Error("AwsTeardownWorkflow requires `stageTypeTagName`");
+    }
+    if (!environmentTypeTagName) {
+      throw new Error("AwsTeardownWorkflow requires `environmentTypeTagName`");
+    }
+    if (!branchNameTagName) {
+      throw new Error("AwsTeardownWorkflow requires `branchNameTagName`");
+    }
+    if (!(rootProject instanceof MonorepoProject)) {
+      throw new Error(
+        "AwsTeardownWorkflow requires the root project to be a MonorepoProject"
+      );
+    }
+    const github = import_github3.GitHub.of(this.rootProject);
+    if (!github) {
+      throw new Error(
+        "AwsTeardownWorkflow requires a GitHub component in the root project"
+      );
+    }
+    const branchPatterns = resolveBranchPatterns(
+      deleteBranchPatterns,
+      awsDestructionTargets
+    );
+    const workflow = new import_github3.GithubWorkflow(github, "teardown-dev");
+    workflow.on({
+      workflowDispatch: {},
+      schedule: [
+        {
+          cron: "32 6 * * *"
+        }
+      ],
+      delete: {
+        branches: branchPatterns
+      }
+    });
+    awsDestructionTargets.forEach((target) => {
+      const {
+        awsStageType,
+        deploymentTargetRole,
+        account,
+        region,
+        ciDeploymentConfig
+      } = target;
+      const { roleArn } = ciDeploymentConfig ?? {};
+      workflow.addJob(
+        `teardown-${awsStageType}-${deploymentTargetRole}-${account}-${region}`.toLowerCase(),
+        {
+          name: `Teardown Stacks in ${awsStageType}/${deploymentTargetRole}/${account}/${region}`,
+          runsOn: ["ubuntu-latest"],
+          permissions: {
+            contents: import_workflows_model6.JobPermission.READ,
+            idToken: import_workflows_model6.JobPermission.WRITE
+          },
+          env: {
+            REPO: "${{ github.repository }}",
+            REGIONS: [region].join(" ")
+          },
+          steps: [
+            {
+              name: `AWS Creds ${account}/${region}`,
+              uses: "aws-actions/configure-aws-credentials@v6",
+              with: {
+                "role-to-assume": roleArn,
+                "aws-region": region,
+                "role-duration-seconds": 900
+              }
+            },
+            {
+              name: "Fetch All Branches",
+              id: "fetch_branches",
+              uses: "actions/github-script@v9",
+              with: {
+                script: [
+                  "const all = await github.paginate(github.rest.repos.listBranches, {",
+                  "  owner: context.repo.owner,",
+                  "  repo: context.repo.repo,",
+                  "  per_page: 100",
+                  "});",
+                  "const names = all.map(b => b.name);",
+                  "console.log(`Found branches: ${names}`);",
+                  'core.setOutput("json", JSON.stringify(names));'
+                ].join("\n")
+              }
+            },
+            {
+              name: "Save Branches to File",
+              run: [
+                'echo "Saving branches to file"',
+                "echo '${{ steps.fetch_branches.outputs.json }}' | jq -r '.[]' | sort -u > branches.txt",
+                'echo "Branches:"',
+                "cat branches.txt"
+              ].join("\n")
+            },
+            {
+              name: "Find Stacks by Tag",
+              id: "find_stacks",
+              run: [
+                "set -euo pipefail",
+                ": > candidates.txt  # columns: arn region branchTag",
+                "# Build tag filters",
+                `TAG_FILTERS=( "Key=${repoTagName},Values=$REPO" )`,
+                `TAG_FILTERS+=( "Key=${stageTypeTagName},Values=${awsStageType}" )`,
+                `TAG_FILTERS+=( "Key=${environmentTypeTagName},Values=${deploymentTargetRole}" )`,
+                "for r in $REGIONS; do",
+                `  echo "Scanning region: $r"`,
+                "  aws resourcegroupstaggingapi get-resources \\",
+                '    --region "$r" \\',
+                '    --resource-type-filters "cloudformation:stack" \\',
+                '    --tag-filters "${TAG_FILTERS[@]}" \\',
+                ` | jq -r --arg r "$r" '`,
+                "    .ResourceTagMappingList[]",
+                "    | . as $res",
+                `    | ($res.Tags[] | select(.Key=="${branchNameTagName}") | .Value) as $branch`,
+                '    | [$res.ResourceARN, $r, ($branch // "")]',
+                "    | @tsv",
+                "    ' >> candidates.txt",
+                "done",
+                "echo 'Tagged stacks:'",
+                `(echo -e "ARN\\tREGION\\tBRANCH"; cat candidates.txt) | column -t -s $'\\t'`
+              ].join("\n")
+            },
+            {
+              name: "Determine Orphan Stacks (No Matching Branch)",
+              run: [
+                "set -euo pipefail",
+                ": > orphans.txt  # arn region branch",
+                "while IFS=$'\\t' read -r arn region branch; do",
+                '  [ -z "$arn" ] && continue',
+                '  if [ -z "$branch" ]; then',
+                "    # If no Branch tag, treat as not-a-preview; skip",
+                "    continue",
+                "  fi",
+                '  if ! grep -Fxq "$branch" branches.txt; then',
+                '    echo -e "$arn\\t$region\\t$branch" >> orphans.txt',
+                "  fi",
+                "done < candidates.txt",
+                "",
+                "if [ -s orphans.txt ]; then",
+                '  echo "Orphan stacks (no matching branch):"',
+                `  (echo -e "ARN\\tREGION\\tBRANCH"; cat orphans.txt) | column -t -s $'\\t'`,
+                "else",
+                '  echo "No orphan stacks found."',
+                "fi"
+              ].join("\n")
+            },
+            {
+              name: "Delete Orphan Stacks",
+              if: "hashFiles('orphans.txt') != ''",
+              run: [
+                "set -euo pipefail",
+                "while IFS=$'\\t' read -r arn region branch; do",
+                '  [ -z "$arn" ] && continue',
+                `  stack_name=$(cut -d'/' -f2 <<<"$arn")`,
+                '  echo "Deleting $stack_name (branch=$branch) in $region"',
+                '  aws cloudformation delete-stack --region "$region" --stack-name "$stack_name" || true',
+                "done < orphans.txt"
+              ].join("\n")
+            }
+          ]
+        }
+      );
+    });
+  }
+};
+
+// src/projects/aws-cdk-project.ts
+var AwsCdkProject = class extends import_projen20.awscdk.AwsCdkTypeScriptApp {
+  constructor(userOptions) {
+    if (!(userOptions.parent instanceof MonorepoProject)) {
+      throw new Error(
+        "AwsCdkProject must be parented to a MonorepoProject. Pass `parent: <MonorepoProject>` in the project options."
+      );
+    }
+    const parent = userOptions.parent;
+    const pnpmVersion = parent.pnpmVersion;
+    const pnpmWorkspace = PnpmWorkspace.of(parent);
+    const testRunner = userOptions.testRunner ?? TestRunner.JEST;
+    const useJest = testRunner === TestRunner.JEST;
+    const defaultOptions = {
+      defaultReleaseBranch: "main",
+      /**
+       * Enable reset task by default.
+       */
+      resetTask: true,
+      /**
+       * Packaging options.
+       */
+      packageManager: import_javascript5.NodePackageManager.PNPM,
+      pnpmVersion,
+      licensed: userOptions.license !== void 0 || false,
+      copyrightOwner: "CodeDrifters",
+      release: false,
+      /**
+       * Don't add sample code.
+       */
+      sampleCode: false,
+      /**
+       * CDK versions sourced from the configulator-managed catalog.
+       */
+      cdkVersion: VERSION.AWS_CDK_LIB_VERSION,
+      cdkCliVersion: VERSION.AWS_CDK_CLI_VERSION,
+      ...useJest ? {
+        /**
+         * Make sure jest config is stored outside of package.json and use
+         * SWC for faster compilation (matches TypeScriptProject).
+         */
+        jestOptions: {
+          configFilePath: "jest.config.json",
+          jestConfig: {
+            roots: [`<rootDir>/src`],
+            transform: {
+              ["^.+\\.[t]sx?$"]: new import_javascript5.Transform("@swc/jest")
+            },
+            moduleFileExtensions: ["js", "ts"]
+          }
+        },
+        devDeps: ["@swc/jest", "@swc/core"]
+      } : {
+        jest: false,
+        devDeps: []
+      },
+      /**
+       * Turn on prettier formatting.
+       */
+      prettier: true,
+      /**
+       * Don't package test files.
+       */
+      npmIgnoreOptions: {
+        ignorePatterns: ["*.spec.*", "*.test.*"]
+      },
+      /**
+       * Options for the automated dependency upgrade task / workflow.
+       * Exclude any packages managed by the parent project's default catalog
+       * so the catalog stays the source of truth.
+       */
+      depsUpgrade: true,
+      depsUpgradeOptions: {
+        workflow: false,
+        exclude: Object.keys(pnpmWorkspace?.defaultCatalog || {}),
+        workflowOptions: {
+          schedule: import_javascript5.UpgradeDependenciesSchedule.WEEKLY
+        },
+        cooldown: 1
+      },
+      /**
+       * Only release when the package source content or package.json changes.
+       */
+      releaseTrigger: import_release2.ReleaseTrigger.continuous({
+        paths: [
+          `${userOptions.outdir}/src/**`,
+          `${userOptions.outdir}/package.json`
+        ]
+      })
+    };
+    const options = (0, import_ts_deepmerge3.merge)(defaultOptions, userOptions);
+    super(options);
+    this.addDevDeps("@types/node@catalog:");
+    this.tsconfig?.addExclude("**/*.test.*");
+    this.tsconfig?.addExclude("**/*.spec.*");
+    if (testRunner === TestRunner.VITEST) {
+      new Vitest(this, {
+        config: {
+          include: ["src/**/*.{test,spec}.?(c|m)[jt]s?(x)"],
+          ...options.vitestOptions?.config
+        },
+        ...options.vitestOptions
+      });
+    } else {
+      this.deps.removeDependency("ts-jest");
+    }
+    this.package.file.addOverride(
+      "packageManager",
+      `pnpm@${options.pnpmVersion}`
+    );
+    this.eslint?.addOverride({
+      files: ["**/*.test.*", "**/*.spec.*"],
+      rules: {
+        "import/no-extraneous-dependencies": "off"
+      }
+    });
+    this.gitignore?.addPatterns(".DS_Store", "test-reports", "cdk.out");
+    this.npmignore?.addPatterns("*.spec.*", "*.test.*", "__fixtures__");
+    new AwsDeploymentConfig(this);
+    (options.deploymentTargets ?? []).forEach(
+      (targetOptions) => this.addDeploymentTarget(targetOptions)
+    );
+    const targetsForAutoDerive = AwsDeploymentConfig.of(this)?.awsDeploymentTargets ?? [];
+    const deployWorkflows = options.deployWorkflows ?? Array.from(new Set(targetsForAutoDerive.map((t) => t.awsStageType))).map(
+      (awsStageType) => ({
+        awsStageType,
+        buildWorkflow: options.sharedBuildWorkflow
+      })
+    );
+    deployWorkflows.forEach(
+      (workflowOptions) => new AwsDeployWorkflow(this, workflowOptions)
+    );
+    if (options.teardownWorkflow) {
+      new AwsTeardownWorkflow(parent, options.teardownWorkflow);
+    }
+    const turboActive = TurboRepo.of(parent) !== void 0;
+    if (turboActive) {
+      const turbo = new TurboRepo(this);
+      turbo.postCompileTask?.outputs.push("dist/**");
+      turbo.postCompileTask?.inputs.push("src/**");
+    }
+    if (options.agentConfig === true || typeof options.agentConfig === "object") {
+      new AgentConfig(
+        this,
+        typeof options.agentConfig === "object" ? options.agentConfig : {}
+      );
+    }
+    if (options.resetTask !== false) {
+      const defaultResetTaskOptions = {
+        pathsToRemove: [
+          "node_modules",
+          "dist",
+          "lib",
+          "cdk.out",
+          "coverage",
+          "test-reports",
+          ".turbo",
+          "tsconfig.tsbuildinfo",
+          this.artifactsDirectory
+        ]
+      };
+      const userResetTaskOptions = options.resetTaskOptions ?? {};
+      const resetTaskOptions = (0, import_ts_deepmerge3.merge)(
+        defaultResetTaskOptions,
+        {
+          ...userResetTaskOptions,
+          pathsToRemove: [
+            ...defaultResetTaskOptions.pathsToRemove ?? [],
+            ...userResetTaskOptions.pathsToRemove ?? []
+          ]
+        }
+      );
+      new ResetTask(this, resetTaskOptions);
+    }
+    const originalResolve = this.package.resolveDepsAndWritePackageJson;
+    this.package.installDependencies = () => {
+      parent.requestInstallDependencies({
+        resolveDepsAndWritePackageJson: () => originalResolve.apply(this.package)
+      });
+    };
+    this.package.resolveDepsAndWritePackageJson = () => {
+    };
+  }
+  /**
+   * Add an AWS deployment target to this project after construction. The
+   * target is registered on the existing `AwsDeploymentConfig` and immediately
+   * available for `AwsDeployWorkflow` consumption.
+   */
+  addDeploymentTarget(options) {
+    return new AwsDeploymentTarget(this, options);
+  }
+};
+
+// src/typescript/typescript-config.ts
+var import_node_path2 = require("path");
+var import_projen21 = require("projen");
+var import_path2 = require("projen/lib/util/path");
+var TypeScriptConfig = class extends import_projen21.Component {
+  constructor(project) {
+    super(project);
+    let tsPaths = {};
+    const workspaceDeps = project.deps.all.filter(
+      (d) => d.version === "workspace:*"
+    );
+    workspaceDeps.forEach((dep) => {
+      const subproject = project.root.subprojects.find((p) => p.package.packageName === dep.name);
+      if (!subproject) {
+        throw new Error(`Could not find subproject ${dep.name} in monorepo.`);
+      }
+      tsPaths = {
+        ...tsPaths,
+        [dep.name]: [
+          (0, import_path2.ensureRelativePathStartsWithDot)(
+            (0, import_node_path2.relative)(project.outdir, subproject.outdir)
+          )
+        ]
+      };
+    });
+    project.tsconfig?.file.addOverride("compilerOptions.paths", tsPaths);
+    project.tsconfigDev?.file.addOverride("compilerOptions.paths", tsPaths);
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_MODEL,
@@ -6215,14 +6627,17 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen19.Compone
   AstroConfig,
   AstroOutput,
   AstroProject,
+  AwsCdkProject,
   AwsDeployWorkflow,
   AwsDeploymentConfig,
   AwsDeploymentTarget,
+  AwsTeardownWorkflow,
   BUILT_IN_BUNDLES,
   CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID,
   DEFAULT_PRIORITY_LABELS,
   DEFAULT_STATUS_LABELS,
+  DEFAULT_TEARDOWN_BRANCH_PATTERNS,
   DEFAULT_TYPE_LABELS,
   JsiiFaker,
   MCP_TRANSPORT,