@alma-cdk/project 0.0.14 → 0.0.17

package/.jsii

@@ -3008,7 +3008,7 @@
   },
   "name": "@alma-cdk/project",
   "readme": {
-    "markdown": "<br/><br/><br/>\n\n🚧 **Work-in-Progress**\n\n<br/><br/><br/>\n\n<div align=\"center\">\n\t<br/>\n\t<br/>\n  <h1>\n\t<img width=\"300\" src=\"assets/alma-cdk-project.svg\" alt=\"Alma CDK Project\" />\n  <br/>\n  <br/>\n  </h1>\n\n  ```sh\n  npm i -D @alma-cdk/project\n  ```\n\n  <div align=\"left\">\n\n  Opinionated CDK “framework” with constructs & utilities for:\n  - deploying multiple environments to multiple accounts (with many-to-many relationship)\n  - managing account configuration through standardized props (no more random config files)\n  - querying account and/or environment specific information within your CDK code\n  - enabling dynamic & short-lived “feature-environments”\n  - enabling well-defined tagging\n  - providing structure & common conventions to CDK projects\n  - choosing the target account & environment by passing in runtime context:\n\n    ```sh\n    npx cdk deploy -c environment=feature/abc-123\n    ```\n    ... which means you don't need to define all the possibile environments ahead of time!\n\n  </div>\n  <br/>\n</div>\n\n\n## Account Strategies\n\nDepending on the use case, you may choose a configuration between 1-3 AWS accounts with the following environments:\n\n\n1. **Shared account (`shared`)**:\n\n    ![default-multi](assets/accounts-1x.svg)\n    <br/>\n\n2. **Multi-account (`dev`+`prod`)**_– RECOMMENDED_:\n\n    ![default-multi](assets/accounts-2x.svg)\n    <br/>\n\n<br/>\n</details>\n\n3. **Multi-account (`dev`+`preprod`+`prod`)**:\n\n    ![default-multi](assets/accounts-3x.svg)\n    <br/>\n\n<br/>\n\n## Getting Started\n\nSteps required to define a _environmental_ project resources; At first, it might seem complex but once you get into the habbit of defining your projects this way it starts to make sense:\n\n1. Choose your [Account Strategy](#account-strategies)\n\n2. Initialize a new `Project` instead of `cdk.App`:\n\n    ```ts\n    // bin/app.ts\n    import { Project, Accounts } from '@alma-cdk/project';\n\n    const project = new Project({\n      // Basic info, you could also read these from package.json if you want\n      name: 'my-cool-project',\n      author: {\n        organization: 'Acme Corp',\n        name: 'Mad Scientists',\n        email: 'mad.scientists@acme.example.com',\n      },\n\n      // If not set, defaults to one of: $CDK_DEFAULT_REGION, $AWS_REGION or us-east-1\n      defaultRegion: 'eu-west-1',\n\n      // Configures the project to use 2 AWS accounts (recommended)\n      accounts: Accounts.two({\n        dev: {\n          id: '111111111111',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.net',\n          },\n        },\n        prod: {\n          id: '222222222222',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.com',\n          },\n        },\n      }),\n    })\n    ```\n\n3. Define a stack which `extends SmartStack` with resources:\n    ```ts\n    // lib/my-stack.ts\n    import { Construct } from 'constructs';\n    import { StackProps, RemovalPolicy } from 'aws-cdk-lib';\n    import { SmartStack, Name, UrlName, PathName, EC } from '@alma-cdk/project';\n\n    export class MyStack extends SmartStack {\n      constructor(scope: Construct, id: string, props?: StackProps) {\n        super(scope, id, props);\n\n        new dynamodb.Table(this, 'Table', {\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n\n          tableName: Name.it(this, 'MyTable'),\n          partitionKey: {\n            type: dynamodb.AttributeType.STRING,\n            name: 'pk',\n          },\n          // StagingMyTable\n        });\n\n        new events.EventBus(this, 'EventBus', {\n          eventBusName: Name.withProject(this, 'MyEventBus'),\n          // MyCoolProjectStagingMyEventBus\n        });\n\n        new s3.Bucket(this, 'Bucket', {\n\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n          autoDeleteObjects: EC.isStable(this) ? false : true,\n\n          bucketName: UrlName.globally(this, 'MyBucket'),\n          // acme-corp-my-cool-project-feature-foo-bar-my-bucket\n        });\n\n        new ssm.StringParameter(this, 'Parameter', {\n          stringValue: 'Foo',\n          tier: ssm.ParameterTier.ADVANCED,\n          parameterName: PathName.withProject(this, 'MyNamespace/MyParameter'),\n          // /MyCoolProject/Staging/MyNamespace/MyParameter\n        });\n      }\n    }\n    ```\n\n4. Define a new _environmental_ which `extends EnvironmentWrapper` and initialize all your environmental `SmartStack` stacks within:\n\n    ```ts\n    // lib/environment.ts\n    import { EnvironmentWrapper } from '@alma-cdk/project';\n    import { MyStack } from './my-stack';\n\n    export class Environment extends EnvironmentWrapper {\n      constructor(scope: Construct) {\n        super(scope);\n        new MyStack(this, 'MyStack', { description: 'This is required' });\n      }\n    }\n    ```\n\n    Resulting Stack properties (given `environment=staging`):\n\n    |        Property         |                    Example value                     |\n    | :---------------------- | :--------------------------------------------------- |\n    | `stackName`             | `\"MyCoolProject-Environment-Staging-MyExampleStack\"` |\n    | `terminationProtection` | `true`                                               |\n    | `env.account`           | `\"111111111111\"`                                     |\n    | `env.region`            | `\"eu-west-1\"`                                        |\n\n    Resulting Tags for the Stack and its resources (given `environment=staging`):\n\n    |        Property         |           Example value           |\n    | :---------------------- | :-------------------------------- |\n    | `Account`               | `dev`                             |\n    | `Environment`           | `staging`                         |\n    | `Project`               | `my-cool-project`                 |\n    | `Author`                | `Mad Scientists`                  |\n    | `Organization`          | `Acme Corp`                       |\n    | `Contact`               | `mad.scientists@acme.example.com` |\n\n5. Finally initialize the environment with the `Project` scope:\n\n    ```ts\n    // bin/app.ts\n    import { Project, Accounts } from '@alma-cdk/project';\n    import { Environment } from '../lib/environment';\n\n    const project = new Project({/* removed for brevity, see step 1 */})\n\n    new Environment(project);\n    ```\n"
+    "markdown": "<br/><br/><br/>\n\n🚧 **Work-in-Progress**\n\n<br/><br/><br/>\n\n<div align=\"center\">\n\t<br/>\n\t<br/>\n  <h1>\n\t<img width=\"300\" src=\"assets/alma-cdk-project.svg\" alt=\"Alma CDK Project\" />\n  <br/>\n  <br/>\n  </h1>\n\n  ```sh\n  npm i -D @alma-cdk/project\n  ```\n\n  <div align=\"left\">\n\n  Opinionated CDK “framework” with constructs & utilities for:\n  - deploying multiple environments to multiple accounts (with many-to-many relationship)\n  - managing account configuration through standardized props (no more random config files)\n  - querying account and/or environment specific information within your CDK code\n  - enabling dynamic & short-lived “feature-environments”\n  - enabling well-defined tagging\n  - providing structure & common conventions to CDK projects\n  - choosing the target account & environment by passing in runtime context:\n\n    ```sh\n    npx cdk deploy -c environment=feature/abc-123\n    ```\n    ... which means you don't need to define all the possibile environments ahead of time!\n\n  </div>\n  <br/>\n</div>\n\n\n## Account Strategies\n\nDepending on the use case, you may choose a configuration between 1-3 AWS accounts with the following environments:\n\n\n1. **Shared account (`shared`)**:\n\n    ![default-multi](assets/accounts-1x.svg)\n    <br/>\n\n2. **Multi-account (`dev`+`prod`)**_– RECOMMENDED_:\n\n    ![default-multi](assets/accounts-2x.svg)\n    <br/>\n\n<br/>\n</details>\n\n3. **Multi-account (`dev`+`preprod`+`prod`)**:\n\n    ![default-multi](assets/accounts-3x.svg)\n    <br/>\n\n<br/>\n\n## Getting Started\n\nSteps required to define a _environmental_ project resources; At first, it might seem complex but once you get into the habbit of defining your projects this way it starts to make sense:\n\n1. Choose your [Account Strategy](#account-strategies)\n\n2. Initialize a new `Project` instead of `cdk.App`:\n\n    ```ts\n    // bin/app.ts\n    import { Project, AccountStrategy } from '@alma-cdk/project';\n\n    const project = new Project({\n      // Basic info, you could also read these from package.json if you want\n      name: 'my-cool-project',\n      author: {\n        organization: 'Acme Corp',\n        name: 'Mad Scientists',\n        email: 'mad.scientists@acme.example.com',\n      },\n\n      // If not set, defaults to one of: $CDK_DEFAULT_REGION, $AWS_REGION or us-east-1\n      defaultRegion: 'eu-west-1',\n\n      // Configures the project to use 2 AWS accounts (recommended)\n      accounts: AccountStrategy.two({\n        dev: {\n          id: '111111111111',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.net',\n          },\n        },\n        prod: {\n          id: '222222222222',\n          config: {\n            // whatever you want here as [string]: any\n            baseDomain: 'example.com',\n          },\n        },\n      }),\n    })\n    ```\n\n3. Define a stack which `extends SmartStack` with resources:\n    ```ts\n    // lib/my-stack.ts\n    import { Construct } from 'constructs';\n    import { StackProps, RemovalPolicy } from 'aws-cdk-lib';\n    import { SmartStack, Name, UrlName, PathName, EC } from '@alma-cdk/project';\n\n    export class MyStack extends SmartStack {\n      constructor(scope: Construct, id: string, props?: StackProps) {\n        super(scope, id, props);\n\n        new dynamodb.Table(this, 'Table', {\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n\n          tableName: Name.it(this, 'MyTable'),\n          partitionKey: {\n            type: dynamodb.AttributeType.STRING,\n            name: 'pk',\n          },\n          // StagingMyTable\n        });\n\n        new events.EventBus(this, 'EventBus', {\n          eventBusName: Name.withProject(this, 'MyEventBus'),\n          // MyCoolProjectStagingMyEventBus\n        });\n\n        new s3.Bucket(this, 'Bucket', {\n\n          removalPolicy: EC.isStable(this) ? RemovalPolicy.RETAIN : RemovalPolicy.DESTROY,\n          autoDeleteObjects: EC.isStable(this) ? false : true,\n\n          bucketName: UrlName.globally(this, 'MyBucket'),\n          // acme-corp-my-cool-project-feature-foo-bar-my-bucket\n        });\n\n        new ssm.StringParameter(this, 'Parameter', {\n          stringValue: 'Foo',\n          tier: ssm.ParameterTier.ADVANCED,\n          parameterName: PathName.withProject(this, 'MyNamespace/MyParameter'),\n          // /MyCoolProject/Staging/MyNamespace/MyParameter\n        });\n      }\n    }\n    ```\n\n4. Define a new _environmental_ which `extends EnvironmentWrapper` and initialize all your environmental `SmartStack` stacks within:\n\n    ```ts\n    // lib/environment.ts\n    import { EnvironmentWrapper } from '@alma-cdk/project';\n    import { MyStack } from './my-stack';\n\n    export class Environment extends EnvironmentWrapper {\n      constructor(scope: Construct) {\n        super(scope);\n        new MyStack(this, 'MyStack', { description: 'This is required' });\n      }\n    }\n    ```\n\n    Resulting Stack properties (given `environment=staging`):\n\n    |        Property         |                    Example value                     |\n    | :---------------------- | :--------------------------------------------------- |\n    | `stackName`             | `\"MyCoolProject-Environment-Staging-MyExampleStack\"` |\n    | `terminationProtection` | `true`                                               |\n    | `env.account`           | `\"111111111111\"`                                     |\n    | `env.region`            | `\"eu-west-1\"`                                        |\n\n    Resulting Tags for the Stack and its resources (given `environment=staging`):\n\n    |        Property         |           Example value           |\n    | :---------------------- | :-------------------------------- |\n    | `Account`               | `dev`                             |\n    | `Environment`           | `staging`                         |\n    | `Project`               | `my-cool-project`                 |\n    | `Author`                | `Mad Scientists`                  |\n    | `Organization`          | `Acme Corp`                       |\n    | `Contact`               | `mad.scientists@acme.example.com` |\n\n5. Finally initialize the environment with the `Project` scope:\n\n    ```ts\n    // bin/app.ts\n    import { Project, Accounts } from '@alma-cdk/project';\n    import { Environment } from '../lib/environment';\n\n    const project = new Project({/* removed for brevity, see step 1 */})\n\n    new Environment(project);\n    ```\n\n<br/>\n\n\n## Documentation\n\nSee detailed documentation for specific classes & methods at [constructs.dev](http://constructs.dev/packages/@alma-cdk/project).\n\nGenerally speaking you would be most interested in the following:\n- Project\n- AccountStrategy\n- SmartStack\n- AccountWrapper & EnvironmentWrapper\n- AccountContext (AC)\n- EnvironmentContext (EC)\n- Name / UrlName / PathName\n"
   },
   "repository": {
     "type": "git",
@@ -3108,13 +3108,14 @@
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Interface for a single account type configuration."
       },
       "fqn": "@alma-cdk/project.AccountConfiguration",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/configurations/accounts.ts",
