@rio-cloud/cdk-v2-constructs 8.3.0 → 8.4.0

package/.jsii

@@ -9106,7 +9106,7 @@
   },
   "name": "@rio-cloud/cdk-v2-constructs",
   "readme": {
-    "markdown": "# RIO CDK Constructs\n\nThis package contains CDK2 constructs for RIO teams.\n\n> NPM: `@rio-cloud/cdk-v2-constructs`\n\n## Bootstrapping of CDK project\n\n```\n$ npx cdk init --language typescript\n```\n\n## Installation\n\n```\n$ npm install --save @rio-cloud/cdk-v2-constructs\n```\n\n## See also\n\n * [How to contribute](./docs/contribution.md)\n * [Changelog](./docs/changelog.md)\n * [brief API description](./docs/API.md)\n\n## Internal documentation for library devs\n[Documentation](./docs/developers-readme.md)\n\n## Constructs overview (Under construction...)\n\n### Watchful\n\nWatchful constructs help generate some default monitors based on the resources defined in your stack. E.g. - If your stack contains a lambda function, and you configure watchful construct, then it will create out of box metric monitors for Throttling, Lambda error and Log error monitors. The ever-growing list of resources that watchful creates monitors for as of today are:\n\n- Application load balancer\n- Cloudfront\n- Documentdb\n- Dynamodb\n- Fargate\n- Lambda\n- RDS\n\nSimply add the following to your CDK stack to get started.\n```\n  import * as rio from '@rio-cloud/cdk-v2-constructs';\n    ...\n    const dw = new rio.watchfulv2.Watchful(this, 'Watchful', {\n      serviceName,\n    });\n    dw.watchScope(this); // Generates alarms for all supported resources\n    ...\n```\n\nThere are options to override some defaults too. Please be aware that the library is very opinionated and is written with the most general use cases in mind. It is necessary to keep the use of the library simple enough, which means that there is only limited flexibility regarding the configuration options. Having said that, feel free to reach out to team CLAID over slack #rio-platform-support in case of feature requests.\n\nThe broad classification of the monitors created by watchful are\n- Log error monitors\n- Metrics Query monitors: Basically everything other than log error monitors\n\nFor Metrics query monitors, you can configure the priority (defaults as 3). For log error monitors, you can configure priority, renotification interval and can configure if the auto close of the monitor is disabled.\n```\n    ...\n    const dw = new Watchful(stack, 'Watchful2', {\n      logErrorMonitorConfig: {\n        disableAutoClose: true,\n        renotifyInterval: 150,\n        priority: 4,\n      },\n      queryErrorMonitorConfig: {\n        priority: 4\n      }\n    });\n    dw.watchScope(stack);\n```\n\nThere is an `overrideAlarmThreshold` method which can be used to override the default watchful thresholds. Please make sure to use the method before the `watchscope` function.\nE.g. -\n```\n...\nconst dw = new Watchful(stack, 'Watchful', {});\ndw.overrideAlarmThreshold({\n  monitoredResourceScope: lambdaA,\n  monitorType: MonitorType.ERRORS,\n  threshold: 5,\n});\ndw.watchScope(stack);\n```\n\n### ClassifyPipelineType\n\nThe pipelines can be tagged with key 'pipeline_type' to the following values:\n\n* deploy: To tag the production pipeline releasing the application\n* branch: The branch pipeline. Mostly used to test contributions / renovate updates\n* vulnerability: The vulnerability pipeline\n\nThe construct `ClassifyPipelineType` can be used to tag the pipeline accordingly. This tag is also picked up by the Datadog pipeline metric used to monitor the pipelines. It is added as a tag to the metric. This gives you more flexibility with managing the monitors also. E.g. some teams don't want to get alerted for branch pipelines. You can then leverage this metric tag to filter the pipelines.\n\nExample:\n\n```typescript\nconst pipeline = new pipelines.CodePipeline(this, 'Pipeline', {\n      ...\n    });\nrio.ClassifyPipelineType.apply(pipeline, rio.RioPipelineType.DEPLOY);\n```\n"
+    "markdown": "# RIO CDK Constructs\n\nThis package contains CDK2 constructs for RIO teams.\n\n> NPM: `@rio-cloud/cdk-v2-constructs`\n\n## Bootstrapping of CDK project\n\n```\n$ npx cdk init --language typescript\n```\n\n## Installation\n\n```\n$ npm install --save @rio-cloud/cdk-v2-constructs\n```\n\n## See also\n\n * [How to contribute](./docs/contribution.md)\n * [Changelog](./docs/changelog.md)\n * [brief API description](./docs/API.md)\n * [Agent documentation](./docs/AGENTS_DOCUMENTATION.md)\n\n## Internal documentation for library devs\n[Documentation](./docs/developers-readme.md)\n\n## Constructs overview (Under construction...)\n\n### Watchful\n\nWatchful constructs help generate some default monitors based on the resources defined in your stack. E.g. - If your stack contains a lambda function, and you configure watchful construct, then it will create out of box metric monitors for Throttling, Lambda error and Log error monitors. The ever-growing list of resources that watchful creates monitors for as of today are:\n\n- Application load balancer\n- Cloudfront\n- Documentdb\n- Dynamodb\n- Fargate\n- Lambda\n- RDS\n\nSimply add the following to your CDK stack to get started.\n```\n  import * as rio from '@rio-cloud/cdk-v2-constructs';\n    ...\n    const dw = new rio.watchfulv2.Watchful(this, 'Watchful', {\n      serviceName,\n    });\n    dw.watchScope(this); // Generates alarms for all supported resources\n    ...\n```\n\nThere are options to override some defaults too. Please be aware that the library is very opinionated and is written with the most general use cases in mind. It is necessary to keep the use of the library simple enough, which means that there is only limited flexibility regarding the configuration options. Having said that, feel free to reach out to team CLAID over slack #rio-platform-support in case of feature requests.\n\nThe broad classification of the monitors created by watchful are\n- Log error monitors\n- Metrics Query monitors: Basically everything other than log error monitors\n\nFor Metrics query monitors, you can configure the priority (defaults as 3). For log error monitors, you can configure priority, renotification interval and can configure if the auto close of the monitor is disabled.\n```\n    ...\n    const dw = new Watchful(stack, 'Watchful2', {\n      logErrorMonitorConfig: {\n        disableAutoClose: true,\n        renotifyInterval: 150,\n        priority: 4,\n      },\n      queryErrorMonitorConfig: {\n        priority: 4\n      }\n    });\n    dw.watchScope(stack);\n```\n\nThere is an `overrideAlarmThreshold` method which can be used to override the default watchful thresholds. Please make sure to use the method before the `watchscope` function.\nE.g. -\n```\n...\nconst dw = new Watchful(stack, 'Watchful', {});\ndw.overrideAlarmThreshold({\n  monitoredResourceScope: lambdaA,\n  monitorType: MonitorType.ERRORS,\n  threshold: 5,\n});\ndw.watchScope(stack);\n```\n\n### ClassifyPipelineType\n\nThe pipelines can be tagged with key 'pipeline_type' to the following values:\n\n* deploy: To tag the production pipeline releasing the application\n* branch: The branch pipeline. Mostly used to test contributions / renovate updates\n* vulnerability: The vulnerability pipeline\n\nThe construct `ClassifyPipelineType` can be used to tag the pipeline accordingly. This tag is also picked up by the Datadog pipeline metric used to monitor the pipelines. It is added as a tag to the metric. This gives you more flexibility with managing the monitors also. E.g. some teams don't want to get alerted for branch pipelines. You can then leverage this metric tag to filter the pipelines.\n\nExample:\n\n```typescript\nconst pipeline = new pipelines.CodePipeline(this, 'Pipeline', {\n      ...\n    });\nrio.ClassifyPipelineType.apply(pipeline, rio.RioPipelineType.DEPLOY);\n```\n"
   },
   "repository": {
     "type": "git",
@@ -9124,49 +9124,49 @@
     "@rio-cloud/cdk-v2-constructs.datadog": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 11
+        "line": 12
       },
       "symbolId": "src/datadog/index:"
     },
     "@rio-cloud/cdk-v2-constructs.datadogv2": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 12
