@flit/cdk-pipeline 1.1.2 → 1.2.1

package/.jsii

@@ -1,6 +1,5 @@
 {
   "author": {
-    "email": "luis@jumper.de",
     "name": "Luis Vierroth",
     "roles": [
       "author"
@@ -8,8 +7,8 @@
     "url": "https://github.com/p-mercury"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.163.0",
-    "constructs": "^10.4.2"
+    "aws-cdk-lib": "^2.174.0",
+    "constructs": "^10.4.0"
   },
   "dependencyClosure": {
     "@aws-cdk/asset-awscli-v1": {
@@ -1878,19 +1877,6 @@
             }
           }
         },
-        "aws-cdk-lib.aws_iot1click": {
-          "targets": {
-            "dotnet": {
-              "namespace": "Amazon.CDK.AWS.IoT1Click"
-            },
-            "java": {
-              "package": "software.amazon.awscdk.services.iot1click"
-            },
-            "python": {
-              "module": "aws_cdk.aws_iot1click"
-            }
-          }
-        },
         "aws-cdk-lib.aws_iotanalytics": {
           "targets": {
             "dotnet": {
@@ -2736,6 +2722,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_pcs": {
+          "targets": {
+            "dotnet": {
+              "package": "Amazon.CDK.AWS.PCS"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.pcs"
+            },
+            "python": {
+              "module": "aws_cdk.aws_pcs"
+            }
+          }
+        },
         "aws-cdk-lib.aws_personalize": {
           "targets": {
             "dotnet": {
@@ -3191,6 +3190,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_s3tables": {
+          "targets": {
+            "dotnet": {
+              "package": "Amazon.CDK.AWS.S3Tables"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.s3tables"
+            },
+            "python": {
+              "module": "aws_cdk.aws_s3tables"
+            }
+          }
+        },
         "aws-cdk-lib.aws_sagemaker": {
           "targets": {
             "dotnet": {
@@ -3899,8 +3911,8 @@
   "docs": {
     "stability": "stable"
   },
-  "homepage": "https://github.com/jumper-de/cdk-pipeline",
-  "jsiiVersion": "5.7.2 (build 224a3f3)",
+  "homepage": "https://github.com/vierroth/cdk-pipeline",
+  "jsiiVersion": "5.7.4 (build fc2a28e)",
   "keywords": [
     "aws",
     "cdk",
@@ -3921,11 +3933,11 @@
   },
   "name": "@flit/cdk-pipeline",
   "readme": {
-    "markdown": "This library exposes a highly customizable and extensible L3 pipeline construct intended as an alternative to the CDK native L3 [CodePipeline](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.pipelines.CodePipeline.html) construct which has some inherent limitations in capability and extensibility.\n\nThe documentation provides the tools and documentation to get your own pipeline up and running and build your own custom segments.\n\n## Usage\n\n### Installation\n\nThe package is available on [NPM](https://www.npmjs.com/package/@flit/cdk-pipeline) and can be installed using your package manager of choice:\n\n```bash\nnpm i @flit/cdk-pipeline\n```\n\n```bash\npnpm add @flit/cdk-pipeline\n```\n\n```bash\nyarn add @flit/cdk-pipeline\n```\n\n### Basics\n\nThe snippet bellow is a basic example of a pipeline which will run whenever a change is detected in a GitHub repository. The pipeline will update itself and, deploy and update a user defined stack. This example demonstrates the three basic elements that make up a pipeline:\n\n#### - Pipeline\n\nThe `Pipeline` construct will create a CloudFormation Stack which contains the pipeline and all of the required peripheral resources to make it work.\n\n#### - Segment\n\nA `Segment` is simply a pre-configured set of pipeline actions which together represent a commonly used CI/CD pattern, like for example building and deploying a stack.\n\nTo build properly, a Pipeline requires at least one SourceSegment, exactly one PipelineSegment and at least one other segment.\n\n#### - Artifact\n\nAn `Artifact` represents a pipeline artifact which can be used to pass information between stages. Every artifact needs to be the output of exactly one Segment and can be consumed by any segments that need that output.\n\n```typescript\nimport { App, SecretValue, Stack } from \"aws-cdk-lib\";\nimport {\n  Pipeline,\n  GitHubSourceSegment,\n  PipelineSegment,\n  StackSegment,\n  Artifact,\n} from \"@flit/cdk-pipeline\";\n\nconst APP = new App();\n\nconst SOURCE_ARTIFACT = new Artifact();\nconst BUILD_ARTIFACT = new Artifact();\n\nnew Pipeline(APP, \"Pipeline\", {\n  rootDir: \"./\",\n  segments: [\n    new CodeStarSourceSegment({\n      output: SOURCE_ARTIFACT,\n      connectionArn: \"code-star-connection-arn\",\n      owner: \"owner-name\",\n      repository: \"repo-name\",\n      branch: \"branch-name\",\n    }),\n    new PipelineSegment({\n      input: SOURCE_ARTIFACT,\n      output: BUILD_ARTIFACT,\n      project: {\n        environment: {\n          computeType: ComputeType.MEDIUM,\n          buildImage: LinuxBuildImage.AMAZON_LINUX_2_ARM_3,\n          privileged: true,\n        },\n        buildSpec: BuildSpec.fromObject({\n          version: \"0.2\",\n          phases: {\n            install: {\n              \"runtime-versions\": {\n                nodejs: \"latest\",\n              },\n              commands: [\"npm i -g npm@latest\", \"npm ci\"],\n            },\n            build: {\n              commands: \"cdk synth --strict --quiet\",\n            },\n          },\n        }),\n      },\n    }),\n    new StackSegment({\n      stack: new Stack(APP, \"BackEnd\"),\n      input: BUILD_ARTIFACT,\n    }),\n  ],\n});\n```\n\nThe above code would produce a pipeline similar to this:\n\n<img src=\"./media/pipeline-ouput-example.png?raw=true\" alt=\"alt text\" width=\"300px\">\n\n### Multiple stacks\n\nTo add another stack to the pipeline you simply add another `StackSegment` with a new stack instance and the pipeline will handle the rest.\n\n```typescript\nimport { App, SecretValue, Stack } from \"aws-cdk-lib\";\nimport {\n  Pipeline,\n  GitHubSourceSegment,\n  PipelineSegment,\n  StackSegment,\n  Artifact,\n} from \"@flit/cdk-pipeline\";\n\nconst APP = new App();\n\nconst SOURCE_ARTIFACT = new Artifact();\nconst BUILD_ARTIFACT = new Artifact();\n\nnew Pipeline(APP, \"Pipeline\", {\n  rootDir: \"./\",\n  segments: [\n    new CodeStarSourceSegment({\n      output: SOURCE_ARTIFACT,\n      connectionArn: \"code-star-connection-arn\",\n      owner: \"owner-name\",\n      repository: \"repo-name\",\n      branch: \"branch-name\",\n    }),\n    new PipelineSegment({\n      input: SOURCE_ARTIFACT,\n      output: BUILD_ARTIFACT,\n      project: {\n        environment: {\n          computeType: ComputeType.MEDIUM,\n          buildImage: LinuxBuildImage.AMAZON_LINUX_2_ARM_3,\n          privileged: true,\n        },\n        buildSpec: BuildSpec.fromObject({\n          version: \"0.2\",\n          phases: {\n            install: {\n              \"runtime-versions\": {\n                nodejs: \"latest\",\n              },\n              commands: [\"npm i -g npm@latest\", \"npm ci\"],\n            },\n            build: {\n              commands: \"cdk synth --strict --quiet\",\n            },\n          },\n        }),\n      },\n    }),\n    new StackSegment({\n      stack: new Stack(APP, \"BackEnd\"),\n      input: BUILD_ARTIFACT,\n    }),\n    new StackSegment({\n      stack: new Stack(APP, \"FrontEnd\"),\n      input: BUILD_ARTIFACT,\n    }),\n  ],\n});\n```\n\n### More complex example\n\nIn some cases you might have a build that bakes API endpoints generated by a previous stage into the stack assets during the build stage. Using the CDK native L3 [CodePipeline](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.pipelines.CodePipeline.html) construct makes this hard, but with this more flexible setup you can run another build for any stack that needs it, and use the previous stacks outputs in that build.\n\n```typescript\nimport { App, SecretValue, Stack } from \"aws-cdk-lib\";\nimport {\n  Pipeline,\n  GitHubSourceSegment,\n  PipelineSegment,\n  StackSegment,\n  Artifact,\n} from \"@flit/cdk-pipeline\";\n\nconst APP = new App();\n\nconst SOURCE_ARTIFACT = new Artifact();\nconst BUILD_ARTIFACT = new Artifact();\nconst FRONT_END_OUTPUT_ARTIFACT = new Artifact();\n\nnew Pipeline(APP, \"Pipeline\", {\n  rootDir: \"./\",\n  segments: [\n    new CodeStarSourceSegment({\n      output: SOURCE_ARTIFACT,\n      connectionArn: \"code-star-connection-arn\",\n      owner: \"owner-name\",\n      repository: \"repo-name\",\n      branch: \"branch-name\",\n    }),\n    new PipelineSegment({\n      input: SOURCE_ARTIFACT,\n      output: BUILD_ARTIFACT,\n      project: {\n        environment: {\n          computeType: ComputeType.MEDIUM,\n          buildImage: LinuxBuildImage.AMAZON_LINUX_2_ARM_3,\n          privileged: true,\n        },\n        buildSpec: BuildSpec.fromObject({\n          version: \"0.2\",\n          phases: {\n            install: {\n              \"runtime-versions\": {\n                nodejs: \"latest\",\n              },\n              commands: [\"npm i -g npm@latest\", \"npm ci\"],\n            },\n            build: {\n              commands: \"cdk synth --strict --quiet\",\n            },\n          },\n        }),\n      },\n    }),\n    new StackSegment({\n      stack: new Stack(APP, \"BackEnd\"),\n      input: BUILD_ARTIFACT,\n      output: FRONT_END_OUTPUT_ARTIFACT,\n    }),\n    new StackSegment({\n      stack: new Stack(APP, \"FrontEnd\"),\n      input: [SOURCE_ARTIFACT, FRONT_END_OUTPUT_ARTIFACT],\n      project: {\n        environment: {\n          computeType: ComputeType.MEDIUM,\n          buildImage: LinuxBuildImage.AMAZON_LINUX_2_ARM_3,\n          privileged: true,\n        },\n        buildSpec: BuildSpec.fromObject({\n          version: \"0.2\",\n          phases: {\n            install: {\n              \"runtime-versions\": {\n                nodejs: \"latest\",\n              },\n              commands: [\"npm i -g npm@latest\", \"npm ci\"],\n            },\n            build: {\n              commands: [\n                \"do something with the STACK_1_OUTPUT_ARTIFACT\",\n                \"cdk synth --strict --quiet\",\n              ],\n            },\n          },\n        }),\n      },\n    }),\n  ],\n});\n```\n\nThis example first build the project, deploys the `Pipeline` and `BackEnd` stacks and then rebuilds the project now with access to the outputs of the `BackEnd` stack. This allows you to now bake in any API endpoints dynamically generated in the `BackEnd` stack.\n\n### Building your own segment\n\nThe snippet bellow is a basic example showing a custom segment which simply adds a stage with two manual approval steps into the pipeline and allows you to optional give this step a name.\n\nEach segment has two components consisting of two distinct classes:\n\n### - Segment\n\nThe main segment class is the class that will be used in your pipeline definition, and can be created by extending the `Segment` abstract class.\n\nThis class **should not** itself create any actual CDK constructs and is simply there to collect configuration trough the `constructor`. The `constructor` should take a single parameter called `props` which is a descendant of the `SegmentProps` interface.\n\nThe segment class also has to define the `construct` abstract function which returns an instance of a descendant of the `SegmentConstructed` abstract class.\n\n### - SegmentConstructed\n\nThis class will be returned by the `construct` function of your segment class and is itself a CDK construct. So in this class you can now allocate the CDK resources this segment requires as you are used to in any other CDK application.\n\nYou can pass any configuration information previously collected in the segment class trough the constructor.\n\n```typescript\nimport { IAction } from \"aws-cdk-lib/aws-codepipeline\";\nimport { ManualApprovalAction } from \"aws-cdk-lib/aws-codepipeline-actions\";\n\nimport { Segment, SegmentConstructed } from \"./segment\";\nimport { Pipeline } from \"./pipeline\";\n\nexport interface RequireApprovalSegmentProps {\n  readonly name?: string;\n}\n\n/**\n * @category Segments\n */\nexport class DoubleApprovalSegment extends Segment {\n  readonly props: RequireApprovalSegmentProps;\n\n  constructor(props: RequireApprovalSegmentProps) {\n    super({ ...props, input: undefined, output: undefined });\n    this.props = props;\n  }\n\n  construct(scope: Pipeline): SegmentConstructed {\n    return new RequireApprovalSegmentConstructed(\n      scope,\n      `RequireApproval`,\n      this.props,\n    );\n  }\n}\n\nexport interface RequireApprovalSegmentConstructedProps {\n  readonly name?: string;\n}\n\nexport class RequireApprovalSegmentConstructed extends SegmentConstructed {\n  readonly name: string;\n  readonly actions: IAction[];\n\n  constructor(\n    scope: Pipeline,\n    id: string,\n    props: RequireApprovalSegmentConstructedProps,\n  ) {\n    super(scope, id);\n\n    this.name = props.name ?? id;\n\n    this.actions = [\n      new ManualApprovalAction({\n        actionName: \"ApproveChanges1\",\n        runOrder: 1,\n      }),\n      new ManualApprovalAction({\n        actionName: \"ApproveChanges2\",\n        runOrder: 2,\n      }),\n    ];\n  }\n}\n```\n"
+    "markdown": "This library exposes a highly customizable and extensible L3 pipeline construct intended as an alternative to the CDK native L3 [CodePipeline](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.pipelines.CodePipeline.html) construct which has some inherent limitations in capability and extensibility.\n\nThe documentation provides the tools and documentation to get your own pipeline up and running and build your own custom segments.\n\n## Usage\n\n### Installation\n\nThe package is available on [NPM](https://www.npmjs.com/package/@flit/cdk-pipeline) and can be installed using your package manager of choice:\n\n```bash\nnpm i @flit/cdk-pipeline\n```\n\n```bash\npnpm add @flit/cdk-pipeline\n```\n\n```bash\nyarn add @flit/cdk-pipeline\n```\n\n### Core concepts\n\n#### - [Example Project](https://github.com/vierroth/cdk-pipeline/blob/main/example/README.md)\n\nTo better understand the core concepts take a look at the included [example project](https://github.com/vierroth/cdk-pipeline/blob/main/example/README.md).\n\n#### - Pipeline\n\nThe `Pipeline` construct will create a CloudFormation Stack which contains the pipeline and all of the required peripheral resources to make it work.\n\n#### - Segment\n\nA `Segment` is simply a pre-configured set of pipeline actions which together represent a commonly used CI/CD pattern, like for example building and deploying a stack.\n\nTo build properly, a Pipeline requires at least one SourceSegment, exactly one PipelineSegment and at least one other segment.\n\n#### - Artifact\n\nAn `Artifact` represents a pipeline artifact which can be used to pass information between stages. Every artifact needs to be the output of exactly one Segment and can be consumed by any segments that need that output.\n"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/jumper-de/cdk-pipeline.git"
+    "url": "https://github.com/vierroth/cdk-pipeline.git"
   },
   "schema": "jsii/0.10.0",
   "targets": {
@@ -4008,33 +4020,37 @@
           },
           "locationInModule": {
             "filename": "src/artifact.ts",
-            "line": 21
+            "line": 11
           },
-          "name": "obtainConsumers",
-          "returns": {
-            "type": {
-              "collection": {
-                "elementtype": {
-                  "fqn": "@flit/cdk-pipeline.Segment"
-                },
-                "kind": "array"
+          "name": "produce",
+          "parameters": [
+            {
+              "name": "producer",
+              "type": {
+                "fqn": "@flit/cdk-pipeline.Segment"
               }
             }
-          }
-        },
+          ]
+        }
+      ],
+      "name": "Artifact",
+      "properties": [
         {
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
             "filename": "src/artifact.ts",
-            "line": 18
+            "line": 21
           },
-          "name": "obtainProducer",
-          "returns": {
-            "optional": true,
-            "type": {
-              "fqn": "@flit/cdk-pipeline.Segment"
+          "name": "consumers",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@flit/cdk-pipeline.Segment"
+              },
+              "kind": "array"
             }
           }
         },
@@ -4042,22 +4058,18 @@
           "docs": {
             "stability": "stable"
           },
+          "immutable": true,
           "locationInModule": {
             "filename": "src/artifact.ts",
-            "line": 11
+            "line": 18
           },
-          "name": "produce",
-          "parameters": [
-            {
-              "name": "producer",
-              "type": {
-                "fqn": "@flit/cdk-pipeline.Segment"
-              }
-            }
-          ]
+          "name": "producer",
+          "optional": true,
+          "type": {
+            "fqn": "@flit/cdk-pipeline.Segment"
+          }
         }
       ],
-      "name": "Artifact",
       "symbolId": "src/artifact:Artifact"
     },
     "@flit/cdk-pipeline.CodeCommitSourceSegment": {
@@ -4411,7 +4423,7 @@
         },
         "locationInModule": {
           "filename": "src/code-star-source-segment.ts",
-          "line": 23
+          "line": 41
         },
         "parameters": [
           {
@@ -4425,7 +4437,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code-star-source-segment.ts",
-        "line": 21
+        "line": 39
       },
       "methods": [
         {
@@ -4434,7 +4446,7 @@
           },
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 27
+            "line": 45
           },
           "name": "construct",
           "overrides": "@flit/cdk-pipeline.Segment",
@@ -4469,7 +4481,7 @@
         },
         "locationInModule": {
           "filename": "src/code-star-source-segment.ts",
-          "line": 51
+          "line": 71
         },
         "parameters": [
           {
@@ -4495,7 +4507,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code-star-source-segment.ts",
-        "line": 48
+        "line": 68
       },
       "name": "CodeStarSourceSegmentConstructed",
       "properties": [
@@ -4506,7 +4518,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 50
+            "line": 70
           },
           "name": "actions",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -4526,7 +4538,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 49
+            "line": 69
           },
           "name": "name",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -4547,7 +4559,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/code-star-source-segment.ts",
-        "line": 36
+        "line": 56
       },
       "name": "CodeStarSourceSegmentConstructedProps",
       "properties": [
@@ -4559,7 +4571,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 38
+            "line": 58
           },
           "name": "actionName",
           "type": {
@@ -4574,7 +4586,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 39
+            "line": 59
           },
           "name": "connectionArn",
           "type": {
@@ -4589,7 +4601,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 37
+            "line": 57
           },
           "name": "output",
           "type": {
@@ -4604,7 +4616,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 40
+            "line": 60
           },
           "name": "owner",
           "type": {
@@ -4619,7 +4631,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 41
+            "line": 61
           },
           "name": "repo",
           "type": {
@@ -4634,7 +4646,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 42
+            "line": 62
           },
           "name": "branch",
           "optional": true,
@@ -4650,7 +4662,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 43
+            "line": 63
           },
           "name": "runOrder",
           "optional": true,
@@ -4666,7 +4678,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 44
+            "line": 64
           },
           "name": "triggerOnPush",
           "optional": true,