-        "line": 12
+        "line": 16
       },
       "name": "AccountConfiguration",
       "properties": [
@@ -3126,7 +3127,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 13
+            "line": 17
           },
           "name": "id",
           "type": {
@@ -3141,7 +3142,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 14
+            "line": 18
           },
           "name": "config",
           "optional": true,
@@ -3376,156 +3377,15 @@
       "name": "AccountContext",
       "symbolId": "src/context/account:AccountContext"
     },
-    "@alma-cdk/project.AccountType": {
+    "@alma-cdk/project.AccountStrategy": {
+      "abstract": true,
       "assembly": "@alma-cdk/project",
       "docs": {
+        "remarks": "Available strategies are:\n- One Account: `shared`\n- Two Accounts: `dev`+`prod` – _recommended_\n- Three Accounts: `dev`+`preprod`+`prod`",
         "stability": "experimental",
-        "summary": "Internal class to handle set/get operations for Account Type."
+        "summary": "Use static methods of `AccountStrategy` abstract class to define your account strategy."
       },
-      "fqn": "@alma-cdk/project.AccountType",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        }
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "src/project/account-type.ts",
-        "line": 10
-      },
-      "methods": [
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "locationInModule": {
-            "filename": "src/project/account-type.ts",
-            "line": 17
-          },
-          "name": "get",
-          "parameters": [
-            {
-              "name": "scope",
-              "type": {
-                "fqn": "constructs.Construct"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "primitive": "string"
-            }
-          },
-          "static": true
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "locationInModule": {
-            "filename": "src/project/account-type.ts",
-            "line": 31
-          },
-          "name": "matchFromEnvironment",
-          "parameters": [
-            {
-              "name": "scope",
-              "type": {
-                "fqn": "constructs.Construct"
-              }
-            },
-            {
-              "name": "accounts",
-              "type": {
-                "collection": {
-                  "elementtype": {
-                    "fqn": "@alma-cdk/project.Account"
-                  },
-                  "kind": "map"
-                }
-              }
-            },
-            {
-              "name": "environmentType",
-              "type": {
-                "primitive": "string"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "primitive": "string"
-            }
-          },
-          "static": true
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "locationInModule": {
-            "filename": "src/project/account-type.ts",
-            "line": 12
-          },
-          "name": "set",
-          "parameters": [
-            {
-              "name": "scope",
-              "type": {
-                "fqn": "constructs.Construct"
-              }
-            },
-            {
-              "name": "accountType",
-              "type": {
-                "primitive": "string"
-              }
-            }
-          ],
-          "static": true
-        }
-      ],
-      "name": "AccountType",
-      "symbolId": "src/project/account-type:AccountType"
-    },
-    "@alma-cdk/project.AccountWrapper": {
-      "assembly": "@alma-cdk/project",
-      "base": "constructs.Construct",
-      "docs": {
-        "stability": "experimental"
-      },
-      "fqn": "@alma-cdk/project.AccountWrapper",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "src/wrapper/account.ts",
-          "line": 7
-        },
-        "parameters": [
-          {
-            "name": "scope",
-            "type": {
-              "fqn": "constructs.Construct"
-            }
-          }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "src/wrapper/account.ts",
-        "line": 5
-      },
-      "name": "AccountWrapper",
-      "symbolId": "src/wrapper/account:AccountWrapper"
-    },
-    "@alma-cdk/project.Accounts": {
-      "assembly": "@alma-cdk/project",
-      "docs": {
-        "stability": "experimental"
-      },
-      "fqn": "@alma-cdk/project.Accounts",
+      "fqn": "@alma-cdk/project.AccountStrategy",
       "initializer": {
         "docs": {
           "stability": "experimental"
@@ -3534,26 +3394,26 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/configurations/accounts.ts",
-        "line": 48
+        "line": 53
       },
       "methods": [
         {
           "docs": {
-            "example": "Accounts.ONE({\n  shared: {\n    id: '111111111111',\n  },\n}),",
+            "example": "AccountStrategy.one({\n  shared: {\n    id: '111111111111',\n  },\n}),",
             "remarks": "1. `shared` account with environments:\n    - development\n    - feature/*\n    - test\n    - qaN\n    - staging\n    - preproduction\n    - production",
             "stability": "experimental",
             "summary": "Enables single account strategy."
           },
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 69
+            "line": 74
           },
           "name": "one",
           "parameters": [
             {
               "name": "props",
               "type": {
-                "fqn": "@alma-cdk/project.AccountsOneProps"
+                "fqn": "@alma-cdk/project.AccountStrategyOneProps"
               }
             }
           ],
@@ -3571,21 +3431,21 @@
         },
         {
           "docs": {
-            "example": "Accounts.THREE({\n  dev: {\n    id: '111111111111',\n  },\n  preprod: {\n    id: '222222222222',\n  },\n  prod: {\n    id: '333333333333',\n  },\n}),",
+            "example": "AccountStrategy.three({\n  dev: {\n    id: '111111111111',\n  },\n  preprod: {\n    id: '222222222222',\n  },\n  prod: {\n    id: '333333333333',\n  },\n}),",
             "remarks": "1. `dev` account with environments:\n    - development\n    - feature/*\n    - test\n    - staging\n2. `preprod` account with environments:\n    - qaN\n    - preproduction\n3. `prod` account with environments:\n    - production",
             "stability": "experimental",
             "summary": "Enables triple account strategy."
           },
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 172
+            "line": 177
           },
           "name": "three",
           "parameters": [
             {
               "name": "props",
               "type": {
-                "fqn": "@alma-cdk/project.AccountsThreeProps"
+                "fqn": "@alma-cdk/project.AccountStrategyThreeProps"
               }
             }
           ],
@@ -3603,21 +3463,21 @@
         },
         {
           "docs": {
-            "example": "Accounts.TWO({\n  dev: {\n    id: '111111111111',\n  },\n  prod: {\n    id: '222222222222',\n  },\n}),",
+            "example": "AccountStrategy.two({\n  dev: {\n    id: '111111111111',\n  },\n  prod: {\n    id: '222222222222',\n  },\n}),",
             "remarks": "1. `dev` account with environments:\n    - development\n    - feature/*\n    - test\n    - qaN\n    - staging\n2. `prod` account with environments:\n    - preproduction\n    - production",
             "stability": "experimental",
             "summary": "Enables dual account strategy."
           },
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 116
+            "line": 121
           },
           "name": "two",
           "parameters": [
             {
               "name": "props",
               "type": {
-                "fqn": "@alma-cdk/project.AccountsTwoProps"
+                "fqn": "@alma-cdk/project.AccountStrategyTwoProps"
               }
             }
           ],
@@ -3634,22 +3494,23 @@
           "static": true
         }
       ],
