Helpers

type Environment = 'sandbox' | 'development' | 'test' | 'staging' | 'production'

const SUPPORTED_CDK_ACTIONS = ['synth', 'diff', 'deploy', 'deploy:hotswap', 'destroy', 'ls'] as const

interface EnvironmentConfig {
  accountId: string;
  enableBranchDeploy: boolean;
}

getTaskName(
  environment: string,
  action: typeof SUPPORTED_CDK_ACTIONS[number],
  options?: { isBranch?: boolean; taskType?: 'all' | 'stack' }
): string

getTaskName('test', 'synth')
// → 'test:synth'

getTaskName('test', 'deploy', { taskType: 'all' })
// → 'test:deploy:all'

getTaskName('test', 'deploy', { isBranch: true, taskType: 'all' })
// → 'test:branch:deploy:all'

getTaskName('test', 'destroy', { isBranch: true, taskType: 'stack' })
// → 'test:branch:destroy:stack'

addCdkActionTask(
  cdkProject: AwsCdkTypeScriptApp,
  targetAccount: {
    CDK_DEFAULT_ACCOUNT: string;
    CDK_DEFAULT_REGION: string;
    ENVIRONMENT: string;
    GITHUB_DEPLOY_ROLE: string;
    GIT_BRANCH_REF?: string;
  }
): void

# Regular environment tasks
npm run test:synth              # Synth all test stacks
npm run test:deploy:all         # Deploy all test stacks
npm run test:deploy:stack MyStack  # Deploy specific test stack
npm run test:diff:all           # Diff all test stacks
npm run test:destroy:all        # Destroy all test stacks

# Branch deployment tasks (when GIT_BRANCH_REF is set)
npm run test:branch:synth
npm run test:branch:deploy:all
npm run test:branch:deploy:hotswap:all
npm run test:branch:destroy:all

import { addCdkActionTask } from './src/bin/env-helper';

addCdkActionTask(project, {
  CDK_DEFAULT_ACCOUNT: '987654321012',
  CDK_DEFAULT_REGION: 'us-east-1',
  ENVIRONMENT: 'test',
  GITHUB_DEPLOY_ROLE: 'GitHubActionsServiceRole',
});

// For branch deployments (line 174)
addCdkActionTask(project, {
  CDK_DEFAULT_ACCOUNT: '987654321012',
  CDK_DEFAULT_REGION: 'us-east-1',
  ENVIRONMENT: 'test',
  GITHUB_DEPLOY_ROLE: 'GitHubActionsServiceRole',
  GIT_BRANCH_REF: '$(echo ${GIT_BRANCH_REF:-$(git rev-parse --abbrev-ref HEAD)})',
});

extractCleanedBranchName(branchRef: string): string | undefined

extractCleanedBranchName('feature/user-auth')
// → 'user-auth'

extractCleanedBranchName('bugfix/fix-api-123')
// → 'fix-api-123'

extractCleanedBranchName('main')
// → undefined

extractCleanedBranchName('v1.2.3')
// → undefined

createEnvResourceName(baseName: string): string

// Regular environment deployment
process.env.ENVIRONMENT = 'test';
createEnvResourceName('MyStack')
// → 'MyStack-test'

// Branch deployment
process.env.GIT_BRANCH_REF = 'feature/user-auth';
createEnvResourceName('MyStack')
// → 'MyStack-user-auth'

// Error case
process.env.GIT_BRANCH_REF = 'main';
createEnvResourceName('MyStack')
// → Throws error

import { createEnvResourceName } from '../bin/env-helper';

// Stack naming
new Stack(app, createEnvResourceName('StarterStack'), { env });

// Resource naming
new Bucket(this, 'Bucket', {
  bucketName: createEnvResourceName('my-app-bucket'),
});

createCdkDeploymentWorkflows(
  gh: GitHub,
  account: string,
  region: string,
  env: string,
  githubDeployRole: string,
  nodeVersion: string,
  deployForBranch: boolean,
  orderedEnvironments: string[]
): void

import { createCdkDeploymentWorkflows } from './src/bin/cicd-helper';

createCdkDeploymentWorkflows(
  project.github,
  config.accountId,
  awsRegion,
  config.name,
  githubRole,
  nodeVersion,
  config.enableBranchDeploy,
  orderedEnvironments,
);

createCdkDeploymentWorkflow(
  gh: GitHub,
  account: string,
  region: string,
  env: string,
  githubDeployRole: string,
  nodeVersion: string,
  isBranchWorkflow: boolean,
  orderedEnvironments: string[]
): void

createCdkDestroyWorkflow(
  gh: GitHub,
  account: string,
  region: string,
  env: string,
  githubDeployRole: string,
  nodeVersion: string
): void

createCdkDiffPrWorkflow(
  gh: GitHub,
  account: string,
  region: string,
  githubDeployRole: string,
  nodeVersion: string,
  orderedEnvironments: string[]
): void

import { createCdkDiffPrWorkflow } from './src/bin/cicd-helper';

createCdkDiffPrWorkflow(
  project.github,
  environmentConfigs[environmentConfigs.length - 1].accountId, // Production account
  awsRegion,
  githubRole,
  nodeVersion,
  orderedEnvironments,
);

getCommonWorkflowSteps(
  nodeVersion: string,
  region: string,
  githubDeployRole: string,
  account: string,
  ref?: string
): WorkflowStep[]

getGitRepositoryDetails(): { gitOwner: string; gitRepoName: string }

import { getGitRepositoryDetails } from '../bin/git-helper';
const { gitOwner, gitRepoName } = getGitRepositoryDetails();