+        "line": 13
       },
       "symbolId": "src/datadogv2/index:"
     },
     "@rio-cloud/cdk-v2-constructs.ecr": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 13
+        "line": 14
       },
       "symbolId": "src/ecr/index:"
     },
     "@rio-cloud/cdk-v2-constructs.fargate": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 14
+        "line": 15
       },
       "symbolId": "src/fargate/index:"
     },
     "@rio-cloud/cdk-v2-constructs.kafka": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 19
+        "line": 20
       },
       "symbolId": "src/kafka/index:"
     },
     "@rio-cloud/cdk-v2-constructs.ses": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 25
+        "line": 26
       },
       "symbolId": "src/ses/index:"
     },
     "@rio-cloud/cdk-v2-constructs.watchfulv2": {
       "locationInModule": {
         "filename": "src/index.ts",
-        "line": 28
+        "line": 29
       },
       "symbolId": "src/watchfulv2/index:"
     }
@@ -9866,6 +9866,7 @@
     "@rio-cloud/cdk-v2-constructs.BackupPolicy": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
+        "remarks": "Apply this to stateful resources that must be discovered by the RIO landing-zone backup solution.\n\nExample:\n```ts\nBackupPolicy.apply(table, Criticality.HIGH);\n```",
         "stability": "stable",
         "summary": "Helper function to tag constructs with correct backup values to be picked up by the rio landing zone backup solution."
       },