@@ -4682,7 +4694,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 45
+            "line": 65
           },
           "name": "variablesNamespace",
           "optional": true,
@@ -4713,12 +4725,15 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "`\"arn:aws:codestar-connections:us-east-1:123456789012:connection/12345678-abcd-12ab-34cdef5678gh\"`",
+            "see": "https://docs.aws.amazon.com/codepipeline/latest/userguide/connections-create.html",
+            "stability": "stable",
+            "summary": "The ARN of the CodeStar Connection created in the AWS console that has permissions to access this GitHub or BitBucket repository."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 11
+            "line": 21
           },
           "name": "connectionArn",
           "type": {
@@ -4728,12 +4743,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "`\"aws\"`",
+            "stability": "stable",
+            "summary": "The owning user or organization of the repository."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 10
+            "line": 14
           },
           "name": "owner",
           "type": {
@@ -4743,12 +4760,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "`\"aws-cdk\"`",
+            "stability": "stable",
+            "summary": "The name of the repository."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 12
+            "line": 26
           },
           "name": "repository",
           "type": {
@@ -4758,12 +4777,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "`\"master\"`",
+            "stability": "stable",
+            "summary": "The branch to build."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 13
+            "line": 31
           },
           "name": "branch",
           "optional": true,
@@ -4779,7 +4800,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 14
+            "line": 32
           },
           "name": "triggerOnPush",
           "optional": true,
