@cdklabs/cdk-cicd-wrapper 0.4.3 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (235) hide show
  1. package/.compatignore +131 -0
  2. package/.jsii +2684 -9948
  3. package/.jsii.tabl.json +1 -1
  4. package/README.md +1 -7
  5. package/lib/app/DeploymentPipelineApp.d.ts +19 -0
  6. package/lib/app/DeploymentPipelineApp.js +49 -0
  7. package/lib/app/PipelineApp.d.ts +25 -0
  8. package/lib/app/PipelineApp.js +62 -0
  9. package/lib/appconfig/accessor.d.ts +59 -0
  10. package/lib/appconfig/accessor.js +79 -0
  11. package/lib/appconfig/defaults.d.ts +23 -0
  12. package/lib/appconfig/defaults.js +87 -0
  13. package/lib/appconfig/error.d.ts +20 -0
  14. package/lib/appconfig/error.js +32 -0
  15. package/lib/appconfig/index.d.ts +6 -0
  16. package/lib/appconfig/index.js +25 -0
  17. package/lib/appconfig/loader.d.ts +34 -0
  18. package/lib/appconfig/loader.js +86 -0
  19. package/lib/appconfig/schema.d.ts +46 -0
  20. package/lib/appconfig/schema.js +14 -0
  21. package/lib/appconfig/validation.d.ts +41 -0
  22. package/lib/appconfig/validation.js +72 -0
  23. package/lib/config/build-image.d.ts +41 -0
  24. package/lib/config/build-image.js +46 -0
  25. package/lib/config/define.d.ts +137 -0
  26. package/lib/config/define.js +151 -0
  27. package/lib/config/naming.d.ts +32 -0
  28. package/lib/config/naming.js +47 -0
  29. package/lib/config/repository.d.ts +36 -0
  30. package/lib/config/repository.js +53 -0
  31. package/lib/config/types.d.ts +375 -0
  32. package/lib/config/types.js +69 -0
  33. package/lib/engine/cdkpipelines/CdkPipelinesEngine.d.ts +46 -0
  34. package/lib/engine/cdkpipelines/CdkPipelinesEngine.js +260 -0
  35. package/lib/engine/codepipeline/CodePipelineEngine.d.ts +63 -0
  36. package/lib/engine/codepipeline/CodePipelineEngine.js +631 -0
  37. package/lib/engine/codepipeline/DeploymentPipeline.d.ts +24 -0
  38. package/lib/engine/codepipeline/DeploymentPipeline.js +236 -0
  39. package/lib/engine/codepipeline/deploy-driver/handler.d.ts +42 -0
  40. package/lib/engine/codepipeline/deploy-driver/handler.js +116 -0
  41. package/lib/engine/codepipeline/source.d.ts +5 -0
  42. package/lib/engine/codepipeline/source.js +56 -0
  43. package/lib/engine/github/GitHubActionsEngine.d.ts +29 -0
  44. package/lib/engine/github/GitHubActionsEngine.js +165 -0
  45. package/lib/engine/types.d.ts +14 -0
  46. package/lib/engine/types.js +11 -0
  47. package/lib/index.d.ts +29 -19
  48. package/lib/index.js +114 -41
  49. package/lib/runtime/attach.d.ts +24 -0
  50. package/lib/runtime/attach.js +41 -0
  51. package/lib/runtime/inject.d.ts +90 -0
  52. package/lib/runtime/inject.js +227 -0
  53. package/lib/runtime/pipeline-assembler.d.ts +25 -0
  54. package/lib/runtime/pipeline-assembler.js +208 -0
  55. package/lib/runtime/register.d.ts +1 -0
  56. package/lib/runtime/register.js +110 -0
  57. package/lib/support/AccessLogsForBucketAspect.d.ts +24 -0
  58. package/lib/support/AccessLogsForBucketAspect.js +67 -0
  59. package/lib/support/DestroyEncryptionKeysOnDeleteAspect.d.ts +10 -0
  60. package/lib/support/DestroyEncryptionKeysOnDeleteAspect.js +33 -0
  61. package/lib/support/DisablePublicIPAssignmentForEC2Aspect.d.ts +9 -0
  62. package/lib/support/DisablePublicIPAssignmentForEC2Aspect.js +34 -0
  63. package/lib/support/EncryptBucketOnTransitAspect.d.ts +10 -0
  64. package/lib/support/EncryptBucketOnTransitAspect.js +56 -0
  65. package/lib/support/EncryptCloudWatchLogGroupsAspect.d.ts +23 -0
  66. package/lib/support/EncryptCloudWatchLogGroupsAspect.js +45 -0
  67. package/lib/support/EncryptSNSTopicOnTransitAspect.d.ts +9 -0
  68. package/lib/support/EncryptSNSTopicOnTransitAspect.js +77 -0
  69. package/lib/support/LambdaDLQAspect.d.ts +17 -0
  70. package/lib/support/LambdaDLQAspect.js +31 -0
  71. package/lib/support/LogRetentionAspect.d.ts +23 -0
  72. package/lib/support/LogRetentionAspect.js +43 -0
  73. package/lib/support/RotateEncryptionKeysAspect.d.ts +9 -0
  74. package/lib/support/RotateEncryptionKeysAspect.js +33 -0
  75. package/lib/support/SupportResources.d.ts +75 -0
  76. package/lib/support/SupportResources.js +137 -0
  77. package/lib/support/Vpc.d.ts +21 -0
  78. package/lib/support/Vpc.js +110 -0
  79. package/node_modules/yaml/browser/dist/compose/composer.js +4 -2
  80. package/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +5 -3
  81. package/node_modules/yaml/browser/dist/nodes/Alias.js +2 -0
  82. package/node_modules/yaml/browser/dist/parse/lexer.js +28 -24
  83. package/node_modules/yaml/browser/dist/parse/parser.js +12 -4
  84. package/node_modules/yaml/browser/dist/schema/yaml-1.1/merge.js +11 -8
  85. package/node_modules/yaml/browser/dist/stringify/stringifyNumber.js +2 -1
  86. package/node_modules/yaml/dist/compose/composer.js +4 -2
  87. package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +5 -3
  88. package/node_modules/yaml/dist/nodes/Alias.js +2 -0
  89. package/node_modules/yaml/dist/nodes/Scalar.d.ts +5 -1
  90. package/node_modules/yaml/dist/parse/lexer.js +28 -24
  91. package/node_modules/yaml/dist/parse/parser.js +12 -4
  92. package/node_modules/yaml/dist/schema/yaml-1.1/merge.js +10 -7
  93. package/node_modules/yaml/dist/stringify/stringifyNumber.js +2 -1
  94. package/node_modules/yaml/package.json +1 -1
  95. package/package.json +8 -4
  96. package/rosetta/default.ts-fixture +1 -1
  97. package/lib/code-pipeline/AppStage.d.ts +0 -80
  98. package/lib/code-pipeline/AppStage.js +0 -80
  99. package/lib/code-pipeline/CDKPipeline.d.ts +0 -225
  100. package/lib/code-pipeline/CDKPipeline.js +0 -167
  101. package/lib/code-pipeline/CodeGuruSecurityStep.d.ts +0 -61
  102. package/lib/code-pipeline/CodeGuruSecurityStep.js +0 -137
  103. package/lib/code-pipeline/PostDeployBuildStep.d.ts +0 -16
  104. package/lib/code-pipeline/PostDeployBuildStep.js +0 -67
  105. package/lib/code-pipeline/PreDeployBuildStep.d.ts +0 -14
  106. package/lib/code-pipeline/PreDeployBuildStep.js +0 -35
  107. package/lib/code-pipeline/index.d.ts +0 -7
  108. package/lib/code-pipeline/index.js +0 -26
  109. package/lib/common/index.d.ts +0 -16
  110. package/lib/common/index.js +0 -35
  111. package/lib/common/spi/ResourceContext.d.ts +0 -128
  112. package/lib/common/spi/ResourceContext.js +0 -251
  113. package/lib/common/spi/index.d.ts +0 -6
  114. package/lib/common/spi/index.js +0 -25
  115. package/lib/common/types/BaseStackProvider.d.ts +0 -95
  116. package/lib/common/types/BaseStackProvider.js +0 -152
  117. package/lib/common/types/DefaultStackProvider.d.ts +0 -70
  118. package/lib/common/types/DefaultStackProvider.js +0 -141
  119. package/lib/common/types/Types.d.ts +0 -402
  120. package/lib/common/types/Types.js +0 -110
  121. package/lib/constructs/CodeCommitRepositoryConstruct.d.ts +0 -56
  122. package/lib/constructs/CodeCommitRepositoryConstruct.js +0 -100
  123. package/lib/constructs/CodeStarConnectionConstruct.d.ts +0 -34
  124. package/lib/constructs/CodeStarConnectionConstruct.js +0 -41
  125. package/lib/constructs/S3RepositoryConstruct.d.ts +0 -51
  126. package/lib/constructs/S3RepositoryConstruct.js +0 -81
  127. package/lib/constructs/index.d.ts +0 -8
  128. package/lib/constructs/index.js +0 -27
  129. package/lib/plugins/index.d.ts +0 -56
  130. package/lib/plugins/index.js +0 -81
  131. package/lib/plugins/optimization/DestroyEncryptionKeysOnDeletePlugin.d.ts +0 -12
  132. package/lib/plugins/optimization/DestroyEncryptionKeysOnDeletePlugin.js +0 -40
  133. package/lib/plugins/pipeline/GitHubPipelinePlugin.d.ts +0 -125
  134. package/lib/plugins/pipeline/GitHubPipelinePlugin.js +0 -44
  135. package/lib/plugins/pipeline/resources/github/GitHubPipelineProvider.d.ts +0 -16
  136. package/lib/plugins/pipeline/resources/github/GitHubPipelineProvider.js +0 -74
  137. package/lib/plugins/pipeline/resources/github/GitHubRepositoryProvider.d.ts +0 -82
  138. package/lib/plugins/pipeline/resources/github/GitHubRepositoryProvider.js +0 -70
  139. package/lib/plugins/security/AccessLogsForBucketPlugin.d.ts +0 -10
  140. package/lib/plugins/security/AccessLogsForBucketPlugin.js +0 -75
  141. package/lib/plugins/security/DisablePublicIPAssignmentForEC2Plugin.d.ts +0 -10
  142. package/lib/plugins/security/DisablePublicIPAssignmentForEC2Plugin.js +0 -36
  143. package/lib/plugins/security/EncryptBucketOnTransitPlugin.d.ts +0 -10
  144. package/lib/plugins/security/EncryptBucketOnTransitPlugin.js +0 -48
  145. package/lib/plugins/security/EncryptCloudWatchLogGroupsPlugin.d.ts +0 -12
  146. package/lib/plugins/security/EncryptCloudWatchLogGroupsPlugin.js +0 -45
  147. package/lib/plugins/security/EncryptSNSTopicOnTransitPlugin.d.ts +0 -10
  148. package/lib/plugins/security/EncryptSNSTopicOnTransitPlugin.js +0 -70
  149. package/lib/plugins/security/LambdaDLQPlugin.d.ts +0 -16
  150. package/lib/plugins/security/LambdaDLQPlugin.js +0 -61
  151. package/lib/plugins/security/RotateEncryptionKeysPlugin.d.ts +0 -10
  152. package/lib/plugins/security/RotateEncryptionKeysPlugin.js +0 -36
  153. package/lib/plugins/utils/CodeArtifactPlugin.d.ts +0 -27
  154. package/lib/plugins/utils/CodeArtifactPlugin.js +0 -66
  155. package/lib/projen/CDKCommands.d.ts +0 -56
  156. package/lib/projen/CDKCommands.js +0 -125
  157. package/lib/projen/CICommands.d.ts +0 -61
  158. package/lib/projen/CICommands.js +0 -70
  159. package/lib/projen/CdkCICDWrapper.d.ts +0 -56
  160. package/lib/projen/CdkCICDWrapper.js +0 -65
  161. package/lib/projen/DevBoxFile.d.ts +0 -12
  162. package/lib/projen/DevBoxFile.js +0 -40
  163. package/lib/projen/DotEnvFile.d.ts +0 -26
  164. package/lib/projen/DotEnvFile.js +0 -40
  165. package/lib/projen/TaskFile.d.ts +0 -18
  166. package/lib/projen/TaskFile.js +0 -26
  167. package/lib/projen/Taskfile.yaml +0 -158
  168. package/lib/projen/index.d.ts +0 -5
  169. package/lib/projen/index.js +0 -24
  170. package/lib/resource-providers/CIDefinitionProvider.d.ts +0 -39
  171. package/lib/resource-providers/CIDefinitionProvider.js +0 -68
  172. package/lib/resource-providers/CodeBuildFactoryProvider.d.ts +0 -136
  173. package/lib/resource-providers/CodeBuildFactoryProvider.js +0 -264
  174. package/lib/resource-providers/ComplianceBucketProvider.d.ts +0 -42
  175. package/lib/resource-providers/ComplianceBucketProvider.js +0 -50
  176. package/lib/resource-providers/DisabledProvider.d.ts +0 -6
  177. package/lib/resource-providers/DisabledProvider.js +0 -16
  178. package/lib/resource-providers/EncryptionProvider.d.ts +0 -25
  179. package/lib/resource-providers/EncryptionProvider.js +0 -33
  180. package/lib/resource-providers/HooksProvider.d.ts +0 -15
  181. package/lib/resource-providers/HooksProvider.js +0 -49
  182. package/lib/resource-providers/LoggingProvider.d.ts +0 -21
  183. package/lib/resource-providers/LoggingProvider.js +0 -63
  184. package/lib/resource-providers/ParameterProvider.d.ts +0 -32
  185. package/lib/resource-providers/ParameterProvider.js +0 -46
  186. package/lib/resource-providers/PhaseCommandProvider.d.ts +0 -136
  187. package/lib/resource-providers/PhaseCommandProvider.js +0 -220
  188. package/lib/resource-providers/PipelineProvider.d.ts +0 -13
  189. package/lib/resource-providers/PipelineProvider.js +0 -54
  190. package/lib/resource-providers/ProxyProvider.d.ts +0 -35
  191. package/lib/resource-providers/ProxyProvider.js +0 -53
  192. package/lib/resource-providers/RepositoryProvider.d.ts +0 -171
  193. package/lib/resource-providers/RepositoryProvider.js +0 -201
  194. package/lib/resource-providers/StageProvider.d.ts +0 -17
  195. package/lib/resource-providers/StageProvider.js +0 -36
  196. package/lib/resource-providers/VPCProvider.d.ts +0 -57
  197. package/lib/resource-providers/VPCProvider.js +0 -67
  198. package/lib/resource-providers/index.d.ts +0 -48
  199. package/lib/resource-providers/index.js +0 -67
  200. package/lib/stacks/CodeCommitRepositoryStack.d.ts +0 -39
  201. package/lib/stacks/CodeCommitRepositoryStack.js +0 -23
  202. package/lib/stacks/CodeStarConnectRepositoryStack.d.ts +0 -44
  203. package/lib/stacks/CodeStarConnectRepositoryStack.js +0 -33
  204. package/lib/stacks/EncryptionStack.d.ts +0 -27
  205. package/lib/stacks/EncryptionStack.js +0 -41
  206. package/lib/stacks/PipelineBlueprint.d.ts +0 -220
  207. package/lib/stacks/PipelineBlueprint.js +0 -467
  208. package/lib/stacks/PipelineBlueprintBase.d.ts +0 -40
  209. package/lib/stacks/PipelineBlueprintBase.js +0 -130
  210. package/lib/stacks/PipelineStack.d.ts +0 -16
  211. package/lib/stacks/PipelineStack.js +0 -36
  212. package/lib/stacks/PostDeployExecutorStack.d.ts +0 -76
  213. package/lib/stacks/PostDeployExecutorStack.js +0 -60
  214. package/lib/stacks/S3RepositoryStack.d.ts +0 -30
  215. package/lib/stacks/S3RepositoryStack.js +0 -38
  216. package/lib/stacks/SSMParameterStack.d.ts +0 -50
  217. package/lib/stacks/SSMParameterStack.js +0 -74
  218. package/lib/stacks/WorkbenchStack.d.ts +0 -19
  219. package/lib/stacks/WorkbenchStack.js +0 -29
  220. package/lib/stacks/compliance-bucket/ComplianceBucketStack.d.ts +0 -47
  221. package/lib/stacks/compliance-bucket/ComplianceBucketStack.js +0 -124
  222. package/lib/stacks/compliance-bucket/lambda-functions/compliance_log_bucket_policy.py +0 -34
  223. package/lib/stacks/compliance-bucket/lambda-functions/make-compliance-log-bucket.py +0 -111
  224. package/lib/stacks/index.d.ts +0 -36
  225. package/lib/stacks/index.js +0 -55
  226. package/lib/stacks/vpc/ManagedVPCStack.d.ts +0 -96
  227. package/lib/stacks/vpc/ManagedVPCStack.js +0 -115
  228. package/lib/stacks/vpc/NoVPCStack.d.ts +0 -27
  229. package/lib/stacks/vpc/NoVPCStack.js +0 -23
  230. package/lib/stacks/vpc/VPCFromLookUpStack.d.ts +0 -42
  231. package/lib/stacks/vpc/VPCFromLookUpStack.js +0 -49
  232. package/lib/utils/ParameterResolver.d.ts +0 -18
  233. package/lib/utils/ParameterResolver.js +0 -34
  234. package/lib/utils/index.d.ts +0 -1
  235. package/lib/utils/index.js +0 -20