@@ -9878,7 +9879,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/backup/backup-policy.ts",
-        "line": 17
+        "line": 24
       },
       "methods": [
         {
@@ -9887,7 +9888,7 @@
           },
           "locationInModule": {
             "filename": "src/backup/backup-policy.ts",
-            "line": 18
+            "line": 25
           },
           "name": "apply",
           "parameters": [
@@ -10216,7 +10217,7 @@
     "@rio-cloud/cdk-v2-constructs.ClassifyPipelineType": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
-        "remarks": "These tags are eventually used in datadog pipeline metrics to filter specific pipeline types\nEg - you can decide to not monitor branch pipelines",
+        "remarks": "These tags are eventually used in datadog pipeline metrics to filter specific pipeline types\nEg - you can decide to not monitor branch pipelines\n\nExample:\n```ts\nClassifyPipelineType.apply(pipeline, RioPipelineType.DEPLOY);\n```",
         "stability": "stable",
         "summary": "Helper function to tag the pipeline with correct pipeline type."
       },
@@ -10229,7 +10230,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/pipeline/rio-pipeline-type.ts",
-        "line": 29
+        "line": 34
       },
       "methods": [
         {
@@ -10238,7 +10239,7 @@
           },
           "locationInModule": {
             "filename": "src/pipeline/rio-pipeline-type.ts",
-            "line": 30
+            "line": 35
           },
           "name": "apply",
           "parameters": [
@@ -14069,8 +14070,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
+        "remarks": "Prefer this construct for new topics. Keep the default retention and partition count unless there is a concrete\noperational requirement to change them. Partition increases are permanent and may require coordination with CLAID\nwhen service limits are exceeded.\n\nExample:\n```ts\nnew KafkaTopicV4(this, 'EventsTopic', {\n  name: 'billing-view.events',\n  metadata: {\n    description: 'Domain events emitted by Billing View.',\n    audience: 'company-internal',\n    recoveryPolicy: 'recoverable',\n  },\n  acl: {\n    write: ['billing-view'],\n    read: ['billing-consumer'],\n  },\n  isLogCompacted: false,\n});\n```",
         "stability": "stable",
-        "summary": "Construct to create a kafka topic."
+        "summary": "Construct to create a version 4 RIO Kafka topic."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.KafkaTopicV4",
       "initializer": {
@@ -14079,7 +14081,7 @@
         },
         "locationInModule": {
           "filename": "src/kafka/kafka-topic.ts",
-          "line": 281
+          "line": 302
         },
         "parameters": [
           {
@@ -14105,7 +14107,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/kafka/kafka-topic.ts",
-        "line": 280
+        "line": 301
       },
       "name": "KafkaTopicV4",
       "symbolId": "src/kafka/kafka-topic:KafkaTopicV4"
@@ -15123,6 +15125,572 @@
       ],
       "symbolId": "src/watchful/watchful:OverrideAlarmThresholdProps"
     },
+    "@rio-cloud/cdk-v2-constructs.ParallelBuildProject": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "base": "aws-cdk-lib.aws_codebuild.PipelineProject",
+      "docs": {
+        "stability": "stable",
+        "summary": "CodeBuild project for parallel pipeline build work."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.ParallelBuildProject",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+          "line": 142
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@rio-cloud/cdk-v2-constructs.ParallelBuildProjectProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+        "line": 136
+      },
+      "name": "ParallelBuildProject",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Hash of buildspec, project environment, and action-level environment inputs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 140
+          },
+          "name": "projectConfigHash",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project:ParallelBuildProject"
+    },
+    "@rio-cloud/cdk-v2-constructs.ParallelBuildProjectProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Properties for a CodeBuild project that is injected as a parallel CodePipeline action."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.ParallelBuildProjectProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+        "line": 17
+      },
+      "name": "ParallelBuildProjectProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Path to the buildspec yaml file, resolved from the consuming CDK app's current working directory."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 21
+          },
+          "name": "buildSpecPath",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Name of the hosted zone."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 31
+          },
+          "name": "hostedZoneName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Name of the service."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 26
+          },
+          "name": "serviceName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Additional project-level environment variables."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 67
+          },
+          "name": "additionalEnvironmentVariables",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codebuild.BuildEnvironmentVariable"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Defaults to the ARM Amazon Linux 2023 standard image used by WebEDI-style services.",
+            "stability": "stable",
+            "summary": "Build image for the project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 55
+          },
+          "name": "buildImage",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.IBuildImage"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Caching strategy to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 48
+          },
+          "name": "cache",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.Cache"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Defaults to `BUILD_GENERAL1_LARGE`.",
+            "stability": "stable",
+            "summary": "Compute type for the project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 62
+          },
+          "name": "computeType",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.ComputeType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Action-level environment values used when calculating `projectConfigHash`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 43
+          },
+          "name": "env",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "When provided, its URI is exposed as `REPO_URI`.",
+            "stability": "stable",
+            "summary": "Repository used by image build steps."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project.ts",
+            "line": 38
+          },
+          "name": "repo",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ecr.IRepository"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/code-build-project:ParallelBuildProjectProps"
+    },
+    "@rio-cloud/cdk-v2-constructs.PipelineBuildActionProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Properties for a CodeBuild action added by `PipelineBuildStageActions`."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildActionProps",
+      "interfaces": [
+        "aws-cdk-lib.aws_codepipeline.CommonAwsActionProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+        "line": 25
+      },
+      "name": "PipelineBuildActionProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The action's CodeBuild project."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 39
+          },
+          "name": "project",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codebuild.IProject"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "CodeBuildActionType.BUILD",
+            "stability": "stable",
+            "summary": "The type of CodeBuild action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 46
+          },
+          "name": "actionType",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codepipeline_actions.CodeBuildActionType"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "true",
+            "stability": "stable",
+            "summary": "Whether to check for secrets in plaintext environment variables."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 58
+          },
+          "name": "checkSecretsInPlainTextEnvVariables",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Combine build artifacts for batch builds."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 72
+          },
+          "name": "combineBatchBuildArtifacts",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Environment variables to pass to the CodeBuild project when this action executes."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 51
+          },
+          "name": "environmentVariables",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codebuild.BuildEnvironmentVariable"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "stable",
+            "summary": "Trigger a batch build."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 65
+          },
+          "name": "executeBatchBuild",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The list of additional input artifacts for this action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 29
+          },
+          "name": "extraInputs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codepipeline.Artifact"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The list of output artifacts for this action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 34
+          },
+          "name": "outputs",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_codepipeline.Artifact"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions:PipelineBuildActionProps"
+    },
+    "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActions": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "base": "constructs.Construct",
+      "docs": {
+        "stability": "stable",
+        "summary": "Adds CodeBuild actions next to an existing action in the same pipeline stage."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActions",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+          "line": 89
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActionsProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+        "line": 78
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Adds a CodeBuild action using the located action's first input artifact."
+          },
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 107
+          },
+          "name": "addBuildAction",
+          "parameters": [
+            {
+              "name": "props",
+              "type": {
+                "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildActionProps"
+              }
+            }
+          ]
+        }
+      ],
+      "name": "PipelineBuildStageActions",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "First input artifact of the located action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 87
+          },
+          "name": "sourceArtifact",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codepipeline.Artifact"
+          }
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Stage that contains the located action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 82
+          },
+          "name": "stage",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codepipeline.IStage"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions:PipelineBuildStageActions"
+    },
+    "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActionsProps": {
+      "assembly": "@rio-cloud/cdk-v2-constructs",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Properties for locating an existing generated CodePipeline action."
+      },
+      "fqn": "@rio-cloud/cdk-v2-constructs.PipelineBuildStageActionsProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+        "line": 10
+      },
+      "name": "PipelineBuildStageActionsProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Name of the action whose input artifact should be reused."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 19
+          },
+          "name": "actionName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The underlying CodePipeline generated by `aws-cdk-lib/pipelines.CodePipeline`."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions.ts",
+            "line": 14
+          },
+          "name": "pipeline",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_codepipeline.Pipeline"
+          }
+        }
+      ],
+      "symbolId": "src/contributions/team-shipper-inbound-blue/pipeline/pipeline-build-stage-actions:PipelineBuildStageActionsProps"
+    },
     "@rio-cloud/cdk-v2-constructs.PipelineFeatures": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "datatype": true,