@@ -4795,7 +4816,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/code-star-source-segment.ts",
-            "line": 15
+            "line": 33
           },
           "name": "variablesNamespace",
           "optional": true,
@@ -4822,7 +4843,7 @@
         },
         "locationInModule": {
           "filename": "src/git-hub-source-segment.ts",
-          "line": 27
+          "line": 39
         },
         "parameters": [
           {
@@ -4836,7 +4857,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/git-hub-source-segment.ts",
-        "line": 25
+        "line": 37
       },
       "methods": [
         {
@@ -4845,7 +4866,7 @@
           },
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 31
+            "line": 43
           },
           "name": "construct",
           "overrides": "@flit/cdk-pipeline.Segment",
@@ -4880,7 +4901,7 @@
         },
         "locationInModule": {
           "filename": "src/git-hub-source-segment.ts",
-          "line": 55
+          "line": 69
         },
         "parameters": [
           {
@@ -4906,7 +4927,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/git-hub-source-segment.ts",
-        "line": 52
+        "line": 66
       },
       "name": "GitHubSourceSegmentConstructed",
       "properties": [
@@ -4917,7 +4938,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 54
+            "line": 68
           },
           "name": "actions",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -4937,7 +4958,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 53
+            "line": 67
           },
           "name": "name",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -4958,7 +4979,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/git-hub-source-segment.ts",