-      "name": "Accounts",
-      "symbolId": "src/configurations/accounts:Accounts"
+      "name": "AccountStrategy",
+      "symbolId": "src/configurations/accounts:AccountStrategy"
     },
-    "@alma-cdk/project.AccountsOneProps": {
+    "@alma-cdk/project.AccountStrategyOneProps": {
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Props `AccountStrategy.one`."
       },
-      "fqn": "@alma-cdk/project.AccountsOneProps",
+      "fqn": "@alma-cdk/project.AccountStrategyOneProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/configurations/accounts.ts",
-        "line": 25
+        "line": 22
       },
-      "name": "AccountsOneProps",
+      "name": "AccountStrategyOneProps",
       "properties": [
         {
           "abstract": true,
@@ -3659,7 +3520,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 27
+            "line": 24
           },
           "name": "shared",
           "type": {
@@ -3674,7 +3535,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 26
+            "line": 23
           },
           "name": "mock",
           "optional": true,
@@ -3683,21 +3544,22 @@
           }
         }
       ],
-      "symbolId": "src/configurations/accounts:AccountsOneProps"
+      "symbolId": "src/configurations/accounts:AccountStrategyOneProps"
     },
-    "@alma-cdk/project.AccountsThreeProps": {
+    "@alma-cdk/project.AccountStrategyThreeProps": {
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Props `AccountStrategy.three`."
       },
-      "fqn": "@alma-cdk/project.AccountsThreeProps",
+      "fqn": "@alma-cdk/project.AccountStrategyThreeProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/configurations/accounts.ts",
-        "line": 36
+        "line": 35
       },