@@ -16053,7 +16621,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "remarks": "This construct bundles the pieces that most RIO backend services need:\nan ECS task definition, the application container, a Datadog sidecar,\noptional FireLens log routing, optional ALB target group wiring, and the\nECS Fargate service itself.\n\nIt also derives Datadog tags and environment variables from `stage`,\n`serviceName`, `version`, the AWS account, and the standard RIO landing-zone\nSSM parameters. Do not set `DD_ENV`, `DD_SERVICE`, `DD_VERSION`, `DD_TAGS`,\nor `DD_LOGS_INJECTION` manually in the application container environment.\n\nUse this construct when you want the RIO paved road for a web-facing or\nservice-style Fargate workload and you want the defaults for observability,\nDatadog service catalog registration, and common AWS wiring to be handled\nfor you.\nIf you need a fully custom ECS setup, or a different deployment strategy\nsuch as blue/green, use a lower-level construct or the blue/green variant\ninstead.\n\nTo use it, provide:\n- `stage`, `serviceName`, and `version` for service identity\n- `vpc` and optionally an existing `cluster`\n- `containerDefinitionOption.image` for the application image\n- `fargateOptions.cpu` and `fargateOptions.memoryLimitMiB` for task sizing\n- optional `datadogOptions`, `frameworks`, and `loadBalancerOptions`\n\nExample:\n```ts\nconst service = new RioFargateService(this, 'Service', {\n  stage: 'prod',\n  serviceName: 'billing-view',\n  version: process.env.GIT_VERSION ?? 'local',\n  vpc: RioLandingZone.getDefaultVpc(this),\n  containerDefinitionOption: {\n    image: ecs.ContainerImage.fromRegistry('example/billing-view:latest'),\n  },\n  fargateOptions: {\n    cpu: 512,\n    memoryLimitMiB: 1024,\n  },\n});\n```",
+        "stability": "stable",
+        "summary": "Creates an opinionated ECS Fargate service for RIO applications."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.RioFargateService",
       "initializer": {
@@ -16062,7 +16632,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service.ts",
-          "line": 406
+          "line": 451
         },
         "parameters": [
           {
@@ -16091,7 +16661,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 365
+        "line": 410
       },
       "name": "RioFargateService",
       "properties": [
@@ -16103,7 +16673,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 402
+            "line": 447
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -16118,7 +16688,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 398
+            "line": 443
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -16132,7 +16702,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 403
+            "line": 448
           },
           "name": "service",
           "type": {
@@ -16146,7 +16716,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 397
+            "line": 442
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -16160,7 +16730,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 400
+            "line": 445
           },
           "name": "taskDefinition",
           "type": {
@@ -16174,7 +16744,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 399
+            "line": 444
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -16189,7 +16759,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 404
+            "line": 449
           },
           "name": "targetGroup",
           "optional": true,
@@ -16898,8 +17468,9 @@
     "@rio-cloud/cdk-v2-constructs.RioLandingZone": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
+        "remarks": "Use these helpers instead of hard-coded VPC IDs, hosted-zone IDs, subnet IDs, or standard team/account SSM parameter\nnames.\n\nExample:\n```ts\nconst vpc = RioLandingZone.getDefaultVpc(this);\nconst hostedZone = RioLandingZone.getDefaultHostedZone(this);\nconst teamIdentifier = RioLandingZone.getTeamIdentifierParameter(this).stringValue;\n```",
         "stability": "stable",
-        "summary": "A wrapper to access infrastructure provided by RIO LandingZone setup (like VPC, HostedZone)."
+        "summary": "A wrapper to access infrastructure provided by the RIO Landing Zone setup, such as VPC, HostedZone, and standard team/account SSM parameters."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.RioLandingZone",
       "initializer": {
@@ -16910,7 +17481,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/rio-landing-zone.ts",
-        "line": 10
+        "line": 21
       },
       "methods": [
         {
@@ -16919,7 +17490,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 75
+            "line": 86
           },
           "name": "getAccountNameParameter",
           "parameters": [
@@ -16944,7 +17515,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 52
+            "line": 63
           },
           "name": "getDefaultHostedZone",
           "parameters": [
@@ -16969,7 +17540,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 14
+            "line": 25
           },
           "name": "getDefaultVpc",
           "parameters": [
@@ -16993,7 +17564,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 71
+            "line": 82
           },
           "name": "getTeamAlertSlackChannelParameter",
           "parameters": [
@@ -17017,7 +17588,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 67
+            "line": 78
           },
           "name": "getTeamEmailParameter",
           "parameters": [
@@ -17041,7 +17612,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 63
+            "line": 74
           },
           "name": "getTeamIdentifierParameter",
           "parameters": [
@@ -17065,7 +17636,7 @@
           },
           "locationInModule": {
             "filename": "src/rio-landing-zone.ts",
-            "line": 59
+            "line": 70
           },
           "name": "getTeamNameParameter",
           "parameters": [
@@ -20368,6 +20939,7 @@
     "@rio-cloud/cdk-v2-constructs.backup.BackupPolicy": {
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "docs": {
+        "remarks": "Apply this to stateful resources that must be discovered by the RIO landing-zone backup solution.\n\nExample:\n```ts\nBackupPolicy.apply(table, Criticality.HIGH);\n```",
         "stability": "stable",
         "summary": "Helper function to tag constructs with correct backup values to be picked up by the rio landing zone backup solution."
       },
@@ -20380,7 +20952,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/backup/backup-policy.ts",
-        "line": 17
+        "line": 24
       },
       "methods": [
         {
@@ -20389,7 +20961,7 @@
           },
           "locationInModule": {
             "filename": "src/backup/backup-policy.ts",
-            "line": 18
+            "line": 25
           },
           "name": "apply",
           "parameters": [
@@ -24186,7 +24758,7 @@
         },
         "locationInModule": {
           "filename": "src/datadogv2/datadog-slo.ts",
-          "line": 103
+          "line": 110
         },
         "parameters": [
           {
@@ -24212,7 +24784,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/datadogv2/datadog-slo.ts",
-        "line": 100
+        "line": 107
       },
       "name": "DatadogSlo",
       "namespace": "datadogv2",
@@ -24224,7 +24796,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/datadogv2/datadog-slo.ts",
-            "line": 149
+            "line": 156
           },
           "name": "sloId",
           "type": {
@@ -25875,7 +26447,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "stable"
+        "remarks": "This construct bundles the pieces that most RIO backend services need:\nan ECS task definition, the application container, a Datadog sidecar,\noptional FireLens log routing, optional ALB target group wiring, and the\nECS Fargate service itself.\n\nIt also derives Datadog tags and environment variables from `stage`,\n`serviceName`, `version`, the AWS account, and the standard RIO landing-zone\nSSM parameters. Do not set `DD_ENV`, `DD_SERVICE`, `DD_VERSION`, `DD_TAGS`,\nor `DD_LOGS_INJECTION` manually in the application container environment.\n\nUse this construct when you want the RIO paved road for a web-facing or\nservice-style Fargate workload and you want the defaults for observability,\nDatadog service catalog registration, and common AWS wiring to be handled\nfor you.\nIf you need a fully custom ECS setup, or a different deployment strategy\nsuch as blue/green, use a lower-level construct or the blue/green variant\ninstead.\n\nTo use it, provide:\n- `stage`, `serviceName`, and `version` for service identity\n- `vpc` and optionally an existing `cluster`\n- `containerDefinitionOption.image` for the application image\n- `fargateOptions.cpu` and `fargateOptions.memoryLimitMiB` for task sizing\n- optional `datadogOptions`, `frameworks`, and `loadBalancerOptions`\n\nExample:\n```ts\nconst service = new RioFargateService(this, 'Service', {\n  stage: 'prod',\n  serviceName: 'billing-view',\n  version: process.env.GIT_VERSION ?? 'local',\n  vpc: RioLandingZone.getDefaultVpc(this),\n  containerDefinitionOption: {\n    image: ecs.ContainerImage.fromRegistry('example/billing-view:latest'),\n  },\n  fargateOptions: {\n    cpu: 512,\n    memoryLimitMiB: 1024,\n  },\n});\n```",
+        "stability": "stable",
+        "summary": "Creates an opinionated ECS Fargate service for RIO applications."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.fargate.RioFargateService",
       "initializer": {
@@ -25884,7 +26458,7 @@
         },
         "locationInModule": {
           "filename": "src/fargate/rio-fargate-service.ts",
-          "line": 406
+          "line": 451
         },
         "parameters": [
           {
@@ -25913,7 +26487,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/fargate/rio-fargate-service.ts",
-        "line": 365
+        "line": 410
       },
       "name": "RioFargateService",
       "namespace": "fargate",
@@ -25926,7 +26500,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 402
+            "line": 447
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -25941,7 +26515,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 398
+            "line": 443
           },
           "name": "datadogSideCarContainerDefinition",
           "type": {
@@ -25955,7 +26529,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 403
+            "line": 448
           },
           "name": "service",
           "type": {
@@ -25969,7 +26543,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 397
+            "line": 442
           },
           "name": "serviceContainerDefinition",
           "type": {
@@ -25983,7 +26557,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 400
+            "line": 445
           },
           "name": "taskDefinition",
           "type": {
@@ -25997,7 +26571,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 399
+            "line": 444
           },
           "name": "logRouterContainerDefinition",
           "optional": true,
@@ -26012,7 +26586,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/fargate/rio-fargate-service.ts",
-            "line": 404
+            "line": 449
           },
           "name": "targetGroup",
           "optional": true,
@@ -27232,8 +27806,9 @@
       "assembly": "@rio-cloud/cdk-v2-constructs",
       "base": "constructs.Construct",
       "docs": {
+        "remarks": "Prefer this construct for new topics. Keep the default retention and partition count unless there is a concrete\noperational requirement to change them. Partition increases are permanent and may require coordination with CLAID\nwhen service limits are exceeded.\n\nExample:\n```ts\nnew KafkaTopicV4(this, 'EventsTopic', {\n  name: 'billing-view.events',\n  metadata: {\n    description: 'Domain events emitted by Billing View.',\n    audience: 'company-internal',\n    recoveryPolicy: 'recoverable',\n  },\n  acl: {\n    write: ['billing-view'],\n    read: ['billing-consumer'],\n  },\n  isLogCompacted: false,\n});\n```",
         "stability": "stable",
-        "summary": "Construct to create a kafka topic."
+        "summary": "Construct to create a version 4 RIO Kafka topic."
       },
       "fqn": "@rio-cloud/cdk-v2-constructs.kafka.KafkaTopicV4",
       "initializer": {
@@ -27242,7 +27817,7 @@
         },
         "locationInModule": {
           "filename": "src/kafka/kafka-topic.ts",
-          "line": 281
+          "line": 302
         },
         "parameters": [
           {
@@ -27268,7 +27843,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/kafka/kafka-topic.ts",
-        "line": 280
+        "line": 301
       },
       "name": "KafkaTopicV4",
       "namespace": "kafka",
@@ -28360,5 +28935,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "2TeaWiyuW7PPTbekEx05nmocPKBWhVeLyXTQf5vRZcc="
+  "fingerprint": "wcpR/g1VxxywWd5SoWGCaeAUBujlAZAJEHSBxLIp3+c="
 }