@codedrifters/configulator 0.0.196 → 0.0.198

package/lib/index.js

@@ -186,11 +186,13 @@ __export(index_exports, {
   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,
@@ -204,6 +206,7 @@ __export(index_exports, {
   ROOT_CI_TASK_NAME: () => ROOT_CI_TASK_NAME,
   ROOT_TURBO_TASK_NAME: () => ROOT_TURBO_TASK_NAME,
   ResetTask: () => ResetTask,
+  StarlightProject: () => StarlightProject,
   TestRunner: () => TestRunner,
   TurboRepo: () => TurboRepo,
   TurboRepoTask: () => TurboRepoTask,
@@ -3053,6 +3056,15 @@ var VERSION = {
    * Version of Projen to use.
    */
   PROJEN_VERSION: "0.99.48",
+  /**
+   * Version of sharp to pin for StarlightProject (required peer for
+   * Starlight's image optimization pipeline).
+   */
+  SHARP_VERSION: "0.34.5",
+  /**
+   * Version of @astrojs/starlight to pin for StarlightProject scaffolding.
+   */
+  STARLIGHT_VERSION: "0.38.3",
   /**
    * What version of the turborepo library should we use?
    */
@@ -4814,6 +4826,8 @@ var VERSION_NPM_PACKAGES = [
   { key: "AWS_CONSTRUCTS_VERSION", npmPackage: "constructs" },
   { key: "PNPM_VERSION", npmPackage: "pnpm" },
   { key: "PROJEN_VERSION", npmPackage: "projen" },
+  { key: "SHARP_VERSION", npmPackage: "sharp" },
+  { key: "STARLIGHT_VERSION", npmPackage: "@astrojs/starlight" },
   { key: "TURBO_VERSION", npmPackage: "turbo" },
   { key: "TYPES_NODE_VERSION", npmPackage: "@types/node" },
   { key: "VITEST_VERSION", npmPackage: "vitest" }
@@ -5914,7 +5928,7 @@ var DEFAULT_FAVICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0
 `;
 
 // src/projects/aws-cdk-project.ts
-var import_projen19 = require("projen");
+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");
@@ -6190,8 +6204,212 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen18.Compone
   }
 };
 
+// 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_projen19.awscdk.AwsCdkTypeScriptApp {
+var AwsCdkProject = class extends import_projen20.awscdk.AwsCdkTypeScriptApp {
   constructor(userOptions) {
     if (!(userOptions.parent instanceof MonorepoProject)) {
       throw new Error(
@@ -6322,6 +6540,9 @@ var AwsCdkProject = class extends import_projen19.awscdk.AwsCdkTypeScriptApp {
     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);
@@ -6380,11 +6601,96 @@ var AwsCdkProject = class extends import_projen19.awscdk.AwsCdkTypeScriptApp {
   }
 };
 
+// src/projects/starlight-project.ts
+var import_projen21 = require("projen");
+var StarlightProject = class extends AstroProject {
+  constructor(userOptions) {
+    const starlightConfig = buildStarlightConfig(userOptions);
+    const starlightSpec = {
+      name: "starlight",
+      importPath: "@astrojs/starlight",
+      defaultImport: true,
+      args: JSON.stringify(starlightConfig, null, 2)
+    };
+    const mergedOptions = {
+      ...userOptions,
+      integrations: [starlightSpec, ...userOptions.integrations ?? []],
+      depsUpgradeOptions: {
+        ...userOptions.depsUpgradeOptions,
+        exclude: [
+          ...userOptions.depsUpgradeOptions?.exclude ?? [],
+          "@astrojs/starlight",
+          "sharp"
+        ]
+      }
+    };
+    super(mergedOptions);
+    const starlightVersion = userOptions.starlightVersion ?? VERSION.STARLIGHT_VERSION;
+    const sharpVersion = userOptions.sharpVersion ?? VERSION.SHARP_VERSION;
+    this.addDeps(
+      `@astrojs/starlight@${starlightVersion}`,
+      `sharp@${sharpVersion}`
+    );
+    const turbo = TurboRepo.of(this);
+    if (turbo?.compileTask) {
+      turbo.compileTask.inputs.push("src/content/**");
+    }
+    if (userOptions.sampleContent === true) {
+      new import_projen21.SampleFile(this, "src/content/docs/index.mdx", {
+        contents: DEFAULT_INDEX_MDX
+      });
+      new import_projen21.SampleFile(this, "src/content/config.ts", {
+        contents: DEFAULT_CONTENT_CONFIG_TS
+      });
+    }
+  }
+};
+function buildStarlightConfig(options) {
+  const config = {
+    title: options.starlightTitle
+  };
+  if (options.starlightDescription !== void 0) {
+    config.description = options.starlightDescription;
+  }
+  if (options.social !== void 0) {
+    config.social = options.social;
+  }
+  if (options.sidebar !== void 0) {
+    config.sidebar = options.sidebar;
+  }
+  if (options.customCss !== void 0) {
+    config.customCss = options.customCss;
+  }
+  if (options.logo !== void 0) {
+    config.logo = options.logo;
+  }
+  if (options.editLink !== void 0) {
+    config.editLink = options.editLink;
+  }
+  return config;
+}
+var DEFAULT_INDEX_MDX = `---
+title: Welcome
+description: Starlight-powered documentation site.
+---
+
+# Hello, Starlight!
+
+Edit \`src/content/docs/index.mdx\` to replace this page.
+`;
+var DEFAULT_CONTENT_CONFIG_TS = `import { defineCollection } from "astro:content";
+import { docsSchema } from "@astrojs/starlight/schema";
+
+export const collections = {
+  docs: defineCollection({ schema: docsSchema() }),
+};
+`;
+
 // src/typescript/typescript-config.ts
 var import_node_path2 = require("path");
-var import_projen20 = require("projen");
+var import_projen22 = require("projen");
 var import_path2 = require("projen/lib/util/path");
-var TypeScriptConfig = class extends import_projen20.Component {
+var TypeScriptConfig = class extends import_projen22.Component {
   constructor(project) {
     super(project);
     let tsPaths = {};
@@ -6422,11 +6728,13 @@ var TypeScriptConfig = class extends import_projen20.Component {
   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,
@@ -6440,6 +6748,7 @@ var TypeScriptConfig = class extends import_projen20.Component {
   ROOT_CI_TASK_NAME,
   ROOT_TURBO_TASK_NAME,
   ResetTask,
+  StarlightProject,
   TestRunner,
   TurboRepo,
   TurboRepoTask,