-      "name": "AccountsThreeProps",
+      "name": "AccountStrategyThreeProps",
       "properties": [
         {
           "abstract": true,
@@ -3707,7 +3569,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 38
+            "line": 37
           },
           "name": "dev",
           "type": {
@@ -3722,7 +3584,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 39
+            "line": 38
           },
           "name": "preprod",
           "type": {
@@ -3737,7 +3599,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 40
+            "line": 39
           },
           "name": "prod",
           "type": {
@@ -3752,7 +3614,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 37
+            "line": 36
           },
           "name": "mock",
           "optional": true,
@@ -3761,21 +3623,22 @@
           }
         }
       ],
-      "symbolId": "src/configurations/accounts:AccountsThreeProps"
+      "symbolId": "src/configurations/accounts:AccountStrategyThreeProps"
     },
-    "@alma-cdk/project.AccountsTwoProps": {
+    "@alma-cdk/project.AccountStrategyTwoProps": {
       "assembly": "@alma-cdk/project",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Props `AccountStrategy.two`."
       },
-      "fqn": "@alma-cdk/project.AccountsTwoProps",
+      "fqn": "@alma-cdk/project.AccountStrategyTwoProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/configurations/accounts.ts",
-        "line": 30
+        "line": 28
       },
-      "name": "AccountsTwoProps",
+      "name": "AccountStrategyTwoProps",
       "properties": [
         {
           "abstract": true,
@@ -3785,7 +3648,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 32
+            "line": 30
           },
           "name": "dev",
           "type": {
@@ -3800,7 +3663,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 33
+            "line": 31
           },
           "name": "prod",
           "type": {
@@ -3815,7 +3678,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/configurations/accounts.ts",
-            "line": 31
+            "line": 29
           },
           "name": "mock",
           "optional": true,
@@ -3824,7 +3687,152 @@
           }
         }
       ],