-        "line": 40
+        "line": 54
       },
       "name": "GitHubSourceSegmentConstructedProps",
       "properties": [
@@ -4970,7 +4991,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 42
+            "line": 56
           },
           "name": "actionName",
           "type": {
@@ -4985,7 +5006,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 43
+            "line": 57
           },
           "name": "oauthToken",
           "type": {
@@ -5000,7 +5021,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 41
+            "line": 55
           },
           "name": "output",
           "type": {
@@ -5015,7 +5036,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 44
+            "line": 58
           },
           "name": "owner",
           "type": {
@@ -5030,7 +5051,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 45
+            "line": 59
           },
           "name": "repo",
           "type": {
@@ -5045,7 +5066,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 46
+            "line": 60
           },
           "name": "branch",
           "optional": true,
@@ -5061,7 +5082,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 47
+            "line": 61
           },
           "name": "runOrder",
           "optional": true,
@@ -5077,7 +5098,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 48
+            "line": 62
           },
           "name": "trigger",
           "optional": true,
@@ -5093,7 +5114,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 49
+            "line": 63
           },
           "name": "variablesNamespace",
           "optional": true,
@@ -5139,12 +5160,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "`\"aws\"`",
+            "stability": "stable",
+            "summary": "The owning user or organization of the repository."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 15
+            "line": 19
           },
           "name": "owner",
           "type": {
@@ -5154,12 +5177,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "example": "`\"aws-cdk\"`",
+            "stability": "stable",
+            "summary": "The name of the repository."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 16
+            "line": 24
           },
           "name": "repository",
           "type": {
@@ -5169,12 +5194,14 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "default": "`\"master\"`",
+            "stability": "stable",
+            "summary": "The branch to build."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 17
+            "line": 29
           },
           "name": "branch",
           "optional": true,