@@ -0,0 +1,34 @@
1
+ import { ConfigSchema } from './validation';
2
+ /** Inputs to a config load. Every dependency is injectable, so the loader is trivially testable. */
3
+ export interface ConfigLoadOptions {
4
+ /** Environment map driving path resolution and derived defaults. Defaults to `process.env`. */
5
+ readonly env?: NodeJS.ProcessEnv;
6
+ /** What the config file must contain. Omitted means any shape is accepted. */
7
+ readonly schema?: ConfigSchema;
8
+ }
9
+ /**
10
+ * Pure resolver/loader/validator for an application's per-environment configuration.
11
+ *
12
+ * No CDK imports: depends only on Node built-ins, `yaml`, and an injectable environment map.
13
+ */
14
+ export declare class ConfigLoader {
15
+ /**
16
+ * Resolve the active config file path. Total: never throws, always returns a non-empty path.
17
+ *
18
+ * Order: `CONFIG_FILE` → `config/<CDK_STAGE>.<ext>` → `config/local.<ext>`. The `local` fallback
19
+ * applies when `CDK_STAGE` is unset; a stage whose file is missing is reported as `MISSING_FILE`
20
+ * rather than silently falling back. When no extension exists on disk the `.json` path is returned,
21
+ * so the caller reports `MISSING_FILE` against a concrete path.
22
+ */
23
+ static resolvePath(env: NodeJS.ProcessEnv): string;
24
+ /**
25
+ * Read, merge with defaults, apply derived defaults, and validate the active configuration.
26
+ * Layers `base defaults < file` (last wins), then derived defaults, then structural validation.
27
+ *
28
+ * Throws a `ConfigError` when the file is missing/unreadable, is not valid JSON/YAML, or is missing
29
+ * a required key or attribute. Left uncaught at a CDK app entry point, this makes `cdk synth` exit
30
+ * non-zero and emit no templates.
31
+ */
32
+ static load<T>(options?: ConfigLoadOptions): T;
33
+ private static parse;
34
+ }
@@ -0,0 +1,86 @@
1
+ "use strict";
2
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.ConfigLoader = void 0;
6
+ const fs = require("fs");
7
+ const path = require("path");
8
+ const yaml = require("yaml");
9
+ const defaults_1 = require("./defaults");
10
+ const error_1 = require("./error");
11
+ const validation_1 = require("./validation");
12
+ /** Config file extensions, in probing order: an existing `.json` wins, then `.yaml`, then `.yml`. */
13
+ const CONFIG_EXTENSIONS = ['.json', '.yaml', '.yml'];
14
+ /** Stage used when `CDK_STAGE` is not set — the plain `cdk deploy` inner loop. */
15
+ const LOCAL_STAGE = 'local';
16
+ /**
17
+ * Pure resolver/loader/validator for an application's per-environment configuration.
18
+ *
19
+ * No CDK imports: depends only on Node built-ins, `yaml`, and an injectable environment map.
20
+ */
21
+ class ConfigLoader {
22
+ /**
23
+ * Resolve the active config file path. Total: never throws, always returns a non-empty path.
24
+ *
25
+ * Order: `CONFIG_FILE` → `config/<CDK_STAGE>.<ext>` → `config/local.<ext>`. The `local` fallback
26
+ * applies when `CDK_STAGE` is unset; a stage whose file is missing is reported as `MISSING_FILE`
27
+ * rather than silently falling back. When no extension exists on disk the `.json` path is returned,
28
+ * so the caller reports `MISSING_FILE` against a concrete path.
29
+ */
30
+ static resolvePath(env) {
31
+ const configFile = (env.CONFIG_FILE ?? '').trim();
32
+ if (configFile.length > 0) {
33
+ return configFile;
34
+ }
35
+ const stage = (env.CDK_STAGE ?? '').trim() || LOCAL_STAGE;
36
+ const basePath = path.join('config', stage);
37
+ for (const extension of CONFIG_EXTENSIONS) {
38
+ if (fs.existsSync(`${basePath}${extension}`)) {
39
+ return `${basePath}${extension}`;
40
+ }
41
+ }
42
+ return `${basePath}${CONFIG_EXTENSIONS[0]}`;
43
+ }
44
+ /**
45
+ * Read, merge with defaults, apply derived defaults, and validate the active configuration.
46
+ * Layers `base defaults < file` (last wins), then derived defaults, then structural validation.
47
+ *
48
+ * Throws a `ConfigError` when the file is missing/unreadable, is not valid JSON/YAML, or is missing
49
+ * a required key or attribute. Left uncaught at a CDK app entry point, this makes `cdk synth` exit
50
+ * non-zero and emit no templates.
51
+ */
52
+ static load(options = {}) {
53
+ const env = options.env ?? process.env;
54
+ const filePath = ConfigLoader.resolvePath(env);
55
+ if (!fs.existsSync(filePath)) {
56
+ throw new error_1.ConfigError(error_1.ConfigErrorKind.MISSING_FILE, `Config file not found: ${filePath}`);
57
+ }
58
+ let raw;
59
+ try {
60
+ raw = fs.readFileSync(filePath, 'utf-8');
61
+ }
62
+ catch (error) {
63
+ throw new error_1.ConfigError(error_1.ConfigErrorKind.MISSING_FILE, `Config file not readable: ${filePath} (${error.message})`);
64
+ }
65
+ const parsed = ConfigLoader.parse(raw, filePath);
66
+ const fileConfig = typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
67
+ ? parsed
68
+ : {};
69
+ const defaults = (0, defaults_1.getDefaultConfig)();
70
+ const merged = (0, defaults_1.deepMerge)(defaults, fileConfig);
71
+ const validated = (0, validation_1.validateConfig)((0, defaults_1.applyDerivedDefaults)(merged, env), filePath, options.schema);
72
+ return validated;
73
+ }
74
+ static parse(raw, filePath) {
75
+ const extension = path.extname(filePath).toLowerCase();
76
+ const isYaml = extension === '.yaml' || extension === '.yml';
77
+ try {
78
+ return isYaml ? yaml.parse(raw) : JSON.parse(raw);
79
+ }
80
+ catch (error) {
81
+ throw new error_1.ConfigError(error_1.ConfigErrorKind.PARSE_ERROR, `Config file is not valid ${isYaml ? 'YAML' : 'JSON'}: ${filePath} (${error.message})`);
82
+ }
83
+ }
84
+ }
85
+ exports.ConfigLoader = ConfigLoader;
86
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9hZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FwcGNvbmZpZy9sb2FkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLHFFQUFxRTtBQUNyRSxzQ0FBc0M7OztBQUV0Qyx5QkFBeUI7QUFDekIsNkJBQTZCO0FBQzdCLDZCQUE2QjtBQUM3Qix5Q0FBK0U7QUFDL0UsbUNBQXVEO0FBQ3ZELDZDQUE0RDtBQUU1RCxxR0FBcUc7QUFDckcsTUFBTSxpQkFBaUIsR0FBRyxDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUM7QUFFckQsa0ZBQWtGO0FBQ2xGLE1BQU0sV0FBVyxHQUFHLE9BQU8sQ0FBQztBQVc1Qjs7OztHQUlHO0FBQ0gsTUFBYSxZQUFZO0lBQ3ZCOzs7Ozs7O09BT0c7SUFDSSxNQUFNLENBQUMsV0FBVyxDQUFDLEdBQXNCO1FBQzlDLE1BQU0sVUFBVSxHQUFHLENBQUMsR0FBRyxDQUFDLFdBQVcsSUFBSSxFQUFFLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNsRCxJQUFJLFVBQVUsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDMUIsT0FBTyxVQUFVLENBQUM7UUFDcEIsQ0FBQztRQUVELE1BQU0sS0FBSyxHQUFHLENBQUMsR0FBRyxDQUFDLFNBQVMsSUFBSSxFQUFFLENBQUMsQ0FBQyxJQUFJLEVBQUUsSUFBSSxXQUFXLENBQUM7UUFDMUQsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFFNUMsS0FBSyxNQUFNLFNBQVMsSUFBSSxpQkFBaUIsRUFBRSxDQUFDO1lBQzFDLElBQUksRUFBRSxDQUFDLFVBQVUsQ0FBQyxHQUFHLFFBQVEsR0FBRyxTQUFTLEVBQUUsQ0FBQyxFQUFFLENBQUM7Z0JBQzdDLE9BQU8sR0FBRyxRQUFRLEdBQUcsU0FBUyxFQUFFLENBQUM7WUFDbkMsQ0FBQztRQUNILENBQUM7UUFDRCxPQUFPLEdBQUcsUUFBUSxHQUFHLGlCQUFpQixDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDOUMsQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxNQUFNLENBQUMsSUFBSSxDQUFJLFVBQTZCLEVBQUU7UUFDbkQsTUFBTSxHQUFHLEdBQUcsT0FBTyxDQUFDLEdBQUcsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDO1FBQ3ZDLE1BQU0sUUFBUSxHQUFHLFlBQVksQ0FBQyxXQUFXLENBQUMsR0FBRyxDQUFDLENBQUM7UUFFL0MsSUFBSSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQztZQUM3QixNQUFNLElBQUksbUJBQVcsQ0FBQyx1QkFBZSxDQUFDLFlBQVksRUFBRSwwQkFBMEIsUUFBUSxFQUFFLENBQUMsQ0FBQztRQUM1RixDQUFDO1FBRUQsSUFBSSxHQUFXLENBQUM7UUFDaEIsSUFBSSxDQUFDO1lBQ0gsR0FBRyxHQUFHLEVBQUUsQ0FBQyxZQUFZLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQzNDLENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsTUFBTSxJQUFJLG1CQUFXLENBQ25CLHVCQUFlLENBQUMsWUFBWSxFQUM1Qiw2QkFBNkIsUUFBUSxLQUFNLEtBQWUsQ0FBQyxPQUFPLEdBQUcsQ0FDdEUsQ0FBQztRQUNKLENBQUM7UUFFRCxNQUFNLE1BQU0sR0FBRyxZQUFZLENBQUMsS0FBSyxDQUFDLEdBQUcsRUFBRSxRQUFRLENBQUMsQ0FBQztRQUNqRCxNQUFNLFVBQVUsR0FDZCxPQUFPLE1BQU0sS0FBSyxRQUFRLElBQUksTUFBTSxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDO1lBQ3JFLENBQUMsQ0FBRSxNQUFrQztZQUNyQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBRVQsTUFBTSxRQUFRLEdBQVksSUFBQSwyQkFBZ0IsR0FBRSxDQUFDO1FBQzdDLE1BQU0sTUFBTSxHQUFHLElBQUEsb0JBQVMsRUFBMEIsUUFBbUMsRUFBRSxVQUFVLENBQUMsQ0FBQztRQUVuRyxNQUFNLFNBQVMsR0FBWSxJQUFBLDJCQUFjLEVBQUMsSUFBQSwrQkFBb0IsRUFBQyxNQUFNLEVBQUUsR0FBRyxDQUFDLEVBQUUsUUFBUSxFQUFFLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUN2RyxPQUFPLFNBQWMsQ0FBQztJQUN4QixDQUFDO0lBRU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFXLEVBQUUsUUFBZ0I7UUFDaEQsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUN2RCxNQUFNLE1BQU0sR0FBRyxTQUFTLEtBQUssT0FBTyxJQUFJLFNBQVMsS0FBSyxNQUFNLENBQUM7UUFDN0QsSUFBSSxDQUFDO1lBQ0gsT0FBTyxNQUFNLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDcEQsQ0FBQztRQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7WUFDZixNQUFNLElBQUksbUJBQVcsQ0FDbkIsdUJBQWUsQ0FBQyxXQUFXLEVBQzNCLDRCQUE0QixNQUFNLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxLQUFLLFFBQVEsS0FBTSxLQUFlLENBQUMsT0FBTyxHQUFHLENBQ2xHLENBQUM7UUFDSixDQUFDO0lBQ0gsQ0FBQztDQUNGO0FBN0VELG9DQTZFQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIENvcHlyaWdodCBBbWF6b24uY29tLCBJbmMuIG9yIGl0cyBhZmZpbGlhdGVzLiBBbGwgUmlnaHRzIFJlc2VydmVkLlxuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcblxuaW1wb3J0ICogYXMgZnMgZnJvbSAnZnMnO1xuaW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCAqIGFzIHlhbWwgZnJvbSAneWFtbCc7XG5pbXBvcnQgeyBhcHBseURlcml2ZWREZWZhdWx0cywgZGVlcE1lcmdlLCBnZXREZWZhdWx0Q29uZmlnIH0gZnJvbSAnLi9kZWZhdWx0cyc7XG5pbXBvcnQgeyBDb25maWdFcnJvciwgQ29uZmlnRXJyb3JLaW5kIH0gZnJvbSAnLi9lcnJvcic7XG5pbXBvcnQgeyBDb25maWdTY2hlbWEsIHZhbGlkYXRlQ29uZmlnIH0gZnJvbSAnLi92YWxpZGF0aW9uJztcblxuLyoqIENvbmZpZyBmaWxlIGV4dGVuc2lvbnMsIGluIHByb2Jpbmcgb3JkZXI6IGFuIGV4aXN0aW5nIGAuanNvbmAgd2lucywgdGhlbiBgLnlhbWxgLCB0aGVuIGAueW1sYC4gKi9cbmNvbnN0IENPTkZJR19FWFRFTlNJT05TID0gWycuanNvbicsICcueWFtbCcsICcueW1sJ107XG5cbi8qKiBTdGFnZSB1c2VkIHdoZW4gYENES19TVEFHRWAgaXMgbm90IHNldCDigJQgdGhlIHBsYWluIGBjZGsgZGVwbG95YCBpbm5lciBsb29wLiAqL1xuY29uc3QgTE9DQUxfU1RBR0UgPSAnbG9jYWwnO1xuXG4vKiogSW5wdXRzIHRvIGEgY29uZmlnIGxvYWQuIEV2ZXJ5IGRlcGVuZGVuY3kgaXMgaW5qZWN0YWJsZSwgc28gdGhlIGxvYWRlciBpcyB0cml2aWFsbHkgdGVzdGFibGUuICovXG5leHBvcnQgaW50ZXJmYWNlIENvbmZpZ0xvYWRPcHRpb25zIHtcbiAgLyoqIEVudmlyb25tZW50IG1hcCBkcml2aW5nIHBhdGggcmVzb2x1dGlvbiBhbmQgZGVyaXZlZCBkZWZhdWx0cy4gRGVmYXVsdHMgdG8gYHByb2Nlc3MuZW52YC4gKi9cbiAgcmVhZG9ubHkgZW52PzogTm9kZUpTLlByb2Nlc3NFbnY7XG5cbiAgLyoqIFdoYXQgdGhlIGNvbmZpZyBmaWxlIG11c3QgY29udGFpbi4gT21pdHRlZCBtZWFucyBhbnkgc2hhcGUgaXMgYWNjZXB0ZWQuICovXG4gIHJlYWRvbmx5IHNjaGVtYT86IENvbmZpZ1NjaGVtYTtcbn1cblxuLyoqXG4gKiBQdXJlIHJlc29sdmVyL2xvYWRlci92YWxpZGF0b3IgZm9yIGFuIGFwcGxpY2F0aW9uJ3MgcGVyLWVudmlyb25tZW50IGNvbmZpZ3VyYXRpb24uXG4gKlxuICogTm8gQ0RLIGltcG9ydHM6IGRlcGVuZHMgb25seSBvbiBOb2RlIGJ1aWx0LWlucywgYHlhbWxgLCBhbmQgYW4gaW5qZWN0YWJsZSBlbnZpcm9ubWVudCBtYXAuXG4gKi9cbmV4cG9ydCBjbGFzcyBDb25maWdMb2FkZXIge1xuICAvKipcbiAgICogUmVzb2x2ZSB0aGUgYWN0aXZlIGNvbmZpZyBmaWxlIHBhdGguIFRvdGFsOiBuZXZlciB0aHJvd3MsIGFsd2F5cyByZXR1cm5zIGEgbm9uLWVtcHR5IHBhdGguXG4gICAqXG4gICAqIE9yZGVyOiBgQ09ORklHX0ZJTEVgIOKGkiBgY29uZmlnLzxDREtfU1RBR0U+LjxleHQ+YCDihpIgYGNvbmZpZy9sb2NhbC48ZXh0PmAuIFRoZSBgbG9jYWxgIGZhbGxiYWNrXG4gICAqIGFwcGxpZXMgd2hlbiBgQ0RLX1NUQUdFYCBpcyB1bnNldDsgYSBzdGFnZSB3aG9zZSBmaWxlIGlzIG1pc3NpbmcgaXMgcmVwb3J0ZWQgYXMgYE1JU1NJTkdfRklMRWBcbiAgICogcmF0aGVyIHRoYW4gc2lsZW50bHkgZmFsbGluZyBiYWNrLiBXaGVuIG5vIGV4dGVuc2lvbiBleGlzdHMgb24gZGlzayB0aGUgYC5qc29uYCBwYXRoIGlzIHJldHVybmVkLFxuICAgKiBzbyB0aGUgY2FsbGVyIHJlcG9ydHMgYE1JU1NJTkdfRklMRWAgYWdhaW5zdCBhIGNvbmNyZXRlIHBhdGguXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIHJlc29sdmVQYXRoKGVudjogTm9kZUpTLlByb2Nlc3NFbnYpOiBzdHJpbmcge1xuICAgIGNvbnN0IGNvbmZpZ0ZpbGUgPSAoZW52LkNPTkZJR19GSUxFID8/ICcnKS50cmltKCk7XG4gICAgaWYgKGNvbmZpZ0ZpbGUubGVuZ3RoID4gMCkge1xuICAgICAgcmV0dXJuIGNvbmZpZ0ZpbGU7XG4gICAgfVxuXG4gICAgY29uc3Qgc3RhZ2UgPSAoZW52LkNES19TVEFHRSA/PyAnJykudHJpbSgpIHx8IExPQ0FMX1NUQUdFO1xuICAgIGNvbnN0IGJhc2VQYXRoID0gcGF0aC5qb2luKCdjb25maWcnLCBzdGFnZSk7XG5cbiAgICBmb3IgKGNvbnN0IGV4dGVuc2lvbiBvZiBDT05GSUdfRVhURU5TSU9OUykge1xuICAgICAgaWYgKGZzLmV4aXN0c1N5bmMoYCR7YmFzZVBhdGh9JHtleHRlbnNpb259YCkpIHtcbiAgICAgICAgcmV0dXJuIGAke2Jhc2VQYXRofSR7ZXh0ZW5zaW9ufWA7XG4gICAgICB9XG4gICAgfVxuICAgIHJldHVybiBgJHtiYXNlUGF0aH0ke0NPTkZJR19FWFRFTlNJT05TWzBdfWA7XG4gIH1cblxuICAvKipcbiAgICogUmVhZCwgbWVyZ2Ugd2l0aCBkZWZhdWx0cywgYXBwbHkgZGVyaXZlZCBkZWZhdWx0cywgYW5kIHZhbGlkYXRlIHRoZSBhY3RpdmUgY29uZmlndXJhdGlvbi5cbiAgICogTGF5ZXJzIGBiYXNlIGRlZmF1bHRzIDwgZmlsZWAgKGxhc3Qgd2lucyksIHRoZW4gZGVyaXZlZCBkZWZhdWx0cywgdGhlbiBzdHJ1Y3R1cmFsIHZhbGlkYXRpb24uXG4gICAqXG4gICAqIFRocm93cyBhIGBDb25maWdFcnJvcmAgd2hlbiB0aGUgZmlsZSBpcyBtaXNzaW5nL3VucmVhZGFibGUsIGlzIG5vdCB2YWxpZCBKU09OL1lBTUwsIG9yIGlzIG1pc3NpbmdcbiAgICogYSByZXF1aXJlZCBrZXkgb3IgYXR0cmlidXRlLiBMZWZ0IHVuY2F1Z2h0IGF0IGEgQ0RLIGFwcCBlbnRyeSBwb2ludCwgdGhpcyBtYWtlcyBgY2RrIHN5bnRoYCBleGl0XG4gICAqIG5vbi16ZXJvIGFuZCBlbWl0IG5vIHRlbXBsYXRlcy5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgbG9hZDxUPihvcHRpb25zOiBDb25maWdMb2FkT3B0aW9ucyA9IHt9KTogVCB7XG4gICAgY29uc3QgZW52ID0gb3B0aW9ucy5lbnYgPz8gcHJvY2Vzcy5lbnY7XG4gICAgY29uc3QgZmlsZVBhdGggPSBDb25maWdMb2FkZXIucmVzb2x2ZVBhdGgoZW52KTtcblxuICAgIGlmICghZnMuZXhpc3RzU3luYyhmaWxlUGF0aCkpIHtcbiAgICAgIHRocm93IG5ldyBDb25maWdFcnJvcihDb25maWdFcnJvcktpbmQuTUlTU0lOR19GSUxFLCBgQ29uZmlnIGZpbGUgbm90IGZvdW5kOiAke2ZpbGVQYXRofWApO1xuICAgIH1cblxuICAgIGxldCByYXc6IHN0cmluZztcbiAgICB0cnkge1xuICAgICAgcmF3ID0gZnMucmVhZEZpbGVTeW5jKGZpbGVQYXRoLCAndXRmLTgnKTtcbiAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgdGhyb3cgbmV3IENvbmZpZ0Vycm9yKFxuICAgICAgICBDb25maWdFcnJvcktpbmQuTUlTU0lOR19GSUxFLFxuICAgICAgICBgQ29uZmlnIGZpbGUgbm90IHJlYWRhYmxlOiAke2ZpbGVQYXRofSAoJHsoZXJyb3IgYXMgRXJyb3IpLm1lc3NhZ2V9KWAsXG4gICAgICApO1xuICAgIH1cblxuICAgIGNvbnN0IHBhcnNlZCA9IENvbmZpZ0xvYWRlci5wYXJzZShyYXcsIGZpbGVQYXRoKTtcbiAgICBjb25zdCBmaWxlQ29uZmlnOiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiA9XG4gICAgICB0eXBlb2YgcGFyc2VkID09PSAnb2JqZWN0JyAmJiBwYXJzZWQgIT09IG51bGwgJiYgIUFycmF5LmlzQXJyYXkocGFyc2VkKVxuICAgICAgICA/IChwYXJzZWQgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pXG4gICAgICAgIDoge307XG5cbiAgICBjb25zdCBkZWZhdWx0czogdW5rbm93biA9IGdldERlZmF1bHRDb25maWcoKTtcbiAgICBjb25zdCBtZXJnZWQgPSBkZWVwTWVyZ2U8UmVjb3JkPHN0cmluZywgdW5rbm93bj4+KGRlZmF1bHRzIGFzIFJlY29yZDxzdHJpbmcsIHVua25vd24+LCBmaWxlQ29uZmlnKTtcblxuICAgIGNvbnN0IHZhbGlkYXRlZDogdW5rbm93biA9IHZhbGlkYXRlQ29uZmlnKGFwcGx5RGVyaXZlZERlZmF1bHRzKG1lcmdlZCwgZW52KSwgZmlsZVBhdGgsIG9wdGlvbnMuc2NoZW1hKTtcbiAgICByZXR1cm4gdmFsaWRhdGVkIGFzIFQ7XG4gIH1cblxuICBwcml2YXRlIHN0YXRpYyBwYXJzZShyYXc6IHN0cmluZywgZmlsZVBhdGg6IHN0cmluZyk6IHVua25vd24ge1xuICAgIGNvbnN0IGV4dGVuc2lvbiA9IHBhdGguZXh0bmFtZShmaWxlUGF0aCkudG9Mb3dlckNhc2UoKTtcbiAgICBjb25zdCBpc1lhbWwgPSBleHRlbnNpb24gPT09ICcueWFtbCcgfHwgZXh0ZW5zaW9uID09PSAnLnltbCc7XG4gICAgdHJ5IHtcbiAgICAgIHJldHVybiBpc1lhbWwgPyB5YW1sLnBhcnNlKHJhdykgOiBKU09OLnBhcnNlKHJhdyk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHRocm93IG5ldyBDb25maWdFcnJvcihcbiAgICAgICAgQ29uZmlnRXJyb3JLaW5kLlBBUlNFX0VSUk9SLFxuICAgICAgICBgQ29uZmlnIGZpbGUgaXMgbm90IHZhbGlkICR7aXNZYW1sID8gJ1lBTUwnIDogJ0pTT04nfTogJHtmaWxlUGF0aH0gKCR7KGVycm9yIGFzIEVycm9yKS5tZXNzYWdlfSlgLFxuICAgICAgKTtcbiAgICB9XG4gIH1cbn1cbiJdfQ==
@@ -0,0 +1,46 @@
1
+ /** Retention behaviour for a class of stateful resources. */
2
+ export declare enum RemovalPolicyValue {
3
+ /** Keep the resource when its stack is deleted. */
4
+ RETAIN = "retain",
5
+ /** Delete the resource when its stack is deleted. */
6
+ DESTROY = "destroy"
7
+ }
8
+ /** AWS account / region routing for the active stage. */
9
+ export interface AwsEnvironment {
10
+ /** Target account id. Derived from `CDK_DEFAULT_ACCOUNT` when the config file omits it. */
11
+ readonly accountId?: string;
12
+ /** Target region. Derived from `CDK_DEFAULT_REGION` (or `AWS_REGION`) when the config file omits it. */
13
+ readonly region?: string;
14
+ }
15
+ /** Retention of stateful resources. Both default to `RETAIN`. */
16
+ export interface RemovalPolicies {
17
+ /** Retention for DynamoDB tables. */
18
+ readonly dynamoDBTable?: RemovalPolicyValue;
19
+ /** Retention for S3 buckets. */
20
+ readonly s3Bucket?: RemovalPolicyValue;
21
+ }
22
+ /**
23
+ * The wrapper's opinionated base schema for an application config file. Deliberately tiny — an
24
+ * application extends it with its own per-environment shape, or ignores it entirely.
25
+ *
26
+ * Networking is intentionally NOT part of the base schema: VPC/subnet/hosted-zone shapes are too
27
+ * application-specific, so they live in the user's own schema.
28
+ */
29
+ export interface BaseConfig {
30
+ /** Application name used for resource naming. */
31
+ readonly application?: string;
32
+ /** Account / region routing. */
33
+ readonly aws: AwsEnvironment;
34
+ /** Free-form cost-allocation/compliance tags. Base defaults may be added to or overridden. */
35
+ readonly tags: {
36
+ [key: string]: string;
37
+ };
38
+ /** Stateful-resource retention. */
39
+ readonly removalPolicies: RemovalPolicies;
40
+ /**
41
+ * CloudWatch Logs retention, in days, the wrapper forces on any log group that does not already set
42
+ * one explicitly (applied tree-wide as an Aspect by the runtime injection hook). Defaults to 365,
43
+ * matching Blueprint's `PipelineBlueprint.logRetentionInDays`.
44
+ */
45
+ readonly logRetentionInDays: number;
46
+ }
@@ -0,0 +1,14 @@
1
+ "use strict";
2
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.RemovalPolicyValue = void 0;
6
+ /** Retention behaviour for a class of stateful resources. */
7
+ var RemovalPolicyValue;
8
+ (function (RemovalPolicyValue) {
9
+ /** Keep the resource when its stack is deleted. */
10
+ RemovalPolicyValue["RETAIN"] = "retain";
11
+ /** Delete the resource when its stack is deleted. */
12
+ RemovalPolicyValue["DESTROY"] = "destroy";
13
+ })(RemovalPolicyValue || (exports.RemovalPolicyValue = RemovalPolicyValue = {}));
14
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FwcGNvbmZpZy9zY2hlbWEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLHFFQUFxRTtBQUNyRSxzQ0FBc0M7OztBQUV0Qyw2REFBNkQ7QUFDN0QsSUFBWSxrQkFLWDtBQUxELFdBQVksa0JBQWtCO0lBQzVCLG1EQUFtRDtJQUNuRCx1Q0FBaUIsQ0FBQTtJQUNqQixxREFBcUQ7SUFDckQseUNBQW1CLENBQUE7QUFDckIsQ0FBQyxFQUxXLGtCQUFrQixrQ0FBbEIsa0JBQWtCLFFBSzdCIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQ29weXJpZ2h0IEFtYXpvbi5jb20sIEluYy4gb3IgaXRzIGFmZmlsaWF0ZXMuIEFsbCBSaWdodHMgUmVzZXJ2ZWQuXG4vLyBTUERYLUxpY2Vuc2UtSWRlbnRpZmllcjogQXBhY2hlLTIuMFxuXG4vKiogUmV0ZW50aW9uIGJlaGF2aW91ciBmb3IgYSBjbGFzcyBvZiBzdGF0ZWZ1bCByZXNvdXJjZXMuICovXG5leHBvcnQgZW51bSBSZW1vdmFsUG9saWN5VmFsdWUge1xuICAvKiogS2VlcCB0aGUgcmVzb3VyY2Ugd2hlbiBpdHMgc3RhY2sgaXMgZGVsZXRlZC4gKi9cbiAgUkVUQUlOID0gJ3JldGFpbicsXG4gIC8qKiBEZWxldGUgdGhlIHJlc291cmNlIHdoZW4gaXRzIHN0YWNrIGlzIGRlbGV0ZWQuICovXG4gIERFU1RST1kgPSAnZGVzdHJveScsXG59XG5cbi8qKiBBV1MgYWNjb3VudCAvIHJlZ2lvbiByb3V0aW5nIGZvciB0aGUgYWN0aXZlIHN0YWdlLiAqL1xuZXhwb3J0IGludGVyZmFjZSBBd3NFbnZpcm9ubWVudCB7XG4gIC8qKiBUYXJnZXQgYWNjb3VudCBpZC4gRGVyaXZlZCBmcm9tIGBDREtfREVGQVVMVF9BQ0NPVU5UYCB3aGVuIHRoZSBjb25maWcgZmlsZSBvbWl0cyBpdC4gKi9cbiAgcmVhZG9ubHkgYWNjb3VudElkPzogc3RyaW5nO1xuXG4gIC8qKiBUYXJnZXQgcmVnaW9uLiBEZXJpdmVkIGZyb20gYENES19ERUZBVUxUX1JFR0lPTmAgKG9yIGBBV1NfUkVHSU9OYCkgd2hlbiB0aGUgY29uZmlnIGZpbGUgb21pdHMgaXQuICovXG4gIHJlYWRvbmx5IHJlZ2lvbj86IHN0cmluZztcbn1cblxuLyoqIFJldGVudGlvbiBvZiBzdGF0ZWZ1bCByZXNvdXJjZXMuIEJvdGggZGVmYXVsdCB0byBgUkVUQUlOYC4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVtb3ZhbFBvbGljaWVzIHtcbiAgLyoqIFJldGVudGlvbiBmb3IgRHluYW1vREIgdGFibGVzLiAqL1xuICByZWFkb25seSBkeW5hbW9EQlRhYmxlPzogUmVtb3ZhbFBvbGljeVZhbHVlO1xuXG4gIC8qKiBSZXRlbnRpb24gZm9yIFMzIGJ1Y2tldHMuICovXG4gIHJlYWRvbmx5IHMzQnVja2V0PzogUmVtb3ZhbFBvbGljeVZhbHVlO1xufVxuXG4vKipcbiAqIFRoZSB3cmFwcGVyJ3Mgb3BpbmlvbmF0ZWQgYmFzZSBzY2hlbWEgZm9yIGFuIGFwcGxpY2F0aW9uIGNvbmZpZyBmaWxlLiBEZWxpYmVyYXRlbHkgdGlueSDigJQgYW5cbiAqIGFwcGxpY2F0aW9uIGV4dGVuZHMgaXQgd2l0aCBpdHMgb3duIHBlci1lbnZpcm9ubWVudCBzaGFwZSwgb3IgaWdub3JlcyBpdCBlbnRpcmVseS5cbiAqXG4gKiBOZXR3b3JraW5nIGlzIGludGVudGlvbmFsbHkgTk9UIHBhcnQgb2YgdGhlIGJhc2Ugc2NoZW1hOiBWUEMvc3VibmV0L2hvc3RlZC16b25lIHNoYXBlcyBhcmUgdG9vXG4gKiBhcHBsaWNhdGlvbi1zcGVjaWZpYywgc28gdGhleSBsaXZlIGluIHRoZSB1c2VyJ3Mgb3duIHNjaGVtYS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCYXNlQ29uZmlnIHtcbiAgLyoqIEFwcGxpY2F0aW9uIG5hbWUgdXNlZCBmb3IgcmVzb3VyY2UgbmFtaW5nLiAqL1xuICByZWFkb25seSBhcHBsaWNhdGlvbj86IHN0cmluZztcblxuICAvKiogQWNjb3VudCAvIHJlZ2lvbiByb3V0aW5nLiAqL1xuICByZWFkb25seSBhd3M6IEF3c0Vudmlyb25tZW50O1xuXG4gIC8qKiBGcmVlLWZvcm0gY29zdC1hbGxvY2F0aW9uL2NvbXBsaWFuY2UgdGFncy4gQmFzZSBkZWZhdWx0cyBtYXkgYmUgYWRkZWQgdG8gb3Igb3ZlcnJpZGRlbi4gKi9cbiAgcmVhZG9ubHkgdGFnczogeyBba2V5OiBzdHJpbmddOiBzdHJpbmcgfTtcblxuICAvKiogU3RhdGVmdWwtcmVzb3VyY2UgcmV0ZW50aW9uLiAqL1xuICByZWFkb25seSByZW1vdmFsUG9saWNpZXM6IFJlbW92YWxQb2xpY2llcztcblxuICAvKipcbiAgICogQ2xvdWRXYXRjaCBMb2dzIHJldGVudGlvbiwgaW4gZGF5cywgdGhlIHdyYXBwZXIgZm9yY2VzIG9uIGFueSBsb2cgZ3JvdXAgdGhhdCBkb2VzIG5vdCBhbHJlYWR5IHNldFxuICAgKiBvbmUgZXhwbGljaXRseSAoYXBwbGllZCB0cmVlLXdpZGUgYXMgYW4gQXNwZWN0IGJ5IHRoZSBydW50aW1lIGluamVjdGlvbiBob29rKS4gRGVmYXVsdHMgdG8gMzY1LFxuICAgKiBtYXRjaGluZyBCbHVlcHJpbnQncyBgUGlwZWxpbmVCbHVlcHJpbnQubG9nUmV0ZW50aW9uSW5EYXlzYC5cbiAgICovXG4gIHJlYWRvbmx5IGxvZ1JldGVudGlvbkluRGF5czogbnVtYmVyO1xufVxuIl19
@@ -0,0 +1,41 @@
1
+ /** Shape a required field must satisfy. */
2
+ export declare enum FieldKind {
3
+ /** A non-blank string. */
4
+ STRING = "string",
5
+ /** A non-empty array. */
6
+ STRING_LIST = "string[]"
7
+ }
8
+ /** A required field addressed by dot-path, plus the shape it must satisfy. */
9
+ export interface RequiredField {
10
+ /** Dot-path into the nested config, e.g. `aws.accountId`. */
11
+ readonly path: string;
12
+ /** The shape the value must have. */
13
+ readonly kind: FieldKind;
14
+ }
15
+ /** A group of fields that becomes required only when `when` resolves to a present value. */
16
+ export interface ConditionalFieldGroup {
17
+ /** Dot-path whose presence activates the group. */
18
+ readonly when: string;
19
+ /** Fields required once the group is active. */
20
+ readonly fields: RequiredField[];
21
+ }
22
+ /** Caller-supplied description of what an application's config file must contain. */
23
+ export interface ConfigSchema {
24
+ /** Fields whose absence is reported as `MISSING_KEY`. */
25
+ readonly requiredKeys?: RequiredField[];
26
+ /** Fields whose absence is reported as `MISSING_ATTRIBUTE`. */
27
+ readonly requiredAttributes?: RequiredField[];
28
+ /** Conditionally required fields; absence is reported as `MISSING_ATTRIBUTE`. */
29
+ readonly conditionalGroups?: ConditionalFieldGroup[];
30
+ }
31
+ /** Read a dot-path (e.g. `aws.accountId`) out of a nested object. */
32
+ export declare function getByPath(obj: Record<string, unknown>, dotPath: string): unknown;
33
+ /** Returns true when a value is absent or fails its declared shape. */
34
+ export declare function isMissing(value: unknown, kind: FieldKind): boolean;
35
+ /**
36
+ * Structurally validate a parsed config object against a caller-supplied schema.
37
+ *
38
+ * Throws a `ConfigError` naming the offending dot-path and the source file, so the failure is
39
+ * actionable when it surfaces uncaught at a CDK app entry point.
40
+ */
41
+ export declare function validateConfig(parsed: unknown, filePath: string, schema?: ConfigSchema): Record<string, unknown>;
@@ -0,0 +1,72 @@
1
+ "use strict";
2
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.FieldKind = void 0;
6
+ exports.getByPath = getByPath;
7
+ exports.isMissing = isMissing;
8
+ exports.validateConfig = validateConfig;
9
+ const error_1 = require("./error");
10
+ /** Shape a required field must satisfy. */
11
+ var FieldKind;
12
+ (function (FieldKind) {
13
+ /** A non-blank string. */
14
+ FieldKind["STRING"] = "string";
15
+ /** A non-empty array. */
16
+ FieldKind["STRING_LIST"] = "string[]";
17
+ })(FieldKind || (exports.FieldKind = FieldKind = {}));
18
+ /** Read a dot-path (e.g. `aws.accountId`) out of a nested object. */
19
+ function getByPath(obj, dotPath) {
20
+ return dotPath.split('.').reduce((acc, key) => {
21
+ if (acc !== null && typeof acc === 'object' && !Array.isArray(acc)) {
22
+ return acc[key];
23
+ }
24
+ return undefined;
25
+ }, obj);
26
+ }
27
+ /** Returns true when a value is absent or fails its declared shape. */
28
+ function isMissing(value, kind) {
29
+ if (value === undefined || value === null) {
30
+ return true;
31
+ }
32
+ if (kind === FieldKind.STRING_LIST) {
33
+ return !Array.isArray(value) || value.length === 0;
34
+ }
35
+ return typeof value !== 'string' || value.trim().length === 0;
36
+ }
37
+ /**
38
+ * Structurally validate a parsed config object against a caller-supplied schema.
39
+ *
40
+ * Throws a `ConfigError` naming the offending dot-path and the source file, so the failure is
41
+ * actionable when it surfaces uncaught at a CDK app entry point.
42
+ */
43
+ function validateConfig(parsed, filePath, schema = {}) {
44
+ const obj = typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed) ? parsed : {};
45
+ for (const field of schema.requiredKeys ?? []) {
46
+ if (isMissing(getByPath(obj, field.path), field.kind)) {
47
+ throw new error_1.ConfigError(error_1.ConfigErrorKind.MISSING_KEY, `Missing or malformed required config key '${field.path}' in ${filePath} (expected ${field.kind})`);
48
+ }
49
+ }
50
+ for (const field of schema.requiredAttributes ?? []) {
51
+ assertAttribute(obj, field, filePath);
52
+ }
53
+ for (const group of schema.conditionalGroups ?? []) {
54
+ // Only required when the activating path is present. `null` counts as absent: in YAML a blank key
55
+ // (`secondary:`) parses to `null` and means "I did not configure this", so it must not activate the
56
+ // group and demand the fields underneath it.
57
+ const activator = getByPath(obj, group.when);
58
+ if (activator === undefined || activator === null) {
59
+ continue;
60
+ }
61
+ for (const field of group.fields) {
62
+ assertAttribute(obj, field, filePath);
63
+ }
64
+ }
65
+ return obj;
66
+ }
67
+ function assertAttribute(obj, field, filePath) {
68
+ if (isMissing(getByPath(obj, field.path), field.kind)) {
69
+ throw new error_1.ConfigError(error_1.ConfigErrorKind.MISSING_ATTRIBUTE, `Missing or malformed required config attribute '${field.path}' in ${filePath} (expected ${field.kind})`);
70
+ }
71
+ }
72
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9hcHBjb25maWcvdmFsaWRhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEscUVBQXFFO0FBQ3JFLHNDQUFzQzs7O0FBMkN0Qyw4QkFPQztBQUdELDhCQVFDO0FBUUQsd0NBK0JDO0FBbEdELG1DQUF1RDtBQUV2RCwyQ0FBMkM7QUFDM0MsSUFBWSxTQUtYO0FBTEQsV0FBWSxTQUFTO0lBQ25CLDBCQUEwQjtJQUMxQiw4QkFBaUIsQ0FBQTtJQUNqQix5QkFBeUI7SUFDekIscUNBQXdCLENBQUE7QUFDMUIsQ0FBQyxFQUxXLFNBQVMseUJBQVQsU0FBUyxRQUtwQjtBQWdDRCxxRUFBcUU7QUFDckUsU0FBZ0IsU0FBUyxDQUFDLEdBQTRCLEVBQUUsT0FBZTtJQUNyRSxPQUFPLE9BQU8sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFVLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxFQUFFO1FBQ3JELElBQUksR0FBRyxLQUFLLElBQUksSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDbkUsT0FBUSxHQUErQixDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQy9DLENBQUM7UUFDRCxPQUFPLFNBQVMsQ0FBQztJQUNuQixDQUFDLEVBQUUsR0FBRyxDQUFDLENBQUM7QUFDVixDQUFDO0FBRUQsdUVBQXVFO0FBQ3ZFLFNBQWdCLFNBQVMsQ0FBQyxLQUFjLEVBQUUsSUFBZTtJQUN2RCxJQUFJLEtBQUssS0FBSyxTQUFTLElBQUksS0FBSyxLQUFLLElBQUksRUFBRSxDQUFDO1FBQzFDLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQUNELElBQUksSUFBSSxLQUFLLFNBQVMsQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUNuQyxPQUFPLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsSUFBSSxLQUFLLENBQUMsTUFBTSxLQUFLLENBQUMsQ0FBQztJQUNyRCxDQUFDO0lBQ0QsT0FBTyxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDLE1BQU0sS0FBSyxDQUFDLENBQUM7QUFDaEUsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsU0FBZ0IsY0FBYyxDQUFDLE1BQWUsRUFBRSxRQUFnQixFQUFFLFNBQXVCLEVBQUU7SUFDekYsTUFBTSxHQUFHLEdBQ1AsT0FBTyxNQUFNLEtBQUssUUFBUSxJQUFJLE1BQU0sS0FBSyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBRSxNQUFrQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFFckgsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLENBQUMsWUFBWSxJQUFJLEVBQUUsRUFBRSxDQUFDO1FBQzlDLElBQUksU0FBUyxDQUFDLFNBQVMsQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxFQUFFLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQ3RELE1BQU0sSUFBSSxtQkFBVyxDQUNuQix1QkFBZSxDQUFDLFdBQVcsRUFDM0IsNkNBQTZDLEtBQUssQ0FBQyxJQUFJLFFBQVEsUUFBUSxjQUFjLEtBQUssQ0FBQyxJQUFJLEdBQUcsQ0FDbkcsQ0FBQztRQUNKLENBQUM7SUFDSCxDQUFDO0lBRUQsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLENBQUMsa0JBQWtCLElBQUksRUFBRSxFQUFFLENBQUM7UUFDcEQsZUFBZSxDQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFDeEMsQ0FBQztJQUVELEtBQUssTUFBTSxLQUFLLElBQUksTUFBTSxDQUFDLGlCQUFpQixJQUFJLEVBQUUsRUFBRSxDQUFDO1FBQ25ELGtHQUFrRztRQUNsRyxvR0FBb0c7UUFDcEcsNkNBQTZDO1FBQzdDLE1BQU0sU0FBUyxHQUFHLFNBQVMsQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQzdDLElBQUksU0FBUyxLQUFLLFNBQVMsSUFBSSxTQUFTLEtBQUssSUFBSSxFQUFFLENBQUM7WUFDbEQsU0FBUztRQUNYLENBQUM7UUFDRCxLQUFLLE1BQU0sS0FBSyxJQUFJLEtBQUssQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUNqQyxlQUFlLENBQUMsR0FBRyxFQUFFLEtBQUssRUFBRSxRQUFRLENBQUMsQ0FBQztRQUN4QyxDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU8sR0FBRyxDQUFDO0FBQ2IsQ0FBQztBQUVELFNBQVMsZUFBZSxDQUFDLEdBQTRCLEVBQUUsS0FBb0IsRUFBRSxRQUFnQjtJQUMzRixJQUFJLFNBQVMsQ0FBQyxTQUFTLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztRQUN0RCxNQUFNLElBQUksbUJBQVcsQ0FDbkIsdUJBQWUsQ0FBQyxpQkFBaUIsRUFDakMsbURBQW1ELEtBQUssQ0FBQyxJQUFJLFFBQVEsUUFBUSxjQUFjLEtBQUssQ0FBQyxJQUFJLEdBQUcsQ0FDekcsQ0FBQztJQUNKLENBQUM7QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQ29weXJpZ2h0IEFtYXpvbi5jb20sIEluYy4gb3IgaXRzIGFmZmlsaWF0ZXMuIEFsbCBSaWdodHMgUmVzZXJ2ZWQuXG4vLyBTUERYLUxpY2Vuc2UtSWRlbnRpZmllcjogQXBhY2hlLTIuMFxuXG5pbXBvcnQgeyBDb25maWdFcnJvciwgQ29uZmlnRXJyb3JLaW5kIH0gZnJvbSAnLi9lcnJvcic7XG5cbi8qKiBTaGFwZSBhIHJlcXVpcmVkIGZpZWxkIG11c3Qgc2F0aXNmeS4gKi9cbmV4cG9ydCBlbnVtIEZpZWxkS2luZCB7XG4gIC8qKiBBIG5vbi1ibGFuayBzdHJpbmcuICovXG4gIFNUUklORyA9ICdzdHJpbmcnLFxuICAvKiogQSBub24tZW1wdHkgYXJyYXkuICovXG4gIFNUUklOR19MSVNUID0gJ3N0cmluZ1tdJyxcbn1cblxuLyoqIEEgcmVxdWlyZWQgZmllbGQgYWRkcmVzc2VkIGJ5IGRvdC1wYXRoLCBwbHVzIHRoZSBzaGFwZSBpdCBtdXN0IHNhdGlzZnkuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlcXVpcmVkRmllbGQge1xuICAvKiogRG90LXBhdGggaW50byB0aGUgbmVzdGVkIGNvbmZpZywgZS5nLiBgYXdzLmFjY291bnRJZGAuICovXG4gIHJlYWRvbmx5IHBhdGg6IHN0cmluZztcblxuICAvKiogVGhlIHNoYXBlIHRoZSB2YWx1ZSBtdXN0IGhhdmUuICovXG4gIHJlYWRvbmx5IGtpbmQ6IEZpZWxkS2luZDtcbn1cblxuLyoqIEEgZ3JvdXAgb2YgZmllbGRzIHRoYXQgYmVjb21lcyByZXF1aXJlZCBvbmx5IHdoZW4gYHdoZW5gIHJlc29sdmVzIHRvIGEgcHJlc2VudCB2YWx1ZS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29uZGl0aW9uYWxGaWVsZEdyb3VwIHtcbiAgLyoqIERvdC1wYXRoIHdob3NlIHByZXNlbmNlIGFjdGl2YXRlcyB0aGUgZ3JvdXAuICovXG4gIHJlYWRvbmx5IHdoZW46IHN0cmluZztcblxuICAvKiogRmllbGRzIHJlcXVpcmVkIG9uY2UgdGhlIGdyb3VwIGlzIGFjdGl2ZS4gKi9cbiAgcmVhZG9ubHkgZmllbGRzOiBSZXF1aXJlZEZpZWxkW107XG59XG5cbi8qKiBDYWxsZXItc3VwcGxpZWQgZGVzY3JpcHRpb24gb2Ygd2hhdCBhbiBhcHBsaWNhdGlvbidzIGNvbmZpZyBmaWxlIG11c3QgY29udGFpbi4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29uZmlnU2NoZW1hIHtcbiAgLyoqIEZpZWxkcyB3aG9zZSBhYnNlbmNlIGlzIHJlcG9ydGVkIGFzIGBNSVNTSU5HX0tFWWAuICovXG4gIHJlYWRvbmx5IHJlcXVpcmVkS2V5cz86IFJlcXVpcmVkRmllbGRbXTtcblxuICAvKiogRmllbGRzIHdob3NlIGFic2VuY2UgaXMgcmVwb3J0ZWQgYXMgYE1JU1NJTkdfQVRUUklCVVRFYC4gKi9cbiAgcmVhZG9ubHkgcmVxdWlyZWRBdHRyaWJ1dGVzPzogUmVxdWlyZWRGaWVsZFtdO1xuXG4gIC8qKiBDb25kaXRpb25hbGx5IHJlcXVpcmVkIGZpZWxkczsgYWJzZW5jZSBpcyByZXBvcnRlZCBhcyBgTUlTU0lOR19BVFRSSUJVVEVgLiAqL1xuICByZWFkb25seSBjb25kaXRpb25hbEdyb3Vwcz86IENvbmRpdGlvbmFsRmllbGRHcm91cFtdO1xufVxuXG4vKiogUmVhZCBhIGRvdC1wYXRoIChlLmcuIGBhd3MuYWNjb3VudElkYCkgb3V0IG9mIGEgbmVzdGVkIG9iamVjdC4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRCeVBhdGgob2JqOiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiwgZG90UGF0aDogc3RyaW5nKTogdW5rbm93biB7XG4gIHJldHVybiBkb3RQYXRoLnNwbGl0KCcuJykucmVkdWNlPHVua25vd24+KChhY2MsIGtleSkgPT4ge1xuICAgIGlmIChhY2MgIT09IG51bGwgJiYgdHlwZW9mIGFjYyA9PT0gJ29iamVjdCcgJiYgIUFycmF5LmlzQXJyYXkoYWNjKSkge1xuICAgICAgcmV0dXJuIChhY2MgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pW2tleV07XG4gICAgfVxuICAgIHJldHVybiB1bmRlZmluZWQ7XG4gIH0sIG9iaik7XG59XG5cbi8qKiBSZXR1cm5zIHRydWUgd2hlbiBhIHZhbHVlIGlzIGFic2VudCBvciBmYWlscyBpdHMgZGVjbGFyZWQgc2hhcGUuICovXG5leHBvcnQgZnVuY3Rpb24gaXNNaXNzaW5nKHZhbHVlOiB1bmtub3duLCBraW5kOiBGaWVsZEtpbmQpOiBib29sZWFuIHtcbiAgaWYgKHZhbHVlID09PSB1bmRlZmluZWQgfHwgdmFsdWUgPT09IG51bGwpIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxuICBpZiAoa2luZCA9PT0gRmllbGRLaW5kLlNUUklOR19MSVNUKSB7XG4gICAgcmV0dXJuICFBcnJheS5pc0FycmF5KHZhbHVlKSB8fCB2YWx1ZS5sZW5ndGggPT09IDA7XG4gIH1cbiAgcmV0dXJuIHR5cGVvZiB2YWx1ZSAhPT0gJ3N0cmluZycgfHwgdmFsdWUudHJpbSgpLmxlbmd0aCA9PT0gMDtcbn1cblxuLyoqXG4gKiBTdHJ1Y3R1cmFsbHkgdmFsaWRhdGUgYSBwYXJzZWQgY29uZmlnIG9iamVjdCBhZ2FpbnN0IGEgY2FsbGVyLXN1cHBsaWVkIHNjaGVtYS5cbiAqXG4gKiBUaHJvd3MgYSBgQ29uZmlnRXJyb3JgIG5hbWluZyB0aGUgb2ZmZW5kaW5nIGRvdC1wYXRoIGFuZCB0aGUgc291cmNlIGZpbGUsIHNvIHRoZSBmYWlsdXJlIGlzXG4gKiBhY3Rpb25hYmxlIHdoZW4gaXQgc3VyZmFjZXMgdW5jYXVnaHQgYXQgYSBDREsgYXBwIGVudHJ5IHBvaW50LlxuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVDb25maWcocGFyc2VkOiB1bmtub3duLCBmaWxlUGF0aDogc3RyaW5nLCBzY2hlbWE6IENvbmZpZ1NjaGVtYSA9IHt9KTogUmVjb3JkPHN0cmluZywgdW5rbm93bj4ge1xuICBjb25zdCBvYmo6IFJlY29yZDxzdHJpbmcsIHVua25vd24+ID1cbiAgICB0eXBlb2YgcGFyc2VkID09PSAnb2JqZWN0JyAmJiBwYXJzZWQgIT09IG51bGwgJiYgIUFycmF5LmlzQXJyYXkocGFyc2VkKSA/IChwYXJzZWQgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pIDoge307XG5cbiAgZm9yIChjb25zdCBmaWVsZCBvZiBzY2hlbWEucmVxdWlyZWRLZXlzID8/IFtdKSB7XG4gICAgaWYgKGlzTWlzc2luZyhnZXRCeVBhdGgob2JqLCBmaWVsZC5wYXRoKSwgZmllbGQua2luZCkpIHtcbiAgICAgIHRocm93IG5ldyBDb25maWdFcnJvcihcbiAgICAgICAgQ29uZmlnRXJyb3JLaW5kLk1JU1NJTkdfS0VZLFxuICAgICAgICBgTWlzc2luZyBvciBtYWxmb3JtZWQgcmVxdWlyZWQgY29uZmlnIGtleSAnJHtmaWVsZC5wYXRofScgaW4gJHtmaWxlUGF0aH0gKGV4cGVjdGVkICR7ZmllbGQua2luZH0pYCxcbiAgICAgICk7XG4gICAgfVxuICB9XG5cbiAgZm9yIChjb25zdCBmaWVsZCBvZiBzY2hlbWEucmVxdWlyZWRBdHRyaWJ1dGVzID8/IFtdKSB7XG4gICAgYXNzZXJ0QXR0cmlidXRlKG9iaiwgZmllbGQsIGZpbGVQYXRoKTtcbiAgfVxuXG4gIGZvciAoY29uc3QgZ3JvdXAgb2Ygc2NoZW1hLmNvbmRpdGlvbmFsR3JvdXBzID8/IFtdKSB7XG4gICAgLy8gT25seSByZXF1aXJlZCB3aGVuIHRoZSBhY3RpdmF0aW5nIHBhdGggaXMgcHJlc2VudC4gYG51bGxgIGNvdW50cyBhcyBhYnNlbnQ6IGluIFlBTUwgYSBibGFuayBrZXlcbiAgICAvLyAoYHNlY29uZGFyeTpgKSBwYXJzZXMgdG8gYG51bGxgIGFuZCBtZWFucyBcIkkgZGlkIG5vdCBjb25maWd1cmUgdGhpc1wiLCBzbyBpdCBtdXN0IG5vdCBhY3RpdmF0ZSB0aGVcbiAgICAvLyBncm91cCBhbmQgZGVtYW5kIHRoZSBmaWVsZHMgdW5kZXJuZWF0aCBpdC5cbiAgICBjb25zdCBhY3RpdmF0b3IgPSBnZXRCeVBhdGgob2JqLCBncm91cC53aGVuKTtcbiAgICBpZiAoYWN0aXZhdG9yID09PSB1bmRlZmluZWQgfHwgYWN0aXZhdG9yID09PSBudWxsKSB7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG4gICAgZm9yIChjb25zdCBmaWVsZCBvZiBncm91cC5maWVsZHMpIHtcbiAgICAgIGFzc2VydEF0dHJpYnV0ZShvYmosIGZpZWxkLCBmaWxlUGF0aCk7XG4gICAgfVxuICB9XG5cbiAgcmV0dXJuIG9iajtcbn1cblxuZnVuY3Rpb24gYXNzZXJ0QXR0cmlidXRlKG9iajogUmVjb3JkPHN0cmluZywgdW5rbm93bj4sIGZpZWxkOiBSZXF1aXJlZEZpZWxkLCBmaWxlUGF0aDogc3RyaW5nKTogdm9pZCB7XG4gIGlmIChpc01pc3NpbmcoZ2V0QnlQYXRoKG9iaiwgZmllbGQucGF0aCksIGZpZWxkLmtpbmQpKSB7XG4gICAgdGhyb3cgbmV3IENvbmZpZ0Vycm9yKFxuICAgICAgQ29uZmlnRXJyb3JLaW5kLk1JU1NJTkdfQVRUUklCVVRFLFxuICAgICAgYE1pc3Npbmcgb3IgbWFsZm9ybWVkIHJlcXVpcmVkIGNvbmZpZyBhdHRyaWJ1dGUgJyR7ZmllbGQucGF0aH0nIGluICR7ZmlsZVBhdGh9IChleHBlY3RlZCAke2ZpZWxkLmtpbmR9KWAsXG4gICAgKTtcbiAgfVxufVxuIl19
@@ -0,0 +1,41 @@
1
+ /** How the pushed image is tagged. */
2
+ export declare enum ImageTagStrategy {
3
+ /** Tag with the resolved source commit sha (CODEBUILD_RESOLVED_SOURCE_VERSION). The default. */
4
+ GIT_SHA = "git_sha",
5
+ /** Tag `latest` only. Simplest, but not immutable -- prefer GIT_SHA for real pipelines. */
6
+ LATEST = "latest"
7
+ }
8
+ /** Props for {@link BuildImage.docker}. */
9
+ export interface DockerBuildProps {
10
+ /** Path to the Dockerfile in the source, relative to its root. Defaults to `Dockerfile`. */
11
+ readonly dockerfile?: string;
12
+ /**
13
+ * Name of the ECR repository to push to. When omitted the pipeline PROVISIONS one named
14
+ * `<application>-deployer`; when set to an existing repo name the pipeline references it and only needs
15
+ * push permission. (A full registry URI is derived at deploy time from the pipeline's own account.)
16
+ */
17
+ readonly repositoryName?: string;
18
+ /** How the image is tagged. Defaults to {@link ImageTagStrategy.GIT_SHA}. */
19
+ readonly tagStrategy?: ImageTagStrategy;
20
+ }
21
+ /** What kind of artifact the build produces. Only Docker today; kept an enum so more can slot in. */
22
+ export declare enum BuildImageKind {
23
+ DOCKER = "docker"
24
+ }
25
+ /**
26
+ * A deployer-image build. Constructed through the static factory (`BuildImage.docker({...})`) so the
27
+ * shape a caller writes reads cleanly in every jsii language, mirroring {@link Repository}.
28
+ */
29
+ export declare class BuildImage {
30
+ /** Build and push a Docker deployer image to ECR. */
31
+ static docker(props?: DockerBuildProps): BuildImage;
32
+ /** The artifact kind. */
33
+ readonly kind: BuildImageKind;
34
+ /** Dockerfile path relative to the source root. */
35
+ readonly dockerfile: string;
36
+ /** Image tag strategy. */
37
+ readonly tagStrategy: ImageTagStrategy;
38
+ /** ECR repository name to push to; when undefined the pipeline provisions `<application>-deployer`. */
39
+ readonly repositoryName?: string;
40
+ private constructor();
41
+ }
@@ -0,0 +1,46 @@
1
+ "use strict";
2
+ var _a;
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.BuildImage = exports.BuildImageKind = exports.ImageTagStrategy = void 0;
5
+ const JSII_RTTI_SYMBOL_1 = Symbol.for("jsii.rtti");
6
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
7
+ // SPDX-License-Identifier: Apache-2.0
8
+ //
9
+ // The Docker deployer-image build for the two-repo container mode (Repo 1). When a config carries a
10
+ // `build`, the CodePipeline engine renders a SECONDARY pipeline that runs CI and then builds & pushes a
11
+ // config-agnostic deployer image to ECR -- it deploys nothing. The image payload is the CDK app + its
12
+ // npm deps (installed in the image), NOT `cdk.out`, so Repo 2 can synth-and-deploy it offline against any
13
+ // target's config. See docs/design/v3-devops-experience.md (Level 2, two-repository split).
14
+ /** How the pushed image is tagged. */
15
+ var ImageTagStrategy;
16
+ (function (ImageTagStrategy) {
17
+ /** Tag with the resolved source commit sha (CODEBUILD_RESOLVED_SOURCE_VERSION). The default. */
18
+ ImageTagStrategy["GIT_SHA"] = "git_sha";
19
+ /** Tag `latest` only. Simplest, but not immutable -- prefer GIT_SHA for real pipelines. */
20
+ ImageTagStrategy["LATEST"] = "latest";
21
+ })(ImageTagStrategy || (exports.ImageTagStrategy = ImageTagStrategy = {}));
22
+ /** What kind of artifact the build produces. Only Docker today; kept an enum so more can slot in. */
23
+ var BuildImageKind;
24
+ (function (BuildImageKind) {
25
+ BuildImageKind["DOCKER"] = "docker";
26
+ })(BuildImageKind || (exports.BuildImageKind = BuildImageKind = {}));
27
+ /**
28
+ * A deployer-image build. Constructed through the static factory (`BuildImage.docker({...})`) so the
29
+ * shape a caller writes reads cleanly in every jsii language, mirroring {@link Repository}.
30
+ */
31
+ class BuildImage {
32
+ /** Build and push a Docker deployer image to ECR. */
33
+ static docker(props = {}) {
34
+ return new BuildImage(BuildImageKind.DOCKER, props.dockerfile ?? 'Dockerfile', props.tagStrategy ?? ImageTagStrategy.GIT_SHA, props.repositoryName);
35
+ }
36
+ constructor(kind, dockerfile, tagStrategy, repositoryName) {
37
+ this.kind = kind;
38
+ this.dockerfile = dockerfile;
39
+ this.tagStrategy = tagStrategy;
40
+ this.repositoryName = repositoryName;
41
+ }
42
+ }
43
+ exports.BuildImage = BuildImage;
44
+ _a = JSII_RTTI_SYMBOL_1;
45
+ BuildImage[_a] = { fqn: "@cdklabs/cdk-cicd-wrapper.BuildImage", version: "1.0.1" };
46
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQtaW1hZ2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL2J1aWxkLWltYWdlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEscUVBQXFFO0FBQ3JFLHNDQUFzQztBQUN0QyxFQUFFO0FBQ0Ysb0dBQW9HO0FBQ3BHLHdHQUF3RztBQUN4RyxzR0FBc0c7QUFDdEcsMEdBQTBHO0FBQzFHLDRGQUE0RjtBQUU1RixzQ0FBc0M7QUFDdEMsSUFBWSxnQkFLWDtBQUxELFdBQVksZ0JBQWdCO0lBQzFCLGdHQUFnRztJQUNoRyx1Q0FBbUIsQ0FBQTtJQUNuQiwyRkFBMkY7SUFDM0YscUNBQWlCLENBQUE7QUFDbkIsQ0FBQyxFQUxXLGdCQUFnQixnQ0FBaEIsZ0JBQWdCLFFBSzNCO0FBZ0JELHFHQUFxRztBQUNyRyxJQUFZLGNBRVg7QUFGRCxXQUFZLGNBQWM7SUFDeEIsbUNBQWlCLENBQUE7QUFDbkIsQ0FBQyxFQUZXLGNBQWMsOEJBQWQsY0FBYyxRQUV6QjtBQUVEOzs7R0FHRztBQUNILE1BQWEsVUFBVTtJQUNyQixxREFBcUQ7SUFDOUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxRQUEwQixFQUFFO1FBQy9DLE9BQU8sSUFBSSxVQUFVLENBQ25CLGNBQWMsQ0FBQyxNQUFNLEVBQ3JCLEtBQUssQ0FBQyxVQUFVLElBQUksWUFBWSxFQUNoQyxLQUFLLENBQUMsV0FBVyxJQUFJLGdCQUFnQixDQUFDLE9BQU8sRUFDN0MsS0FBSyxDQUFDLGNBQWMsQ0FDckIsQ0FBQztJQUNKLENBQUM7SUFXRCxZQUNFLElBQW9CLEVBQ3BCLFVBQWtCLEVBQ2xCLFdBQTZCLEVBQzdCLGNBQXVCO1FBRXZCLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFDO1FBQzdCLElBQUksQ0FBQyxXQUFXLEdBQUcsV0FBVyxDQUFDO1FBQy9CLElBQUksQ0FBQyxjQUFjLEdBQUcsY0FBYyxDQUFDO0lBQ3ZDLENBQUM7O0FBOUJILGdDQStCQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIENvcHlyaWdodCBBbWF6b24uY29tLCBJbmMuIG9yIGl0cyBhZmZpbGlhdGVzLiBBbGwgUmlnaHRzIFJlc2VydmVkLlxuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcbi8vXG4vLyBUaGUgRG9ja2VyIGRlcGxveWVyLWltYWdlIGJ1aWxkIGZvciB0aGUgdHdvLXJlcG8gY29udGFpbmVyIG1vZGUgKFJlcG8gMSkuIFdoZW4gYSBjb25maWcgY2FycmllcyBhXG4vLyBgYnVpbGRgLCB0aGUgQ29kZVBpcGVsaW5lIGVuZ2luZSByZW5kZXJzIGEgU0VDT05EQVJZIHBpcGVsaW5lIHRoYXQgcnVucyBDSSBhbmQgdGhlbiBidWlsZHMgJiBwdXNoZXMgYVxuLy8gY29uZmlnLWFnbm9zdGljIGRlcGxveWVyIGltYWdlIHRvIEVDUiAtLSBpdCBkZXBsb3lzIG5vdGhpbmcuIFRoZSBpbWFnZSBwYXlsb2FkIGlzIHRoZSBDREsgYXBwICsgaXRzXG4vLyBucG0gZGVwcyAoaW5zdGFsbGVkIGluIHRoZSBpbWFnZSksIE5PVCBgY2RrLm91dGAsIHNvIFJlcG8gMiBjYW4gc3ludGgtYW5kLWRlcGxveSBpdCBvZmZsaW5lIGFnYWluc3QgYW55XG4vLyB0YXJnZXQncyBjb25maWcuIFNlZSBkb2NzL2Rlc2lnbi92My1kZXZvcHMtZXhwZXJpZW5jZS5tZCAoTGV2ZWwgMiwgdHdvLXJlcG9zaXRvcnkgc3BsaXQpLlxuXG4vKiogSG93IHRoZSBwdXNoZWQgaW1hZ2UgaXMgdGFnZ2VkLiAqL1xuZXhwb3J0IGVudW0gSW1hZ2VUYWdTdHJhdGVneSB7XG4gIC8qKiBUYWcgd2l0aCB0aGUgcmVzb2x2ZWQgc291cmNlIGNvbW1pdCBzaGEgKENPREVCVUlMRF9SRVNPTFZFRF9TT1VSQ0VfVkVSU0lPTikuIFRoZSBkZWZhdWx0LiAqL1xuICBHSVRfU0hBID0gJ2dpdF9zaGEnLFxuICAvKiogVGFnIGBsYXRlc3RgIG9ubHkuIFNpbXBsZXN0LCBidXQgbm90IGltbXV0YWJsZSAtLSBwcmVmZXIgR0lUX1NIQSBmb3IgcmVhbCBwaXBlbGluZXMuICovXG4gIExBVEVTVCA9ICdsYXRlc3QnLFxufVxuXG4vKiogUHJvcHMgZm9yIHtAbGluayBCdWlsZEltYWdlLmRvY2tlcn0uICovXG5leHBvcnQgaW50ZXJmYWNlIERvY2tlckJ1aWxkUHJvcHMge1xuICAvKiogUGF0aCB0byB0aGUgRG9ja2VyZmlsZSBpbiB0aGUgc291cmNlLCByZWxhdGl2ZSB0byBpdHMgcm9vdC4gRGVmYXVsdHMgdG8gYERvY2tlcmZpbGVgLiAqL1xuICByZWFkb25seSBkb2NrZXJmaWxlPzogc3RyaW5nO1xuICAvKipcbiAgICogTmFtZSBvZiB0aGUgRUNSIHJlcG9zaXRvcnkgdG8gcHVzaCB0by4gV2hlbiBvbWl0dGVkIHRoZSBwaXBlbGluZSBQUk9WSVNJT05TIG9uZSBuYW1lZFxuICAgKiBgPGFwcGxpY2F0aW9uPi1kZXBsb3llcmA7IHdoZW4gc2V0IHRvIGFuIGV4aXN0aW5nIHJlcG8gbmFtZSB0aGUgcGlwZWxpbmUgcmVmZXJlbmNlcyBpdCBhbmQgb25seSBuZWVkc1xuICAgKiBwdXNoIHBlcm1pc3Npb24uIChBIGZ1bGwgcmVnaXN0cnkgVVJJIGlzIGRlcml2ZWQgYXQgZGVwbG95IHRpbWUgZnJvbSB0aGUgcGlwZWxpbmUncyBvd24gYWNjb3VudC4pXG4gICAqL1xuICByZWFkb25seSByZXBvc2l0b3J5TmFtZT86IHN0cmluZztcbiAgLyoqIEhvdyB0aGUgaW1hZ2UgaXMgdGFnZ2VkLiBEZWZhdWx0cyB0byB7QGxpbmsgSW1hZ2VUYWdTdHJhdGVneS5HSVRfU0hBfS4gKi9cbiAgcmVhZG9ubHkgdGFnU3RyYXRlZ3k/OiBJbWFnZVRhZ1N0cmF0ZWd5O1xufVxuXG4vKiogV2hhdCBraW5kIG9mIGFydGlmYWN0IHRoZSBidWlsZCBwcm9kdWNlcy4gT25seSBEb2NrZXIgdG9kYXk7IGtlcHQgYW4gZW51bSBzbyBtb3JlIGNhbiBzbG90IGluLiAqL1xuZXhwb3J0IGVudW0gQnVpbGRJbWFnZUtpbmQge1xuICBET0NLRVIgPSAnZG9ja2VyJyxcbn1cblxuLyoqXG4gKiBBIGRlcGxveWVyLWltYWdlIGJ1aWxkLiBDb25zdHJ1Y3RlZCB0aHJvdWdoIHRoZSBzdGF0aWMgZmFjdG9yeSAoYEJ1aWxkSW1hZ2UuZG9ja2VyKHsuLi59KWApIHNvIHRoZVxuICogc2hhcGUgYSBjYWxsZXIgd3JpdGVzIHJlYWRzIGNsZWFubHkgaW4gZXZlcnkganNpaSBsYW5ndWFnZSwgbWlycm9yaW5nIHtAbGluayBSZXBvc2l0b3J5fS5cbiAqL1xuZXhwb3J0IGNsYXNzIEJ1aWxkSW1hZ2Uge1xuICAvKiogQnVpbGQgYW5kIHB1c2ggYSBEb2NrZXIgZGVwbG95ZXIgaW1hZ2UgdG8gRUNSLiAqL1xuICBwdWJsaWMgc3RhdGljIGRvY2tlcihwcm9wczogRG9ja2VyQnVpbGRQcm9wcyA9IHt9KTogQnVpbGRJbWFnZSB7XG4gICAgcmV0dXJuIG5ldyBCdWlsZEltYWdlKFxuICAgICAgQnVpbGRJbWFnZUtpbmQuRE9DS0VSLFxuICAgICAgcHJvcHMuZG9ja2VyZmlsZSA/PyAnRG9ja2VyZmlsZScsXG4gICAgICBwcm9wcy50YWdTdHJhdGVneSA/PyBJbWFnZVRhZ1N0cmF0ZWd5LkdJVF9TSEEsXG4gICAgICBwcm9wcy5yZXBvc2l0b3J5TmFtZSxcbiAgICApO1xuICB9XG5cbiAgLyoqIFRoZSBhcnRpZmFjdCBraW5kLiAqL1xuICBwdWJsaWMgcmVhZG9ubHkga2luZDogQnVpbGRJbWFnZUtpbmQ7XG4gIC8qKiBEb2NrZXJmaWxlIHBhdGggcmVsYXRpdmUgdG8gdGhlIHNvdXJjZSByb290LiAqL1xuICBwdWJsaWMgcmVhZG9ubHkgZG9ja2VyZmlsZTogc3RyaW5nO1xuICAvKiogSW1hZ2UgdGFnIHN0cmF0ZWd5LiAqL1xuICBwdWJsaWMgcmVhZG9ubHkgdGFnU3RyYXRlZ3k6IEltYWdlVGFnU3RyYXRlZ3k7XG4gIC8qKiBFQ1IgcmVwb3NpdG9yeSBuYW1lIHRvIHB1c2ggdG87IHdoZW4gdW5kZWZpbmVkIHRoZSBwaXBlbGluZSBwcm92aXNpb25zIGA8YXBwbGljYXRpb24+LWRlcGxveWVyYC4gKi9cbiAgcHVibGljIHJlYWRvbmx5IHJlcG9zaXRvcnlOYW1lPzogc3RyaW5nO1xuXG4gIHByaXZhdGUgY29uc3RydWN0b3IoXG4gICAga2luZDogQnVpbGRJbWFnZUtpbmQsXG4gICAgZG9ja2VyZmlsZTogc3RyaW5nLFxuICAgIHRhZ1N0cmF0ZWd5OiBJbWFnZVRhZ1N0cmF0ZWd5LFxuICAgIHJlcG9zaXRvcnlOYW1lPzogc3RyaW5nLFxuICApIHtcbiAgICB0aGlzLmtpbmQgPSBraW5kO1xuICAgIHRoaXMuZG9ja2VyZmlsZSA9IGRvY2tlcmZpbGU7XG4gICAgdGhpcy50YWdTdHJhdGVneSA9IHRhZ1N0cmF0ZWd5O1xuICAgIHRoaXMucmVwb3NpdG9yeU5hbWUgPSByZXBvc2l0b3J5TmFtZTtcbiAgfVxufVxuIl19
@@ -0,0 +1,137 @@
1
+ import { aws_codebuild as codebuild } from 'aws-cdk-lib';
2
+ import { BuildImage } from './build-image';
3
+ import { Repository } from './repository';
4
+ import { CodeArtifactConfig, DeployModel, DeploymentConfig, EngineType, GitHubActionsConfig, NpmRegistryConfig, RegionOrder, ResolvedCicdConfig, ResolvedDeploymentConfig, SynthesizerType, VpcConfig } from './types';
5
+ /** A stage's target environment, as written. Either `region` (one) or `regions` (many). */
6
+ export interface StageEnvInput {
7
+ readonly account?: string;
8
+ readonly region?: string;
9
+ readonly regions?: string[];
10
+ readonly regionOrder?: RegionOrder;
11
+ }
12
+ /** A stage, as written: a full object (bare-name string form is handled at the array level). */
13
+ export interface StageInput {
14
+ readonly name: string;
15
+ readonly env?: StageEnvInput;
16
+ readonly manualApproval?: boolean;
17
+ readonly deployment?: DeploymentConfig;
18
+ }
19
+ /** CI config as written. `synthStages` may be the string `'all'` or an explicit list. */
20
+ export interface CiConfigInput {
21
+ readonly steps?: {
22
+ [key: string]: string;
23
+ };
24
+ readonly synthStages?: string[] | 'all';
25
+ readonly image?: string;
26
+ /** Escape hatch: a CodeBuild spec fragment merged into the CI build project. See `CiConfig.partialBuildSpec`. */
27
+ readonly partialBuildSpec?: codebuild.BuildSpec;
28
+ }
29
+ /** Proxy config as written: `noProxy`/`proxyTestUrl` are optional, defaulted by `normalizeProxy`. */
30
+ export interface ProxyConfigInput {
31
+ readonly proxySecretArn: string;
32
+ readonly noProxy?: string[];
33
+ readonly proxyTestUrl?: string;
34
+ }
35
+ /** What a user passes to `defineCICD`. Deliberately permissive; normalized to `ResolvedCicdConfig`. */
36
+ export interface CicdConfigProps {
37
+ readonly application?: string;
38
+ readonly qualifier?: string;
39
+ readonly repository: Repository;
40
+ /** Each stage is either a bare name (`'dev'`) or a full object. */
41
+ readonly stages: Array<string | StageInput>;
42
+ readonly synthesizer?: {
43
+ readonly type?: SynthesizerType;
44
+ };
45
+ readonly engine?: EngineType;
46
+ /** GitHub Actions engine configuration. Only read when `engine` is `EngineType.GITHUB_ACTIONS`. */
47
+ readonly githubActions?: GitHubActionsConfig;
48
+ readonly ci?: CiConfigInput;
49
+ readonly codeArtifact?: CodeArtifactConfig;
50
+ /** Generic private npm registry the builds authenticate against. See `ResolvedCicdConfig.npmRegistry`. */
51
+ readonly npmRegistry?: NpmRegistryConfig;
52
+ /** HTTP(S) proxy every build project routes through. See `ResolvedCicdConfig.proxy`. */
53
+ readonly proxy?: ProxyConfigInput;
54
+ /** VPC every CodeBuild project runs in. See `ResolvedCicdConfig.vpc`. */
55
+ readonly vpc?: VpcConfig;
56
+ /** Compliance/access-log destination bucket name. See `ResolvedCicdConfig.complianceLogBucketName`. */
57
+ readonly complianceLogBucketName?: string;
58
+ /**
59
+ * CodeBuild environment overrides (privileged mode, compute type, environment variables) applied to
60
+ * every CodeBuild project. See `ResolvedCicdConfig.codeBuildEnvSettings`.
61
+ */
62
+ readonly codeBuildEnvSettings?: codebuild.BuildEnvironment;
63
+ /** How the deployed assembly is produced. Defaults to `DeployModel.ASSEMBLY_PROMOTION`. */
64
+ readonly deployModel?: DeployModel;
65
+ /** Let a Lambda execute and await CloudFormation instead of paying build compute to wait. Off by default. */
66
+ readonly asyncDeploy?: boolean;
67
+ /**
68
+ * Deploy with CloudFormation express mode (`cdk deploy --express`): CloudFormation reports completion
69
+ * without waiting for resource stabilization -- faster, but rollback is disabled (a failed deploy is
70
+ * left in a failed state). Not recommended for production (AWS guidance); targets fast iterative
71
+ * deployments. Off by default.
72
+ */
73
+ readonly express?: boolean;
74
+ /** Container mode (Repo 1): build & push a deployer image to ECR instead of deploying. See `BuildImage`. */
75
+ readonly deployerImage?: BuildImage;
76
+ }
77
+ /**
78
+ * Normalize an already-parsed config object (e.g. from a `cicd.config.yaml`) into the resolved shape.
79
+ * Shared with `defineCICD` so YAML and TS authoring get identical defaults.
80
+ */
81
+ export declare function resolveCicdConfig(props: CicdConfigProps): ResolvedCicdConfig;
82
+ /**
83
+ * The Level-1 entry point a user writes in `cicd.config.ts`:
84
+ *
85
+ * ```ts
86
+ * export default defineCICD({
87
+ * application: 'my-app',
88
+ * repository: Repository.github('org/my-app'),
89
+ * stages: [{ name: 'dev', env: { account: '...', region: 'us-east-1' } }, 'prod'],
90
+ * });
91
+ * ```
92
+ */
93
+ export declare const defineCICD: typeof resolveCicdConfig;
94
+ /** A deployment target, as written in Repo 2's `deploy.config.ts`. `env` takes one region or many. */
95
+ export interface DeploymentTargetInput {
96
+ readonly stage: string;
97
+ readonly env?: StageEnvInput;
98
+ readonly manualApproval?: boolean;
99
+ readonly deployment?: DeploymentConfig;
100
+ /** This target's deployer image (tag/digest), overriding the top-level `image` -- the per-stage version. */
101
+ readonly image?: string;
102
+ }
103
+ /** What a user passes to `defineDeployment` (Repo 2). Deliberately permissive; normalized to resolved structs. */
104
+ export interface DeploymentProps {
105
+ /** Default deployer image (an ECR/OCI reference, tag or digest); optional if every target pins its own `image`. */
106
+ readonly image?: string;
107
+ /** The targets to run the image against, in order. */
108
+ readonly targets: DeploymentTargetInput[];
109
+ /**
110
+ * The config-only source repository the CD pipeline watches (where this `deploy.config.ts` lives).
111
+ * Omit for the local `cdk-cicd deploy --from-image` executor; set it to provision a CD CodePipeline
112
+ * with `cdk-cicd deploy-ci` (source -> CodeBuild that runs the image against each target).
113
+ */
114
+ readonly repository?: Repository;
115
+ /** Private CodeArtifact repo the CD build logs into before `npm ci` (for a pre-release wrapper CLI). */
116
+ readonly codeArtifact?: CodeArtifactConfig;
117
+ /** Generic private npm registry the CD build authenticates against before `npm ci`. */
118
+ readonly npmRegistry?: NpmRegistryConfig;
119
+ }
120
+ /**
121
+ * The container-mode (Repo 2) entry point a user writes in `deploy.config.ts`:
122
+ *
123
+ * ```ts
124
+ * export default defineDeployment({
125
+ * image: 'ACCT.dkr.ecr.eu-west-1.amazonaws.com/my-app-deployer:1.4.2',
126
+ * targets: [
127
+ * { stage: 'dev', env: { account: '...', region: 'eu-west-1' } },
128
+ * { stage: 'prod', env: { account: '...', regions: ['eu-west-1', 'us-east-1'] }, manualApproval: true },
129
+ * ],
130
+ * });
131
+ * ```
132
+ *
133
+ * TS-only for the same reason as `defineCICD`: jsii silently omits free functions, and this is loaded
134
+ * in-process by the CLI (via ts-node) so it never crosses the jsii boundary. Only the resolved
135
+ * `ResolvedDeploymentConfig` is jsii-modeled.
136
+ */
137
+ export declare function defineDeployment(props: DeploymentProps): ResolvedDeploymentConfig;