-      "symbolId": "src/configurations/accounts:AccountsTwoProps"
+      "symbolId": "src/configurations/accounts:AccountStrategyTwoProps"
+    },
+    "@alma-cdk/project.AccountType": {
+      "assembly": "@alma-cdk/project",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Internal class to handle set/get operations for Account Type."
+      },
+      "fqn": "@alma-cdk/project.AccountType",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/project/account-type.ts",
+        "line": 10
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/project/account-type.ts",
+            "line": 17
+          },
+          "name": "get",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/project/account-type.ts",
+            "line": 31
+          },
+          "name": "matchFromEnvironment",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "accounts",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "fqn": "@alma-cdk/project.Account"
+                  },
+                  "kind": "map"
+                }
+              }
+            },
+            {
+              "name": "environmentType",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/project/account-type.ts",
+            "line": 12
+          },
+          "name": "set",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "accountType",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "static": true
+        }
+      ],
+      "name": "AccountType",
+      "symbolId": "src/project/account-type:AccountType"
+    },
+    "@alma-cdk/project.AccountWrapper": {
+      "assembly": "@alma-cdk/project",
+      "base": "constructs.Construct",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Wrapper for account-level stacks."
+      },
+      "fqn": "@alma-cdk/project.AccountWrapper",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/wrapper/account.ts",
+          "line": 10
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/wrapper/account.ts",
+        "line": 8
+      },
+      "name": "AccountWrapper",
+      "symbolId": "src/wrapper/account:AccountWrapper"
     },
     "@alma-cdk/project.Author": {
       "assembly": "@alma-cdk/project",
@@ -4501,7 +4509,8 @@
       "assembly": "@alma-cdk/project",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Wrapper for environmental stacks."
       },
       "fqn": "@alma-cdk/project.EnvironmentWrapper",
       "initializer": {
@@ -4510,7 +4519,7 @@
         },
         "locationInModule": {
           "filename": "src/wrapper/environment.ts",
-          "line": 6
+          "line": 9
         },
         "parameters": [
           {
@@ -4524,7 +4533,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/wrapper/environment.ts",
-        "line": 5
+        "line": 8
       },
       "name": "EnvironmentWrapper",
       "symbolId": "src/wrapper/environment:EnvironmentWrapper"
@@ -5564,6 +5573,6 @@
       "symbolId": "src/name/name-url:UrlName"
     }
   },
-  "version": "0.0.14",
-  "fingerprint": "vEgkOZgFu3i3GChywMiVzy/lFWyUkYIafDhO5YvaDeM="
+  "version": "0.0.17",
+  "fingerprint": "OXl2lfPzMoWBNGRkixdEMnL3oE8vp1dDaa2drmST5Mk="
 }