@@ -5190,7 +5217,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 18
+            "line": 30
           },
           "name": "trigger",
           "optional": true,
@@ -5206,7 +5233,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/git-hub-source-segment.ts",
-            "line": 19
+            "line": 31
           },
           "name": "variablesNamespace",
           "optional": true,
@@ -5335,26 +5362,10 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/pipeline.ts",
-        "line": 15
+        "line": 14
       },
       "name": "PipelineProps",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "The path to the cdk projects root directory containing the cdk.json file relative to the asset root."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/pipeline.ts",
-            "line": 25
-          },
-          "name": "rootDir",
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -5386,13 +5397,31 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline.ts",
-            "line": 20
+            "line": 19
           },
           "name": "pipelineName",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "`\".\"`",
+            "stability": "stable",
+            "summary": "The path to the cdk projects root directory containing the cdk.json file relative to the asset root."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/pipeline.ts",
+            "line": 25
+          },
+          "name": "rootDir",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "src/pipeline:PipelineProps"
@@ -5413,7 +5442,7 @@
         },
         "locationInModule": {
           "filename": "src/pipeline-segment.ts",
-          "line": 74
+          "line": 66
         },
         "parameters": [
           {
@@ -5427,7 +5456,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/pipeline-segment.ts",
-        "line": 70
+        "line": 62
       },
       "methods": [
         {
@@ -5436,7 +5465,7 @@
           },
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 79
+            "line": 71
           },
           "name": "construct",
           "overrides": "@flit/cdk-pipeline.Segment",
@@ -5464,7 +5493,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 71
+            "line": 63
           },
           "name": "isPipeline",
           "overrides": "@flit/cdk-pipeline.Segment",
@@ -5479,7 +5508,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 72
+            "line": 64
           },
           "name": "props",
           "type": {
@@ -5502,7 +5531,7 @@
         },
         "locationInModule": {
           "filename": "src/pipeline-segment.ts",
-          "line": 107
+          "line": 97
         },
         "parameters": [
           {
@@ -5528,7 +5557,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/pipeline-segment.ts",
-        "line": 103
+        "line": 93
       },
       "name": "PipelineSegmentConstructed",
       "properties": [
@@ -5539,7 +5568,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 105
+            "line": 95
           },
           "name": "actions",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -5559,7 +5588,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 104
+            "line": 94
           },
           "name": "name",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -5580,7 +5609,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/pipeline-segment.ts",
-        "line": 89
+        "line": 81
       },
       "name": "PipelineSegmentConstructedProps",
       "properties": [
@@ -5592,7 +5621,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 96
+            "line": 86
           },
           "name": "input",
           "type": {
@@ -5607,7 +5636,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 91
+            "line": 83
           },
           "name": "project",
           "type": {
@@ -5622,7 +5651,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 90
+            "line": 82
           },
           "name": "stack",
           "type": {
@@ -5637,23 +5666,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 94
-          },
-          "name": "account",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/pipeline-segment.ts",
-            "line": 92
+            "line": 84
           },
           "name": "environmentVariables",
           "optional": true,
@@ -5674,7 +5687,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 97
+            "line": 87
           },
           "name": "extraInputs",
           "optional": true,
@@ -5695,7 +5708,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 100
+            "line": 90
           },
           "name": "manualApproval",
           "optional": true,
@@ -5711,7 +5724,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 98
+            "line": 88
           },
           "name": "output",
           "optional": true,
@@ -5727,7 +5740,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 99
+            "line": 89
           },
           "name": "outputFileName",
           "optional": true,
@@ -5743,23 +5756,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 95
-          },
-          "name": "region",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/pipeline-segment.ts",
-            "line": 93
+            "line": 85
           },
           "name": "stackName",
           "optional": true,
@@ -5831,23 +5828,6 @@
             "fqn": "aws-cdk-lib.aws_codebuild.ProjectProps"
           }
         },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "The AWS account this Action is supposed to operate in."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/pipeline-segment.ts",
-            "line": 45
-          },
-          "name": "account",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -5880,7 +5860,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 64
+            "line": 56
           },
           "name": "manualApproval",
           "optional": true,
@@ -5898,7 +5878,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 54
+            "line": 46
           },
           "name": "output",
           "optional": true,
@@ -5916,7 +5896,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/pipeline-segment.ts",
-            "line": 59
+            "line": 51
           },
           "name": "outputFileName",
           "optional": true,
@@ -5927,26 +5907,7 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable",
-            "summary": "The AWS region the given Action resides in."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/pipeline-segment.ts",
-            "line": 49
-          },
-          "name": "region",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "custom": {
-              "deafult": "The name of the given stack."
-            },
+            "default": "The name of the given stack.",
             "stability": "stable",
             "summary": "The name of the stack to apply this action to."
           },
@@ -6606,7 +6567,7 @@
           },
           "locationInModule": {
             "filename": "src/segment.ts",
-            "line": 39
+            "line": 31
           },
           "name": "construct",
           "parameters": [
@@ -6757,7 +6718,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/segment.ts",
-        "line": 42
+        "line": 34
       },
       "name": "SegmentConstructed",
       "properties": [
@@ -6768,7 +6729,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/segment.ts",
-            "line": 44
+            "line": 36
           },
           "name": "actions",
           "type": {
@@ -6787,7 +6748,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/segment.ts",
-            "line": 43
+            "line": 35
           },
           "name": "name",
           "type": {
@@ -6972,7 +6933,7 @@
         },
         "locationInModule": {
           "filename": "src/stack-segment.ts",
-          "line": 82
+          "line": 73
         },
         "parameters": [
           {
@@ -6986,7 +6947,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/stack-segment.ts",
-        "line": 79
+        "line": 70
       },
       "methods": [
         {
@@ -6995,7 +6956,7 @@
           },
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 87
+            "line": 78
           },
           "name": "construct",
           "overrides": "@flit/cdk-pipeline.Segment",
@@ -7023,7 +6984,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 80
+            "line": 71
           },
           "name": "props",
           "type": {
@@ -7046,7 +7007,7 @@
         },
         "locationInModule": {
           "filename": "src/stack-segment.ts",
-          "line": 118
+          "line": 107
         },
         "parameters": [
           {
@@ -7072,7 +7033,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/stack-segment.ts",
-        "line": 114
+        "line": 103
       },
       "name": "StackSegmentConstructed",
       "properties": [
@@ -7083,7 +7044,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 116
+            "line": 105
           },
           "name": "actions",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -7103,7 +7064,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 115
+            "line": 104
           },
           "name": "name",
           "overrides": "@flit/cdk-pipeline.SegmentConstructed",
@@ -7124,7 +7085,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/stack-segment.ts",
-        "line": 100
+        "line": 91
       },
       "name": "StackSegmentConstructedProps",
       "properties": [
@@ -7136,7 +7097,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 107
+            "line": 96
           },
           "name": "input",
           "type": {
@@ -7151,7 +7112,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 101
+            "line": 92
           },
           "name": "stack",
           "type": {
@@ -7166,23 +7127,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 105
-          },
-          "name": "account",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/stack-segment.ts",
-            "line": 103
+            "line": 94
           },
           "name": "environmentVariables",
           "optional": true,
@@ -7203,7 +7148,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 108
+            "line": 97
           },
           "name": "extraInputs",
           "optional": true,
@@ -7224,7 +7169,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 111
+            "line": 100
           },
           "name": "manualApproval",
           "optional": true,
@@ -7240,7 +7185,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 109
+            "line": 98
           },
           "name": "output",
           "optional": true,
@@ -7256,7 +7201,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 110
+            "line": 99
           },
           "name": "outputFileName",
           "optional": true,
@@ -7272,7 +7217,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 102
+            "line": 93
           },
           "name": "project",
           "optional": true,
@@ -7288,23 +7233,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 106
-          },
-          "name": "region",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/stack-segment.ts",
-            "line": 104
+            "line": 95
           },
           "name": "stackName",
           "optional": true,
@@ -7375,23 +7304,6 @@
             "fqn": "aws-cdk-lib.Stack"
           }
         },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "The AWS account this Action is supposed to operate in."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/stack-segment.ts",
-            "line": 54
-          },
-          "name": "account",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -7417,14 +7329,14 @@
         {
           "abstract": true,
           "docs": {
-            "default": "false",
+            "default": "`false`",
             "stability": "stable",
             "summary": "Does this stage require manual approval of the change set?"
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 73
+            "line": 64
           },
           "name": "manualApproval",
           "optional": true,
@@ -7435,14 +7347,13 @@
         {
           "abstract": true,
           "docs": {
-            "default": "no output artifact",
             "stability": "stable",
             "summary": "The artifact to hold the stack deployment output file."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 63
+            "line": 54
           },
           "name": "output",
           "optional": true,
@@ -7453,14 +7364,14 @@
         {
           "abstract": true,
           "docs": {
-            "default": "artifact.json",
+            "default": "`\"artifact.json\"`",
             "stability": "stable",
             "summary": "The filename for the file in the output artifact."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/stack-segment.ts",
-            "line": 68
+            "line": 59
           },
           "name": "outputFileName",
           "optional": true,
@@ -7486,23 +7397,6 @@
             "fqn": "aws-cdk-lib.aws_codebuild.ProjectProps"
           }
         },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "The AWS region the given Action resides in."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/stack-segment.ts",
-            "line": 58
-          },
-          "name": "region",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -7523,9 +7417,7 @@
         {
           "abstract": true,
           "docs": {
-            "custom": {
-              "deafult": "The name of the given stack."
-            },
+            "default": "The name of the given stack.",
             "stability": "stable",
             "summary": "The name of the stack to deploy the changes to."
           },
@@ -7544,6 +7436,6 @@
       "symbolId": "src/stack-segment:StackSegmentProps"
     }
   },
-  "version": "1.1.2",
-  "fingerprint": "TWfmiock8PgSfF2XQV2a4QZd8s/TbBiazDhCLx986/M="
+  "version": "1.2.1",
+  "fingerprint": "XY5F0djyOJi8BbAtSDnm/l5noqFcX3cuwUACzPBeWpg="
 }